# US-MAI014-001: Registrar y validar carrier

**ID:** US-MAI014-001
**Modulo:** MAI-014 (Carriers)
**Prioridad:** Alta
**Story Points:** 5

---

## Historia de Usuario

**Como** carrier manager
**Quiero** registrar carriers con su documentacion
**Para** tener un pool de terceros validados para subcontratar

---

## Criterios de Aceptacion

### CA-001: Registrar datos del carrier
**Dado** que tengo un nuevo carrier potencial
**Cuando** lo registro
**Entonces** capturo datos fiscales, contacto, bancarios y operativos

### CA-002: Cargar documentos obligatorios
**Dado** que el carrier debe tener documentos vigentes
**Cuando** completo el registro
**Entonces** cargo permiso SCT, poliza y constancia fiscal

### CA-003: Validar vigencias
**Dado** que los documentos tienen fecha de vencimiento
**Cuando** el sistema verifica
**Entonces** alerta si estan proximos a vencer o vencidos

### CA-004: Aprobar o rechazar carrier
**Dado** que revise la documentacion
**Cuando** decido
**Entonces** puedo aprobar (activo) o rechazar con motivo

### CA-005: Bloquear si documento vence
**Dado** que un documento expiro
**Cuando** el job verifica
**Entonces** el carrier pasa a estado BLOQUEADO

---

## Mockup / UI

```
+----------------------------------------------------------+
| REGISTRAR CARRIER                                     X  |
+----------------------------------------------------------+
|                                                          |
|  DATOS FISCALES                                         |
|                                                          |
|  RFC: [TRA990101AB1                ]                    |
|  Razon social: [Transportes del Norte SA de CV       ] |
|  Regimen fiscal: [General de ley personas morales  v]  |
|                                                          |
|  Domicilio fiscal:                                      |
|  [Av. Industrial 500, Parque Ind. Monterrey         ]  |
|  CP: [64000   ]  Ciudad: [Monterrey, NL            ]   |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  CONTACTO                                               |
|                                                          |
|  Contacto comercial: [Roberto Garza Martinez        ]  |
|  Telefono: [81 1234 5678    ]  Email: [rgarza@...   ]  |
|                                                          |
|  Contacto operativo: [Mario Lopez                   ]  |
|  Telefono: [81 8765 4321    ]  Email: [mlopez@...   ]  |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DATOS BANCARIOS                                        |
|                                                          |
|  Banco: [BBVA                     v]                   |
|  CLABE: [012580001234567890]                           |
|  Beneficiario: [Transportes del Norte SA de CV      ]  |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  CAPACIDADES OPERATIVAS                                 |
|                                                          |
|  Tipos de equipo:                                       |
|  [x] Caja seca 53'                                     |
|  [x] Caja refrigerada                                  |
|  [ ] Plataforma                                        |
|  [ ] Tanque                                            |
|                                                          |
|  Cobertura: [Nacional               v]                 |
|  Unidades disponibles: [15     ]                       |
|                                                          |
|  ------------------------------------------------------ |
|                                                          |
|  DOCUMENTOS                                             |
|                                                          |
|  | Documento          | Archivo    | Vigencia   | Est ||
|  |--------------------|------------|------------|-----||
|  | Constancia fiscal  | [Cargar]   | -          | -   ||
|  | Permiso SCT*       | [Cargar]   | [________] | -   ||
|  | Poliza seguro*     | [Cargar]   | [________] | -   ||
|  | Opinion 32-D       | [Cargar]   | [________] | -   ||
|                                                          |
|  * Documento obligatorio                               |
|                                                          |
|  [Cancelar]                        [Guardar Carrier]   |
|                                                          |
+----------------------------------------------------------+
```

---

## Estados del Carrier

| Estado | Puede asignarse | Descripcion |
|--------|-----------------|-------------|
| PENDIENTE | No | En revision |
| ACTIVO | Si | Documentos OK |
| BLOQUEADO | No | Documento vencido |
| SUSPENDIDO | No | Por desempeno |
| INACTIVO | No | Baja voluntaria |

---

## Notas Tecnicas

- Tabla: `carriers.carriers`
- Tabla: `carriers.documentos_carrier`
- Tabla: `carriers.contactos_carrier`
- Job: `check-carrier-documents.job.ts` (diario)
- Validar RFC con SAT (opcional)

---

## Definicion de Done

- [ ] Formulario de registro completo
- [ ] Carga de documentos obligatorios
- [ ] Validacion de vigencias
- [ ] Estados del carrier
- [ ] Bloqueo automatico por vencimiento
- [ ] Alertas de documentos por vencer
- [ ] Tests de registro y validacion