257 lines
8.6 KiB
Markdown
257 lines
8.6 KiB
Markdown
# MiInventario - Mapa de Documentacion
|
|
|
|
---
|
|
id: MAP-DOCS-MII
|
|
type: Index
|
|
status: Published
|
|
version: "1.1.0"
|
|
created_date: 2026-01-10
|
|
updated_date: 2026-01-16
|
|
simco_version: "4.0.0"
|
|
---
|
|
|
|
## Resumen Ejecutivo
|
|
|
|
| Campo | Valor |
|
|
|-------|-------|
|
|
| **Proyecto** | MiInventario |
|
|
| **Codigo** | MII |
|
|
| **Tipo** | Standalone SaaS |
|
|
| **Estado** | En Planificacion |
|
|
| **Total Epicas** | 15 |
|
|
| **Total Integraciones** | 6 |
|
|
| **Version SIMCO** | 4.0.0 |
|
|
|
|
---
|
|
|
|
## Estructura de Documentacion
|
|
|
|
```
|
|
docs/
|
|
│
|
|
├── _definitions/ # DEFINICIONES CANONICAS
|
|
│ ├── _INDEX.yml # Indice de definiciones (@PROJ_DEF_INDEX)
|
|
│ ├── DATABASE-SCHEMA.md # Schema BD (@PROJ_DEF_DB)
|
|
│ ├── ENTITIES-CATALOG.md # Entidades (@PROJ_DEF_ENTITIES)
|
|
│ ├── SERVICES-CATALOG.md # Servicios (@PROJ_DEF_SERVICES)
|
|
│ └── MODULES-CATALOG.md # Modulos (@PROJ_DEF_MODULES)
|
|
│
|
|
├── _quick/ # NAVEGACION RAPIDA
|
|
│ ├── QUICK-INDEX.yml # Indice rapido (@PROJ_QUICK_INDEX)
|
|
│ ├── QUICK-API.yml # API endpoints (@PROJ_QUICK_API)
|
|
│ ├── QUICK-DATABASE.yml # BD rapido (@PROJ_QUICK_DATABASE)
|
|
│ └── QUICK-MODULES.yml # Modulos rapido (@PROJ_QUICK_MODULES)
|
|
│
|
|
├── 00-vision-general/ # VISION Y CONTEXTO
|
|
│ ├── _MAP.md # Indice de vision
|
|
│ ├── VISION-PROYECTO.md # Propuesta de valor
|
|
│ ├── REQUERIMIENTOS-FUNCIONALES.md # 52 RFs documentados
|
|
│ ├── REQUERIMIENTOS-ORIGINALES.md # Documento original
|
|
│ └── ARQUITECTURA-TECNICA.md # Stack y diagrama
|
|
│
|
|
├── 01-epicas/ # ROADMAP DE DESARROLLO
|
|
│ ├── _MAP.md # Roadmap visual
|
|
│ ├── MII-001-infraestructura-base.md
|
|
│ ├── MII-002-autenticacion.md
|
|
│ ├── MII-003-gestion-tiendas.md
|
|
│ ├── MII-004-captura-video.md
|
|
│ ├── MII-005-procesamiento-ia.md
|
|
│ ├── MII-006-reportes-inventario.md
|
|
│ ├── MII-007-retroalimentacion.md
|
|
│ ├── MII-008-validacion-aleatoria.md
|
|
│ ├── MII-009-wallet-creditos.md
|
|
│ ├── MII-010-paquetes-recarga.md
|
|
│ ├── MII-011-pagos-tarjeta.md
|
|
│ ├── MII-012-pagos-oxxo.md
|
|
│ ├── MII-013-pagos-7eleven.md
|
|
│ ├── MII-014-referidos.md
|
|
│ └── MII-015-admin-saas.md
|
|
│
|
|
├── 02-especificaciones/ # DOCUMENTACION TECNICA
|
|
│ ├── _MAP.md
|
|
│ ├── ARQUITECTURA-DATABASE.md # Schema BD (FUENTE CANONICA)
|
|
│ ├── ESPECIFICACION-COMPONENTES.md # Modulos backend/mobile
|
|
│ ├── INTEGRACIONES-EXTERNAS.md # Resumen integraciones
|
|
│ └── PLAN-DESARROLLO.md # Cronograma
|
|
│
|
|
├── 02-integraciones/ # INTEGRACIONES EXTERNAS
|
|
│ ├── _MAP.md
|
|
│ ├── INT-001-stripe.md
|
|
│ ├── INT-002-oxxo-voucher.md
|
|
│ ├── INT-003-7eleven.md
|
|
│ ├── INT-004-firebase-fcm.md
|
|
│ ├── INT-005-s3-storage.md
|
|
│ └── INT-006-ai-provider.md
|
|
│
|
|
├── 90-transversal/ # DOCUMENTACION HORIZONTAL
|
|
│ ├── _MAP.md
|
|
│ ├── GUIA-DESPLIEGUE.md
|
|
│ └── ARQUITECTURA-MULTI-TENANT.md
|
|
│
|
|
├── 97-adr/ # DECISIONES ARQUITECTONICAS
|
|
│ ├── _MAP.md
|
|
│ ├── ADR-0001-modelo-creditos-tokens.md
|
|
│ ├── ADR-0002-procesamiento-asincrono.md
|
|
│ ├── ADR-0003-abstraccion-proveedores-ia.md
|
|
│ └── ADR-0004-pagos-efectivo-mexico.md
|
|
│
|
|
├── README.md # Indice principal
|
|
├── _MAP.md # Este archivo
|
|
└── INDICE-ARQUITECTURA.md # Navegacion por arquitectura
|
|
```
|
|
|
|
---
|
|
|
|
## Progreso por Fase
|
|
|
|
### Fase 1: MVP Core (6 epicas)
|
|
|
|
| Epica | Nombre | Estado | SP |
|
|
|-------|--------|--------|-----|
|
|
| MII-001 | Infraestructura Base | Pendiente | 8 |
|
|
| MII-002 | Autenticacion | Pendiente | 13 |
|
|
| MII-003 | Gestion de Tiendas | Pendiente | 8 |
|
|
| MII-004 | Captura de Video | Pendiente | 21 |
|
|
| MII-005 | Procesamiento IA | Pendiente | 34 |
|
|
| MII-006 | Reportes de Inventario | Pendiente | 13 |
|
|
|
|
### Fase 2: Retroalimentacion (2 epicas)
|
|
|
|
| Epica | Nombre | Estado | SP |
|
|
|-------|--------|--------|-----|
|
|
| MII-007 | Retroalimentacion | Pendiente | 13 |
|
|
| MII-008 | Validacion Aleatoria | Pendiente | 8 |
|
|
|
|
### Fase 3: Monetizacion (5 epicas)
|
|
|
|
| Epica | Nombre | Estado | SP |
|
|
|-------|--------|--------|-----|
|
|
| MII-009 | Wallet y Creditos | Pendiente | 13 |
|
|
| MII-010 | Paquetes de Recarga | Pendiente | 8 |
|
|
| MII-011 | Pagos con Tarjeta | Pendiente | 8 |
|
|
| MII-012 | Pagos OXXO | Pendiente | 13 |
|
|
| MII-013 | Pagos 7-Eleven | Pendiente | 8 |
|
|
|
|
### Fase 4: Crecimiento (2 epicas)
|
|
|
|
| Epica | Nombre | Estado | SP |
|
|
|-------|--------|--------|-----|
|
|
| MII-014 | Sistema de Referidos | Pendiente | 21 |
|
|
| MII-015 | Administracion SaaS | Pendiente | 13 |
|
|
|
|
---
|
|
|
|
## Integraciones Externas
|
|
|
|
| ID | Integracion | Tipo | Estado |
|
|
|----|-------------|------|--------|
|
|
| INT-001 | Stripe | Pagos | Pendiente |
|
|
| INT-002 | OXXO (via Stripe) | Pagos | Pendiente |
|
|
| INT-003 | 7-Eleven | Pagos | Pendiente |
|
|
| INT-004 | Firebase FCM | Notificaciones | Pendiente |
|
|
| INT-005 | S3/MinIO | Almacenamiento | Pendiente |
|
|
| INT-006 | Proveedor IA | ML/Vision | Pendiente |
|
|
|
|
---
|
|
|
|
## Navegacion Rapida
|
|
|
|
### Por Componente
|
|
|
|
| Componente | Documentacion |
|
|
|------------|---------------|
|
|
| Backend | [ESPECIFICACION-COMPONENTES.md](./02-especificaciones/ESPECIFICACION-COMPONENTES.md) |
|
|
| Mobile | [ESPECIFICACION-COMPONENTES.md](./02-especificaciones/ESPECIFICACION-COMPONENTES.md) |
|
|
| Database | [ARQUITECTURA-DATABASE.md](./02-especificaciones/ARQUITECTURA-DATABASE.md) |
|
|
| Integraciones | [02-integraciones/_MAP.md](./02-integraciones/_MAP.md) |
|
|
|
|
### Por Rol
|
|
|
|
| Rol | Documentos Clave |
|
|
|-----|------------------|
|
|
| PM/PO | Vision, Requerimientos, Epicas |
|
|
| Tech Lead | Arquitectura, ADRs, Especificaciones |
|
|
| Backend Dev | Especificaciones, Integraciones, Database |
|
|
| Mobile Dev | Especificaciones, Integraciones |
|
|
| DevOps | Guia Despliegue, Arquitectura |
|
|
|
|
### Por Estado
|
|
|
|
| Estado | Epicas |
|
|
|--------|--------|
|
|
| Completado | - |
|
|
| En Progreso | - |
|
|
| Pendiente | MII-001 a MII-015 |
|
|
|
|
---
|
|
|
|
## Fuentes Canonicas
|
|
|
|
| Tema | Fuente Canonica | Alias | NO buscar en |
|
|
|------|-----------------|-------|--------------|
|
|
| Schema BD | _definitions/DATABASE-SCHEMA.md | @PROJ_DEF_DB | Otros docs |
|
|
| Entities | _definitions/ENTITIES-CATALOG.md | @PROJ_DEF_ENTITIES | Inventarios |
|
|
| Services | _definitions/SERVICES-CATALOG.md | @PROJ_DEF_SERVICES | Inventarios |
|
|
| Modules | _definitions/MODULES-CATALOG.md | @PROJ_DEF_MODULES | Inventarios |
|
|
| Requerimientos | 00-vision-general/REQUERIMIENTOS-FUNCIONALES.md | - | Epicas |
|
|
| Stack | 00-vision-general/ARQUITECTURA-TECNICA.md | - | Epicas |
|
|
|
|
---
|
|
|
|
## Navegacion Rapida (_quick/)
|
|
|
|
| Archivo | Alias | Descripcion |
|
|
|---------|-------|-------------|
|
|
| QUICK-INDEX.yml | @PROJ_QUICK_INDEX | Punto de entrada rapido |
|
|
| QUICK-API.yml | @PROJ_QUICK_API | 61 endpoints documentados |
|
|
| QUICK-DATABASE.yml | @PROJ_QUICK_DATABASE | 21 tablas, 14 enums |
|
|
| QUICK-MODULES.yml | @PROJ_QUICK_MODULES | 14 modulos implementados |
|
|
|
|
### Atajos por Rol
|
|
|
|
| Rol | Archivos Clave |
|
|
|-----|----------------|
|
|
| Backend Dev | ENTITIES-CATALOG.md, SERVICES-CATALOG.md, QUICK-API.yml |
|
|
| Mobile Dev | QUICK-API.yml, FRONTEND_INVENTORY.yml |
|
|
| DBA | DATABASE-SCHEMA.md, QUICK-DATABASE.yml |
|
|
| Architect | MODULES-CATALOG.md, DEPENDENCY-GRAPH.yml |
|
|
|
|
---
|
|
|
|
## Orchestration
|
|
|
|
| Archivo | Descripcion |
|
|
|---------|-------------|
|
|
| orchestration/_refs/WS-REFERENCES.yml | Referencias a workspace (nivel=0) |
|
|
| orchestration/DEPENDENCY-GRAPH.yml | Grafo de dependencias |
|
|
| orchestration/TRACEABILITY.yml | Trazabilidad epicas-modulos-objetos |
|
|
| orchestration/inventarios/MASTER_INVENTORY.yml | Inventario maestro |
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
### Documentacion Principal
|
|
- [Contexto del Proyecto](../orchestration/00-guidelines/CONTEXTO-PROYECTO.md)
|
|
- [Inventarios](../orchestration/inventarios/)
|
|
- [Plan de Implementacion](../orchestration/PLAN-IMPLEMENTACION.md)
|
|
|
|
### Workspace
|
|
- [Directivas SIMCO](/home/isem/workspace-v2/orchestration/directivas/simco/)
|
|
- [Catalogo](/home/isem/workspace-v2/shared/catalog/)
|
|
- [Templates](/home/isem/workspace-v2/orchestration/templates/)
|
|
|
|
---
|
|
|
|
## Historial de Cambios
|
|
|
|
| Fecha | Version | Cambios |
|
|
|-------|---------|---------|
|
|
| 2026-01-10 | 1.0.0 | Creacion inicial del mapa |
|
|
| 2026-01-16 | 1.1.0 | Agregadas estructuras _definitions/ y _quick/ |
|
|
|
|
---
|
|
|
|
**Ultima Actualizacion:** 2026-01-16
|
|
**Autor:** Agente Orquestador
|