Caso Simulado: De la Frustración Operativa al Documento SRS
Explora cómo una empresa de distribución de alimentos congelados con pérdidas diarias traduce sus cuellos de botella en una Especificación de Software vinculante bajo la norma ISO/IEC/IEEE 29148.
Un Día Caótico en Alimentos & Frigoríficos San Rafael (AFSR)
Alimentos & Frigoríficos San Rafael abastece a más de 180 restaurantes, hoteles y carnicerías. En el último año crecieron un 45%, pero siguen operando con mensajes de WhatsApp, libretas de papel carbón y una hoja de Excel compartida llamada PEDIDOS_HOY_FINAL_v3_CORREGIDO.xlsx.
Los Protagonistas
Don Roberto
Director General"Estamos perdiendo dinero y clientes por devoluciones de producto descompuesto y pedidos fantasma."
Laura Gómez
Jefa de LogísticaPasa de 6:30 PM a 9:00 PM conciliando notas arrugadas y mensajes de voz en una hoja de Excel.
Carlos Mendoza
Jefe de Cámaras FríasArma tarimas a $-18^\circ\text{C}$ con guantes térmicos gruesos y lapiceros que se congelan y no rayan.
Miguel Ramos
Chofer de RepartoReparte en zonas sin señal de internet con hojas de papel carbón que se mojan con el hielo derretido.
Los 3 Incidentes Críticos del Día
Dos vendedores, Jorge y Patricia, venden simultáneamente 40 cajas y 35 cajas de costilla de cerdo. En almacén solo había 45 cajas físicas en total. El hotel se queda sin producto para su banquete y cancela el contrato.
[RF-01] Bloqueo y reserva transaccional de stock con expiración de 15 minutos en el catálogo central.
Doña Carmen (dueña de restaurante) devuelve 3 cajas descongeladas y firma en una hoja de papel carbón empapada por el hielo. El papel se rompe y se pierde. Tres días después niega haber recibido la mercancía y la empresa pierde $4,800 MXN.
[RF-05] y [RF-06] App móvil con captura obligatoria de fotos de rechazo, firma táctil POD y coordenadas GPS.
Los choferes entregan en sótanos de centros comerciales sin cobertura 4G/5G. Las entregas no se registran y Laura no sabe cuánto dinero en efectivo recaudaron hasta las 9:00 PM.
[RF-04] y [RF-07] Arquitectura Offline-First con base de datos local SQLite cifrada y motor de sincronización automática al recuperar red.
ColdTrack & Orders (CTO)
Sistema Integral de Gestión de Pedidos, Almacén y Rutas Frigoríficas
1. Introducción
1.1 Propósito
El propósito de este documento es definir formalmente los requerimientos funcionales, no funcionales, interfaces de comunicación y restricciones arquitectónicas para el desarrollo del sistema ColdTrack & Orders (CTO v1.0), sirviendo como contrato técnico vinculante entre Alimentos San Rafael y el equipo de ingeniería.
1.2 Alcance del Producto
| Dentro del Alcance (v1.0) | Fuera de Alcance (Exclusiones v1.0) |
|---|---|
| • Portal Web de pedidos y asignación de rutas en vivo. | • Facturación fiscal electrónica directa (se exportará CSV/JSON para ERP). |
| • App móvil Android con soporte Offline-First para choferes. | • Pasarela de cobro bancario con tarjeta en punto de venta. |
| • Comprobante Digital de Entrega (POD) con fotos y firma. | • Aplicación nativa para sistema operativo iOS. |
| • Control de stock con reserva transaccional de 15 min. | • Ruteo dinámico con inteligencia artificial predictiva. |
1.3 Definiciones y Acrónimos
- POD (Proof of Delivery): Evidencia digital que certifica la recepción (firma, foto y GPS).
- Picking: Proceso de surtido y escaneo de productos en almacén.
- Offline-First: Capacidad de operar sin internet y sincronizar al reconectar.
2. Descripción General
2.1 Perfiles de Usuario
| Rol | Nivel TI | Dispositivo | Responsabilidad |
|---|---|---|---|
| Ejecutivo de Ventas | Básico | Web / Tablet | Levantamiento de pedidos y consulta de saldo cliente. |
| Operador de Almacén | Básico | Terminal Rugerizada | Escaneo de códigos de barras a $-18^\circ\text{C}$ con guantes. |
| Chofer de Reparto | Básico | Smartphone Android | Entrega en ruta, cobro de efectivo y firma POD. |
| Gerente de Logística | Avanzado | PC Escritorio 1080p | Monitoreo en vivo de rutas y liquidación de cajas. |
3. Requerimientos Funcionales Específicos
Sintaxis EARS: Cuando un ejecutivo de ventas agregue un producto a una orden en borrador, el sistema debe apartar las unidades del catálogo general por un lapso máximo de 15 minutos.
Sintaxis EARS: Cuando el operario escanee una caja en cámara fría, el sistema debe verificar que el código SKU y número de lote coincidan con la orden antes de marcar el ítem como completado.
Sintaxis EARS: Mientras el smartphone del chofer permanezca sin señal de internet, la app móvil debe permitir consultar la hoja de ruta, registrar firmas táctiles y almacenar fotografías en base de datos SQLite cifrada.
Sintaxis EARS: Si el cliente rechaza mercancía por descongelamiento o daño físico, el sistema debe exigir ingresar el motivo, capturar al menos 1 fotografía obligatoria y recalcular el importe a cobrar en ese instante.
Sintaxis EARS: Cuando el dispositivo móvil detecte conectividad de red, el sistema debe transmitir en segundo plano todos los eventos locales pendientes en un plazo no mayor a 10 segundos.
4. Requisitos No Funcionales (Métricas SMART)
| ID | Atributo | Métrica Cuantitativa Verificable |
|---|---|---|
| RNF-01 | Rendimiento | Tiempo de respuesta $< 1.2\text{s}$ para el $P_{95}$ con 150 usuarios simultáneos. |
| RNF-02 | Disponibilidad | $99.7\%$ de Uptime mensual en horario operativo (05:00 a 23:00 hrs). |
| RNF-03 | Seguridad | TLS 1.3 para APIs y base de datos móvil SQLite cifrada en reposo con AES-256. |
| RNF-04 | Batería | Consumo GPS menor al $18\%$ de batería en una jornada completa de 8 horas. |
| RNF-05 | Integridad | Cero firmas o fotos perdidas ante cortes abruptos de energía o reinicio del teléfono. |
5. Matriz de Modos de Falla y Riesgo (FMEA)
$\text{RPN} = \text{Severidad (S)} \times \text{Ocurrencia (O)} \times \text{Detección (D)}$
| ID | Modo de Falla | S | O | D | RPN | Mitigación Obligatoria en Software |
|---|---|---|---|---|---|---|
| F-01 | Pérdida de firma por caída de red en sótano | 9 | 8 | 2 | 144 | Arquitectura Offline-First con persistencia local SQLite. |
| F-02 | Venta concurrente de stock inexistente | 8 | 7 | 4 | 224 | Bloqueo transaccional de 15 minutos en base de datos. |
| F-03 | Lectura errónea de lote caducado | 10 | 4 | 5 | 200 | Bloqueo automático de escáner si caducidad es menor a 15 días. |
6. Matriz de Trazabilidad (RTM)
| ID Requisito | Nombre | Caso de Uso | Test Case QA | Estado |
|---|---|---|---|---|
| RF-01 | Reserva Stock Temporal | CU-VENTAS-01 | TC-STOCK-001 | Aprobado |
| RF-04 | Operación Móvil Offline | CU-RUTA-01 | TC-OFFLINE-001 | Aprobado |
| RF-05 | Entrega Parcial & Fotos | CU-RUTA-04 | TC-POD-003 | Aprobado |
7. Aprobación y Firmas de las Partes
Director General (AFSR)
[Firmado Digitalmente]Jefa de Operaciones Logísticas
[Firmado Digitalmente]Líder Técnico de Desarrollo
[Firmado Digitalmente]