Validación — Arquitectura y tecnologías
Uso interno. No exponer como material para stakeholders.
Estado
- Última actualización: 2026-08-02
- Owner: Desarrollo / documentación
Contradicciones resueltas
El stack documentado no correspondía al sistema
Detectado: 2026-08-02, al contrastar la documentación contra el repositorio.
La versión anterior de overview/inventario-tecnologias.md describía un stack de Vite, React, TypeScript, shadcn-ui y Supabase (Auth, Postgres, Storage) como tecnologías de sy-energy.
sy-energy es una aplicación Laravel 13 sobre PHP 8.5, con MySQL, MongoDB, Redis y AWS. No usa React, ni Vite, ni Supabase en ninguna capa.
La misma información incorrecta aparecía en overview/integraciones-externas.md y en overview/variables-por-ambiente.md, esta última con variables VITE_SUPABASE_*.
Hipótesis del origen: la fuente cruda de la primera pasada documental probablemente correspondía a otro producto, o a un prototipo que no llegó a producción.
Resolución: los tres documentos se reescribieron contra el código del repositorio. Queda registrado aquí para que la contradicción no se reintroduzca si vuelve a aparecer esa fuente.
Pendiente: confirmar de dónde salió esa descripción, por si hay más documentación derivada de la misma fuente.
Gaps abiertos
| Gap | Detalle | Quién lo cierra |
|---|---|---|
| Versiones de motores | No están confirmadas las versiones productivas de MySQL, MongoDB y Redis. | DevOps |
| Modelo de datos | No existe diagrama de entidades ni diccionario de datos. | Desarrollo |
Migración app/ → src/ | No está documentado qué se migra a la capa de dominios y qué se queda. | Desarrollo |
| Diferencias entre participantes | Más allá de las colas, no está documentado qué configuración difiere entre instancias. | Desarrollo / DevOps |
| Arquitectura de red | No documentada: topología, dimensionamiento, respaldos del servidor. | DevOps |
| Política de dependencias | No documentada la estrategia de actualización. | Desarrollo |
| Rollback de base de datos | Deployer revierte código, no migraciones. Sin procedimiento documentado. | DevOps |
Observaciones técnicas
- El repositorio incluye
CODE_QUALITY_AND_PATTERNS.mdySECURITY_REVIEW.md. Conviene revisar si su contenido debe reflejarse en la documentación publicada. - Los archivos de despliegue por participante contienen hostnames e IPs productivas. No deben transcribirse a la documentación publicada.
- Los modelos históricos mezclan español e inglés en nombres de tabla y columna, lo que eleva el costo de lectura de cualquier consulta.
- Conviven Bootstrap 4 con Tailwind, y jQuery con Vue 3.