diff --git a/README.md b/README.md index 3197f46..abca65f 100644 --- a/README.md +++ b/README.md @@ -2,9 +2,28 @@ Repositorio del sistema DH Inspección V2. -## Estructura +## Componentes -- `api-v3/`: API v3. -- `web-v2/`: aplicación web. -- `scripts/`: utilidades operativas y de despliegue. -- `docs/`: documentación técnica. +- `api-v3/`: API NestJS/TypeORM y contratos de dominio. +- `web-v2/`: aplicación WEB React/Vite. +- `android-app/`: aplicación Android para trabajo de campo. +- `scripts/`: utilidades operativas, preflight y despliegue. +- `docs/`: documentación funcional y técnica. + +## Documentación vigente + +- [Manual del Programador](docs/MANUAL_PROGRAMADOR.md) +- [Manual de Usuario](docs/MANUAL_USUARIO.md) +- [Modelo canónico de Inventarios F6.1](docs/F6_INVENTORY_MODEL.md) +- [Auditoría de consistencia F6.1](docs/AUDITORIA_CONSISTENCIA_F6_1.md) + +## Contratos que no deben romperse + +- Inventario físico: **Departamento → Área → Yacimiento → Instalación → Subinstalación**. +- Empresa es un maestro independiente; la Operadora se relaciona temporalmente con Área. +- Una Inspección puede tener múltiples Actas, pero sólo un Acta `DRAFT` simultánea. +- Hallazgos directos: Yacimiento, Instalación y Subinstalación, siempre con `OTROS` disponible. +- La APK puede abrir una Inspección reutilizando el lifecycle canónico del backend. +- GEDO/IF oficializa el Informe, pero no activa por sí solo el vencimiento No urgente. + +Las reglas detalladas y el procedimiento de cambio seguro están en los manuales enlazados arriba.