workspace-v1/projects/erp-mecanicas-diesel/docs/02-definicion-modulos/MMD-005-vehiculos/historias-usuario/US-MMD005-006-flotas.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

2.6 KiB

US-MMD005-006: Gestionar Flotas de Vehiculos

Metadata

Campo Valor
ID US-MMD005-006
Epica EPIC-MMD-005 - Vehiculos y Flotas
Modulo vehiculos
Prioridad P1
Story Points 5
Sprint Sprint 6
Estado Backlog

Historia de Usuario

Como administrador, quiero agrupar vehiculos por flota o empresa, para gestionar clientes con multiples unidades y generar reportes consolidados.

Descripcion Detallada

Los clientes empresariales pueden tener flotas de vehiculos. El sistema debe permitir agruparlos, aplicar condiciones comerciales por flota, y generar reportes consolidados.


Criterios de Aceptacion

Escenario 1: Crear flota

DADO que registro cliente empresarial
CUANDO creo flota:
  | Nombre | Transportes del Norte |
  | Contacto | Juan Perez |
  | Vehiculos | 25 |
  | Condicion pago | Credito 30 dias |
ENTONCES se crea la flota

Escenario 2: Asignar vehiculos a flota

DADO que tengo flota creada
CUANDO asigno vehiculos:
  | Vehiculo | Numero economico |
  | Kenworth T680 | TN-001 |
  | Freightliner Cascadia | TN-002 |
ENTONCES se vinculan a la flota

Escenario 3: Dashboard de flota

DADO que accedo a la flota
CUANDO veo dashboard
ENTONCES muestra:
  | Metrica | Valor |
  | Total vehiculos | 25 |
  | En servicio | 3 |
  | Servicios mes | 8 |
  | Facturado mes | $45,000 |

Escenario 4: Condiciones comerciales

DADO que configuro condiciones de flota
CUANDO defino:
  | Descuento mano obra | 10% |
  | Descuento refacciones | 5% |
  | Credito | 30 dias |
ENTONCES se aplica automaticamente
A todas las ordenes de la flota

Escenario 5: Reporte consolidado

DADO que necesito reporte para cliente
CUANDO genero reporte de flota
ENTONCES muestra:
  - Servicios realizados por vehiculo
  - Costos totales
  - Comparativo mensual
  - Estado de cuenta

Tareas Tecnicas

Database:

  • DB-101: Crear tabla fleets
  • DB-102: Relacion vehicles -> fleet

Backend:

  • BE-200: CRUD flotas
  • BE-201: Dashboard de flota
  • BE-202: Condiciones comerciales
  • BE-203: Reportes consolidados

Frontend:

  • FE-197: Crear FleetManagement page
  • FE-198: Crear FleetDashboard
  • FE-199: Crear FleetConditions form
  • FE-200: Crear FleetReports

Definition of Done (DoD)

  • CRUD de flotas
  • Asignar vehiculos
  • Dashboard de flota
  • Condiciones comerciales
  • Reporte consolidado
  • Tests pasando

Creada por: Requirements-Analyst Fecha: 2025-12-06