ec43d9c6cd
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>
146 lines
5.5 KiB
Markdown
146 lines
5.5 KiB
Markdown
# 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
|