---
id: development-repository
title: Desarrollo y releases
category: development
version: 1.0
status: stable
audience:
  - user
  - administrator
  - developer
  - ai
updated_at: 2026-07-14
related:
  - documentation-home
  - operations-platform-operations
  - architecture-esp-platform-architecture-v1-0
tags:
  - development
  - git
  - release
  - flyway
---

# 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.