erp-core/orchestration/analisis/F3-PLAN-ESTANDARIZACION-DOCUMENTACION-2026-01-10.md

FASE 3: PLAN DE ESTANDARIZACION DE DOCUMENTACION

ERP Core - Plan de Accion Detallado

---

METADATOS

Campo	Valor
Fase	3 - Planeacion basada en Analisis
Proyecto	ERP Core
Fecha	2026-01-10
Orquestador	PERFIL-ORQUESTADOR
Metodologia	CAPVED + SIMCO v3.8
Estado	COMPLETADO
Documento Anterior	F2-ANALISIS-DETALLADO-DOCUMENTACION-2026-01-10.md

---

1. RESUMEN DEL PLAN

1.1 Objetivos

1. Corregir errores criticos en inventarios YAML
2. Actualizar especificaciones tecnicas desactualizadas
3. Crear documentacion faltante para modulos verticales
4. Estandarizar nomenclatura de archivos y directorios
5. Sincronizar inventarios con estado actual del codigo

1.2 Metricas Meta

Metrica	Actual	Meta	Incremento
Completitud Global	62%	95%	+33%
Sync Codigo-Docs	40%	90%	+50%
Nomenclatura	77%	95%	+18%
Inventarios	70%	100%	+30%

1.3 Esfuerzo Total Estimado

PRIORIDAD P0 (Criticos):    62-70 horas
PRIORIDAD P1 (Altos):       40-45 horas
PRIORIDAD P2 (Medios):      19-20 horas
────────────────────────────────────────
TOTAL:                      121-135 horas

---

2. PLAN DE EJECUCION POR PRIORIDAD

2.1 SPRINT 1: CORRECCIONES CRITICAS (P0)

Duracion estimada: 3-4 dias Esfuerzo: 62-70 horas Perfiles: DOCUMENTATION, DOCUMENTATION-MAINTAINER

BLOQUE A: Correcciones Inventarios (8 horas)

Tarea	ID	Archivo	Accion	Esfuerzo	Perfil
A1	GAP-P0-004	MASTER_INVENTORY.yml	Corregir estructura YAML lineas 1054-1102	1h	DOC-MAINT
A2	GAP-P0-013	BACKEND_INVENTORY.yml	Agregar MGN-005 a MGN-010	4h	DOC
A3	GAP-P0-014	FRONTEND_INVENTORY.yml	Agregar MGN-005 a MGN-009	4h	DOC
A4	GAP-P0-015	DEPENDENCY_GRAPH.yml	Actualizar (36 dias desactualizado)	2h	DOC
A5	GAP-P1-005	TRACEABILITY_MATRIX.yml	Actualizar metricas y test_coverage	2h	DOC

Orden de ejecucion: A1 → A4 → A5 → A2 → A3

BLOQUE B: Actualizacion ET Existentes (14 horas)

Tarea	ID	Archivo	Servicios a Documentar	Esfuerzo	Perfil
B1	GAP-P0-002	ET-auth-backend.md	mfa, trusted-devices, email-verification, permission-cache, apiKeys, oauth	6h	DOC
B2	GAP-P0-003	ET-FIN-backend.md	invoices, payments, payment-methods, payment-terms, journal-entries, reconcile-models, taxes, incoterms	8h	DOC

Detalle B1 - ET-auth-backend.md:

servicios_a_agregar:
  - nombre: mfa.service.ts
    entidades: [user-mfa.entity.ts, mfa-audit-log.entity.ts]
    endpoints: [POST /mfa/setup, POST /mfa/verify, POST /mfa/disable]
    tests: 45

  - nombre: trusted-devices.service.ts
    entidades: [trusted-device.entity.ts]
    endpoints: [GET /devices, DELETE /devices/:id]
    tests: 41

  - nombre: email-verification.service.ts
    entidades: [email-verification-token.entity.ts, verification-code.entity.ts]
    endpoints: [POST /verify-email, POST /resend-verification]
    tests: 32

  - nombre: permission-cache.service.ts
    entidades: []
    endpoints: []
    tests: 37

  - nombre: apiKeys.service.ts
    entidades: [api-key.entity.ts]
    endpoints: [POST /api-keys, GET /api-keys, DELETE /api-keys/:id]
    tests: -

  - nombre: oauth.service.ts
    entidades: [oauth-provider.entity.ts, oauth-state.entity.ts, oauth-user-link.entity.ts]
    endpoints: [GET /oauth/:provider, GET /oauth/:provider/callback]
    tests: 32

servicios_a_eliminar:
  - password.service.ts (no existe)
  - blacklist.service.ts (no existe)

Detalle B2 - ET-FIN-backend.md:

servicios_a_agregar:
  - nombre: invoices.service.ts
    entidades: [invoice.entity.ts, invoice-line.entity.ts]
    endpoints: [CRUD /invoices]

  - nombre: payments.service.ts
    entidades: [payment.entity.ts, payment-invoice.entity.ts]
    endpoints: [CRUD /payments, POST /payments/:id/reconcile]
    tests: 36

  - nombre: payment-methods.service.ts
    entidades: [payment-method.entity.ts]
    endpoints: [CRUD /payment-methods]

  - nombre: payment-terms.service.ts
    entidades: [payment-term.entity.ts, payment-term-line.entity.ts]
    endpoints: [CRUD /payment-terms]

  - nombre: journal-entries.service.ts
    entidades: [journal-entry.entity.ts, journal-entry-line.entity.ts]
    endpoints: [CRUD /journal-entries, POST /journal-entries/:id/post]

  - nombre: reconcile-models.service.ts
    entidades: [reconcile-model.entity.ts, reconcile-model-line.entity.ts]
    endpoints: [CRUD /reconcile-models]

  - nombre: taxes.service.ts
    entidades: [tax.entity.ts]
    endpoints: [CRUD /taxes]

  - nombre: incoterms.service.ts
    entidades: [incoterm.entity.ts]
    endpoints: [CRUD /incoterms]

BLOQUE C: Creacion ET Modulos Verticales (40-48 horas)

Tarea	ID	Modulo	Servicios	Esfuerzo	Perfil
C1	GAP-P0-005	MGN-011 Sales	customer-groups, sales-teams, orders, quotations, pricelists	5h	DOC
C2	GAP-P0-006	MGN-012 Purchases	purchases, rfqs	3h	DOC
C3	GAP-P0-007	MGN-013 Inventory	locations, warehouses, pickings, valuation, adjustments, products, lots, stock-quants, package-types	8h	DOC
C4	GAP-P0-008	MGN-014 HR	leaves, contracts, skills, departments, employees, payslips, expenses	6h	DOC
C5	GAP-P0-009	MGN-015 CRM	stages, leads, tags, opportunities	4h	DOC
C6	GAP-P0-010	MGN-016 Projects	timesheets, projects, tasks	3h	DOC
C7	GAP-P0-011	MGN-017 Partners	partners, ranking	2h	DOC
C8	GAP-P0-012	MGN-018 Companies	companies	1h	DOC

Estructura a crear por modulo:

docs/03-fase-vertical/MGN-0XX-{modulo}/
├── README.md
├── _MAP.md
├── requerimientos/
│   ├── RF-{MOD}-001.md
│   └── INDICE-RF-{MOD}.md
├── especificaciones/
│   ├── ET-{MOD}-backend.md
│   └── ET-{MOD}-frontend.md
├── historias-usuario/
│   └── BACKLOG-{MOD}.md
└── implementacion/
    └── TRACEABILITY.yml

Contenido minimo ET-*-backend.md:

estructura:
  - Metadatos (version, fecha, estado)
  - Servicios (lista completa con metodos)
  - Entidades TypeORM (campos, relaciones)
  - DTOs (CreateDto, UpdateDto, ResponseDto)
  - Controllers (endpoints REST)
  - Guards/Middlewares aplicables
  - Tests existentes
  - Dependencias entre modulos

---

2.2 SPRINT 2: ESTANDARIZACION (P1)

Duracion estimada: 2-3 dias Esfuerzo: 40-45 horas Perfiles: DOCUMENTATION-MAINTAINER, CODE-REVIEWER

BLOQUE D: Nomenclatura (12 horas)

Tarea	ID	Descripcion	Archivos	Esfuerzo	Perfil
D1	GAP-P1-001	Renombrar archivos FASE-X	30 archivos	2h	DOC-MAINT
D2	GAP-P1-002	Normalizar ET a UPPERCASE	8 archivos	0.5h	DOC-MAINT
D3	GAP-P1-003	Estandarizar DDL-SPEC	25 archivos	3h	DOC-MAINT
D4	GAP-P1-008	Numerar directorios	59 directorios	3h	DOC-MAINT
D5	GAP-P1-012	Prefijos archivos restantes	96 archivos	4h	DOC-MAINT

Mapeo de renombrado D1:

FASE-1-PLAN-COMPARACION-ODOO.md → PLAN-COMPARACION-ODOO-2025-12-XX.md
FASE-2-ANALISIS-DETALLADO-DOC-VS-DEV.md → ANALISIS-DOC-VS-DEV-2025-12-XX.md
FASE-3-PLAN-CORRECCIONES-ODOO.md → PLAN-CORRECCIONES-ODOO-2025-12-XX.md
FASE-4-VALIDACION-DEPENDENCIAS.md → VALIDACION-DEPENDENCIAS-2025-12-XX.md
FASE-5-REFINAMIENTO-PLAN.md → PLAN-REFINADO-FASE5-2025-12-XX.md
FASE-6-REPORTE-EJECUCION.md → REPORTE-EJECUCION-FASE6-2025-12-XX.md
...

Mapeo de renombrado D2:

ET-auth-backend.md → ET-AUTH-BACKEND.md
ET-rbac-backend.md → ET-RBAC-BACKEND.md
ET-tenants-backend.md → ET-TENANTS-BACKEND.md
ET-users-backend.md → ET-USERS-BACKEND.md
hr-domain.md → ET-BACKEND-HR.md

Patron DDL-SPEC D3:

DDL-SPEC-core_auth.md → ET-DATABASE-AUTH-DDL.md
DDL-SPEC-core_users.md → ET-DATABASE-USERS-DDL.md
DDL-SPEC-billing.md → ET-DATABASE-BILLING-DDL.md
...

Numeracion directorios D4:

orchestration/agentes/ → orchestration/06-agentes/
orchestration/analisis/ → orchestration/07-analisis-historico/
orchestration/directivas/ → orchestration/08-directivas/
orchestration/prompts/ → orchestration/09-prompts/
orchestration/sessions/ → orchestration/10-sessions/
orchestration/trazas/ → orchestration/11-trazas/
orchestration/environment/ → orchestration/12-environment/
orchestration/estados/ → orchestration/13-estados/
orchestration/propagacion/ → orchestration/14-propagacion/

BLOQUE E: Estructura (8 horas)

Tarea	ID	Descripcion	Esfuerzo	Perfil
E1	GAP-P1-004	Organizar 16 archivos huerfanos	1h	DOC-MAINT
E2	GAP-P1-009	Crear _MAP.md por fase	1h	DOC
E3	GAP-P0-001	Completar estructura modulos verticales	4h	DOC
E4	GAP-P1-011	Sincronizar conteos inventarios	2h	DOC

Reorganizacion E1:

docs/
├── 00-planning/  (NUEVO)
│   ├── PLAN-DOCUMENTACION-ERP-GENERICO.md
│   ├── PLAN-DESARROLLO-FRONTEND.md
│   ├── PLAN-EXPANSION-BACKEND.md
│   ├── PLAN-MAESTRO-MIGRACION-CONSOLIDACION.md
│   ├── SPRINT-PLAN-FASE-1.md
│   ├── LANZAR-FASE-0.md
│   ├── INSTRUCCIONES-AGENTE-ARQUITECTURA.md
│   └── FRONTEND-PRIORITY-MATRIX.md
│
├── 00-reports/  (NUEVO)
│   ├── CORRECCION-GAP-001-REPORTE.md
│   ├── CORRECCION-GAP-002-REPORTE.md
│   ├── REPORTE-ALINEACION-DDL-SPECS.md
│   ├── REPORTE-REVALIDACION-TECNICA-COMPLETA.md
│   └── RESUMEN-EJECUTIVO-REVALIDACION.md

BLOQUE F: Tests y Sincronizacion (20 horas)

Tarea	ID	Descripcion	Modulos	Esfuerzo	Perfil
F1	GAP-P1-006	Implementar tests faltantes	companies, reports, crm	12h	TESTING
F2	GAP-P1-007	Implementar tests faltantes	projects, notifications	8h	TESTING
F3	GAP-P1-010	Verificar DDL vs Entidades ORM	Todos	4h	DB-AUDITOR

---

2.3 SPRINT 3: MEJORAS (P2)

Duracion estimada: 1-2 dias Esfuerzo: 19-20 horas Perfiles: DOCUMENTATION, ARCHITECTURE-ANALYST

BLOQUE G: Mejoras Adicionales

Tarea	ID	Descripcion	Esfuerzo	Perfil
G1	GAP-P2-001	Documentar integraciones externas (Stripe, OAuth, etc.)	4h	DOC
G2	GAP-P2-002	Prefijo REF- para archivos referencia	0.5h	DOC-MAINT
G3	GAP-P2-003	Crear indices tematicos adicionales	2h	DOC
G4	GAP-P2-004	Crear script validacion cruzada inventarios	3h	DEVOPS
G5	GAP-P2-005	Documentar DTOs en ET existentes	6h	DOC
G6	GAP-P2-006	Crear mapa visual dependencias	2h	ARCH-ANALYST
G7	GAP-P2-007	Estandarizar campo updated_by en inventarios	1h	DOC-MAINT
G8	GAP-P2-008	Crear CONVENCIONES.md de nomenclatura	1h	DOC

---

3. CRONOGRAMA DE EJECUCION

SPRINT 1 (P0): Correcciones Criticas
├── Dia 1: Bloques A (Inventarios)
├── Dia 2: Bloque B (ET existentes)
├── Dia 3: Bloque C1-C4 (ET verticales)
└── Dia 4: Bloque C5-C8 (ET verticales)

SPRINT 2 (P1): Estandarizacion
├── Dia 5: Bloque D (Nomenclatura)
├── Dia 6: Bloque E (Estructura)
└── Dia 7: Bloque F (Tests/Sync)

SPRINT 3 (P2): Mejoras
├── Dia 8: Bloque G1-G4
└── Dia 9: Bloque G5-G8

---

4. ASIGNACION DE PERFILES

4.1 Matriz de Responsabilidad

Perfil	Bloques Asignados	Tareas	Horas
PERFIL-DOCUMENTATION	A2-A5, B1-B2, C1-C8, E2-E4, G1, G3, G5	18	70h
PERFIL-DOCUMENTATION-MAINTAINER	A1, D1-D5, E1, G2, G7, G8	9	18h
PERFIL-TESTING	F1-F2	2	20h
PERFIL-DATABASE-AUDITOR	F3	1	4h
PERFIL-DEVOPS	G4	1	3h
PERFIL-ARCHITECTURE-ANALYST	G6	1	2h

4.2 Delegacion de Tareas

delegacion_paralela:
  batch_1:  # Dia 1
    - perfil: DOCUMENTATION-MAINTAINER
      tarea: A1 (MASTER_INVENTORY.yml)
    - perfil: DOCUMENTATION
      tarea: A4 (DEPENDENCY_GRAPH.yml)

  batch_2:  # Dia 2
    - perfil: DOCUMENTATION
      tarea: B1 (ET-auth-backend.md)
    - perfil: DOCUMENTATION
      tarea: B2 (ET-FIN-backend.md)

  batch_3:  # Dia 3-4
    - perfil: DOCUMENTATION
      tareas: [C1, C2, C3, C4]
    - perfil: DOCUMENTATION
      tareas: [C5, C6, C7, C8]

---

5. CHECKLISTS DE VALIDACION

5.1 Checklist Sprint 1

## Bloque A - Inventarios
- [ ] A1: MASTER_INVENTORY.yml sin errores YAML
- [ ] A2: BACKEND_INVENTORY.yml tiene MGN-005 a MGN-010
- [ ] A3: FRONTEND_INVENTORY.yml tiene MGN-005 a MGN-009
- [ ] A4: DEPENDENCY_GRAPH.yml actualizado a 2026-01-10
- [ ] A5: TRACEABILITY_MATRIX.yml con test_coverage correcto

## Bloque B - ET Existentes
- [ ] B1: ET-auth-backend.md tiene 6 servicios nuevos
- [ ] B1: ET-auth-backend.md NO tiene password.service, blacklist.service
- [ ] B2: ET-FIN-backend.md tiene 8 servicios nuevos

## Bloque C - ET Verticales
- [ ] C1: MGN-011 Sales tiene ET completa
- [ ] C2: MGN-012 Purchases tiene ET completa
- [ ] C3: MGN-013 Inventory tiene ET completa
- [ ] C4: MGN-014 HR tiene ET completa
- [ ] C5: MGN-015 CRM tiene ET completa
- [ ] C6: MGN-016 Projects tiene ET completa
- [ ] C7: MGN-017 Partners tiene ET completa
- [ ] C8: MGN-018 Companies tiene ET completa

5.2 Checklist Sprint 2

## Bloque D - Nomenclatura
- [ ] D1: 0 archivos con prefijo FASE-X
- [ ] D2: Todos los ET en UPPERCASE
- [ ] D3: DDL-SPEC estandarizado a ET-DATABASE-*
- [ ] D4: Todos directorios con prefijo numerico
- [ ] D5: 0 archivos MD sin prefijo valido

## Bloque E - Estructura
- [ ] E1: 0 archivos huerfanos en raiz docs/
- [ ] E2: _MAP.md existe en 01-fase-foundation/, 02-fase-core-business/, 03-fase-vertical/
- [ ] E3: Todos modulos verticales con estructura completa
- [ ] E4: Conteos consistentes entre inventarios

## Bloque F - Tests/Sync
- [ ] F1: companies, reports, crm tienen tests
- [ ] F2: projects, notifications tienen tests
- [ ] F3: Reporte DDL vs ORM sin discrepancias criticas

5.3 Checklist Sprint 3

## Bloque G - Mejoras
- [ ] G1: Documentacion integraciones: Stripe, OAuth, Email, WebSocket
- [ ] G2: Archivos referencia con prefijo REF-
- [ ] G3: Indices tematicos creados
- [ ] G4: Script validate-inventories.sh funcional
- [ ] G5: DTOs documentados en ET principales
- [ ] G6: Mapa visual de dependencias creado
- [ ] G7: Campo updated_by consistente
- [ ] G8: CONVENCIONES.md creado

---

6. RIESGOS Y MITIGACIONES

Riesgo	Probabilidad	Impacto	Mitigacion
Archivos con referencias cruzadas	Media	Alto	Validar dependencias antes de renombrar
Codigo depende de rutas de docs	Baja	Alto	Verificar imports/referencias en codigo
Inventarios con datos incorrectos	Media	Medio	Validar contra codigo fuente
Estructura inconsistente post-cambio	Media	Medio	Ejecutar validacion post-ejecucion

---

7. CRITERIOS DE EXITO

7.1 Metricas de Completitud

Metrica	Actual	Meta Sprint 1	Meta Final
Modulos con ET	10/18	18/18	18/18
Inventarios validos	5/6	6/6	6/6
Nomenclatura conforme	77%	85%	95%
Sync Codigo-Docs	40%	70%	90%

7.2 Criterios de Aceptacion

1. Sprint 1: Todos los gaps P0 resueltos
2. Sprint 2: Nomenclatura y estructura estandarizadas
3. Sprint 3: Mejoras adicionales implementadas
4. General: Validacion automatizada pasa sin errores

---

8. ENTREGABLES

8.1 Por Sprint

Sprint	Entregables
Sprint 1	6 inventarios actualizados, 10 ET actualizadas/creadas
Sprint 2	~195 archivos renombrados, estructura reorganizada
Sprint 3	4 documentos nuevos, 1 script validacion

8.2 Documentos Finales

orchestration/analisis/
├── F1-ANALISIS-INICIAL-DOCUMENTACION-2026-01-10.md
├── F2-ANALISIS-DETALLADO-DOCUMENTACION-2026-01-10.md
├── F3-PLAN-ESTANDARIZACION-DOCUMENTACION-2026-01-10.md
├── F4-VALIDACION-PLAN-2026-01-10.md (proximo)
├── F5-DEPENDENCIAS-DOCUMENTACION-2026-01-10.md (proximo)
├── F6-PLAN-REFINADO-2026-01-10.md (proximo)
├── F7-REPORTE-EJECUCION-2026-01-10.md (proximo)
└── F8-VALIDACION-FINAL-2026-01-10.md (proximo)

---

9. PROXIMOS PASOS

1. FASE 4: Validar este plan contra el analisis detallado
2. FASE 5: Analizar dependencias entre archivos a modificar
3. FASE 6: Refinar plan basado en dependencias
4. FASE 7: Ejecutar plan
5. FASE 8: Validar ejecucion

---

10. APROBACION

Rol	Estado	Fecha
Orquestador	COMPLETADO	2026-01-10
Usuario	PENDIENTE	-

---

Plan generado siguiendo CAPVED + SIMCO v3.8 Esfuerzo total estimado: 121-135 horas Proximo paso: FASE 4 - Validacion de Planeacion