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>
This commit is contained in:
Adrian Flores Cortes
parent
e3b5ce146e
commit
3a3eb4089c
363
docs/_definitions/DATABASE-SCHEMA.md
Normal file
363
docs/_definitions/DATABASE-SCHEMA.md
Normal file
@ -0,0 +1,363 @@
|
||||
# DATABASE-SCHEMA.md - ERP Transportistas
|
||||
|
||||
**Version:** 1.0.0
|
||||
**Fecha:** 2026-01-26
|
||||
**Engine:** PostgreSQL 15+ con PostGIS
|
||||
**Total Schemas:** 8 especializados + heredados
|
||||
**Total Tablas:** ~98 propias + heredadas
|
||||
|
||||
---
|
||||
|
||||
## Resumen de Schemas
|
||||
|
||||
| Schema | Tablas | ENUMs | DDL File | Estado |
|
||||
|--------|--------|-------|----------|--------|
|
||||
| transport | ~25 | ~10 | 01-transport-schema-ddl.sql | 100% |
|
||||
| fleet | ~15 | ~8 | 02-fleet-schema-ddl.sql | 100% |
|
||||
| tracking | ~10 | ~5 | 03-tracking-schema-ddl.sql | 100% |
|
||||
| fuel | ~8 | ~4 | 04-fuel-schema-ddl.sql | 100% |
|
||||
| maintenance | ~12 | ~6 | 05-maintenance-schema-ddl.sql | 100% |
|
||||
| carriers | ~8 | ~4 | 06-carriers-schema-ddl.sql | 100% |
|
||||
| billing | ~10 | ~5 | 07-billing-transport-ddl.sql | 100% |
|
||||
| compliance | ~10 | ~5 | 08-compliance-schema-ddl.sql | 100% |
|
||||
|
||||
---
|
||||
|
||||
## Schema: transport
|
||||
|
||||
### Descripcion
|
||||
Ordenes de transporte, embarques, viajes y rutas.
|
||||
|
||||
### Tablas Principales
|
||||
|
||||
```sql
|
||||
-- Ordenes de Transporte
|
||||
CREATE TABLE transport.ordenes_transporte (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL REFERENCES auth.tenants(id),
|
||||
numero VARCHAR(20) NOT NULL,
|
||||
cliente_id UUID NOT NULL,
|
||||
status transport.status_ot NOT NULL DEFAULT 'BORRADOR',
|
||||
fecha_solicitud TIMESTAMPTZ NOT NULL,
|
||||
fecha_requerida TIMESTAMPTZ,
|
||||
origen_id UUID NOT NULL,
|
||||
destino_id UUID NOT NULL,
|
||||
peso_kg DECIMAL(10,2),
|
||||
volumen_m3 DECIMAL(10,2),
|
||||
valor_declarado DECIMAL(12,2),
|
||||
instrucciones TEXT,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW(),
|
||||
updated_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Embarques (agrupacion de OTs)
|
||||
CREATE TABLE transport.embarques (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL,
|
||||
numero VARCHAR(20) NOT NULL,
|
||||
viaje_id UUID,
|
||||
status transport.status_embarque NOT NULL,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Viajes
|
||||
CREATE TABLE transport.viajes (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL,
|
||||
numero VARCHAR(20) NOT NULL,
|
||||
unidad_id UUID NOT NULL,
|
||||
operador_id UUID NOT NULL,
|
||||
remolque_id UUID,
|
||||
status transport.status_viaje NOT NULL DEFAULT 'PLANEADO',
|
||||
fecha_salida_programada TIMESTAMPTZ,
|
||||
fecha_salida_real TIMESTAMPTZ,
|
||||
fecha_llegada_programada TIMESTAMPTZ,
|
||||
fecha_llegada_real TIMESTAMPTZ,
|
||||
km_inicial INTEGER,
|
||||
km_final INTEGER,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Paradas del viaje
|
||||
CREATE TABLE transport.paradas_viaje (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
viaje_id UUID NOT NULL REFERENCES transport.viajes(id),
|
||||
secuencia INTEGER NOT NULL,
|
||||
tipo transport.tipo_parada NOT NULL, -- ORIGEN, DESTINO, ESCALA
|
||||
ubicacion_id UUID NOT NULL,
|
||||
eta TIMESTAMPTZ,
|
||||
ata TIMESTAMPTZ, -- Actual Time of Arrival
|
||||
etd TIMESTAMPTZ,
|
||||
atd TIMESTAMPTZ, -- Actual Time of Departure
|
||||
status transport.status_parada NOT NULL
|
||||
);
|
||||
```
|
||||
|
||||
### ENUMs
|
||||
|
||||
```sql
|
||||
CREATE TYPE transport.status_ot AS ENUM (
|
||||
'BORRADOR', 'CONFIRMADA', 'PLANEADA', 'EN_TRANSITO',
|
||||
'ENTREGADA', 'FACTURADA', 'CERRADA', 'CANCELADA'
|
||||
);
|
||||
|
||||
CREATE TYPE transport.status_viaje AS ENUM (
|
||||
'PLANEADO', 'DESPACHADO', 'EN_TRANSITO', 'EN_DESTINO',
|
||||
'ENTREGADO', 'CERRADO', 'CANCELADO'
|
||||
);
|
||||
|
||||
CREATE TYPE transport.tipo_parada AS ENUM (
|
||||
'ORIGEN', 'DESTINO', 'ESCALA', 'CRUCE_FRONTERA'
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Schema: fleet
|
||||
|
||||
### Descripcion
|
||||
Unidades, remolques, operadores y documentos.
|
||||
|
||||
### Tablas Principales
|
||||
|
||||
```sql
|
||||
-- Unidades (tractoras, cajas)
|
||||
CREATE TABLE fleet.unidades (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL,
|
||||
numero_economico VARCHAR(20) NOT NULL,
|
||||
tipo fleet.tipo_unidad NOT NULL,
|
||||
marca VARCHAR(50),
|
||||
modelo VARCHAR(50),
|
||||
ano INTEGER,
|
||||
placa VARCHAR(15),
|
||||
numero_serie VARCHAR(50),
|
||||
capacidad_kg DECIMAL(10,2),
|
||||
status fleet.status_unidad NOT NULL DEFAULT 'DISPONIBLE',
|
||||
km_actual INTEGER,
|
||||
proximo_servicio_km INTEGER,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Operadores
|
||||
CREATE TABLE fleet.operadores (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL,
|
||||
numero_empleado VARCHAR(20) NOT NULL,
|
||||
nombre VARCHAR(100) NOT NULL,
|
||||
apellido_paterno VARCHAR(50) NOT NULL,
|
||||
apellido_materno VARCHAR(50),
|
||||
rfc VARCHAR(13),
|
||||
curp VARCHAR(18),
|
||||
licencia_federal VARCHAR(20),
|
||||
licencia_vencimiento DATE,
|
||||
status fleet.status_operador NOT NULL DEFAULT 'ACTIVO',
|
||||
telefono VARCHAR(15),
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Documentos de unidades
|
||||
CREATE TABLE fleet.documentos_unidades (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
unidad_id UUID NOT NULL REFERENCES fleet.unidades(id),
|
||||
tipo fleet.tipo_documento_unidad NOT NULL,
|
||||
numero VARCHAR(50),
|
||||
fecha_emision DATE,
|
||||
fecha_vencimiento DATE,
|
||||
archivo_url TEXT,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
### ENUMs
|
||||
|
||||
```sql
|
||||
CREATE TYPE fleet.tipo_unidad AS ENUM (
|
||||
'TRACTOCAMION', 'RABON', 'TORTON', 'CAJA_SECA',
|
||||
'CAJA_REFRIGERADA', 'PLATAFORMA', 'LOWBOY', 'TANQUE'
|
||||
);
|
||||
|
||||
CREATE TYPE fleet.status_unidad AS ENUM (
|
||||
'DISPONIBLE', 'EN_VIAJE', 'EN_MANTENIMIENTO',
|
||||
'FUERA_SERVICIO', 'BAJA'
|
||||
);
|
||||
|
||||
CREATE TYPE fleet.status_operador AS ENUM (
|
||||
'ACTIVO', 'EN_VIAJE', 'DESCANSO', 'VACACIONES',
|
||||
'INCAPACIDAD', 'BAJA'
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Schema: tracking
|
||||
|
||||
### Descripcion
|
||||
Eventos GPS, geocercas, alertas, ETA.
|
||||
|
||||
### Tablas Principales
|
||||
|
||||
```sql
|
||||
-- Eventos de tracking
|
||||
CREATE TABLE tracking.eventos (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL,
|
||||
unidad_id UUID NOT NULL,
|
||||
viaje_id UUID,
|
||||
tipo tracking.tipo_evento NOT NULL,
|
||||
latitud DECIMAL(10,7) NOT NULL,
|
||||
longitud DECIMAL(10,7) NOT NULL,
|
||||
velocidad_kmh INTEGER,
|
||||
rumbo INTEGER,
|
||||
odometro INTEGER,
|
||||
timestamp_gps TIMESTAMPTZ NOT NULL,
|
||||
timestamp_server TIMESTAMPTZ DEFAULT NOW(),
|
||||
datos_extra JSONB
|
||||
);
|
||||
|
||||
-- Geocercas
|
||||
CREATE TABLE tracking.geocercas (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL,
|
||||
nombre VARCHAR(100) NOT NULL,
|
||||
tipo tracking.tipo_geocerca NOT NULL,
|
||||
geometria GEOMETRY(POLYGON, 4326),
|
||||
radio_metros INTEGER, -- para circulares
|
||||
activa BOOLEAN DEFAULT true,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Alertas
|
||||
CREATE TABLE tracking.alertas (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL,
|
||||
viaje_id UUID,
|
||||
unidad_id UUID,
|
||||
tipo tracking.tipo_alerta NOT NULL,
|
||||
severidad tracking.severidad_alerta NOT NULL,
|
||||
mensaje TEXT NOT NULL,
|
||||
leida BOOLEAN DEFAULT false,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Schema: fuel
|
||||
|
||||
### Descripcion
|
||||
Combustible, peajes, gastos de viaje.
|
||||
|
||||
### Tablas Principales
|
||||
|
||||
```sql
|
||||
-- Cargas de combustible
|
||||
CREATE TABLE fuel.cargas_combustible (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL,
|
||||
viaje_id UUID,
|
||||
unidad_id UUID NOT NULL,
|
||||
operador_id UUID NOT NULL,
|
||||
estacion VARCHAR(100),
|
||||
litros DECIMAL(8,2) NOT NULL,
|
||||
precio_litro DECIMAL(8,4) NOT NULL,
|
||||
total DECIMAL(10,2) NOT NULL,
|
||||
odometro INTEGER,
|
||||
tipo_pago fuel.tipo_pago NOT NULL,
|
||||
numero_vale VARCHAR(30),
|
||||
fecha TIMESTAMPTZ NOT NULL,
|
||||
latitud DECIMAL(10,7),
|
||||
longitud DECIMAL(10,7),
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Control de rendimiento
|
||||
CREATE TABLE fuel.control_rendimiento (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
unidad_id UUID NOT NULL,
|
||||
periodo_inicio DATE NOT NULL,
|
||||
periodo_fin DATE NOT NULL,
|
||||
km_recorridos INTEGER NOT NULL,
|
||||
litros_consumidos DECIMAL(10,2) NOT NULL,
|
||||
rendimiento_real DECIMAL(6,2) NOT NULL, -- km/litro
|
||||
rendimiento_esperado DECIMAL(6,2),
|
||||
variacion_porcentaje DECIMAL(5,2),
|
||||
alerta_generada BOOLEAN DEFAULT false
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Schema: compliance
|
||||
|
||||
### Descripcion
|
||||
Carta Porte CFDI 3.1, HOS, inspecciones.
|
||||
|
||||
### Tablas Principales
|
||||
|
||||
```sql
|
||||
-- Carta Porte
|
||||
CREATE TABLE compliance.cartas_porte (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL,
|
||||
viaje_id UUID NOT NULL,
|
||||
tipo_cfdi compliance.tipo_cfdi NOT NULL, -- INGRESO, TRASLADO
|
||||
version_carta_porte VARCHAR(10) DEFAULT '3.1',
|
||||
uuid_cfdi UUID,
|
||||
folio_fiscal VARCHAR(50),
|
||||
fecha_timbrado TIMESTAMPTZ,
|
||||
status compliance.status_carta_porte NOT NULL,
|
||||
xml_firmado TEXT,
|
||||
pdf_url TEXT,
|
||||
created_at TIMESTAMPTZ DEFAULT NOW()
|
||||
);
|
||||
|
||||
-- Registro HOS (Horas de Servicio)
|
||||
CREATE TABLE compliance.registros_hos (
|
||||
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
||||
tenant_id UUID NOT NULL,
|
||||
operador_id UUID NOT NULL,
|
||||
fecha DATE NOT NULL,
|
||||
horas_conduccion DECIMAL(4,2),
|
||||
horas_servicio DECIMAL(4,2),
|
||||
horas_descanso DECIMAL(4,2),
|
||||
status compliance.status_hos NOT NULL,
|
||||
notas TEXT
|
||||
);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Extensiones Requeridas
|
||||
|
||||
```sql
|
||||
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
|
||||
CREATE EXTENSION IF NOT EXISTS "pgcrypto";
|
||||
CREATE EXTENSION IF NOT EXISTS "postgis"; -- Para tracking geografico
|
||||
CREATE EXTENSION IF NOT EXISTS "pg_trgm"; -- Para busquedas
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## RLS (Row Level Security)
|
||||
|
||||
Todas las tablas implementan RLS por tenant:
|
||||
|
||||
```sql
|
||||
ALTER TABLE transport.ordenes_transporte ENABLE ROW LEVEL SECURITY;
|
||||
|
||||
CREATE POLICY tenant_isolation ON transport.ordenes_transporte
|
||||
USING (tenant_id = current_setting('app.tenant_id')::UUID);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Referencias
|
||||
|
||||
- DDL completo: `database/ddl/`
|
||||
- Inventario: `orchestration/inventarios/DATABASE_INVENTORY.yml`
|
||||
- Entities: `ENTITIES-CATALOG.md`
|
||||
|
||||
---
|
||||
|
||||
*Ultima actualizacion: 2026-01-26*
|
||||
219
docs/_definitions/ENTITIES-CATALOG.md
Normal file
219
docs/_definitions/ENTITIES-CATALOG.md
Normal file
@ -0,0 +1,219 @@
|
||||
# ENTITIES-CATALOG.md - ERP Transportistas
|
||||
|
||||
**Version:** 1.0.0
|
||||
**Fecha:** 2026-01-26
|
||||
**Total Entities:** 153 (95 heredadas + 58 propias especializadas)
|
||||
|
||||
---
|
||||
|
||||
## Resumen por Schema
|
||||
|
||||
| Schema | Entities | Estado |
|
||||
|--------|----------|--------|
|
||||
| auth | 20 | Heredado 100% |
|
||||
| catalog | 15 | Heredado + extensiones |
|
||||
| transport | ~25 | DDL completo |
|
||||
| fleet | ~15 | DDL completo |
|
||||
| tracking | ~10 | DDL completo |
|
||||
| fuel | ~8 | DDL completo |
|
||||
| maintenance | ~12 | DDL completo |
|
||||
| carriers | ~8 | DDL completo |
|
||||
| billing | ~10 | DDL completo |
|
||||
| compliance | ~10 | DDL completo |
|
||||
|
||||
---
|
||||
|
||||
## Entities Heredadas (erp-core)
|
||||
|
||||
### Schema: auth (20)
|
||||
- User, Role, Permission, RefreshToken, Session
|
||||
- Tenant, Company, Branch
|
||||
- UserRole, RolePermission
|
||||
- PasswordReset, TwoFactorAuth
|
||||
- ApiKey, AuditLog, LoginAttempt
|
||||
- UserPreference, UserNotification
|
||||
- OAuthProvider, OAuthToken
|
||||
- DeviceSession, SecurityEvent
|
||||
|
||||
### Schema: catalog (15)
|
||||
- Country, State, City, Currency
|
||||
- PaymentMethod, PaymentTerm
|
||||
- UnitOfMeasure, TaxRate
|
||||
- DocumentType, DocumentSequence
|
||||
- Category, Tag
|
||||
- Bank, BankAccount
|
||||
- Warehouse
|
||||
|
||||
---
|
||||
|
||||
## Entities Propias - Schema: transport (~25)
|
||||
|
||||
### Ordenes de Transporte (MAI-003)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| OrdenTransporte | ordenes_transporte | Backend 40% | Solicitud de servicio |
|
||||
| Embarque | embarques | Pendiente | Agrupacion de OTs |
|
||||
| Parada | paradas | Pendiente | Origenes/destinos |
|
||||
| RestriccionOT | restricciones_ot | Pendiente | Restricciones logisticas |
|
||||
| ItemOT | items_ot | Pendiente | Lineas de la OT |
|
||||
|
||||
### Viajes y Rutas (MAI-004, MAI-005)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| Viaje | viajes | Backend parcial | Ejecucion operativa |
|
||||
| Ruta | rutas | Pendiente | Trayecto definido |
|
||||
| ParadaViaje | paradas_viaje | Pendiente | Secuencia de paradas |
|
||||
| ChecklistPreViaje | checklists_pre_viaje | Pendiente | Inspeccion salida |
|
||||
| SelloViaje | sellos_viaje | Pendiente | Sellos de seguridad |
|
||||
| EvidenciaCarga | evidencias_carga | Pendiente | Fotos de carga |
|
||||
|
||||
### POD y Cierre (MAI-007)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| POD | pods | Pendiente | Proof of Delivery |
|
||||
| FirmaDigital | firmas_digitales | Pendiente | Firma electronica |
|
||||
| FotoEntrega | fotos_entrega | Pendiente | Evidencia fotografica |
|
||||
| TiempoReal | tiempos_reales | Pendiente | Tiempos efectivos |
|
||||
|
||||
### Incidencias (MAI-008)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| Incidencia | incidencias | Pendiente | Evento inesperado |
|
||||
| ReclamoCliente | reclamos_clientes | Pendiente | Queja formal |
|
||||
|
||||
---
|
||||
|
||||
## Entities Propias - Schema: fleet (~15)
|
||||
|
||||
### Unidades y Remolques (MAI-011)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| Unidad | unidades | Backend 40% | Tractora/caja |
|
||||
| Remolque | remolques | Pendiente | Semirremolque |
|
||||
| ConfiguracionVehicular | configuraciones_vehiculares | Pendiente | Combinaciones |
|
||||
| DocumentoUnidad | documentos_unidades | Pendiente | Permisos, seguros |
|
||||
|
||||
### Operadores (MAI-011)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| Operador | operadores | Backend 40% | Conductor |
|
||||
| LicenciaOperador | licencias_operadores | Pendiente | Licencias SCT |
|
||||
| DocumentoOperador | documentos_operadores | Pendiente | Antidoping, cursos |
|
||||
| DisponibilidadOperador | disponibilidad_operadores | Pendiente | Horario, descansos |
|
||||
|
||||
---
|
||||
|
||||
## Entities Propias - Schema: tracking (~10)
|
||||
|
||||
### Eventos GPS (MAI-006)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| EventoTracking | eventos_tracking | Backend 20% | Posicion GPS |
|
||||
| Geocerca | geocercas | Backend 20% | Zonas geograficas |
|
||||
| AlertaTracking | alertas_tracking | Pendiente | Notificaciones |
|
||||
| ETADinamico | eta_dinamico | Pendiente | Tiempo estimado |
|
||||
| DispositivoGPS | dispositivos_gps | Pendiente | Hardware tracking |
|
||||
|
||||
---
|
||||
|
||||
## Entities Propias - Schema: fuel (~8)
|
||||
|
||||
### Combustible (MAI-012)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| CargaCombustible | cargas_combustible | Backend 50% | Registro de carga |
|
||||
| CrucePeaje | cruces_peaje | Backend 50% | Peajes IAVE/TAG |
|
||||
| GastoViaje | gastos_viaje | Backend 50% | Gastos operativos |
|
||||
| AnticipoViatico | anticipos_viaticos | Backend 50% | Adelantos |
|
||||
| ControlRendimiento | control_rendimiento | Backend 50% | km/litro |
|
||||
|
||||
---
|
||||
|
||||
## Entities Propias - Schema: maintenance (~12)
|
||||
|
||||
### Mantenimiento (MAI-013)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| OrdenTrabajo | ordenes_trabajo | Pendiente | OT mantenimiento |
|
||||
| ProgramaMantenimiento | programas_mantenimiento | Pendiente | Preventivo |
|
||||
| RefaccionFlota | refacciones_flota | Pendiente | Inventario partes |
|
||||
| HistorialMantenimiento | historial_mantenimiento | Pendiente | Registro historico |
|
||||
| ProveedorMantenimiento | proveedores_mantenimiento | Pendiente | Talleres externos |
|
||||
|
||||
---
|
||||
|
||||
## Entities Propias - Schema: carriers (~8)
|
||||
|
||||
### Terceros (MAI-014)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| Carrier | carriers | Pendiente | Transportista externo |
|
||||
| DocumentoCarrier | documentos_carriers | Pendiente | Permisos, seguros |
|
||||
| ScorecardCarrier | scorecard_carriers | Pendiente | Evaluacion |
|
||||
| TarifaCarrier | tarifas_carriers | Pendiente | Precios acordados |
|
||||
|
||||
---
|
||||
|
||||
## Entities Propias - Schema: billing (~10)
|
||||
|
||||
### Facturacion Transporte (MAI-009)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| Lane | lanes | Backend 30% | Ruta comercial |
|
||||
| Tarifa | tarifas | Backend 30% | Precio por lane |
|
||||
| RecargoCatalogo | recargos_catalogo | Backend 30% | Fuel surcharge, detention |
|
||||
| FacturaTransporte | facturas_transporte | Backend 30% | Factura servicio |
|
||||
| LineaFactura | lineas_factura | Backend 30% | Detalle factura |
|
||||
| FuelSurcharge | fuel_surcharge | Backend 30% | Recargo combustible |
|
||||
|
||||
### Liquidaciones (MAI-010)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| LiquidacionOperador | liquidaciones_operadores | Pendiente | Pago operador |
|
||||
| Deduccion | deducciones | Pendiente | Descuentos |
|
||||
|
||||
---
|
||||
|
||||
## Entities Propias - Schema: compliance (~10)
|
||||
|
||||
### Carta Porte (MAE-016)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| CartaPorte | cartas_porte | Pendiente | Complemento CFDI |
|
||||
| UbicacionCartaPorte | ubicaciones_carta_porte | Pendiente | Origenes/destinos |
|
||||
| MercanciaCartaPorte | mercancias_carta_porte | Pendiente | Detalle carga |
|
||||
| AutoTransporteFederal | autotransporte_federal | Pendiente | Datos SCT |
|
||||
| FiguraTransporte | figuras_transporte | Pendiente | Operador, propietario |
|
||||
|
||||
### HOS y Bitacora (MAE-017)
|
||||
|
||||
| Entity | Tabla | Estado | Descripcion |
|
||||
|--------|-------|--------|-------------|
|
||||
| RegistroHOS | registros_hos | Pendiente | Horas de servicio |
|
||||
| Bitacora | bitacoras | Pendiente | Log operador |
|
||||
| InspeccionUnidad | inspecciones_unidades | Pendiente | Pre/post viaje |
|
||||
|
||||
---
|
||||
|
||||
## Referencias
|
||||
|
||||
- DDL completo: `database/ddl/`
|
||||
- Backend Inventory: `orchestration/inventarios/BACKEND_INVENTORY.yml`
|
||||
- Database Inventory: `orchestration/inventarios/DATABASE_INVENTORY.yml`
|
||||
|
||||
---
|
||||
|
||||
*Ultima actualizacion: 2026-01-26*
|
||||
206
docs/_definitions/MODULES-CATALOG.md
Normal file
206
docs/_definitions/MODULES-CATALOG.md
Normal file
@ -0,0 +1,206 @@
|
||||
# MODULES-CATALOG.md - ERP Transportistas
|
||||
|
||||
**Version:** 1.0.0
|
||||
**Fecha:** 2026-01-26
|
||||
**Total Modulos:** 42 (22 heredados + 20 propios)
|
||||
|
||||
---
|
||||
|
||||
## Resumen
|
||||
|
||||
| Categoria | Cantidad | Estado |
|
||||
|-----------|----------|--------|
|
||||
| Heredados de erp-core | 22 | 100% disponibles |
|
||||
| Propios Fase 1 (MAI) | 15 | DDL 100%, Backend 40% |
|
||||
| Propios Fase 2 (MAE) | 3 | DDL 100%, Backend 0% |
|
||||
| Propios Fase 3 (MAA) | 2 | Planificados |
|
||||
|
||||
---
|
||||
|
||||
## Modulos Heredados (erp-core)
|
||||
|
||||
### Foundation (4)
|
||||
|
||||
| Codigo | Nombre | Entities | Reutilizacion |
|
||||
|--------|--------|----------|---------------|
|
||||
| MGN-001 | Auth | 20 | 100% |
|
||||
| MGN-002 | Users | 3 | 100% |
|
||||
| MGN-003 | Roles | 4 | 100% |
|
||||
| MGN-004 | Tenants | 2 | 100% |
|
||||
|
||||
### Core Business (6)
|
||||
|
||||
| Codigo | Nombre | Entities | Reutilizacion |
|
||||
|--------|--------|----------|---------------|
|
||||
| MGN-005 | Catalogs | 15 | 80% + extensiones |
|
||||
| MGN-006 | Settings | 8 | 90% |
|
||||
| MGN-010 | Partners | 5 | 60% + carriers |
|
||||
| MGN-011 | Inventory | 14 | 50% (refacciones) |
|
||||
| MGN-012 | Financial | 15 | 70% + transporte |
|
||||
| MGN-013 | Purchasing | 10 | 60% |
|
||||
|
||||
### Extended (5)
|
||||
|
||||
| Codigo | Nombre | Entities | Reutilizacion |
|
||||
|--------|--------|----------|---------------|
|
||||
| MGN-007 | Audit | 7 | 100% |
|
||||
| MGN-008 | Notifications | 6 | 100% |
|
||||
| MGN-009 | Reports | 5 | 50% + KPIs transporte |
|
||||
| MGN-014 | CRM | 8 | 60% + shippers |
|
||||
| MGN-015 | Projects | 10 | 30% (viajes como proyectos) |
|
||||
|
||||
### SaaS Platform (4)
|
||||
|
||||
| Codigo | Nombre | Entities | Reutilizacion |
|
||||
|--------|--------|----------|---------------|
|
||||
| MGN-016 | Billing | 5 | 100% |
|
||||
| MGN-017 | Plans | 3 | 100% |
|
||||
| MGN-018 | Webhooks | 4 | 100% |
|
||||
| MGN-019 | Feature Flags | 2 | 100% |
|
||||
|
||||
### AI/Intelligence (3)
|
||||
|
||||
| Codigo | Nombre | Entities | Reutilizacion |
|
||||
|--------|--------|----------|---------------|
|
||||
| MGN-020 | AI Integration | 7 | 80% + rutas |
|
||||
| MGN-021 | WhatsApp | 5 | 100% |
|
||||
| MGN-022 | MCP Server | 2 | 70% + tools transporte |
|
||||
|
||||
---
|
||||
|
||||
## Modulos Propios - Fase 1 (MAI)
|
||||
|
||||
### MAI-001: Fundamentos
|
||||
- **Hereda de:** MGN-001 a MGN-004
|
||||
- **Estado:** 100% heredado
|
||||
- **Descripcion:** Auth, RBAC, multi-tenancy
|
||||
|
||||
### MAI-002: Clientes y Tarifas
|
||||
- **Schema:** transport
|
||||
- **Entities:** Cliente, Lane, Tarifa, Recargo
|
||||
- **Estado:** DDL 0%, Backend 0%
|
||||
- **Descripcion:** Shippers, tarifas por lane, SLAs
|
||||
|
||||
### MAI-003: Ordenes de Transporte
|
||||
- **Schema:** transport
|
||||
- **Entities:** OrdenTransporte, Embarque, Parada, Restriccion
|
||||
- **Estado:** DDL 100%, Backend 40%
|
||||
- **Descripcion:** Solicitudes de servicio, multi-paradas
|
||||
|
||||
### MAI-004: Planeacion TMS
|
||||
- **Schema:** transport
|
||||
- **Entities:** Consolidacion, AsignacionRecurso, CapacidadRuta
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Planeacion de carga, capacidad
|
||||
|
||||
### MAI-005: Despacho
|
||||
- **Schema:** transport
|
||||
- **Entities:** ChecklistPreViaje, Sello, EvidenciaCarga
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Liberacion de viajes
|
||||
|
||||
### MAI-006: Tracking
|
||||
- **Schema:** tracking
|
||||
- **Entities:** EventoTracking, Geocerca, AlertaTracking, ETA
|
||||
- **Estado:** DDL 100%, Backend 20%
|
||||
- **Descripcion:** GPS, eventos, alertas
|
||||
|
||||
### MAI-007: POD y Cierre
|
||||
- **Schema:** transport
|
||||
- **Entities:** POD, FirmaDigital, FotoEntrega, TiempoReal
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Proof of Delivery
|
||||
|
||||
### MAI-008: Incidencias
|
||||
- **Schema:** transport
|
||||
- **Entities:** Incidencia, ReclamoCliente, ImpactoServicio
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Reclamaciones
|
||||
|
||||
### MAI-009: Facturacion Transporte
|
||||
- **Schema:** billing
|
||||
- **Entities:** FacturaTransporte, LineaFactura, FuelSurcharge
|
||||
- **Estado:** DDL 100%, Backend 30%
|
||||
- **Descripcion:** Facturacion especializada
|
||||
|
||||
### MAI-010: Liquidaciones
|
||||
- **Schema:** billing
|
||||
- **Entities:** LiquidacionOperador, Viatico, Deduccion
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Pago a operadores
|
||||
|
||||
### MAI-011: Gestion de Flota
|
||||
- **Schema:** fleet
|
||||
- **Entities:** Unidad, Remolque, Operador, LicenciaOperador
|
||||
- **Estado:** DDL 100%, Backend 40%
|
||||
- **Descripcion:** Control de activos
|
||||
|
||||
### MAI-012: Combustible y Gastos
|
||||
- **Schema:** fuel
|
||||
- **Entities:** CargaCombustible, CrucePeaje, GastoViaje, Anticipo
|
||||
- **Estado:** DDL 100%, Backend 50%
|
||||
- **Descripcion:** Control antifraude
|
||||
|
||||
### MAI-013: Mantenimiento Flota
|
||||
- **Schema:** maintenance
|
||||
- **Entities:** OrdenTrabajo, ProgramaMantenimiento, Refaccion
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Preventivo/correctivo
|
||||
|
||||
### MAI-014: Carriers (Terceros)
|
||||
- **Schema:** carriers
|
||||
- **Entities:** Carrier, DocumentoCarrier, ScorecardCarrier
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Subcontratacion
|
||||
|
||||
### MAI-015: Portal Cliente
|
||||
- **Schema:** transport
|
||||
- **Entities:** UsuarioPortal, ConfigPortal
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Autoservicio clientes
|
||||
|
||||
---
|
||||
|
||||
## Modulos Propios - Fase 2 (MAE)
|
||||
|
||||
### MAE-016: Carta Porte CFDI
|
||||
- **Schema:** compliance
|
||||
- **Entities:** CartaPorte, ComplementoFiscal, ExpedienteCFDI
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Complemento 3.1 obligatorio
|
||||
|
||||
### MAE-017: HOS y Bitacora
|
||||
- **Schema:** compliance
|
||||
- **Entities:** RegistroHOS, Bitacora, InspeccionUnidad
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Horas de servicio, NOM-087
|
||||
|
||||
### MAE-018: Reportes y KPIs
|
||||
- **Schema:** analytics
|
||||
- **Entities:** KPITransporte, ReporteOTIF, DashboardConfig
|
||||
- **Estado:** DDL 100%, Backend 0%
|
||||
- **Descripcion:** Metricas de desempeno
|
||||
|
||||
---
|
||||
|
||||
## Modulos Propios - Fase 3 (MAA)
|
||||
|
||||
### MAA-019: Optimizacion Rutas
|
||||
- **Estado:** Planificado
|
||||
- **Descripcion:** ML para optimizacion, prediccion ETA
|
||||
|
||||
### MAA-020: Integraciones EDI
|
||||
- **Estado:** Planificado
|
||||
- **Descripcion:** Intercambio electronico datos
|
||||
|
||||
---
|
||||
|
||||
## Referencias
|
||||
|
||||
- Inventario Backend: `orchestration/inventarios/BACKEND_INVENTORY.yml`
|
||||
- Inventario Database: `orchestration/inventarios/DATABASE_INVENTORY.yml`
|
||||
- CLAUDE.md: `CLAUDE.md`
|
||||
|
||||
---
|
||||
|
||||
*Ultima actualizacion: 2026-01-26*
|
||||
195
docs/_definitions/SERVICES-CATALOG.md
Normal file
195
docs/_definitions/SERVICES-CATALOG.md
Normal file
@ -0,0 +1,195 @@
|
||||
# SERVICES-CATALOG.md - ERP Transportistas
|
||||
|
||||
**Version:** 1.0.0
|
||||
**Fecha:** 2026-01-26
|
||||
**Total Services:** ~80 (50 heredados + 30 propios)
|
||||
|
||||
---
|
||||
|
||||
## Resumen
|
||||
|
||||
| Categoria | Services | Estado |
|
||||
|-----------|----------|--------|
|
||||
| Heredados erp-core | ~50 | 100% disponibles |
|
||||
| Propios transporte | ~30 | 40% implementados |
|
||||
|
||||
---
|
||||
|
||||
## Services Heredados (erp-core)
|
||||
|
||||
### Auth & Users
|
||||
- AuthService
|
||||
- UsersService
|
||||
- RolesService
|
||||
- PermissionsService
|
||||
- SessionsService
|
||||
|
||||
### Tenancy
|
||||
- TenantsService
|
||||
- CompaniesService
|
||||
- BranchesService
|
||||
|
||||
### Core
|
||||
- CatalogsService
|
||||
- SettingsService
|
||||
- AuditService
|
||||
- NotificationsService
|
||||
|
||||
### Financial
|
||||
- FinancialService
|
||||
- InvoicesService
|
||||
- PaymentsService
|
||||
- AccountingService
|
||||
|
||||
### Partners
|
||||
- PartnersService
|
||||
- CustomersService
|
||||
- SuppliersService
|
||||
|
||||
### AI/Intelligence
|
||||
- AIService
|
||||
- WhatsAppService
|
||||
- MCPService
|
||||
|
||||
---
|
||||
|
||||
## Services Propios - Transporte
|
||||
|
||||
### OrdenesTransporteService (MAI-003)
|
||||
- **Path:** `backend/src/modules/ordenes-transporte/services/`
|
||||
- **Estado:** 40% implementado
|
||||
- **Metodos:**
|
||||
- `create(dto)` - Crear OT
|
||||
- `findAll(filters)` - Listar OTs
|
||||
- `findById(id)` - Obtener OT
|
||||
- `update(id, dto)` - Actualizar OT
|
||||
- `delete(id)` - Eliminar OT
|
||||
- `changeStatus(id, status)` - Cambiar estado
|
||||
- `assignToViaje(otId, viajeId)` - Asignar a viaje
|
||||
|
||||
### ViajesService (MAI-004, MAI-005)
|
||||
- **Path:** `backend/src/modules/viajes/services/`
|
||||
- **Estado:** Pendiente
|
||||
- **Metodos:**
|
||||
- `create(dto)` - Crear viaje
|
||||
- `planificar(viajeId, recursos)` - Planificar recursos
|
||||
- `despachar(viajeId, checklist)` - Liberar viaje
|
||||
- `cerrar(viajeId, pod)` - Cerrar con POD
|
||||
|
||||
### TrackingService (MAI-006)
|
||||
- **Path:** `backend/src/modules/tracking/services/`
|
||||
- **Estado:** 20% implementado
|
||||
- **Metodos:**
|
||||
- `registrarEvento(dto)` - Registrar posicion GPS
|
||||
- `getUltimaPosicion(unidadId)` - Ultima ubicacion
|
||||
- `getHistorial(viajeId)` - Historial de eventos
|
||||
- `calcularETA(viajeId)` - ETA dinamico
|
||||
- `verificarGeocercas(lat, lng)` - Check geocercas
|
||||
- `generarAlerta(tipo, datos)` - Crear alerta
|
||||
|
||||
### FlotaService (MAI-011)
|
||||
- **Path:** `backend/src/modules/gestion-flota/services/`
|
||||
- **Estado:** 40% implementado
|
||||
- **Metodos:**
|
||||
- `getUnidades(filters)` - Listar unidades
|
||||
- `getOperadores(filters)` - Listar operadores
|
||||
- `getDisponibilidad(fecha)` - Recursos disponibles
|
||||
- `asignarOperador(unidadId, operadorId)` - Asignar
|
||||
- `verificarDocumentos(recursoId)` - Validar vigencia
|
||||
|
||||
### CombustibleService (MAI-012)
|
||||
- **Path:** `backend/src/modules/combustible-gastos/services/`
|
||||
- **Estado:** 50% implementado
|
||||
- **Metodos:**
|
||||
- `registrarCarga(dto)` - Registrar carga combustible
|
||||
- `registrarPeaje(dto)` - Registrar cruce peaje
|
||||
- `registrarGasto(dto)` - Registrar gasto
|
||||
- `generarAnticipo(operadorId, monto)` - Crear anticipo
|
||||
- `calcularRendimiento(unidadId, periodo)` - km/litro
|
||||
- `detectarAnomalias(viajeId)` - Alertas fraude
|
||||
|
||||
### FacturacionTransporteService (MAI-009)
|
||||
- **Path:** `backend/src/modules/facturacion-transporte/services/`
|
||||
- **Estado:** 30% implementado
|
||||
- **Metodos:**
|
||||
- `calcularTarifa(lane, peso, volumen)` - Calcular precio
|
||||
- `aplicarRecargos(facturaId, recargos)` - Agregar recargos
|
||||
- `generarFactura(viajeId)` - Crear factura
|
||||
- `calcularFuelSurcharge(fecha)` - Recargo combustible
|
||||
|
||||
### CartaPorteService (MAE-016)
|
||||
- **Path:** `backend/src/modules/carta-porte/services/`
|
||||
- **Estado:** Pendiente
|
||||
- **Metodos:**
|
||||
- `generarComplemento(viajeId)` - Crear XML
|
||||
- `validarDatos(dto)` - Validar requeridos
|
||||
- `timbrar(cartaPorteId)` - Enviar a PAC
|
||||
- `generarPDF(cartaPorteId)` - PDF para impresion
|
||||
- `cancelar(cartaPorteId, motivo)` - Cancelar CFDI
|
||||
|
||||
### MantenimientoService (MAI-013)
|
||||
- **Path:** `backend/src/modules/mantenimiento/services/`
|
||||
- **Estado:** Pendiente
|
||||
- **Metodos:**
|
||||
- `crearOrdenTrabajo(dto)` - Crear OT manto
|
||||
- `programarPreventivo(unidadId)` - Programar
|
||||
- `registrarRefaccion(otId, refaccion)` - Agregar parte
|
||||
- `getProximosMantenimientos()` - Alertas vencimiento
|
||||
|
||||
### CarriersService (MAI-014)
|
||||
- **Path:** `backend/src/modules/carriers/services/`
|
||||
- **Estado:** Pendiente
|
||||
- **Metodos:**
|
||||
- `registrarCarrier(dto)` - Alta tercero
|
||||
- `validarDocumentos(carrierId)` - Verificar vigencia
|
||||
- `calcularScorecard(carrierId)` - Evaluar desempeno
|
||||
- `asignarViaje(carrierId, viajeId)` - Subcontratar
|
||||
|
||||
---
|
||||
|
||||
## Integraciones Externas
|
||||
|
||||
### GPSIntegrationService
|
||||
- **Estado:** Planificado
|
||||
- **Proveedores:**
|
||||
- Geotab
|
||||
- Samsara
|
||||
- Omnitracs
|
||||
- **Metodos:**
|
||||
- `conectar(proveedor, credentials)`
|
||||
- `getPosicion(deviceId)`
|
||||
- `getEventos(desde, hasta)`
|
||||
|
||||
### PACIntegrationService
|
||||
- **Estado:** Planificado
|
||||
- **Proveedores:**
|
||||
- Finkok
|
||||
- Facturama
|
||||
- SW Sapien
|
||||
- **Metodos:**
|
||||
- `timbrar(xml)`
|
||||
- `cancelar(uuid, motivo)`
|
||||
- `getStatus(uuid)`
|
||||
|
||||
### MapasService
|
||||
- **Estado:** Planificado
|
||||
- **Proveedores:**
|
||||
- Google Maps
|
||||
- HERE
|
||||
- Mapbox
|
||||
- **Metodos:**
|
||||
- `geocodificar(direccion)`
|
||||
- `calcularRuta(origen, destino)`
|
||||
- `getDistanciaTiempo(puntos)`
|
||||
|
||||
---
|
||||
|
||||
## Referencias
|
||||
|
||||
- Backend: `backend/src/modules/`
|
||||
- Entities: `ENTITIES-CATALOG.md`
|
||||
- API: `_quick/QUICK-API.yml`
|
||||
|
||||
---
|
||||
|
||||
*Ultima actualizacion: 2026-01-26*
|
||||
39
docs/_definitions/_INDEX.yml
Normal file
39
docs/_definitions/_INDEX.yml
Normal file
@ -0,0 +1,39 @@
|
||||
# _INDEX.yml - Indice de Definiciones Canonicas
|
||||
# ERP Transportistas
|
||||
# Version: 1.0.0
|
||||
# Fecha: 2026-01-26
|
||||
|
||||
name: "Definiciones Canonicas - ERP Transportistas"
|
||||
description: "Single Source of Truth para entidades, servicios y base de datos"
|
||||
|
||||
catalogs:
|
||||
- file: "MODULES-CATALOG.md"
|
||||
description: "Catalogo de modulos del sistema"
|
||||
priority: 1
|
||||
|
||||
- file: "ENTITIES-CATALOG.md"
|
||||
description: "Catalogo de entidades backend"
|
||||
priority: 2
|
||||
|
||||
- file: "SERVICES-CATALOG.md"
|
||||
description: "Catalogo de servicios backend"
|
||||
priority: 3
|
||||
|
||||
- file: "DATABASE-SCHEMA.md"
|
||||
description: "Esquema de base de datos"
|
||||
priority: 4
|
||||
|
||||
usage: |
|
||||
Estos archivos son la fuente unica de verdad.
|
||||
Antes de crear entidad/servicio nuevo:
|
||||
1. Verificar si existe en catalogo
|
||||
2. Si existe: USAR
|
||||
3. Si no existe: CREAR y DOCUMENTAR aqui
|
||||
|
||||
sync_with:
|
||||
- "orchestration/inventarios/MASTER_INVENTORY.yml"
|
||||
- "orchestration/inventarios/BACKEND_INVENTORY.yml"
|
||||
- "orchestration/inventarios/DATABASE_INVENTORY.yml"
|
||||
|
||||
last_updated: "2026-01-26"
|
||||
updated_by: "claude-code-orquestador"
|
||||
224
docs/_quick/QUICK-API.yml
Normal file
224
docs/_quick/QUICK-API.yml
Normal file
@ -0,0 +1,224 @@
|
||||
# QUICK-API.yml - API Endpoints ERP Transportistas
|
||||
# Version: 1.0.0
|
||||
# Fecha: 2026-01-26
|
||||
|
||||
base_url: "http://localhost:3014/api/v1"
|
||||
auth_header: "Authorization: Bearer {token}"
|
||||
tenant_header: "X-Tenant-ID: {tenant_uuid}"
|
||||
|
||||
endpoints:
|
||||
auth:
|
||||
prefix: "/auth"
|
||||
routes:
|
||||
- method: "POST"
|
||||
path: "/login"
|
||||
description: "Autenticacion"
|
||||
body: "{ email, password }"
|
||||
|
||||
- method: "POST"
|
||||
path: "/refresh"
|
||||
description: "Refrescar token"
|
||||
|
||||
- method: "POST"
|
||||
path: "/logout"
|
||||
description: "Cerrar sesion"
|
||||
|
||||
ordenes_transporte:
|
||||
prefix: "/ordenes-transporte"
|
||||
status: "40% implementado"
|
||||
routes:
|
||||
- method: "GET"
|
||||
path: "/"
|
||||
description: "Listar OTs"
|
||||
query: "?status=CONFIRMADA&cliente_id=uuid"
|
||||
|
||||
- method: "GET"
|
||||
path: "/:id"
|
||||
description: "Obtener OT"
|
||||
|
||||
- method: "POST"
|
||||
path: "/"
|
||||
description: "Crear OT"
|
||||
body: "CreateOrdenTransporteDto"
|
||||
|
||||
- method: "PATCH"
|
||||
path: "/:id"
|
||||
description: "Actualizar OT"
|
||||
|
||||
- method: "PATCH"
|
||||
path: "/:id/status"
|
||||
description: "Cambiar status"
|
||||
body: "{ status: 'CONFIRMADA' }"
|
||||
|
||||
- method: "DELETE"
|
||||
path: "/:id"
|
||||
description: "Eliminar OT"
|
||||
|
||||
viajes:
|
||||
prefix: "/viajes"
|
||||
status: "Pendiente"
|
||||
routes:
|
||||
- method: "GET"
|
||||
path: "/"
|
||||
description: "Listar viajes"
|
||||
|
||||
- method: "POST"
|
||||
path: "/"
|
||||
description: "Crear viaje"
|
||||
|
||||
- method: "POST"
|
||||
path: "/:id/despachar"
|
||||
description: "Despachar viaje"
|
||||
|
||||
- method: "POST"
|
||||
path: "/:id/cerrar"
|
||||
description: "Cerrar con POD"
|
||||
|
||||
tracking:
|
||||
prefix: "/tracking"
|
||||
status: "20% implementado"
|
||||
routes:
|
||||
- method: "POST"
|
||||
path: "/eventos"
|
||||
description: "Registrar evento GPS"
|
||||
body: "{ unidad_id, lat, lng, velocidad, timestamp }"
|
||||
|
||||
- method: "GET"
|
||||
path: "/unidades/:id/posicion"
|
||||
description: "Ultima posicion"
|
||||
|
||||
- method: "GET"
|
||||
path: "/viajes/:id/historial"
|
||||
description: "Historial de eventos"
|
||||
|
||||
- method: "GET"
|
||||
path: "/viajes/:id/eta"
|
||||
description: "ETA dinamico"
|
||||
|
||||
flota:
|
||||
prefix: "/flota"
|
||||
status: "40% implementado"
|
||||
routes:
|
||||
- method: "GET"
|
||||
path: "/unidades"
|
||||
description: "Listar unidades"
|
||||
|
||||
- method: "GET"
|
||||
path: "/operadores"
|
||||
description: "Listar operadores"
|
||||
|
||||
- method: "GET"
|
||||
path: "/disponibilidad"
|
||||
description: "Recursos disponibles"
|
||||
query: "?fecha=2026-01-26"
|
||||
|
||||
combustible:
|
||||
prefix: "/combustible"
|
||||
status: "50% implementado"
|
||||
routes:
|
||||
- method: "POST"
|
||||
path: "/cargas"
|
||||
description: "Registrar carga"
|
||||
|
||||
- method: "GET"
|
||||
path: "/rendimiento/:unidad_id"
|
||||
description: "Rendimiento km/litro"
|
||||
|
||||
- method: "GET"
|
||||
path: "/anomalias"
|
||||
description: "Alertas de fraude"
|
||||
|
||||
facturacion:
|
||||
prefix: "/facturacion"
|
||||
status: "30% implementado"
|
||||
routes:
|
||||
- method: "GET"
|
||||
path: "/tarifas"
|
||||
description: "Listar tarifas"
|
||||
query: "?lane=origen-destino"
|
||||
|
||||
- method: "POST"
|
||||
path: "/facturas"
|
||||
description: "Generar factura"
|
||||
|
||||
- method: "GET"
|
||||
path: "/fuel-surcharge"
|
||||
description: "Recargo combustible actual"
|
||||
|
||||
carta_porte:
|
||||
prefix: "/carta-porte"
|
||||
status: "Pendiente"
|
||||
routes:
|
||||
- method: "POST"
|
||||
path: "/"
|
||||
description: "Generar complemento"
|
||||
body: "{ viaje_id }"
|
||||
|
||||
- method: "POST"
|
||||
path: "/:id/timbrar"
|
||||
description: "Timbrar con PAC"
|
||||
|
||||
- method: "GET"
|
||||
path: "/:id/pdf"
|
||||
description: "Descargar PDF"
|
||||
|
||||
- method: "POST"
|
||||
path: "/:id/cancelar"
|
||||
description: "Cancelar CFDI"
|
||||
|
||||
carriers:
|
||||
prefix: "/carriers"
|
||||
status: "Pendiente"
|
||||
routes:
|
||||
- method: "GET"
|
||||
path: "/"
|
||||
description: "Listar carriers"
|
||||
|
||||
- method: "GET"
|
||||
path: "/:id/scorecard"
|
||||
description: "Evaluacion"
|
||||
|
||||
mantenimiento:
|
||||
prefix: "/mantenimiento"
|
||||
status: "Pendiente"
|
||||
routes:
|
||||
- method: "GET"
|
||||
path: "/proximos"
|
||||
description: "Proximos mantenimientos"
|
||||
|
||||
- method: "POST"
|
||||
path: "/ordenes-trabajo"
|
||||
description: "Crear OT mantenimiento"
|
||||
|
||||
response_format:
|
||||
success:
|
||||
example: |
|
||||
{
|
||||
"success": true,
|
||||
"data": { ... },
|
||||
"meta": {
|
||||
"total": 100,
|
||||
"page": 1,
|
||||
"limit": 20
|
||||
}
|
||||
}
|
||||
|
||||
error:
|
||||
example: |
|
||||
{
|
||||
"success": false,
|
||||
"error": {
|
||||
"code": "VALIDATION_ERROR",
|
||||
"message": "Campo requerido",
|
||||
"details": [ ... ]
|
||||
}
|
||||
}
|
||||
|
||||
pagination:
|
||||
query_params:
|
||||
- "limit (default: 20, max: 100)"
|
||||
- "offset (default: 0)"
|
||||
- "sort (campo)"
|
||||
- "order (asc|desc)"
|
||||
|
||||
last_updated: "2026-01-26"
|
||||
155
docs/_quick/QUICK-DATABASE.yml
Normal file
155
docs/_quick/QUICK-DATABASE.yml
Normal file
@ -0,0 +1,155 @@
|
||||
# QUICK-DATABASE.yml - Base de Datos ERP Transportistas
|
||||
# Version: 1.0.0
|
||||
# Fecha: 2026-01-26
|
||||
|
||||
summary:
|
||||
engine: "PostgreSQL 15+ con PostGIS"
|
||||
total_schemas: 8
|
||||
total_tables: "~98"
|
||||
total_enums: "~47"
|
||||
ddl_status: "100%"
|
||||
|
||||
schemas:
|
||||
transport:
|
||||
description: "Ordenes de transporte, embarques, viajes"
|
||||
ddl_file: "01-transport-schema-ddl.sql"
|
||||
lines: "~13,500"
|
||||
tables:
|
||||
- "ordenes_transporte"
|
||||
- "embarques"
|
||||
- "viajes"
|
||||
- "paradas_viaje"
|
||||
- "items_ot"
|
||||
- "restricciones_ot"
|
||||
- "checklists_pre_viaje"
|
||||
- "sellos_viaje"
|
||||
- "evidencias_carga"
|
||||
- "pods"
|
||||
- "firmas_digitales"
|
||||
- "incidencias"
|
||||
|
||||
fleet:
|
||||
description: "Unidades, remolques, operadores"
|
||||
ddl_file: "02-fleet-schema-ddl.sql"
|
||||
lines: "~12,200"
|
||||
tables:
|
||||
- "unidades"
|
||||
- "remolques"
|
||||
- "operadores"
|
||||
- "licencias_operadores"
|
||||
- "documentos_unidades"
|
||||
- "documentos_operadores"
|
||||
- "disponibilidad_operadores"
|
||||
- "configuraciones_vehiculares"
|
||||
|
||||
tracking:
|
||||
description: "GPS, eventos, geocercas, alertas"
|
||||
ddl_file: "03-tracking-schema-ddl.sql"
|
||||
lines: "~11,600"
|
||||
tables:
|
||||
- "eventos"
|
||||
- "geocercas"
|
||||
- "alertas"
|
||||
- "eta_dinamico"
|
||||
- "dispositivos_gps"
|
||||
|
||||
fuel:
|
||||
description: "Combustible, peajes, gastos"
|
||||
ddl_file: "04-fuel-schema-ddl.sql"
|
||||
lines: "~9,300"
|
||||
tables:
|
||||
- "cargas_combustible"
|
||||
- "cruces_peaje"
|
||||
- "gastos_viaje"
|
||||
- "anticipos_viaticos"
|
||||
- "control_rendimiento"
|
||||
|
||||
maintenance:
|
||||
description: "Mantenimiento preventivo/correctivo"
|
||||
ddl_file: "05-maintenance-schema-ddl.sql"
|
||||
lines: "~9,600"
|
||||
tables:
|
||||
- "ordenes_trabajo"
|
||||
- "programas_mantenimiento"
|
||||
- "refacciones_flota"
|
||||
- "historial_mantenimiento"
|
||||
- "proveedores_mantenimiento"
|
||||
|
||||
carriers:
|
||||
description: "Transportistas terceros"
|
||||
ddl_file: "06-carriers-schema-ddl.sql"
|
||||
lines: "~10,600"
|
||||
tables:
|
||||
- "carriers"
|
||||
- "documentos_carriers"
|
||||
- "scorecard_carriers"
|
||||
- "tarifas_carriers"
|
||||
|
||||
billing:
|
||||
description: "Facturacion transporte"
|
||||
ddl_file: "07-billing-transport-ddl.sql"
|
||||
lines: "~10,700"
|
||||
tables:
|
||||
- "lanes"
|
||||
- "tarifas"
|
||||
- "recargos_catalogo"
|
||||
- "facturas_transporte"
|
||||
- "lineas_factura"
|
||||
- "fuel_surcharge"
|
||||
- "liquidaciones_operadores"
|
||||
- "deducciones"
|
||||
|
||||
compliance:
|
||||
description: "Carta Porte, HOS, inspecciones"
|
||||
ddl_file: "08-compliance-schema-ddl.sql"
|
||||
lines: "~14,700"
|
||||
tables:
|
||||
- "cartas_porte"
|
||||
- "ubicaciones_carta_porte"
|
||||
- "mercancias_carta_porte"
|
||||
- "autotransporte_federal"
|
||||
- "figuras_transporte"
|
||||
- "registros_hos"
|
||||
- "bitacoras"
|
||||
- "inspecciones_unidades"
|
||||
|
||||
key_enums:
|
||||
transport:
|
||||
- "status_ot"
|
||||
- "status_viaje"
|
||||
- "tipo_parada"
|
||||
- "status_embarque"
|
||||
|
||||
fleet:
|
||||
- "tipo_unidad"
|
||||
- "status_unidad"
|
||||
- "status_operador"
|
||||
- "tipo_documento_unidad"
|
||||
|
||||
tracking:
|
||||
- "tipo_evento"
|
||||
- "tipo_geocerca"
|
||||
- "tipo_alerta"
|
||||
- "severidad_alerta"
|
||||
|
||||
compliance:
|
||||
- "tipo_cfdi"
|
||||
- "status_carta_porte"
|
||||
- "status_hos"
|
||||
|
||||
extensions:
|
||||
- "uuid-ossp"
|
||||
- "pgcrypto"
|
||||
- "postgis"
|
||||
- "pg_trgm"
|
||||
|
||||
rls_enabled: true
|
||||
rls_policy: "tenant_isolation"
|
||||
|
||||
credentials:
|
||||
database: "erp_transportistas_db"
|
||||
user: "erp_admin"
|
||||
password: "erp_dev_2026"
|
||||
port: 5432
|
||||
|
||||
last_updated: "2026-01-26"
|
||||
53
docs/_quick/QUICK-INDEX.yml
Normal file
53
docs/_quick/QUICK-INDEX.yml
Normal file
@ -0,0 +1,53 @@
|
||||
# QUICK-INDEX.yml - Navegacion Rapida ERP Transportistas
|
||||
# Version: 1.0.0
|
||||
# Fecha: 2026-01-26
|
||||
|
||||
name: "Guias Rapidas - ERP Transportistas"
|
||||
description: "Indice de documentos de referencia rapida"
|
||||
|
||||
guides:
|
||||
- file: "QUICK-MODULES.yml"
|
||||
description: "Modulos del sistema y estado"
|
||||
use_when: "Necesitas ver que modulos existen y su progreso"
|
||||
|
||||
- file: "QUICK-DATABASE.yml"
|
||||
description: "Schemas y tablas principales"
|
||||
use_when: "Necesitas consultar estructura de BD"
|
||||
|
||||
- file: "QUICK-API.yml"
|
||||
description: "Endpoints principales"
|
||||
use_when: "Necesitas ver rutas de API"
|
||||
|
||||
quick_links:
|
||||
documentacion:
|
||||
vision: "docs/00-vision-general/VISION-ERP-TRANSPORTISTAS.md"
|
||||
requerimientos: "docs/03-requerimientos/REQ-GIRO-TRANSPORTISTA.md"
|
||||
modulos: "docs/02-definicion-modulos/"
|
||||
|
||||
inventarios:
|
||||
master: "orchestration/inventarios/MASTER_INVENTORY.yml"
|
||||
backend: "orchestration/inventarios/BACKEND_INVENTORY.yml"
|
||||
database: "orchestration/inventarios/DATABASE_INVENTORY.yml"
|
||||
|
||||
catalogos:
|
||||
modules: "_definitions/MODULES-CATALOG.md"
|
||||
entities: "_definitions/ENTITIES-CATALOG.md"
|
||||
services: "_definitions/SERVICES-CATALOG.md"
|
||||
database: "_definitions/DATABASE-SCHEMA.md"
|
||||
|
||||
ddl:
|
||||
transport: "database/ddl/01-transport-schema-ddl.sql"
|
||||
fleet: "database/ddl/02-fleet-schema-ddl.sql"
|
||||
tracking: "database/ddl/03-tracking-schema-ddl.sql"
|
||||
fuel: "database/ddl/04-fuel-schema-ddl.sql"
|
||||
maintenance: "database/ddl/05-maintenance-schema-ddl.sql"
|
||||
carriers: "database/ddl/06-carriers-schema-ddl.sql"
|
||||
billing: "database/ddl/07-billing-transport-ddl.sql"
|
||||
compliance: "database/ddl/08-compliance-schema-ddl.sql"
|
||||
|
||||
orchestration:
|
||||
status: "PROJECT-STATUS.md"
|
||||
proxima: "orchestration/PROXIMA-ACCION.md"
|
||||
herencia: "orchestration/00-guidelines/HERENCIA-ERP-CORE.md"
|
||||
|
||||
last_updated: "2026-01-26"
|
||||
219
docs/_quick/QUICK-MODULES.yml
Normal file
219
docs/_quick/QUICK-MODULES.yml
Normal file
@ -0,0 +1,219 @@
|
||||
# QUICK-MODULES.yml - Modulos ERP Transportistas
|
||||
# Version: 1.0.0
|
||||
# Fecha: 2026-01-26
|
||||
|
||||
summary:
|
||||
total: 42
|
||||
heredados: 22
|
||||
propios: 20
|
||||
implementados: 8
|
||||
pendientes: 12
|
||||
|
||||
heredados:
|
||||
foundation:
|
||||
- code: "MGN-001"
|
||||
name: "Auth"
|
||||
status: "100%"
|
||||
- code: "MGN-002"
|
||||
name: "Users"
|
||||
status: "100%"
|
||||
- code: "MGN-003"
|
||||
name: "Roles"
|
||||
status: "100%"
|
||||
- code: "MGN-004"
|
||||
name: "Tenants"
|
||||
status: "100%"
|
||||
|
||||
core_business:
|
||||
- code: "MGN-005"
|
||||
name: "Catalogs"
|
||||
status: "80%"
|
||||
notes: "Extendido con catalogos transporte"
|
||||
- code: "MGN-010"
|
||||
name: "Partners"
|
||||
status: "60%"
|
||||
notes: "Extendido con carriers"
|
||||
- code: "MGN-012"
|
||||
name: "Financial"
|
||||
status: "70%"
|
||||
notes: "Extendido con facturacion transporte"
|
||||
|
||||
saas:
|
||||
- code: "MGN-016"
|
||||
name: "Billing"
|
||||
status: "100%"
|
||||
- code: "MGN-017"
|
||||
name: "Plans"
|
||||
status: "100%"
|
||||
- code: "MGN-018"
|
||||
name: "Webhooks"
|
||||
status: "100%"
|
||||
- code: "MGN-019"
|
||||
name: "Feature Flags"
|
||||
status: "100%"
|
||||
|
||||
ai:
|
||||
- code: "MGN-020"
|
||||
name: "AI Integration"
|
||||
status: "80%"
|
||||
- code: "MGN-021"
|
||||
name: "WhatsApp"
|
||||
status: "100%"
|
||||
- code: "MGN-022"
|
||||
name: "MCP Server"
|
||||
status: "70%"
|
||||
|
||||
propios:
|
||||
fase_1_mai:
|
||||
- code: "MAI-001"
|
||||
name: "Fundamentos"
|
||||
ddl: "-"
|
||||
backend: "100%"
|
||||
frontend: "0%"
|
||||
priority: "Heredado"
|
||||
|
||||
- code: "MAI-002"
|
||||
name: "Clientes y Tarifas"
|
||||
ddl: "0%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "ALTA"
|
||||
|
||||
- code: "MAI-003"
|
||||
name: "Ordenes de Transporte"
|
||||
ddl: "100%"
|
||||
backend: "40%"
|
||||
frontend: "0%"
|
||||
priority: "CRITICA"
|
||||
|
||||
- code: "MAI-004"
|
||||
name: "Planeacion TMS"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "ALTA"
|
||||
|
||||
- code: "MAI-005"
|
||||
name: "Despacho"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "ALTA"
|
||||
|
||||
- code: "MAI-006"
|
||||
name: "Tracking"
|
||||
ddl: "100%"
|
||||
backend: "20%"
|
||||
frontend: "0%"
|
||||
priority: "CRITICA"
|
||||
|
||||
- code: "MAI-007"
|
||||
name: "POD y Cierre"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "ALTA"
|
||||
|
||||
- code: "MAI-008"
|
||||
name: "Incidencias"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "MEDIA"
|
||||
|
||||
- code: "MAI-009"
|
||||
name: "Facturacion Transporte"
|
||||
ddl: "100%"
|
||||
backend: "30%"
|
||||
frontend: "0%"
|
||||
priority: "ALTA"
|
||||
|
||||
- code: "MAI-010"
|
||||
name: "Liquidaciones"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "MEDIA"
|
||||
|
||||
- code: "MAI-011"
|
||||
name: "Gestion de Flota"
|
||||
ddl: "100%"
|
||||
backend: "40%"
|
||||
frontend: "0%"
|
||||
priority: "CRITICA"
|
||||
|
||||
- code: "MAI-012"
|
||||
name: "Combustible y Gastos"
|
||||
ddl: "100%"
|
||||
backend: "50%"
|
||||
frontend: "0%"
|
||||
priority: "MEDIA"
|
||||
|
||||
- code: "MAI-013"
|
||||
name: "Mantenimiento Flota"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "MEDIA"
|
||||
|
||||
- code: "MAI-014"
|
||||
name: "Carriers (Terceros)"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "MEDIA"
|
||||
|
||||
- code: "MAI-015"
|
||||
name: "Portal Cliente"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "BAJA"
|
||||
|
||||
fase_2_mae:
|
||||
- code: "MAE-016"
|
||||
name: "Carta Porte CFDI"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "CRITICA"
|
||||
notes: "Complemento 3.1 obligatorio"
|
||||
|
||||
- code: "MAE-017"
|
||||
name: "HOS y Bitacora"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "ALTA"
|
||||
|
||||
- code: "MAE-018"
|
||||
name: "Reportes y KPIs"
|
||||
ddl: "100%"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "MEDIA"
|
||||
|
||||
fase_3_maa:
|
||||
- code: "MAA-019"
|
||||
name: "Optimizacion Rutas"
|
||||
ddl: "-"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "BAJA"
|
||||
notes: "Fase futura"
|
||||
|
||||
- code: "MAA-020"
|
||||
name: "Integraciones EDI"
|
||||
ddl: "-"
|
||||
backend: "0%"
|
||||
frontend: "0%"
|
||||
priority: "BAJA"
|
||||
notes: "Fase futura"
|
||||
|
||||
critical_path:
|
||||
- "MAI-003: Ordenes de Transporte"
|
||||
- "MAI-006: Tracking"
|
||||
- "MAI-011: Gestion de Flota"
|
||||
- "MAE-016: Carta Porte CFDI"
|
||||
|
||||
last_updated: "2026-01-26"
|
||||
201
orchestration/00-guidelines/HERENCIA-ERP-CORE.md
Normal file
201
orchestration/00-guidelines/HERENCIA-ERP-CORE.md
Normal file
@ -0,0 +1,201 @@
|
||||
# Herencia ERP-Core - ERP Transportistas
|
||||
|
||||
**Version:** 1.0.0
|
||||
**Fecha:** 2026-01-26
|
||||
**Tipo:** CONSUMER (Nivel 2)
|
||||
|
||||
---
|
||||
|
||||
## Relacion de Herencia
|
||||
|
||||
```
|
||||
template-saas (PROVIDER - L0)
|
||||
│
|
||||
▼
|
||||
erp-core (INTERMEDIATE - L1)
|
||||
│
|
||||
├── erp-construccion
|
||||
├── erp-mecanicas-diesel
|
||||
├── erp-clinicas
|
||||
├── erp-retail
|
||||
├── erp-vidrio-templado
|
||||
└── erp-transportistas ◀── ESTE PROYECTO
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Modulos Heredados de erp-core
|
||||
|
||||
### Foundation (100% Heredado)
|
||||
|
||||
| Modulo | Codigo Core | Reutilizacion | Modificaciones |
|
||||
|--------|-------------|---------------|----------------|
|
||||
| Auth | MGN-001 | 100% | Ninguna |
|
||||
| Users | MGN-002 | 100% | Ninguna |
|
||||
| Roles | MGN-003 | 100% | Roles adicionales transporte |
|
||||
| Tenants | MGN-004 | 100% | Ninguna |
|
||||
|
||||
### Core Business (60-70% Heredado)
|
||||
|
||||
| Modulo | Codigo Core | Reutilizacion | Extensiones |
|
||||
|--------|-------------|---------------|-------------|
|
||||
| Catalogs | MGN-005 | 80% | Catalogos vehiculares |
|
||||
| Settings | MGN-006 | 90% | Config GPS/tracking |
|
||||
| Financial | MGN-012 | 70% | Facturacion transporte |
|
||||
| Inventory | MGN-011 | 50% | Combustible, refacciones |
|
||||
| Partners | MGN-010 | 60% | Clientes, carriers |
|
||||
|
||||
### SaaS Features (100% Heredado)
|
||||
|
||||
| Modulo | Codigo Core | Reutilizacion |
|
||||
|--------|-------------|---------------|
|
||||
| Billing | MGN-016 | 100% |
|
||||
| Plans | MGN-017 | 100% |
|
||||
| Webhooks | MGN-018 | 100% |
|
||||
| Feature Flags | MGN-019 | 100% |
|
||||
|
||||
### AI/Intelligence (80% Heredado)
|
||||
|
||||
| Modulo | Codigo Core | Reutilizacion | Extensiones |
|
||||
|--------|-------------|---------------|-------------|
|
||||
| AI Integration | MGN-020 | 80% | Optimizacion rutas |
|
||||
| WhatsApp | MGN-021 | 100% | - |
|
||||
| MCP Server | MGN-022 | 70% | Tools transporte |
|
||||
|
||||
---
|
||||
|
||||
## Modulos Especificos de Transporte (MAI/MAE/MAA)
|
||||
|
||||
### Fase 1 - MAI (Modulo Aplicacion Inicial)
|
||||
|
||||
| Codigo | Nombre | Herencia Core | Status |
|
||||
|--------|--------|---------------|--------|
|
||||
| MAI-001 | Fundamentos | MGN-001 a 004 | Heredado |
|
||||
| MAI-002 | Clientes y Tarifas | MGN-010 ext | Nuevo 30% |
|
||||
| MAI-003 | Ordenes de Transporte | - | Nuevo 100% |
|
||||
| MAI-004 | Planeacion TMS | - | Nuevo 100% |
|
||||
| MAI-005 | Despacho | - | Nuevo 100% |
|
||||
| MAI-006 | Tracking | - | Nuevo 100% |
|
||||
| MAI-007 | POD y Cierre | - | Nuevo 100% |
|
||||
| MAI-008 | Incidencias | - | Nuevo 100% |
|
||||
| MAI-009 | Facturacion Transporte | MGN-012 ext | Nuevo 60% |
|
||||
| MAI-010 | Liquidaciones | - | Nuevo 100% |
|
||||
| MAI-011 | Gestion de Flota | - | Nuevo 100% |
|
||||
| MAI-012 | Combustible y Gastos | MGN-011 ext | Nuevo 70% |
|
||||
| MAI-013 | Mantenimiento Flota | - | Nuevo 100% |
|
||||
| MAI-014 | Carriers (Terceros) | - | Nuevo 100% |
|
||||
| MAI-015 | Portal Cliente | - | Nuevo 100% |
|
||||
|
||||
### Fase 2 - MAE (Modulo Aplicacion Extendido)
|
||||
|
||||
| Codigo | Nombre | Herencia Core | Status |
|
||||
|--------|--------|---------------|--------|
|
||||
| MAE-016 | Carta Porte CFDI | MGN-012 ext | Nuevo 80% |
|
||||
| MAE-017 | HOS y Bitacora | - | Nuevo 100% |
|
||||
| MAE-018 | Reportes y KPIs | MGN-006 ext | Nuevo 50% |
|
||||
|
||||
### Fase 3 - MAA (Modulo Aplicacion Avanzado)
|
||||
|
||||
| Codigo | Nombre | Herencia Core | Status |
|
||||
|--------|--------|---------------|--------|
|
||||
| MAA-019 | Optimizacion Rutas | MGN-020 ext | Futuro |
|
||||
| MAA-020 | Integraciones EDI | - | Futuro |
|
||||
|
||||
---
|
||||
|
||||
## Patrones Reutilizados
|
||||
|
||||
### Desde erp-core
|
||||
|
||||
1. **Multi-Tenancy con RLS**
|
||||
- Aislamiento por tenant_id
|
||||
- Politicas RLS en todas las tablas
|
||||
- Header X-Tenant-ID
|
||||
|
||||
2. **Estructura de Modulos Backend**
|
||||
```
|
||||
module/
|
||||
├── entities/
|
||||
├── services/
|
||||
├── controllers/
|
||||
├── dto/
|
||||
└── index.ts
|
||||
```
|
||||
|
||||
3. **Naming Conventions**
|
||||
- Entities: PascalCase singular
|
||||
- Tables: snake_case plural
|
||||
- Services: PascalCase + Service
|
||||
- Controllers: PascalCase + Controller
|
||||
|
||||
4. **API REST Standards**
|
||||
- Versionado: /api/v1/
|
||||
- Pagination: limit, offset
|
||||
- Sorting: sort, order
|
||||
- Filtering: field=value
|
||||
|
||||
---
|
||||
|
||||
## Schemas de Base de Datos
|
||||
|
||||
### Heredados de erp-core
|
||||
- auth
|
||||
- catalog
|
||||
- settings
|
||||
- billing
|
||||
- ai
|
||||
|
||||
### Especificos de Transporte
|
||||
- transport (ordenes, embarques, viajes)
|
||||
- fleet (unidades, operadores)
|
||||
- tracking (eventos, geofences)
|
||||
- fuel (cargas combustible)
|
||||
- maintenance (mantenimiento flota)
|
||||
- carriers (transportistas terceros)
|
||||
- billing_transport (facturacion especializada)
|
||||
- compliance (HOS, carta porte)
|
||||
|
||||
---
|
||||
|
||||
## Directivas Heredadas
|
||||
|
||||
1. `DIRECTIVA-MULTI-TENANT.md` - Obligatoria
|
||||
2. `DIRECTIVA-EXTENSION-VERTICALES.md` - Obligatoria
|
||||
3. `ESTANDARES-API-REST-GENERICO.md` - Obligatoria
|
||||
4. `TRIGGER-COHERENCIA-CAPAS.md` - Obligatoria
|
||||
5. `TRIGGER-INVENTARIOS.md` - Obligatoria
|
||||
|
||||
---
|
||||
|
||||
## Propagacion de Cambios
|
||||
|
||||
### Desde erp-core
|
||||
|
||||
| Tipo Cambio | Propagacion | SLA |
|
||||
|-------------|-------------|-----|
|
||||
| Security Fix | FORZADA | 24h |
|
||||
| Bug Fix Critico | INMEDIATA | 48h |
|
||||
| Feature Nuevo | EVALUADA | 2 semanas |
|
||||
| Breaking Change | PLANIFICADA | 1 mes |
|
||||
| Docs | INMEDIATA | 1 dia |
|
||||
|
||||
### Proceso
|
||||
|
||||
1. Monitorear cambios en erp-core
|
||||
2. Evaluar impacto en modulos heredados
|
||||
3. Aplicar cambios manteniendo extensiones locales
|
||||
4. Validar build + lint + tests
|
||||
5. Documentar en PROPAGATION-LOG
|
||||
|
||||
---
|
||||
|
||||
## Referencias
|
||||
|
||||
- `workspace-v2/orchestration/directivas/simco/PROPAGATION-RULES.md`
|
||||
- `workspace-v2/orchestration/inventarios/REUSABLE-CODE-INVENTORY.yml`
|
||||
- `erp-core/orchestration/directivas/DIRECTIVA-EXTENSION-VERTICALES.md`
|
||||
|
||||
---
|
||||
|
||||
*Ultima actualizacion: 2026-01-26*
|
||||
*Agente: claude-code-orquestador*
|
||||
28
orchestration/directivas/README.md
Normal file
28
orchestration/directivas/README.md
Normal file
@ -0,0 +1,28 @@
|
||||
# Directivas Locales - ERP Transportistas
|
||||
|
||||
## Herencia
|
||||
|
||||
Este proyecto hereda directivas de:
|
||||
1. `workspace-v2/orchestration/directivas/` - Directivas globales SIMCO
|
||||
2. `erp-core/orchestration/directivas/` - Directivas ERP genericas
|
||||
|
||||
## Directivas Heredadas (Obligatorias)
|
||||
|
||||
| Directiva | Ubicacion | Proposito |
|
||||
|-----------|-----------|-----------|
|
||||
| DIRECTIVA-MULTI-TENANT | erp-core | Aislamiento por tenant |
|
||||
| DIRECTIVA-EXTENSION-VERTICALES | erp-core | Patron de extension |
|
||||
| ESTANDARES-API-REST-GENERICO | erp-core | Estandares API |
|
||||
| TRIGGER-COHERENCIA-CAPAS | erp-core | DDL-Entity-Controller |
|
||||
| TRIGGER-INVENTARIOS | erp-core | Sincronizacion inventarios |
|
||||
|
||||
## Directivas Locales
|
||||
|
||||
Crear aqui directivas especificas de transporte:
|
||||
- DIRECTIVA-CARTA-PORTE.md
|
||||
- DIRECTIVA-TRACKING-GPS.md
|
||||
- DIRECTIVA-INTEGRACIONES-EDI.md
|
||||
|
||||
---
|
||||
|
||||
*Creado: 2026-01-26*
|
||||
26
orchestration/trazas/README.md
Normal file
26
orchestration/trazas/README.md
Normal file
@ -0,0 +1,26 @@
|
||||
# Trazas - ERP Transportistas
|
||||
|
||||
## Proposito
|
||||
|
||||
Carpeta para tracking de actividades de agentes y tareas en progreso.
|
||||
|
||||
## Archivos de Traza
|
||||
|
||||
| Archivo | Proposito |
|
||||
|---------|-----------|
|
||||
| TRAZA-TAREAS-BACKEND.md | Historial tareas backend |
|
||||
| TRAZA-TAREAS-DATABASE.md | Historial tareas DDL |
|
||||
| TRAZA-TAREAS-FRONTEND.md | Historial tareas frontend |
|
||||
| ACTIVE-FILES.yml | Archivos en edicion activa (multi-agente) |
|
||||
| BLOCKED-TASKS.yml | Tareas bloqueadas |
|
||||
|
||||
## Uso
|
||||
|
||||
Los agentes deben actualizar las trazas al:
|
||||
- Iniciar una tarea
|
||||
- Completar una tarea
|
||||
- Encontrar un bloqueo
|
||||
|
||||
---
|
||||
|
||||
*Creado: 2026-01-26*
|
||||
Loading…
Reference in New Issue
Block a user