erp-construccion/orchestration/inventarios/README.md

108 lines
2.9 KiB
Markdown

# Inventarios - ERP Construccion
**Version:** 1.0.0
**Fecha:** 2025-12-06
---
## Descripcion
Este directorio contiene los inventarios YAML que sirven como **Single Source of Truth (SSOT)** para el proyecto ERP Construccion. Estos archivos son la referencia canonica para metricas, trazabilidad y componentes del sistema.
---
## Archivos de Inventario
| Archivo | Descripcion | Actualizado |
|---------|-------------|-------------|
| [MASTER_INVENTORY.yml](./MASTER_INVENTORY.yml) | Inventario maestro con metricas globales | 2025-12-06 |
| [TRACEABILITY_MATRIX.yml](./TRACEABILITY_MATRIX.yml) | Matriz de trazabilidad RF->ET->US->Codigo | 2025-12-06 |
| [DEPENDENCY_GRAPH.yml](./DEPENDENCY_GRAPH.yml) | Grafo de dependencias entre modulos | 2025-12-06 |
| [BACKEND_INVENTORY.yml](./BACKEND_INVENTORY.yml) | Inventario de componentes backend | 2025-12-06 |
| [FRONTEND_INVENTORY.yml](./FRONTEND_INVENTORY.yml) | Inventario de componentes frontend (web+mobile) | 2025-12-06 |
| [DATABASE_INVENTORY.yml](./DATABASE_INVENTORY.yml) | Inventario de objetos de base de datos | 2025-12-06 |
---
## Resumen Ejecutivo
### Metricas del Proyecto
| Metrica | Valor |
|---------|-------|
| **Modulos** | 18 |
| **Requerimientos (RF)** | 79 |
| **Especificaciones (ET)** | 78 |
| **User Stories (US)** | 139 |
| **Story Points** | 650 |
| **Tablas BD** | 67 |
| **Endpoints API** | 280 |
| **Apps Moviles** | 5 |
| **Reutilizacion Core** | 61% |
### Configuracion de Puertos
| Servicio | Puerto |
|----------|--------|
| Backend API | 3100 |
| Frontend Web | 5174 |
| PostgreSQL | 5433 |
| Redis | 6380 |
| MinIO API | 9100 |
| MinIO Console | 9101 |
---
## Uso de los Inventarios
### Para Agentes
Los agentes NEXUS deben consultar estos inventarios antes de:
1. Crear nuevos componentes (verificar que no existan)
2. Establecer dependencias entre modulos
3. Calcular metricas de progreso
### Para Documentacion
Estos archivos son la referencia para:
1. Generar reportes de avance
2. Validar trazabilidad completa
3. Identificar gaps en documentacion
### Para Desarrollo
Los desarrolladores deben:
1. Actualizar inventarios al completar implementaciones
2. Verificar dependencias antes de empezar modulo
3. Registrar nuevos endpoints/componentes
---
## Actualizacion
### Frecuencia
- **MASTER_INVENTORY.yml**: Al completar hitos
- **TRACEABILITY_MATRIX.yml**: Al documentar RF/ET/US
- **DEPENDENCY_GRAPH.yml**: Al agregar dependencias
- **Inventarios de capa**: Al implementar componentes
### Responsables
- **Requirements-Analyst**: RF, ET, US, MASTER
- **NEXUS-BACKEND**: BACKEND_INVENTORY
- **NEXUS-FRONTEND**: FRONTEND_INVENTORY
- **NEXUS-DATABASE**: DATABASE_INVENTORY
---
## Alineacion con ERP Core
Estos inventarios siguen la misma estructura que `/erp-core/orchestration/inventarios/` para mantener consistencia entre proyectos.
Ver [DEVENV-PORTS.md](/home/isem/workspace/core/devtools/environment/DEVENV-PORTS.md) para esquema global de puertos.
---
**Ultima actualizacion:** 2025-12-06