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

2.5 KiB

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:

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. Crear estructura de trazabilidad (Sprint 2.3)
  2. 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


Ultima actualizacion: 2025-11-24 Version: 1.0.0