Desarrollo y releases
Entorno único
Todo desarrollo se realiza directamente en /opt/esp-platform/repo dentro de la VM. El Mac solo aporta SSH, navegador y USB. No existe copia de trabajo paralela.
Estructura
backend contiene Spring Boot, recursos, Flyway y frontend. docs contiene Markdown oficial e histórico. scripts contiene validación y operación reproducible. Los datos binarios no se versionan en Git.
Flujo
Lea la Constitución y SPEC antes de diseñar. Cree una rama cuando proceda, implemente de forma acotada, ejecute Maven test, valide la UI y los flujos físicos según riesgo. Actualice documentación y ADR. Después cree commit, tag, release interna y snapshot aprobado.
Migraciones
Flyway es la única vía para cambiar esquema. Una migración aplicada no se modifica; se añade otra. Las entidades usan ddl-auto validate para detectar divergencias.
Documentación
Edite Markdown, ejecute scripts/build-documentation.sh y compruebe manifest, enlaces, descargas y paquete. La web no edita archivos críticos.
Estabilidad
v0.1.0-flasher-backups está congelada como producto estable. Solo admite correcciones, seguridad, compatibilidad o mejoras expresamente aprobadas.