MII-006: Reportes de Inventario
id: MII-006
type: Epic
status: Pendiente
priority: P0
phase: 1
story_points: 13
created_date: 2026-01-10
updated_date: 2026-01-10
simco_version: "4.0.0"
Metadata
| Campo |
Valor |
| ID |
MII-006 |
| Nombre |
Reportes de Inventario |
| Fase |
1 - MVP Core |
| Prioridad |
P0 |
| Story Points |
13 |
| Estado |
Pendiente |
1. Descripcion
Implementar la visualizacion de resultados de inventario, historial de sesiones, y exportacion de reportes en formatos utiles para el usuario.
Objetivo
Permitir a los usuarios ver, analizar y exportar los resultados de sus inventarios de forma clara y util.
2. Requerimientos Relacionados
| RF |
Descripcion |
Prioridad |
| FR-050 |
Resultado por sesion (SKU, cantidad, confianza, evidencias) |
P0 |
| FR-051 |
Exportacion PDF/CSV y compartir via WhatsApp |
P2 |
| FR-052 |
Historial por fecha, tienda, totales, variaciones |
P1 |
3. Criterios de Aceptacion
AC-001: Ver Resultado de Sesion
DADO que una sesion de inventario esta completa (DONE)
CUANDO abro el reporte
ENTONCES veo una lista de productos con:
- Nombre del producto
- Presentacion
- Cantidad detectada
- Nivel de confianza (alto/medio/bajo)
- Thumbnail de evidencia
AC-002: Filtrar y Ordenar
DADO que estoy viendo un reporte
CUANDO aplico filtros
ENTONCES puedo filtrar por:
- Categoria
- Nivel de confianza
- Estado (detectado, duda, desconocido)
Y puedo ordenar por nombre, cantidad o confianza
AC-003: Ver Evidencia
DADO que veo un item en el reporte
CUANDO toco el item
ENTONCES puedo ver:
- Frames donde fue detectado
- Bounding boxes resaltados
- Fotos close-up si existen
AC-004: Exportar PDF
DADO que tengo un reporte completo
CUANDO selecciono "Exportar PDF"
ENTONCES se genera un PDF con:
- Fecha y tienda
- Lista de productos
- Totales y resumen
Y puedo guardarlo o compartirlo
AC-005: Exportar CSV
DADO que tengo un reporte completo
CUANDO selecciono "Exportar CSV"
ENTONCES se genera un archivo CSV
Y puedo importarlo en Excel o Google Sheets
AC-006: Compartir por WhatsApp
DADO que tengo un reporte
CUANDO selecciono "Compartir"
ENTONCES puedo enviar un resumen por WhatsApp
Y/o el archivo PDF adjunto
AC-007: Ver Historial
DADO que he realizado multiples inventarios
CUANDO voy al historial
ENTONCES veo lista de sesiones por fecha
Y puedo ver totales por sesion
Y puedo comparar variaciones entre sesiones
4. Tareas Tecnicas
| ID |
Tarea |
Estimacion |
Estado |
| T-001 |
Crear pantalla de resultado de sesion |
2 SP |
Pendiente |
| T-002 |
Implementar lista de items con filtros |
2 SP |
Pendiente |
| T-003 |
Crear visor de evidencias |
2 SP |
Pendiente |
| T-004 |
Implementar generacion de PDF |
2 SP |
Pendiente |
| T-005 |
Implementar exportacion CSV |
1 SP |
Pendiente |
| T-006 |
Integrar share nativo (WhatsApp) |
1 SP |
Pendiente |
| T-007 |
Crear pantalla de historial |
2 SP |
Pendiente |
| T-008 |
Implementar comparador de variaciones |
1 SP |
Pendiente |
5. Endpoints API
| Metodo |
Endpoint |
Descripcion |
Auth |
| GET |
/inventory/sessions |
Listar sesiones (historial) |
JWT |
| GET |
/inventory/sessions/:id |
Detalle de sesion |
JWT |
| GET |
/inventory/sessions/:id/items |
Items de sesion |
JWT |
| GET |
/inventory/sessions/:id/export/pdf |
Exportar PDF |
JWT |
| GET |
/inventory/sessions/:id/export/csv |
Exportar CSV |
JWT |
| GET |
/inventory/sessions/compare |
Comparar sesiones |
JWT |
6. Pantallas Mobile
| Pantalla |
Componentes |
| SessionResultScreen |
Lista items, resumen, acciones |
| ItemDetailScreen |
Evidencias, frames, bounding boxes |
| HistoryScreen |
Lista sesiones, filtros fecha/tienda |
| CompareScreen |
Comparar 2 sesiones, variaciones |
| ExportModal |
Opciones PDF/CSV/WhatsApp |
7. Estructura del Reporte PDF
┌─────────────────────────────────────────────────────────────────┐
│ MIINVENTARIO │
│ Reporte de Inventario │
├─────────────────────────────────────────────────────────────────┤
│ │
│ Tienda: La Tiendita de Don Pepe │
│ Fecha: 10 de Enero, 2026 10:30 AM │
│ Sesion: #MII-2026-0110-001 │
│ │
├─────────────────────────────────────────────────────────────────┤
│ RESUMEN │
│ ─────── │
│ Total Productos: 45 │
│ Total Unidades: 312 │
│ Confianza Promedio: 87% │
│ Productos con Duda: 5 │
│ │
├─────────────────────────────────────────────────────────────────┤
│ DETALLE │
│ ─────── │
│ # | Producto | Presentacion | Cantidad | Conf │
│ 1 | Coca-Cola | 600ml | 24 | 95% │
│ 2 | Sabritas Original | 45g | 15 | 92% │
│ 3 | Bimbo Pan Blanco | 680g | 8 | 88% │
│ ... │
│ │
├─────────────────────────────────────────────────────────────────┤
│ PRODUCTOS CON DUDA (Requieren confirmacion) │
│ ─────────────────── │
│ # | Producto | Presentacion | Cantidad | Conf │
│ 1 | Producto Desconocido | - | 3 | 45% │
│ ... │
│ │
└─────────────────────────────────────────────────────────────────┘
Generado por MiInventario
8. Estructura CSV
session_id,date,store_name,product_id,product_name,brand,category,presentation,quantity,confidence,status
"uuid-1","2026-01-10T10:30:00Z","Tienda Don Pepe","prod-1","Coca-Cola","Coca-Cola","Bebidas","600ml",24,0.95,"DETECTED"
"uuid-1","2026-01-10T10:30:00Z","Tienda Don Pepe","prod-2","Sabritas","Sabritas","Snacks","45g",15,0.92,"DETECTED"
...
9. Comparacion de Variaciones
| Metrica |
Sesion 1 |
Sesion 2 |
Variacion |
| Total productos |
45 |
42 |
-3 |
| Total unidades |
312 |
298 |
-14 |
| Coca-Cola 600ml |
24 |
18 |
-6 |
| Sabritas 45g |
15 |
20 |
+5 |
10. Dependencias
Entrada (Requiere)
- MII-001: Infraestructura Base
- MII-002: Autenticacion
- MII-003: Gestion de Tiendas
- MII-004: Captura de Video
- MII-005: Procesamiento IA
Salida (Bloquea)
- MII-007: Retroalimentacion (usa la UI de reporte)
11. Librerias Sugeridas
| Funcion |
Libreria |
| PDF Generation |
react-native-html-to-pdf |
| CSV Generation |
papaparse |
| Share |
react-native-share |
| Charts (opcional) |
react-native-chart-kit |
12. Riesgos
| Riesgo |
Probabilidad |
Impacto |
Mitigacion |
| PDF lento en listas grandes |
Media |
Bajo |
Paginacion, lazy load |
| Imagenes pesadas |
Media |
Medio |
Thumbnails, lazy load |
| Formato CSV incompatible |
Baja |
Bajo |
Estandar RFC 4180 |
13. Notas de Implementacion
- Usar paginacion para historial largo
- Cachear thumbnails de evidencia
- Considerar modo offline para ver reportes guardados
- WhatsApp share puede usar deep link o share nativo
14. Referencias
Ultima Actualizacion: 2026-01-10
rckrdmrd
1a53b5c4d3