erp-transportistas-v2/orchestration/PROJECT-PROFILE.yml
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

302 lines
9.1 KiB
YAML

# PROJECT-PROFILE.yml - ERP Transportistas
# Perfil del proyecto para propagacion y herencia
# Sistema SIMCO v4.0.0
version: "1.0.0"
project: "erp-transportistas"
updated: "2026-01-25"
# ═══════════════════════════════════════════════════════════════════════════════
# IDENTIFICACION
# ═══════════════════════════════════════════════════════════════════════════════
identification:
name: "ERP Transportistas"
slug: "erp-transportistas"
type: "CONSUMER"
industry: "Transporte de Carga / Logistica / 3PL"
version: "1.0.0"
# ═══════════════════════════════════════════════════════════════════════════════
# HERENCIA
# ═══════════════════════════════════════════════════════════════════════════════
inheritance:
parent: "erp-core"
grandparent: "template-saas"
modules_inherited:
full:
- auth
- users
- roles
- tenants
- audit
- notifications
- billing
- plans
- webhooks
- feature_flags
- ai_integration
- whatsapp_business
- mcp_server
extended:
- catalogs
- settings
- financial
- inventory
- purchasing
- sales
- crm
- partners
- reports
- projects
# ═══════════════════════════════════════════════════════════════════════════════
# MODULOS PROPIOS
# ═══════════════════════════════════════════════════════════════════════════════
own_modules:
phase_1_mai:
- code: "MAI-002"
name: "clientes-tarifas"
priority: "high"
dependencies: []
- code: "MAI-003"
name: "ordenes-transporte"
priority: "critical"
dependencies: ["MAI-002"]
- code: "MAI-004"
name: "planeacion-tms"
priority: "high"
dependencies: ["MAI-003"]
- code: "MAI-005"
name: "despacho"
priority: "high"
dependencies: ["MAI-004", "MAI-011"]
- code: "MAI-006"
name: "tracking"
priority: "critical"
dependencies: ["MAI-005"]
- code: "MAI-007"
name: "pod-cierre"
priority: "high"
dependencies: ["MAI-006"]
- code: "MAI-008"
name: "incidencias"
priority: "medium"
dependencies: ["MAI-006"]
- code: "MAI-009"
name: "facturacion-transporte"
priority: "high"
dependencies: ["MAI-007"]
- code: "MAI-010"
name: "liquidaciones"
priority: "medium"
dependencies: ["MAI-007"]
- code: "MAI-011"
name: "gestion-flota"
priority: "critical"
dependencies: []
- code: "MAI-012"
name: "combustible-gastos"
priority: "medium"
dependencies: ["MAI-011"]
- code: "MAI-013"
name: "mantenimiento-flota"
priority: "medium"
dependencies: ["MAI-011"]
- code: "MAI-014"
name: "carriers-terceros"
priority: "medium"
dependencies: ["MAI-003"]
- code: "MAI-015"
name: "portal-cliente"
priority: "low"
dependencies: ["MAI-006", "MAI-007"]
phase_2_mae:
- code: "MAE-016"
name: "carta-porte-cfdi"
priority: "critical"
dependencies: ["MAI-009"]
- code: "MAE-017"
name: "hos-bitacora"
priority: "medium"
dependencies: ["MAI-011"]
- code: "MAE-018"
name: "reportes-kpis"
priority: "medium"
dependencies: ["MAI-007"]
phase_3_maa:
- code: "MAA-019"
name: "optimizacion-rutas"
priority: "low"
dependencies: ["MAI-004"]
- code: "MAA-020"
name: "integraciones-edi"
priority: "low"
dependencies: ["MAI-003"]
# ═══════════════════════════════════════════════════════════════════════════════
# ENTIDADES PRINCIPALES
# ═══════════════════════════════════════════════════════════════════════════════
core_entities:
- name: "OrdenTransporte"
schema: "transport"
table: "ordenes_transporte"
module: "MAI-003"
- name: "Embarque"
schema: "transport"
table: "embarques"
module: "MAI-003"
- name: "Viaje"
schema: "transport"
table: "viajes"
module: "MAI-005"
- name: "Unidad"
schema: "fleet"
table: "unidades"
module: "MAI-011"
- name: "Remolque"
schema: "fleet"
table: "remolques"
module: "MAI-011"
- name: "Operador"
schema: "fleet"
table: "operadores"
module: "MAI-011"
- name: "EventoTracking"
schema: "tracking"
table: "eventos_tracking"
module: "MAI-006"
- name: "POD"
schema: "transport"
table: "pods"
module: "MAI-007"
- name: "Tarifa"
schema: "billing"
table: "tarifas"
module: "MAI-002"
- name: "CartaPorte"
schema: "compliance"
table: "cartas_porte"
module: "MAE-016"
# ═══════════════════════════════════════════════════════════════════════════════
# INTEGRACIONES
# ═══════════════════════════════════════════════════════════════════════════════
integrations:
required:
- name: "GPS/Telematica"
type: "api"
module: "MAI-006"
providers: ["Geotab", "Samsara", "CalAmp", "Generic"]
- name: "PAC (CFDI)"
type: "api"
module: "MAE-016"
providers: ["Finkok", "Facturapi", "SW Sapien"]
- name: "Mapas"
type: "api"
module: "MAI-004"
providers: ["Google Maps", "HERE", "OpenRouteService"]
optional:
- name: "Tarjetas Combustible"
type: "file"
module: "MAI-012"
- name: "TAG Peajes"
type: "file"
module: "MAI-012"
# ═══════════════════════════════════════════════════════════════════════════════
# COMPLIANCE
# ═══════════════════════════════════════════════════════════════════════════════
compliance:
mexico:
- name: "Carta Porte 3.1"
authority: "SAT"
mandatory: true
module: "MAE-016"
- name: "NOM-087"
authority: "SCT"
mandatory: true
module: "MAE-017"
description: "Bitacora de horas de servicio"
- name: "NOM-068"
authority: "SCT"
mandatory: true
module: "MAI-005"
description: "Condiciones fisico-mecanicas"
# ═══════════════════════════════════════════════════════════════════════════════
# WORKFLOWS
# ═══════════════════════════════════════════════════════════════════════════════
workflows:
main:
name: "Flujo Principal de Viaje"
states:
- "BORRADOR"
- "PLANEADO"
- "DESPACHADO"
- "EN_TRANSITO"
- "EN_DESTINO"
- "ENTREGADO"
- "CERRADO"
- "FACTURADO"
- "COBRADO"
incidencia:
name: "Flujo de Incidencias"
states:
- "ABIERTA"
- "ASIGNADA"
- "EN_INVESTIGACION"
- "RESUELTA"
- "CERRADA"
# ═══════════════════════════════════════════════════════════════════════════════
# METADATA
# ═══════════════════════════════════════════════════════════════════════════════
metadata:
created_by: "META-ORQUESTADOR"
created_at: "2026-01-25"
last_updated: "2026-01-25"