Este documento registra los cambios relevantes de documentación, arquitectura y evolución técnica de IZ-CentralForms.
Actualmente el proyecto se encuentra en etapa de documentación técnica y preparación para despliegue. No debe interpretarse este historial como un changelog productivo hasta que exista una versión publicada en QA, staging o producción.
| Fecha | Versión | Tipo | Cambio | Evidencia |
|---|
| 2026-06-11 | docs-validado-final | Revisión cruzada contra código y documentos finales de desarrollo; se rescataron variables de entorno, troubleshooting local, checklist operativo y backlog técnico. | Equipo Interzone | configuracion.md, despliegue.md, operacion.md, roadmap.md |
| 2026-06-11 | 0.1.0-docs | Documentación | Homologación inicial de documentación Starlight para IZ-CentralForms. | Carpeta proyectos/iz-centralforms/ |
| 2026-06-11 | 0.1.1-docs | Documentación | Estandarización de estructura documental: arquitectura, tecnología, infraestructura, configuración, despliegue, operación, seguridad, roadmap e historial. | Archivos .md del proyecto |
| 2026-06-11 | 0.1.2-docs | Arquitectura | Integración de diagramas recortados en assets/ y traslado de texto, notas, errores y flujos a Markdown. | arquitectura.md, seguridad.md |
| 2026-06-11 | 0.1.3-docs | Validación técnica | Revisión de documentación contra el código de la aplicación. | Código fuente CentralForms |
| 2026-06-11 | 0.1.4-docs | Ajuste documental | Simplificación de documentos para reducir duplicidad y mantener contenido técnico claro para jefatura y desarrollo. | Documentación validada |
| Área | Estado documentado |
|---|
| Core API | Implementado |
| Seguridad base | Implementada |
| SDK Embed | Implementado |
| Email/Webhook | Implementado como base funcional |
| IntegrationLogs | Implementado |
| Admin API | Implementada parcialmente para consulta operativa |
| Admin Panel | Pendiente |
| Despliegue productivo | Pendiente |
| Monitoreo productivo | Pendiente |
| Versión sugerida | Área | Cambio esperado | Prioridad |
|---|
0.2.0-admin | Administración | Panel administrativo con autenticación, roles y gestión de formularios. | Alta |
0.3.0-security | Seguridad | Rotación formal de API Keys, auditoría admin y hardening de CORS/HTTPS. | Alta |
0.4.0-ops | Operación | Monitoreo, alertas, retención de logs y backups productivos. | Media |
0.5.0-integrations | Integraciones | Retry policy, reprocesamiento manual y dead-letter para integraciones fallidas. | Media |
1.0.0 | Release | Versión candidata para ambiente real con despliegue, operación y soporte definidos. | Alta |
Registrar un cambio cuando afecte cualquiera de estas áreas:
- endpoints públicos o administrativos;
- headers, payloads o códigos de respuesta;
- seguridad: API Key, Origin, CSRF, Admin Key, CORS o rate limiting;
- base de datos, migraciones o scripts SQL;
- SDK Embed;
- email, webhook o
IntegrationLogs;
- despliegue IIS, SQL Server o configuración productiva;
- operación, monitoreo, backups o troubleshooting;
- diagramas o arquitectura.
Cada cambio debe asociarse con al menos una evidencia:
| Evidencia | Uso |
|---|
| Commit | Cambio técnico en código. |
| Pull request | Revisión técnica aprobada. |
| Ticket | Solicitud funcional, bug o tarea operativa. |
| Release tag | Versión publicada. |
| Documento actualizado | Cambio documental. |
| Captura o log | Evidencia de despliegue o validación. |
| Criterio | Aplicación |
|---|
| Claridad | Evitar duplicar la misma información en varias tablas. |
| Trazabilidad | Distinguir cambios documentales de cambios funcionales. |
| Precisión | Validar contra código cuando el documento describa comportamiento real. |
| Starlight | Mantener frontmatter, asides y estructura compatible con Astro/Starlight. |
| Assets | Usar solo diagramas recortados; no capturas completas del PDF. |
| Pendientes | Marcar como pendiente lo que no exista todavía en código o infraestructura. |
