# 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