# Documentación Klee Framework

Este directorio es la fuente oficial de documentación técnica del framework.

## Índice

1. **[01_GETTING_STARTED.md](01_GETTING_STARTED.md)**  
   Instalación, configuración completa de `.env` y `ConfigEnv.php`, estructura de directorios y primer arranque.

2. **[02_ARCHITECTURE.md](02_ARCHITECTURE.md)**  
   Flujo HTTP completo, componentes del core (Controller, Model, View, Router), sistema de atributos (26 tipos), traits del modelo, middleware pipeline, servicios (Request, Response, UserFlash, EventDispatcher, MailService, ListaAjax), permisos, CSRF y seguridad.

3. **[03_MODULE_DEVELOPMENT.md](03_MODULE_DEVELOPMENT.md)**  
   Guía paso a paso para crear módulos con código real: scaffolding `bin/make`, modelo con atributos, controlador CRUD, vistas (list, view, create, edit, _form), migraciones, seeders, registro en Modules.php y configuración de ListaAjax.

4. **[04_DATABASE_WORKFLOW.md](04_DATABASE_WORKFLOW.md)**  
   Migraciones (estructura, reglas, ejemplos de código), seeders (datos y permisos), convención de orden y secuencia de despliegue.

5. **[05_OPERATIONS.md](05_OPERATIONS.md)**  
   Doctor de entorno, cache/classmap, smoke tests, logs y runbook de incidencias.

6. **[06_STANDARDS.md](06_STANDARDS.md)**  
   Naming completo (controladores, modelos, tablas, columnas, vistas, migraciones), formato de código, reglas de compatibilidad, UI/Metronic y versionado SemVer.

7. **[AI_MODULE_DEVELOPMENT_GUIDE.md](AI_MODULE_DEVELOPMENT_GUIDE.md)**  
   Guía completa para asistentes IA: reglas obligatorias, proceso paso a paso, patrones de código con snippets reales (modelo, controlador, vistas, migración, seeder, Modules.php), APIs disponibles, reglas CSRF, checklist de entrega y prompt recomendado.

## Regla de mantenimiento

- Si cambia un flujo técnico o comando CLI, se actualiza esta carpeta en el mismo cambio.
- No crear documentación paralela fuera de `docs/` excepto `README.md` y `CHANGELOG.md`.