# Starter Kit RKM

**Autor:** Rodrigo Jaque Escobar  
**Contacto:** rjaquers@gmail.com  
**Versión:** v6.0.0 (marzo 2026)

## Licencia y autoría

Este proyecto fue diseñado y desarrollado por Rodrigo Jaque Escobar como base MVC en PHP para entornos de hosting restrictivos (sin SSH, sin Composer, despliegue FTP a cPanel).

## Stack tecnológico

- PHP 8.2+ con `mysqli` + Prepared Statements
- MySQL / MariaDB
- Bootstrap 5 + Font Awesome + Bootstrap Icons
- JavaScript nativo + AJAX puntual
- PHPMailer (manual, en `/vendor/phpmailer/`)
- PWA (Service Worker + Manifest)

## Estructura del proyecto

```
├── app/
│   ├── controllers/      # Controladores MVC
│   │   └── api/          # Endpoints JSON
│   ├── core/             # Núcleo: Router, Controller, Model, Autoload
│   ├── helpers/          # Funciones globales (csrf, logger, network)
│   ├── middleware/        # Auth y Permission
│   ├── mobile/           # QR Scanner helper
│   ├── models/           # Capa de datos (mysqli)
│   ├── reports/          # Excel/Pdf (placeholders)
│   ├── services/         # Lógica de negocio
│   └── views/            # Plantillas PHP
│       ├── auth/         # Login
│       ├── dashboard/    # Panel principal
│       ├── emails/       # Plantillas de correo
│       └── layouts/      # Header y Footer
├── cache/                # Caché en archivos (CacheService)
├── config/               # Configuración (DB, mail, PWA)
├── docs/                 # Documentación
├── logs/                 # Logs de aplicación
├── public/               # DocumentRoot público
│   ├── assets/
│   │   ├── css/
│   │   ├── icons/
│   │   └── js/
│   ├── .htaccess
│   └── index.php         # Front Controller
├── sql/                  # Schema, seed y optimizaciones
└── vendor/               # Librerías manuales (PHPMailer)
```

## Changelog

Ver [`CHANGELOG.md`](CHANGELOG.md) para el historial completo de versiones.