miinventario-v2/orchestration/CONTEXT-MAP.yml
rckrdmrd 1a53b5c4d3 [MIINVENTARIO] feat: Initial commit - Sistema de inventario con análisis de video IA
- Backend NestJS con módulos de autenticación, inventario, créditos
- Frontend React con dashboard y componentes UI
- Base de datos PostgreSQL con migraciones
- Tests E2E configurados
- Configuración de Docker y deployment

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 02:25:48 -06:00

404 lines
11 KiB
YAML

# MiInventario - Context Map
# Version: 1.0.0
# Actualizado: 2026-01-10
metadata:
proyecto: miinventario
codigo: MII
tipo: standalone-saas
nivel_simco: L2-A
version: "0.1.0"
simco_version: "4.0.0"
estado: planificacion
creado: 2026-01-10
actualizado: 2026-01-10
actualizado_por: "Agente Orquestador"
# ===========================================
# 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: 3150
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: pendiente
progreso: 0
- id: 2
nombre: "Retroalimentacion"
descripcion: "Mejora continua del modelo IA"
epicas: [MII-007, MII-008]
story_points: 21
estado: pendiente
progreso: 0
- 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: pendiente
progreso: 0
- id: 4
nombre: "Crecimiento"
descripcion: "Referidos y administracion"
epicas: [MII-014, MII-015]
story_points: 34
estado: pendiente
progreso: 0
# ===========================================
# EPICAS
# ===========================================
epicas:
MII-001:
nombre: "Infraestructura Base"
fase: 1
sp: 8
estado: pendiente
dependencias: []
MII-002:
nombre: "Autenticacion"
fase: 1
sp: 13
estado: pendiente
dependencias: [MII-001]
catalogo: ["auth", "session-management"]
MII-003:
nombre: "Gestion de Tiendas"
fase: 1
sp: 8
estado: pendiente
dependencias: [MII-002]
catalogo: ["multi-tenancy"]
MII-004:
nombre: "Captura de Video"
fase: 1
sp: 21
estado: pendiente
dependencias: [MII-003]
MII-005:
nombre: "Procesamiento IA"
fase: 1
sp: 34
estado: pendiente
dependencias: [MII-004]
MII-006:
nombre: "Reportes de Inventario"
fase: 1
sp: 13
estado: pendiente
dependencias: [MII-005]
MII-007:
nombre: "Retroalimentacion"
fase: 2
sp: 13
estado: pendiente
dependencias: [MII-006]
MII-008:
nombre: "Validacion Aleatoria"
fase: 2
sp: 8
estado: pendiente
dependencias: [MII-006]
MII-009:
nombre: "Wallet y Creditos"
fase: 3
sp: 13
estado: pendiente
dependencias: [MII-006]
catalogo: ["audit-logs"]
MII-010:
nombre: "Paquetes de Recarga"
fase: 3
sp: 8
estado: pendiente
dependencias: [MII-009]
MII-011:
nombre: "Pagos con Tarjeta"
fase: 3
sp: 8
estado: pendiente
dependencias: [MII-010]
catalogo: ["payments"]
MII-012:
nombre: "Pagos OXXO"
fase: 3
sp: 13
estado: pendiente
dependencias: [MII-010]
MII-013:
nombre: "Pagos 7-Eleven"
fase: 3
sp: 8
estado: pendiente
dependencias: [MII-010]
MII-014:
nombre: "Sistema de Referidos"
fase: 4
sp: 21
estado: pendiente
dependencias: [MII-009]
MII-015:
nombre: "Administracion SaaS"
fase: 4
sp: 13
estado: pendiente
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: pendiente
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: pendiente
documentacion: "@DOCS/02-integraciones/INT-002-oxxo-voucher.md"
- id: INT-003
nombre: 7-Eleven
tipo: pagos
proveedor: Agregador
proposito: "Pagos en efectivo en 7-Eleven"
prioridad: P1
estado: pendiente
documentacion: "@DOCS/02-integraciones/INT-003-7eleven.md"
- id: INT-004
nombre: Firebase FCM
tipo: notificaciones
proveedor: Google
proposito: "Push notifications"
prioridad: P1
estado: pendiente
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: pendiente
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: pendiente
documentacion: "@DOCS/02-integraciones/INT-006-ai-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"