docs: Add SIMCO documentation for ERP Transportistas

- Created TASK-2026-01-25-DOCUMENTACION-MODULOS task
- Created DATABASE_INVENTORY.yml (8 schemas, ~98 tables)
- Created BACKEND_INVENTORY.yml (153 entities, 23 modules)
- Created PROXIMA-ACCION.md with current status
- Documented 11 new entities (combustible-gastos, tarifas-transporte)
- Documented 5 new controllers

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Adrian Flores Cortes 2026-01-25 14:49:10 -06:00
parent 652e365c66
commit e020576fcc
4 changed files with 592 additions and 0 deletions

View File

@ -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*

View File

@ -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"

View File

@ -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"

View File

@ -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)