erp-transportistas-v2/docs/02-definicion-modulos/MAI-013-mantenimiento-flota/historias-usuario/US-MAI013-002.md
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

202 lines
8.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# US-MAI013-002: Gestionar orden de trabajo correctivo
**ID:** US-MAI013-002
**Modulo:** MAI-013 (Mantenimiento)
**Prioridad:** Alta
**Story Points:** 8
---
## Historia de Usuario
**Como** jefe de mantenimiento
**Quiero** gestionar ordenes de trabajo para fallas correctivas
**Para** reparar unidades de forma controlada y trazable
---
## Criterios de Aceptacion
### CA-001: Crear ticket de falla
**Dado** que una unidad tiene una falla
**Cuando** se reporta
**Entonces** se crea ticket con descripcion, fotos y prioridad
### CA-002: Diagnosticar y crear OT
**Dado** que hay un ticket de falla
**Cuando** el mecanico diagnostica
**Entonces** se crea OT con trabajos, refacciones y tiempo estimado
### CA-003: Ejecutar OT
**Dado** que hay una OT aprobada
**Cuando** el mecanico trabaja
**Entonces** registra avances, refacciones usadas y tiempo real
### CA-004: Cerrar OT con pruebas
**Dado** que se completo el trabajo
**Cuando** se cierra la OT
**Entonces** se documentan pruebas realizadas y fotos
### CA-005: Liberar unidad
**Dado** que la OT esta cerrada
**Cuando** se aprueba
**Entonces** la unidad cambia a DISPONIBLE
---
## Mockup / UI
### Ticket de Falla
```
+----------------------------------------------------------+
| REPORTAR FALLA X |
+----------------------------------------------------------+
| |
| Unidad: [T-1025 - Kenworth T680 v] |
| |
| Ubicacion actual: |
| (o) En patio |
| ( ) En ruta - especificar ubicacion |
| |
| ------------------------------------------------------ |
| |
| DESCRIPCION DE LA FALLA |
| |
| Tipo: [Frenos v] |
| o Motor |
| o Frenos |
| o Suspension |
| o Electrico |
| o Llantas |
| o Transmision |
| o Aire acondicionado |
| o Carroceria |
| o Otro |
| |
| Descripcion: |
| [Ruido metalico al frenar. Se siente vibracion ]|
| [en el pedal. Posibles balatas gastadas. ]|
| |
| Prioridad: |
| ( ) CRITICA - Unidad parada / Seguridad |
| (o) ALTA - Afecta operacion |
| ( ) MEDIA - Funciona con limitaciones |
| ( ) BAJA - Estetico / menor |
| |
| ------------------------------------------------------ |
| |
| EVIDENCIAS |
| |
| [+ Agregar foto] [+ Agregar video] |
| |
| [IMG] falla_freno_1.jpg |
| |
| [Cancelar] [Reportar Falla] |
| |
+----------------------------------------------------------+
```
### Orden de Trabajo
```
+----------------------------------------------------------+
| ORDEN DE TRABAJO - OT-2026-0125 |
+----------------------------------------------------------+
| |
| Unidad: T-1025 | Kenworth T680 |
| Tipo: CORRECTIVO |
| Prioridad: ALTA |
| Estado: EN_EJECUCION |
| |
| Origen: Ticket #TKT-0089 - Falla en frenos |
| |
| ------------------------------------------------------ |
| |
| DIAGNOSTICO |
| |
| Mecanico: Pedro Martinez |
| Fecha: 27-ene-2026 08:30 |
| |
| Hallazgos: |
| - Balatas delanteras desgastadas al 95% |
| - Disco delantero derecho con ranuras |
| - Liquido de frenos bajo nivel |
| |
| ------------------------------------------------------ |
| |
| TRABAJOS A REALIZAR |
| |
| [x] Cambio de balatas delanteras (2 pz) |
| [x] Rectificado de disco delantero |
| [x] Cambio de liquido de frenos |
| [ ] Purga de sistema |
| |
| Tiempo estimado: 4 horas |
| Tiempo real: 3.5 horas |
| |
| ------------------------------------------------------ |
| |
| REFACCIONES |
| |
| | Refaccion | Cant | Stock | Costo | |
| |---------------------|------|-------|---------| |
| | Balatas del. KW | 2 | [8] | $1,200 | |
| | Liquido frenos DOT4 | 2L | [15] | $350 | |
| |---------------------|------|-------|---------| |
| | TOTAL REFACCIONES | $1,550 | |
| |
| ------------------------------------------------------ |
| |
| COSTOS |
| |
| Mano de obra (3.5h × $150): $525.00 |
| Refacciones: $1,550.00 |
| Servicio externo (rectificado): $400.00 |
| ───────────────────────────────────────────── |
| TOTAL OT: $2,475.00 |
| |
| ------------------------------------------------------ |
| |
| [Agregar trabajo] [Agregar refaccion] |
| |
| [Cancelar OT] [Cerrar y Liberar Unidad] |
| |
+----------------------------------------------------------+
```
---
## Flujo de Estados OT
```
CREADA → DIAGNOSTICO → APROBADA → EN_EJECUCION →
PENDIENTE_REFACCION ←─────────────────────
COMPLETADA → PRUEBAS → CERRADA → LIBERADA
```
---
## Notas Tecnicas
- Tabla: `maintenance.tickets_falla`
- Tabla: `maintenance.ordenes_trabajo`
- Tabla: `maintenance.lineas_ot`
- Relacion con `maintenance.refacciones`
- Actualiza `fleet.unidades.estado`
---
## Definicion de Done
- [ ] Crear ticket de falla con fotos
- [ ] Diagnostico por mecanico
- [ ] Crear OT con trabajos y refacciones
- [ ] Registro de ejecucion y avances
- [ ] Consumo de refacciones del stock
- [ ] Cierre con pruebas y fotos
- [ ] Liberacion automatica de unidad
- [ ] Tests de flujo completo