diff --git a/orchestration/PROXIMA-ACCION.md b/orchestration/PROXIMA-ACCION.md new file mode 100644 index 0000000..886754c --- /dev/null +++ b/orchestration/PROXIMA-ACCION.md @@ -0,0 +1,149 @@ +# PROXIMA-ACCION.md - ERP Transportistas + +**Ultima Actualizacion:** 2026-01-25 +**Sistema:** SIMCO v4.0.0 +**Estado del Proyecto:** 45% completado | DDL 100% | Backend 40% + +--- + +## Estado Actual (2026-01-25) + +### Progreso General + +| Capa | Progreso | Notas | +|------|----------|-------| +| DDL | 100% | 8 schemas especializados transporte | +| Backend | 40% | 153 entities (95 heredadas + 11 nuevas especializadas) | +| Frontend | 0% | Pendiente | +| Documentacion | 30% | Requerimientos definidos, falta especificaciones modulos | + +### Entidades Nuevas Creadas (2026-01-25) + +**Modulo: combustible-gastos (MAI-012)** +- `carga-combustible.entity.ts` - Cargas de combustible +- `cruce-peaje.entity.ts` - Cruces de peaje +- `gasto-viaje.entity.ts` - Gastos de viaje +- `anticipo-viatico.entity.ts` - Anticipos viaticos +- `control-rendimiento.entity.ts` - Control de rendimiento + +**Modulo: tarifas-transporte (MAI-009)** +- `lane.entity.ts` - Lanes/rutas de transporte +- `tarifa.entity.ts` - Tarifas por lane +- `recargo-catalogo.entity.ts` - Catalogo de recargos +- `factura-transporte.entity.ts` - Facturas de transporte +- `linea-factura.entity.ts` - Lineas de factura +- `fuel-surcharge.entity.ts` - Recargo por combustible + +### Controladores Nuevos Creados (2026-01-25) + +- `operadores.controller.ts` (gestion-flota) +- `unidades.controller.ts` (gestion-flota) +- `ordenes-transporte.controller.ts` (ordenes-transporte) +- `tracking.controller.ts` (tracking) +- `viajes.controller.ts` (viajes) + +--- + +## Tareas Completadas + +### TASK-2026-01-25-001-CREAR-PROYECTO +- Estructura de carpetas creada +- CLAUDE.md con especificaciones del giro +- Documentacion de requerimientos (REQ-GIRO-TRANSPORTISTA.md) +- Registro en SUBMODULES-INVENTORY.yml +- **Commit:** 2026-01-25 + +### TASK-2026-01-25-DOCUMENTACION-MODULOS (En Progreso) +- DATABASE_INVENTORY.yml creado +- BACKEND_INVENTORY.yml creado +- PROXIMA-ACCION.md actualizado + +--- + +## Proximas Acciones + +### P0 - Inmediato + +1. **Completar servicios para entidades nuevas** + - combustible-gastos: crear services y DTOs + - tarifas-transporte: crear services y DTOs + - Estimacion: 4-6 horas + +2. **Crear especificaciones de modulos prioritarios** + - MAI-003: Ordenes de Transporte + - MAI-006: Tracking + - MAI-009: Facturacion Transporte + - MAI-011: Gestion de Flota + - MAE-016: Carta Porte CFDI + +### P1 - Corto Plazo + +3. **Implementar modulo Carta Porte CFDI 3.1** + - Entidades para complemento fiscal + - Integracion con PAC + - Generacion XML/PDF + +4. **Implementar frontend base** + - Dashboard transportista + - Gestion de flota + - Tracking de viajes + +### P2 - Mediano Plazo + +5. **Integracion con GPS/Telematica** +6. **Portal de clientes** +7. **App movil para operadores** + +--- + +## Modulos del Sistema + +### Fase 1 - MAI (Inicial) + +| Codigo | Nombre | DDL | Backend | Frontend | +|--------|--------|:---:|:-------:|:--------:| +| MAI-001 | Fundamentos | - | 100% | - | +| MAI-002 | Clientes y Tarifas | - | 0% | - | +| MAI-003 | Ordenes de Transporte | 100% | 40% | 0% | +| MAI-004 | Planeacion TMS | 100% | 0% | 0% | +| MAI-005 | Despacho | 100% | 0% | 0% | +| MAI-006 | Tracking | 100% | 20% | 0% | +| MAI-007 | POD y Cierre | 100% | 0% | 0% | +| MAI-008 | Incidencias | 100% | 0% | 0% | +| MAI-009 | Facturacion Transporte | 100% | 30% | 0% | +| MAI-010 | Liquidaciones | 100% | 0% | 0% | +| MAI-011 | Gestion de Flota | 100% | 40% | 0% | +| MAI-012 | Combustible y Gastos | 100% | 50% | 0% | +| MAI-013 | Mantenimiento Flota | 100% | 0% | 0% | +| MAI-014 | Carriers (Terceros) | 100% | 0% | 0% | +| MAI-015 | Portal Cliente | 100% | 0% | 0% | + +### Fase 2 - MAE (Extendido) + +| Codigo | Nombre | DDL | Backend | Frontend | +|--------|--------|:---:|:-------:|:--------:| +| MAE-016 | Carta Porte CFDI | 100% | 0% | 0% | +| MAE-017 | HOS y Bitacora | 100% | 0% | 0% | +| MAE-018 | Reportes y KPIs | 100% | 0% | 0% | + +### Fase 3 - MAA (Avanzado) + +| Codigo | Nombre | DDL | Backend | Frontend | +|--------|--------|:---:|:-------:|:--------:| +| MAA-019 | Optimizacion Rutas | - | 0% | 0% | +| MAA-020 | Integraciones EDI | - | 0% | 0% | + +--- + +## Referencias + +| Recurso | Ubicacion | +|---------|-----------| +| Inventario BD | `orchestration/inventarios/DATABASE_INVENTORY.yml` | +| Inventario Backend | `orchestration/inventarios/BACKEND_INVENTORY.yml` | +| Requerimientos | `docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md` | +| CLAUDE.md | `CLAUDE.md` | + +--- + +*Sistema SIMCO v4.0.0 - ERP Transportistas* diff --git a/orchestration/inventarios/BACKEND_INVENTORY.yml b/orchestration/inventarios/BACKEND_INVENTORY.yml new file mode 100644 index 0000000..f3e00e9 --- /dev/null +++ b/orchestration/inventarios/BACKEND_INVENTORY.yml @@ -0,0 +1,226 @@ +# BACKEND_INVENTORY.yml - ERP Transportistas +# Sistema SIMCO v4.0.0 +# Generado: 2026-01-25 + +version: "1.0.0" +created: "2026-01-25" +updated: "2026-01-25" + +# Resumen +summary: + framework: NestJS + language: TypeScript + total_modules: 23 + total_entities: 153 + hereda_de: erp-core + status: "40% implementado" + +# Modulos del Backend +modules: + # Heredados de erp-core + heredados: + - name: auth + entities: 20 + status: heredado + descripcion: "Autenticacion, JWT, OAuth, 2FA" + + - name: users + entities: 3 + status: heredado + descripcion: "Gestion de usuarios" + + - name: tenants + entities: 2 + status: heredado + descripcion: "Multi-tenancy" + + - name: companies + entities: 1 + status: heredado + descripcion: "Empresas transportistas" + + - name: ai + entities: 7 + status: heredado + descripcion: "Integracion IA/LLM" + + - name: audit + entities: 7 + status: heredado + descripcion: "Auditoria y logs" + + - name: notifications + entities: 6 + status: heredado + descripcion: "Notificaciones multicanal" + + - name: billing-usage + entities: 5 + status: heredado + descripcion: "Facturacion SaaS" + + - name: branches + entities: 5 + status: heredado + descripcion: "Sucursales" + + - name: financial + entities: 15 + status: heredado + descripcion: "Contabilidad base" + + - name: inventory + entities: 14 + status: heredado + descripcion: "Inventario base" + + - name: partners + entities: 5 + status: heredado + descripcion: "Clientes/Proveedores" + + - name: payment-terminals + entities: 3 + status: heredado + descripcion: "Terminales de pago" + + - name: mcp + entities: 2 + status: heredado + descripcion: "MCP Server" + + # Especializados de Transporte (NUEVOS) + especializados: + - name: ordenes-transporte + entities: 4 + status: en_progreso + descripcion: "Ordenes de transporte y embarques" + modulo_simco: MAI-003 + entidades: + - quotation.entity.ts + - quotation-item.entity.ts + - sales-order.entity.ts + - sales-order-item.entity.ts + controllers: 1 + notas: "Pendiente completar servicios" + + - name: gestion-flota + entities: 7 + status: en_progreso + descripcion: "Unidades, operadores, productos" + modulo_simco: MAI-011 + entidades: + - product.entity.ts + - product-category.entity.ts + - product-variant.entity.ts + - product-attribute.entity.ts + - product-attribute-value.entity.ts + - product-price.entity.ts + - product-supplier.entity.ts + controllers: 2 + notas: "Controladores operadores y unidades creados" + + - name: tracking + entities: 0 + status: en_progreso + descripcion: "GPS, eventos, alertas" + modulo_simco: MAI-006 + controllers: 1 + notas: "Controlador basico creado, faltan entidades" + + - name: viajes + entities: 1 + status: en_progreso + descripcion: "Viajes y timesheets" + modulo_simco: MAI-003 + entidades: + - timesheet.entity.ts + controllers: 1 + notas: "Controlador creado" + + - name: combustible-gastos + entities: 5 + status: nuevo + descripcion: "Control de combustible, peajes, gastos" + modulo_simco: MAI-012 + entidades: + - carga-combustible.entity.ts + - cruce-peaje.entity.ts + - gasto-viaje.entity.ts + - anticipo-viatico.entity.ts + - control-rendimiento.entity.ts + controllers: 0 + notas: "Entidades creadas, faltan controladores y servicios" + + - name: tarifas-transporte + entities: 6 + status: nuevo + descripcion: "Tarifas por lane, facturacion, recargos" + modulo_simco: MAI-009 + entidades: + - lane.entity.ts + - tarifa.entity.ts + - recargo-catalogo.entity.ts + - factura-transporte.entity.ts + - linea-factura.entity.ts + - fuel-surcharge.entity.ts + controllers: 0 + notas: "Entidades creadas, faltan controladores y servicios" + + - name: carta-porte + entities: 0 + status: pendiente + descripcion: "Complemento Carta Porte CFDI 3.1" + modulo_simco: MAE-016 + notas: "Pendiente implementacion" + + - name: fiscal + entities: 0 + status: pendiente + descripcion: "Integracion fiscal Mexico" + notas: "Pendiente implementacion" + + - name: core + entities: 0 + status: base + descripcion: "Modulo core compartido" + +# Totales +totales: + entities: 153 + controllers: 5 + services: TBD + dtos: TBD + +# Entidades Nuevas (2026-01-25) +entidades_nuevas_2026_01_25: + combustible_gastos: + - carga-combustible.entity.ts + - cruce-peaje.entity.ts + - gasto-viaje.entity.ts + - anticipo-viatico.entity.ts + - control-rendimiento.entity.ts + tarifas_transporte: + - lane.entity.ts + - tarifa.entity.ts + - recargo-catalogo.entity.ts + - factura-transporte.entity.ts + - linea-factura.entity.ts + - fuel-surcharge.entity.ts + total: 11 + +# Controladores Nuevos (2026-01-25) +controladores_nuevos_2026_01_25: + - operadores.controller.ts (gestion-flota) + - unidades.controller.ts (gestion-flota) + - ordenes-transporte.controller.ts (ordenes-transporte) + - tracking.controller.ts (tracking) + - viajes.controller.ts (viajes) + total: 5 + +# Notas +notas: + - "Backend hereda 95+ entities de erp-core" + - "11 entidades especializadas creadas para transporte" + - "5 controladores nuevos agregados 2026-01-25" + - "Pendiente: servicios, DTOs, tests" diff --git a/orchestration/inventarios/DATABASE_INVENTORY.yml b/orchestration/inventarios/DATABASE_INVENTORY.yml new file mode 100644 index 0000000..ca400dc --- /dev/null +++ b/orchestration/inventarios/DATABASE_INVENTORY.yml @@ -0,0 +1,128 @@ +# DATABASE_INVENTORY.yml - ERP Transportistas +# Sistema SIMCO v4.0.0 +# Generado: 2026-01-25 + +version: "1.0.0" +created: "2026-01-25" +updated: "2026-01-25" + +# Resumen +summary: + database_name: erp_transportistas_db + total_schemas: 8 + total_ddl_files: 9 + hereda_de: erp-core + +# Schemas Especializados de Transporte +schemas: + - name: transport + ddl_file: 01-transport-schema-ddl.sql + descripcion: "Ordenes de transporte, embarques, viajes, rutas" + tablas_estimadas: 25 + enums_estimados: 10 + modulos_relacionados: + - MAI-003 (Ordenes de Transporte) + - MAI-004 (Planeacion TMS) + - MAI-005 (Despacho) + + - name: fleet + ddl_file: 02-fleet-schema-ddl.sql + descripcion: "Unidades tractoras, remolques, operadores, documentacion" + tablas_estimadas: 15 + enums_estimados: 8 + modulos_relacionados: + - MAI-011 (Gestion de Flota) + + - name: tracking + ddl_file: 03-tracking-schema-ddl.sql + descripcion: "GPS, eventos, alertas, ETA dinamico" + tablas_estimadas: 10 + enums_estimados: 5 + modulos_relacionados: + - MAI-006 (Tracking) + - MAI-007 (POD y Cierre) + + - name: fuel + ddl_file: 04-fuel-schema-ddl.sql + descripcion: "Vales combustible, peajes, gastos de viaje, control antifraude" + tablas_estimadas: 8 + enums_estimados: 4 + modulos_relacionados: + - MAI-012 (Combustible y Gastos) + + - name: maintenance + ddl_file: 05-maintenance-schema-ddl.sql + descripcion: "Mantenimiento preventivo/correctivo, ordenes de trabajo" + tablas_estimadas: 12 + enums_estimados: 6 + modulos_relacionados: + - MAI-013 (Mantenimiento Flota) + + - name: carriers + ddl_file: 06-carriers-schema-ddl.sql + descripcion: "Subcontratacion terceros, documentos, scorecard" + tablas_estimadas: 8 + enums_estimados: 4 + modulos_relacionados: + - MAI-014 (Carriers Terceros) + + - name: billing + ddl_file: 07-billing-transport-ddl.sql + descripcion: "Tarifas por lane, facturacion, recargos fuel surcharge" + tablas_estimadas: 10 + enums_estimados: 5 + modulos_relacionados: + - MAI-009 (Facturacion Transporte) + - MAI-010 (Liquidaciones) + + - name: compliance + ddl_file: 08-compliance-schema-ddl.sql + descripcion: "Carta Porte CFDI 3.1, HOS, inspecciones" + tablas_estimadas: 10 + enums_estimados: 5 + modulos_relacionados: + - MAE-016 (Carta Porte CFDI) + - MAE-017 (HOS y Bitacora) + +# Totales Estimados +totales: + tablas: ~98 + enums: ~47 + funciones: TBD + triggers: TBD + rls_policies: TBD + +# DDL Files +ddl_files: + - file: 00-schemas-init.sql + descripcion: "Inicializacion de schemas y extensiones" + - file: 01-transport-schema-ddl.sql + schema: transport + - file: 02-fleet-schema-ddl.sql + schema: fleet + - file: 03-tracking-schema-ddl.sql + schema: tracking + - file: 04-fuel-schema-ddl.sql + schema: fuel + - file: 05-maintenance-schema-ddl.sql + schema: maintenance + - file: 06-carriers-schema-ddl.sql + schema: carriers + - file: 07-billing-transport-ddl.sql + schema: billing + - file: 08-compliance-schema-ddl.sql + schema: compliance + +# Credenciales +credenciales: + database: erp_transportistas_db + user: erp_admin + password: erp_dev_2026 + port: 5432 + host: localhost + +# Notas +notas: + - "DDL 100% completado segun PROJECT-STATUS.md" + - "Backend al 40% - entidades heredadas de erp-core + especializadas" + - "Requiere creacion de BD en WSL para deploy" diff --git a/orchestration/tareas/TASK-2026-01-25-DOCUMENTACION-MODULOS/METADATA.yml b/orchestration/tareas/TASK-2026-01-25-DOCUMENTACION-MODULOS/METADATA.yml new file mode 100644 index 0000000..a56a7d5 --- /dev/null +++ b/orchestration/tareas/TASK-2026-01-25-DOCUMENTACION-MODULOS/METADATA.yml @@ -0,0 +1,89 @@ +# METADATA.yml - TASK-2026-01-25-DOCUMENTACION-MODULOS +# Sistema SIMCO v4.0.0 + +task_id: TASK-2026-01-25-DOCUMENTACION-MODULOS +title: "Documentacion de Modulos y Entidades de ERP Transportistas" +type: documentation +priority: P0 +status: in_progress + +# Fechas +created: 2026-01-25 +started: 2026-01-25 + +# Asignacion +owner: claude-code +project: erp-transportistas + +# Contexto +descripcion: | + Crear documentacion SIMCO completa para ERP Transportistas: + - Inventarios actualizados (DATABASE, BACKEND, FRONTEND) + - Documentacion de 11 entidades nuevas (combustible-gastos, tarifas-transporte) + - Especificaciones de modulos prioritarios (MAI-003, MAI-006, MAI-009, MAI-011, MAE-016) + - Actualizacion de PROXIMA-ACCION.md + +# Alcance +scope: + entidades_nuevas: 11 + modulos_prioritarios: 5 + inventarios_a_crear: 3 + + entidades_combustible_gastos: + - carga-combustible.entity.ts + - cruce-peaje.entity.ts + - gasto-viaje.entity.ts + - anticipo-viatico.entity.ts + - control-rendimiento.entity.ts + + entidades_tarifas_transporte: + - lane.entity.ts + - tarifa.entity.ts + - recargo-catalogo.entity.ts + - factura-transporte.entity.ts + - linea-factura.entity.ts + - fuel-surcharge.entity.ts + + modulos_prioritarios: + - MAI-003: Ordenes de Transporte + - MAI-006: Tracking + - MAI-009: Facturacion Transporte + - MAI-011: Gestion de Flota + - MAE-016: Carta Porte CFDI + +# Fases +phases: + - id: FASE-1 + title: "Crear inventarios base" + status: pending + entregables: + - orchestration/inventarios/DATABASE_INVENTORY.yml + - orchestration/inventarios/BACKEND_INVENTORY.yml + - orchestration/inventarios/MASTER_INVENTORY.yml + + - id: FASE-2 + title: "Documentar entidades nuevas" + status: pending + entregables: + - docs/02-definicion-modulos/MAI-012-combustible-gastos/ENTITIES.md + - docs/02-definicion-modulos/MAI-009-facturacion-transporte/ENTITIES.md + + - id: FASE-3 + title: "Actualizar PROXIMA-ACCION.md" + status: pending + entregables: + - orchestration/PROXIMA-ACCION.md + +# Metodologia +methodology: CAPVED +validation_checklist: + - "Inventarios creados con estructura SIMCO" + - "Entidades documentadas con campos y relaciones" + - "PROXIMA-ACCION.md actualizado con estado real" + +# Trazabilidad +traceability: + previous_task: TASK-2026-01-25-001-CREAR-PROYECTO + related_modules: + - MAI-009 (Facturacion Transporte) + - MAI-012 (Combustible y Gastos)