# 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