Validaciones internas
Esta sección es para el equipo interno de desarrollo, operación y documentación. No debe exponerse como material para stakeholders.
Objetivo
Concentrar lo que la documentación publicada no puede afirmar: gaps, contradicciones detectadas, preguntas abiertas y riesgos conocidos.
Separar esto de la documentación publicada permite que lo publicado sea afirmativo y confiable, mientras lo incierto queda registrado en lugar de perderse.
Estado
- Estado: Borrador
- Última actualización: 2026-08-02
- Owner: Desarrollo / documentación
Documentos
| Dominio | Documento | Contenido |
|---|---|---|
| Arquitectura | Arquitectura y tecnologías | Contradicción de stack resuelta, gaps de arquitectura y modelo de datos. |
| Runbook | Runbook de operación diaria | Preguntas sobre responsables, alertamiento y línea base. |
| Integraciones | Integraciones externas | Contradicción de integraciones resuelta, gaps de colas y contingencia. |
| Scheduler | Scheduler, batch y colas | Confirmación del scheduler, idempotencia pendiente, riesgos de comandos. |
| Módulos | Módulos | Cobertura, dominios sin documentar y riesgos de datos. |
| Facturación | Facturación | Preguntas abiertas del ciclo mensual y hallazgos confirmados. |
Lo más urgente
Ordenado por impacto:
| # | Pendiente | Dónde |
|---|---|---|
| 1 | Validar la secuencia real del ciclo mensual de facturación. | Facturación |
| 2 | Confirmar qué comandos son idempotentes. Sin esto, cada reintento es una decisión a ciegas. | Scheduler |
| 3 | Definir procedimiento ante reliquidaciones de periodos ya facturados. | Facturación |
| 4 | Definir procedimiento de cancelación de CFDI. | Facturación |
| 5 | Establecer alertamiento del cron, los workers y las tareas programadas. | Runbook |
Contradicciones detectadas
| Fecha | Contradicción | Estado |
|---|---|---|
| 2026-08-02 | El stack documentado (React, Vite, Supabase) no correspondía a sy-energy. Afectaba tecnologías, integraciones y variables. | Resuelta. Documentos reescritos contra código. Origen de la fuente incorrecta sin identificar. |
| 2026-08-02 | El scheduler figuraba como "pendiente de confirmar existencia" cuando está definido en código con 9 tareas. | Resuelta. |
| 2026-08-02 | La documentación listaba 7 comandos "pendiente SME"; el repositorio declara más de 45. | Resuelta. |