Some checks failed
Build / Build Backend (push) Has been cancelled
Build / Build Mobile (TypeScript Check) (push) Has been cancelled
Lint / Lint Backend (push) Has been cancelled
Lint / Lint Mobile (push) Has been cancelled
Test / Backend E2E Tests (push) Has been cancelled
Test / Mobile Unit Tests (push) Has been cancelled
Build / Build Docker Image (push) Has been cancelled
- Add exports module with PDF/CSV/Excel generation - Add reports module for inventory analytics - Add POS integrations module - Add database migrations for exports, movements and integrations - Add GitHub Actions CI/CD workflow with Docker support - Add mobile export and reports screens with tests - Update epic documentation with traceability - Add deployment and security guides Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
404 lines
11 KiB
YAML
404 lines
11 KiB
YAML
# MiInventario - Context Map
|
|
# Version: 1.2.0
|
|
# Actualizado: 2026-01-13
|
|
|
|
metadata:
|
|
proyecto: miinventario
|
|
codigo: MII
|
|
tipo: standalone-saas
|
|
nivel_simco: L2-A
|
|
version: "1.2.0"
|
|
simco_version: "4.0.0"
|
|
estado: completado
|
|
creado: 2026-01-10
|
|
actualizado: 2026-01-13
|
|
actualizado_por: "Agente Arquitecto de Documentación"
|
|
|
|
# ===========================================
|
|
# RUTAS ABSOLUTAS DEL PROYECTO
|
|
# ===========================================
|
|
rutas:
|
|
proyecto: /home/isem/workspace-v2/projects/miinventario
|
|
docs: /home/isem/workspace-v2/projects/miinventario/docs
|
|
orchestration: /home/isem/workspace-v2/projects/miinventario/orchestration
|
|
backend: /home/isem/workspace-v2/projects/miinventario/apps/backend
|
|
mobile: /home/isem/workspace-v2/projects/miinventario/apps/mobile
|
|
database: /home/isem/workspace-v2/projects/miinventario/database
|
|
|
|
# ===========================================
|
|
# ALIASES DEL PROYECTO
|
|
# ===========================================
|
|
aliases:
|
|
"@PROJECT": /home/isem/workspace-v2/projects/miinventario
|
|
"@DOCS": /home/isem/workspace-v2/projects/miinventario/docs
|
|
"@ORCH": /home/isem/workspace-v2/projects/miinventario/orchestration
|
|
"@BACKEND": /home/isem/workspace-v2/projects/miinventario/apps/backend
|
|
"@BACKEND_SRC": /home/isem/workspace-v2/projects/miinventario/apps/backend/src
|
|
"@MOBILE": /home/isem/workspace-v2/projects/miinventario/apps/mobile
|
|
"@MOBILE_SRC": /home/isem/workspace-v2/projects/miinventario/apps/mobile/src
|
|
"@DDL": /home/isem/workspace-v2/projects/miinventario/database/schemas
|
|
"@SEEDS": /home/isem/workspace-v2/projects/miinventario/database/seeds
|
|
"@INVENTORY": /home/isem/workspace-v2/projects/miinventario/orchestration/inventarios
|
|
"@TRAZAS": /home/isem/workspace-v2/projects/miinventario/orchestration/trazas
|
|
|
|
# ===========================================
|
|
# VARIABLES DEL PROYECTO
|
|
# ===========================================
|
|
variables:
|
|
PROJECT: miinventario
|
|
PROJECT_CODE: MII
|
|
DB_NAME: miinventario_dev
|
|
BACKEND_PORT: 3142
|
|
MOBILE_PORT: 8082
|
|
POSTGRES_PORT: 5433
|
|
REDIS_PORT: 6380
|
|
MINIO_PORT: 9002
|
|
MINIO_CONSOLE_PORT: 9003
|
|
|
|
# ===========================================
|
|
# SINGLE SOURCE OF TRUTH (SSOT)
|
|
# ===========================================
|
|
ssot:
|
|
inventario_master: "@INVENTORY/MASTER_INVENTORY.yml"
|
|
inventario_database: "@INVENTORY/DATABASE_INVENTORY.yml"
|
|
inventario_backend: "@INVENTORY/BACKEND_INVENTORY.yml"
|
|
inventario_frontend: "@INVENTORY/FRONTEND_INVENTORY.yml"
|
|
contexto: "@ORCH/00-guidelines/CONTEXTO-PROYECTO.md"
|
|
herencia: "@ORCH/00-guidelines/HERENCIA-SIMCO.md"
|
|
vision: "@DOCS/00-vision-general/VISION-PROYECTO.md"
|
|
requerimientos: "@DOCS/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md"
|
|
arquitectura: "@DOCS/00-vision-general/ARQUITECTURA-TECNICA.md"
|
|
|
|
# ===========================================
|
|
# INTEGRACION CON DOCS
|
|
# ===========================================
|
|
integracion_docs:
|
|
mapa_docs: "@DOCS/_MAP.md"
|
|
indice: "@DOCS/INDICE-ARQUITECTURA.md"
|
|
estructura:
|
|
vision: "@DOCS/00-vision-general/"
|
|
epicas: "@DOCS/01-epicas/"
|
|
especificaciones: "@DOCS/02-especificaciones/"
|
|
integraciones: "@DOCS/02-integraciones/"
|
|
transversal: "@DOCS/90-transversal/"
|
|
adr: "@DOCS/97-adr/"
|
|
|
|
# ===========================================
|
|
# HERENCIA DEL WORKSPACE
|
|
# ===========================================
|
|
herencia:
|
|
workspace: /home/isem/workspace-v2
|
|
simco: /home/isem/workspace-v2/orchestration/directivas/simco
|
|
principios: /home/isem/workspace-v2/orchestration/directivas/principios
|
|
templates: /home/isem/workspace-v2/orchestration/templates
|
|
catalog: /home/isem/workspace-v2/shared/catalog
|
|
knowledge: /home/isem/workspace-v2/shared/knowledge-base
|
|
|
|
# ===========================================
|
|
# FASES DEL PROYECTO
|
|
# ===========================================
|
|
fases:
|
|
- id: 1
|
|
nombre: "MVP Core"
|
|
descripcion: "Funcionalidad base de inventario"
|
|
epicas: [MII-001, MII-002, MII-003, MII-004, MII-005, MII-006]
|
|
story_points: 97
|
|
estado: completado
|
|
progreso: 100
|
|
|
|
- id: 2
|
|
nombre: "Retroalimentacion"
|
|
descripcion: "Mejora continua del modelo IA"
|
|
epicas: [MII-007, MII-008]
|
|
story_points: 21
|
|
estado: completado
|
|
progreso: 100
|
|
|
|
- id: 3
|
|
nombre: "Monetizacion"
|
|
descripcion: "Sistema de creditos y pagos"
|
|
epicas: [MII-009, MII-010, MII-011, MII-012, MII-013]
|
|
story_points: 50
|
|
estado: completado
|
|
progreso: 100
|
|
|
|
- id: 4
|
|
nombre: "Crecimiento"
|
|
descripcion: "Referidos y administracion"
|
|
epicas: [MII-014, MII-015]
|
|
story_points: 34
|
|
estado: completado
|
|
progreso: 100
|
|
|
|
# ===========================================
|
|
# EPICAS
|
|
# ===========================================
|
|
epicas:
|
|
MII-001:
|
|
nombre: "Infraestructura Base"
|
|
fase: 1
|
|
sp: 8
|
|
estado: completado
|
|
dependencias: []
|
|
|
|
MII-002:
|
|
nombre: "Autenticacion"
|
|
fase: 1
|
|
sp: 13
|
|
estado: completado
|
|
dependencias: [MII-001]
|
|
catalogo: ["auth", "session-management"]
|
|
|
|
MII-003:
|
|
nombre: "Gestion de Tiendas"
|
|
fase: 1
|
|
sp: 8
|
|
estado: completado
|
|
dependencias: [MII-002]
|
|
catalogo: ["multi-tenancy"]
|
|
|
|
MII-004:
|
|
nombre: "Captura de Video"
|
|
fase: 1
|
|
sp: 21
|
|
estado: completado
|
|
dependencias: [MII-003]
|
|
|
|
MII-005:
|
|
nombre: "Procesamiento IA"
|
|
fase: 1
|
|
sp: 34
|
|
estado: completado
|
|
dependencias: [MII-004]
|
|
|
|
MII-006:
|
|
nombre: "Reportes de Inventario"
|
|
fase: 1
|
|
sp: 13
|
|
estado: completado
|
|
dependencias: [MII-005]
|
|
|
|
MII-007:
|
|
nombre: "Retroalimentacion"
|
|
fase: 2
|
|
sp: 13
|
|
estado: completado
|
|
dependencias: [MII-006]
|
|
|
|
MII-008:
|
|
nombre: "Validacion Aleatoria"
|
|
fase: 2
|
|
sp: 8
|
|
estado: completado
|
|
dependencias: [MII-006]
|
|
|
|
MII-009:
|
|
nombre: "Wallet y Creditos"
|
|
fase: 3
|
|
sp: 13
|
|
estado: completado
|
|
dependencias: [MII-006]
|
|
catalogo: ["audit-logs"]
|
|
|
|
MII-010:
|
|
nombre: "Paquetes de Recarga"
|
|
fase: 3
|
|
sp: 8
|
|
estado: completado
|
|
dependencias: [MII-009]
|
|
|
|
MII-011:
|
|
nombre: "Pagos con Tarjeta"
|
|
fase: 3
|
|
sp: 8
|
|
estado: completado
|
|
dependencias: [MII-010]
|
|
catalogo: ["payments"]
|
|
|
|
MII-012:
|
|
nombre: "Pagos OXXO"
|
|
fase: 3
|
|
sp: 13
|
|
estado: completado
|
|
dependencias: [MII-010]
|
|
|
|
MII-013:
|
|
nombre: "Pagos 7-Eleven"
|
|
fase: 3
|
|
sp: 8
|
|
estado: completado
|
|
dependencias: [MII-010]
|
|
|
|
MII-014:
|
|
nombre: "Sistema de Referidos"
|
|
fase: 4
|
|
sp: 21
|
|
estado: completado
|
|
dependencias: [MII-009]
|
|
|
|
MII-015:
|
|
nombre: "Administracion SaaS"
|
|
fase: 4
|
|
sp: 13
|
|
estado: completado
|
|
dependencias: [MII-009, MII-014]
|
|
|
|
# ===========================================
|
|
# INTEGRACIONES EXTERNAS
|
|
# ===========================================
|
|
integraciones:
|
|
- id: INT-001
|
|
nombre: Stripe
|
|
tipo: pagos
|
|
proveedor: Stripe Inc.
|
|
proposito: "Pagos con tarjeta y OXXO voucher"
|
|
prioridad: P0
|
|
estado: implementado
|
|
documentacion: "@DOCS/02-integraciones/INT-001-stripe.md"
|
|
|
|
- id: INT-002
|
|
nombre: OXXO
|
|
tipo: pagos
|
|
proveedor: Stripe (via OXXO)
|
|
proposito: "Pagos en efectivo en OXXO"
|
|
prioridad: P0
|
|
estado: implementado
|
|
documentacion: "@DOCS/02-integraciones/INT-002-oxxo.md"
|
|
|
|
- id: INT-003
|
|
nombre: 7-Eleven
|
|
tipo: pagos
|
|
proveedor: Agregador
|
|
proposito: "Pagos en efectivo en 7-Eleven"
|
|
prioridad: P1
|
|
estado: implementado
|
|
documentacion: "@DOCS/02-integraciones/INT-003-7eleven.md"
|
|
|
|
- id: INT-004
|
|
nombre: Firebase FCM
|
|
tipo: notificaciones
|
|
proveedor: Google
|
|
proposito: "Push notifications"
|
|
prioridad: P1
|
|
estado: implementado
|
|
documentacion: "@DOCS/02-integraciones/INT-004-firebase-fcm.md"
|
|
|
|
- id: INT-005
|
|
nombre: S3/MinIO
|
|
tipo: almacenamiento
|
|
proveedor: AWS/MinIO
|
|
proposito: "Almacenamiento de videos y frames"
|
|
prioridad: P0
|
|
estado: implementado
|
|
documentacion: "@DOCS/02-integraciones/INT-005-s3-storage.md"
|
|
|
|
- id: INT-006
|
|
nombre: Proveedor IA
|
|
tipo: ml-vision
|
|
proveedor: Multiples (abstraccion)
|
|
proposito: "Deteccion y conteo de productos"
|
|
prioridad: P0
|
|
estado: implementado
|
|
documentacion: "@DOCS/02-integraciones/INT-006-ia-provider.md"
|
|
|
|
# ===========================================
|
|
# SCHEMAS DE BASE DE DATOS
|
|
# ===========================================
|
|
schemas:
|
|
- nombre: public
|
|
proposito: "Configuracion global, tenants"
|
|
tablas_principales: [tenants, settings, configurations]
|
|
|
|
- nombre: auth
|
|
proposito: "Usuarios, sesiones, tokens"
|
|
tablas_principales: [users, user_profiles, sessions, refresh_tokens]
|
|
|
|
- nombre: catalog
|
|
proposito: "Productos, SKUs, categorias"
|
|
tablas_principales: [products, skus, categories, brands]
|
|
|
|
- nombre: inventory
|
|
proposito: "Sesiones, lineas, detecciones"
|
|
tablas_principales: [inventory_sessions, session_line_items, detections]
|
|
|
|
- nombre: wallet
|
|
proposito: "Saldos, transacciones"
|
|
tablas_principales: [wallets, wallet_transactions]
|
|
|
|
- nombre: payments
|
|
proposito: "Pagos, referencias"
|
|
tablas_principales: [payments, payment_references]
|
|
|
|
- nombre: referrals
|
|
proposito: "Codigos, relaciones, recompensas"
|
|
tablas_principales: [referral_links, referral_rewards]
|
|
|
|
- nombre: ai
|
|
proposito: "Proveedores, costos, feedback"
|
|
tablas_principales: [ai_providers, ai_costs, feedback_events, validation_tasks]
|
|
|
|
- nombre: admin
|
|
proposito: "Configuraciones administrativas"
|
|
tablas_principales: [packages, pricing_rules, metrics]
|
|
|
|
# ===========================================
|
|
# MODULOS BACKEND
|
|
# ===========================================
|
|
modulos_backend:
|
|
- nombre: auth
|
|
ruta: "modules/auth"
|
|
dependencias: []
|
|
|
|
- nombre: users
|
|
ruta: "modules/users"
|
|
dependencias: [auth]
|
|
|
|
- nombre: stores
|
|
ruta: "modules/stores"
|
|
dependencias: [auth, users]
|
|
|
|
- nombre: inventory-sessions
|
|
ruta: "modules/inventory-sessions"
|
|
dependencias: [auth, stores]
|
|
|
|
- nombre: products
|
|
ruta: "modules/products"
|
|
dependencias: [auth]
|
|
|
|
- nombre: wallet
|
|
ruta: "modules/wallet"
|
|
dependencias: [auth, users]
|
|
|
|
- nombre: payments
|
|
ruta: "modules/payments"
|
|
dependencias: [auth, wallet]
|
|
|
|
- nombre: referrals
|
|
ruta: "modules/referrals"
|
|
dependencias: [auth, users, wallet]
|
|
|
|
- nombre: ai-processing
|
|
ruta: "modules/ai-processing"
|
|
dependencias: [inventory-sessions, products]
|
|
|
|
- nombre: feedback
|
|
ruta: "modules/feedback"
|
|
dependencias: [inventory-sessions, products]
|
|
|
|
- nombre: admin
|
|
ruta: "modules/admin"
|
|
dependencias: [auth]
|
|
|
|
# ===========================================
|
|
# CHANGELOG
|
|
# ===========================================
|
|
changelog:
|
|
- version: "1.0.0"
|
|
fecha: 2026-01-10
|
|
cambios:
|
|
- "Creacion inicial del context map"
|
|
- "Definicion de 15 epicas en 4 fases"
|
|
- "Identificacion de 6 integraciones"
|
|
- "Mapeo de 9 schemas de base de datos"
|
|
- "Definicion de 11 modulos backend"
|