erp-construccion/docs/04-modelado/trazabilidad/README.md

106 lines
2.5 KiB
Markdown

# TRAZABILIDAD - ERP CONSTRUCCION
**Fecha:** 2025-11-24
**Basado en:** ADR-012 Politica de Trazabilidad Completa
**Version:** 1.0.0
---
## Proposito
Este directorio contiene la documentacion de trazabilidad del ERP de Construccion, asegurando la conexion completa entre:
- **Requerimientos Funcionales (RF)**
- **Especificaciones Tecnicas (ET)**
- **Objetos de Base de Datos (BD)**
- **Codigo Fuente (Code)**
## Estructura
```
trazabilidad/
+-- README.md (este archivo)
+-- INVENTARIO-OBJETOS-BD.yml # Inventario completo de objetos BD
+-- MATRIZ-TRAZABILIDAD-GLOBAL.md # Matriz RF -> ET -> BD -> Code
+-- modulos/
| +-- TRACEABILITY-MAI-001.yaml # Trazabilidad por modulo
| +-- TRACEABILITY-MAI-002.yaml
| +-- TRACEABILITY-MAI-003.yaml
| +-- ...
```
## Formato de Trazabilidad por Modulo
Cada archivo `TRACEABILITY-MAI-XXX.yaml` sigue el formato:
```yaml
modulo: MAI-XXX
nombre: Nombre del Modulo
fecha_actualizacion: YYYY-MM-DD
responsable: rol-responsable
requerimientos:
- id: RF-XXX-001
nombre: Nombre del Requerimiento
prioridad: P0|P1|P2
especificaciones:
- id: ET-XXX-001
tipo: backend|frontend|database
estado: pendiente|en_progreso|completado
tablas_bd:
- schema.tabla_1
- schema.tabla_2
codigo:
- path/to/file.ts
- path/to/component.tsx
```
## Inventario de Objetos BD
El archivo `INVENTARIO-OBJETOS-BD.yml` contiene:
- Lista completa de schemas
- Lista completa de tablas por schema
- ENUMs/Types definidos
- Funciones y triggers
- Policies RLS
- Vistas
## Matriz de Trazabilidad
La matriz global permite:
1. **Forward Tracing:** RF -> ET -> BD -> Code
2. **Backward Tracing:** Code -> BD -> ET -> RF
3. **Analisis de Impacto:** Que cambia si modifico X?
4. **Cobertura:** Que RFs no tienen implementacion?
## Estados de Trazabilidad
| Estado | Descripcion |
|--------|-------------|
| `pendiente` | Documentado pero no implementado |
| `en_progreso` | En desarrollo |
| `completado` | Implementado y probado |
| `obsoleto` | Ya no aplica |
## Proximos Pasos
1. [x] Crear estructura de trazabilidad (Sprint 2.3)
2. [x] Crear INVENTARIO-OBJETOS-BD.yml (Sprint 2.4)
3. [ ] Crear TRACEABILITY-MAI-XXX.yaml por modulo (Sprint 3)
4. [ ] Crear MATRIZ-TRAZABILIDAD-GLOBAL.md (Sprint 5)
---
## Referencias
- [ADR-012: Politica de Trazabilidad Completa](../../adr/ADR-012-complete-traceability-policy.md)
- [Database Design](../database-design/)
- [ERP Generico - Trazabilidad](/projects/erp-generic/docs/02-modelado/trazabilidad/)
---
**Ultima actualizacion:** 2025-11-24
**Version:** 1.0.0