rckrdmrd/erp-transportistas-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
26 Commits 1 Branch 0 Tags 813 KiB
e2e67d6030
Commit Graph

26 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
Adrian Flores Cortes
e2e67d6030 chore: Update backend submodule (TASK-005 TypeScript fixes) 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 10:12:23 -06:00
Adrian Flores Cortes
fef271bd34 fix: Update backend submodule (TypeScript error fixes) 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 09:14:25 -06:00
Adrian Flores Cortes
076e844a21 chore: Update backend submodule (entities propagation) 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 09:07:24 -06:00
Adrian Flores Cortes
13b637bea4 docs: Phase 6 validation - Update status files 
- PROJECT-STATUS.md: Updated with real progress metrics
  - Documentation: 100% (18 modules, 54 US, 325 SP)
  - DDL: 100% (8 schemas)
  - Backend: 15% (entities copied, pending adaptation)
  - Added documentation structure tree
  - Added metrics section

- PROXIMA-ACCION.md: Updated next steps
  - Marked Phase 2-6 as complete
  - Next priority: Backend implementation
  - Clear action items for P0/P1/P2/P3

Documentation plan complete. Ready for backend implementation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 02:39:56 -06:00
Adrian Flores Cortes
a3991cd4ea docs: Add Phase 5 traceability matrices 
4 traceability matrices created in orchestration/matrices/:

1. MATRIZ-RF-GENERICOS-GIRO.yml
   - Maps erp-core generic RFs to transport-specific RFs
   - 8 fully inherited, 8 extended, 62 new
   - Total 78 RFs for the transport vertical

2. MATRIZ-RF-GIRO-MODULOS.yml
   - Maps 78 RFs to 20 modules (MAI/MAE/MAA)
   - Dependencies between modules
   - Priority breakdown (P0-P4)

3. MATRIZ-MODULOS-US.yml
   - Maps modules to 54 user stories
   - 325 story points total
   - Sprint velocity estimation (13-17 sprints)

4. MATRIZ-DDL-RF.yml
   - Bidirectional mapping DDL tables to RFs
   - 8 schemas, 58 tables documented
   - 100% RF coverage

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 02:37:51 -06:00
Adrian Flores Cortes
457ff6b620 docs: Add Phase 4 architecture and standards 
- FLUJO-PRINCIPAL-TRANSPORTE.md: End-to-end transport workflow
  - 8 phases from OT capture to collection
  - State machine diagram
  - Actors and integrations per phase

- INTEGRACIONES-EXTERNAS.md: External integrations spec
  - GPS/Telematics (Geotab, CalAmp, Samsara, etc.)
  - PAC CFDI (Finkok, Facturama) with Carta Porte 3.1
  - Geocoding/Routing (Google, HERE, Mapbox)
  - WhatsApp/SMS notifications
  - TAG/IAVE toll integration
  - Banking (SPEI/CIE)

- MATRIZ-RBAC-TRANSPORTISTAS.yml: 16 roles with permissions
  - Permissions per module (MAI-001 to MAE-018)
  - Data restrictions per role
  - Critical actions requiring authorization

- ESPECIFICACION-KPIS.yml: 17 KPIs defined
  - Formulas, source tables, thresholds
  - Operational, fleet, financial, fuel, quality, compliance
  - Materialized views and calculation jobs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 02:31:39 -06:00
Adrian Flores Cortes
ec43d9c6cd docs: Add Phase 3 secondary modules specifications (P1/P2/P3) 
Modules documented:
- MAI-003 (OT): README, REQUERIMIENTOS, RESUMEN-EPICA, 10 US
- MAI-006 (Tracking): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-008 (Incidencias): 3 US (18 SP)
- MAI-011 (Flota): README, REQUERIMIENTOS, RESUMEN-EPICA
- MAI-012 (Combustible): 3 US (18 SP)
- MAI-013 (Mantenimiento): 3 US (18 SP)
- MAI-014 (Carriers): 3 US (18 SP)
- MAI-015 (Portal): 3 US (18 SP)
- MAE-016 (Carta Porte): 10 US
- MAE-017 (HOS): 3 US (16 SP)
- MAE-018 (Reportes): 3 US (18 SP)

Phase 2+3 complete: 13 modules, 50+ User Stories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 02:24:35 -06:00
Adrian Flores Cortes
569eaeb5a4 docs: Add MAI-009 (Facturación) and MAI-010 (Liquidaciones) specifications 
MAI-009 Facturación Transporte (31 SP):
- README, REQUERIMIENTOS (7 RF), RESUMEN-EPICA
- 5 User Stories: generación factura, recargos, CFDI/Carta Porte,
  conciliación/pagos, estados de cuenta

MAI-010 Liquidaciones (31 SP):
- README, REQUERIMIENTOS (6 RF), RESUMEN-EPICA
- 5 User Stories: esquemas pago, cálculo por viaje, viáticos,
  deducciones, generar/autorizar liquidación

Part of Phase 2 - P0 Critical Modules specification

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 02:05:03 -06:00
Adrian Flores Cortes
9caeae936a docs: Add MAI-002, MAI-004, MAI-005 module specifications 
MAI-002 (Tarifas y SLA):
- README, REQUERIMIENTOS, RESUMEN-EPICA
- 5 User Stories (31 SP total)
- Covers: tarifario por lane, recargos, SLA, cotizaciones, aprobaciones

MAI-004 (Planeacion TMS):
- README, REQUERIMIENTOS, RESUMEN-EPICA
- 5 User Stories (39 SP total)
- Covers: tablero planeacion, consolidacion, asignacion, validaciones, ETA

MAI-005 (Despacho):
- README, REQUERIMIENTOS, RESUMEN-EPICA
- 5 User Stories (28 SP total)
- Covers: checklist NOM-068, sellos, evidencias, kit documental, gate out

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 01:51:58 -06:00
Adrian Flores Cortes
7f45eb6383 docs(modulos): MAI-007 POD y Cierre - Especificacion completa 
Nuevo modulo P0 critico especificado:
- README.md: Vision general, alcance, actores, flujo
- REQUERIMIENTOS.md: 4 RF (4.7.1-4.7.4), RNF, validaciones
- RESUMEN-EPICA.md: Valor de negocio, criterios exito, 31 SP

User Stories (5):
- US-MAI007-001: Capturar firma digital (8 SP)
- US-MAI007-002: Registrar tiempos reales (5 SP)
- US-MAI007-003: Adjuntar fotos evidencia (5 SP)
- US-MAI007-004: Validar POD antes de cierre (8 SP)
- US-MAI007-005: Cerrar con excepcion (5 SP)

Este modulo es bloqueante para:
- MAI-009 (Facturacion)
- MAI-010 (Liquidaciones)
- MAE-016 (Carta Porte)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 01:33:03 -06:00
Adrian Flores Cortes
1845cfcaec docs(analisis): Fase 1 - Matrices de coherencia y mapeo RF 
Nuevos archivos de analisis:
- MATRIZ-COHERENCIA-DDL-BACKEND.yml: Coherencia 28% global
  - transport: 0% (6 tablas, 0 entities)
  - fleet: 0% (5 tablas, 0 entities)
  - fuel: 100% (5 tablas, 5 entities)
  - billing: 100% (6 tablas, 6 entities)

- MAPEO-RF-GIRO-A-MODULOS.yml: 68 RF mapeados
  - 35% con documentacion
  - P0 urgente: MAI-007, MAI-004, MAI-005, MAI-002

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 01:28:16 -06:00
Adrian Flores Cortes
4bbace6345 docs(auditoria): Fase 0 - Purga y correccion de documentacion 
CORRECCION CRITICA:
- Porcentaje backend corregido de 40% a 15%
- Entities: 153 total (109 heredadas + 44 propias)
- Entities especializadas disenadas sin implementar: ~58

Cambios:
- BACKEND_INVENTORY.yml: Reescrito con estado real
- ENTITIES-CATALOG.md: Separacion IMPLEMENTADAS vs DISENADAS
- PROXIMA-ACCION.md: Porcentajes corregidos, gaps identificados
- MAPA-DOCUMENTACION.yml: Estructura actualizada
- MASTER_INVENTORY.yml: Nuevo inventario consolidado

Carpetas vacias eliminadas:
- docs/01-analisis-referencias/
- docs/10-modelado/
- docs/20-user-stories/
- docs/30-integraciones/
- docs/90-transversal/
- docs/97-adr/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-27 01:22:27 -06:00
Adrian Flores Cortes
3a3eb4089c docs: Propagar templates de documentacion desde erp-core 
Estructura _definitions/:
- _INDEX.yml: Indice de catalogos
- MODULES-CATALOG.md: 42 modulos (22 heredados + 20 propios)
- ENTITIES-CATALOG.md: ~153 entities por schema
- SERVICES-CATALOG.md: ~80 services documentados
- DATABASE-SCHEMA.md: 8 schemas con DDL detallado

Estructura _quick/:
- QUICK-INDEX.yml: Navegacion rapida
- QUICK-MODULES.yml: Estado de modulos
- QUICK-DATABASE.yml: Resumen de BD
- QUICK-API.yml: Endpoints principales

Orchestration:
- HERENCIA-ERP-CORE.md: Documentacion de herencia
- directivas/README.md: Directivas locales
- trazas/README.md: Sistema de trazas

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-26 23:07:50 -06:00
Adrian Flores Cortes
e3b5ce146e chore: Update frontend submodule with React components 
- Viajes, Flota, Tracking, Ordenes de Transporte modules
- Types, API services, and components for all modules

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-26 02:13:10 -06:00
Adrian Flores Cortes
d1f6a176f0 docs: Complete SIMCO documentation for MAI-009 and MAI-012 modules 
- Add ENTITIES.md for MAI-012 (Combustible y Gastos) with 5 entities
- Add ENTITIES.md for MAI-009 (Facturacion Transporte) with 6 entities
- Update TASK-2026-01-25-DOCUMENTACION-MODULOS status to completed
- Document all fields, indices, ENUMs and helper methods

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 14:55:18 -06:00
Adrian Flores Cortes
e020576fcc 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>
 2026-01-25 14:49:10 -06:00
Adrian Flores Cortes
652e365c66 chore: Update backend submodule with entity fixes 
- TypeScript compatibility fixes for transport entities
- Added missing fields and enum values
- Added fiscal module and app.ts

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 14:46:34 -06:00
Adrian Flores Cortes
a99d1af6b7 chore: Update backend submodule with config files 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 14:36:10 -06:00
Adrian Flores Cortes
fdfdc7f920 chore: Update backend submodule with new controllers 
- gestion-flota: operadores, unidades controllers
- ordenes-transporte: ordenes-transporte controller
- tracking: tracking controller
- viajes: viajes controller

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 14:31:14 -06:00
Adrian Flores Cortes
3501b838c7 chore: Update backend with carta-porte entities and services 
- CartaPorte CFDI 3.1 compliance entities (7 entities)
- Core transport services (viajes, flota, tracking, OT)
- Total: ~2,300 lines of new code

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 14:24:53 -06:00
Adrian Flores Cortes
ff4e851f82 chore: Update backend submodule with new entities 
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 14:15:36 -06:00
Adrian Flores Cortes
e285e007ad chore: Update backend submodule with viajes entities 
- Viaje, ParadaViaje, Pod entities for trip management
- Adapted inventory and financial modules for transport

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 10:38:25 -06:00
Adrian Flores Cortes
93131db0b5 docs: Update progress status after DDL and entities implementation 
PROJECT-STATUS.md:
- DDL: 100% complete (8 files, ~2,976 lines)
- Backend: 40% (24 modules + transport entities)
- Updated checklist with completed items

PLAN-DESARROLLO-REUTILIZACION.md:
- Phase 1: Partners adapted for shippers/consignees
- Phase 2: Entities implemented (Unidad, Operador, OrdenTransporte, EventoTracking, Geocerca)
- Phase 3: DDL complete, entities structure ready

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 10:29:45 -06:00
Adrian Flores Cortes
67070ccea9 feat: Update submodules with DDL and entities implementation 
Backend (3cc989c):
- Adapted partners module for shippers/consignees
- Added Unidad, Operador entities for fleet management
- Added OrdenTransporte entity for transport orders
- Added EventoTracking, Geocerca entities for tracking

Database (7a91823):
- Complete DDL files 01-08 for all schemas
- ~98 tables across 8 schemas
- CFDI Carta Porte 3.1 compliant structure
- PostGIS for geospatial tracking
- RLS policies for multi-tenancy

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 10:26:54 -06:00
Adrian Flores Cortes
82e7ff6f83 feat: Complete Phase 0-1 of SIMCO-REUSE development plan 
- Update PROJECT-STATUS.md with backend progress (25% overall)
- Add PLAN-DESARROLLO-REUTILIZACION.md with code reuse strategy
- Update backend submodule reference (419 files, ~69k lines copied)

Phases completed:
- Phase 0: Base modules (100% copy) - auth, users, tenants, ai, etc.
- Phase 1: Modules for adaptation - partners, inventory, financial
- Phase 2: Pattern modules created - ordenes-transporte, gestion-flota, viajes
- Phase 3: Transport-specific structure - tracking, tarifas, combustible, carta-porte

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 10:12:16 -06:00
Adrian Flores Cortes
37ed0aa919 feat: Initial project structure for ERP Transportistas 
Vertical ERP for freight transport and logistics companies.

Includes:
- Project configuration (CLAUDE.md, SIMCO orchestration)
- Backend submodule (NestJS 10.x)
- Frontend submodule (React 18.x + Vite)
- Database submodule (PostgreSQL 15 + PostGIS)
- Requirements documentation (REQ-GIRO-TRANSPORTISTA.md)
- 20 modules defined (MAI/MAE/MAA phases)

Key features:
- Transport orders (OT) management
- Fleet and driver management
- Real-time GPS tracking
- POD (Proof of Delivery)
- CFDI with Carta Porte 3.1 compliance
- Fuel and maintenance control
- Third-party carrier management

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-01-25 09:53:54 -06:00