diff --git a/orchestration/BOOTLOADER.md b/orchestration/BOOTLOADER.md new file mode 100644 index 0000000..c92d55a --- /dev/null +++ b/orchestration/BOOTLOADER.md @@ -0,0 +1,190 @@ +# BOOTLOADER - MiInventario + +**Sistema:** NEXUS v4.0 - Protocolo de Arranque Local +**Proyecto:** MiInventario +**Tipo:** STANDALONE (Sistema Independiente) +**Version:** 1.0.0 +**Fecha:** 2026-01-24 + +--- + +## 1. Proposito + +Este BOOTLOADER define la secuencia de arranque especifica para MiInventario. +Sistema de inventario con IA para PyMEs que opera de forma independiente, +sin dependencias de otros proyectos del workspace. + +--- + +## 2. Arquitectura del Proyecto + +``` +MiInventario (STANDALONE) + │ + ├── apps/backend <- NestJS API (11 modulos) + ├── apps/mobile <- React Native App + └── database <- PostgreSQL (9 schemas) + +Integraciones Externas: + ├── Stripe <- Pagos tarjeta + ├── OXXO/7-Eleven <- Pagos efectivo + ├── Firebase FCM <- Push notifications + ├── S3/MinIO <- Almacenamiento videos + └── IA Provider <- Vision ML +``` + +--- + +## 3. Secuencia de Arranque (5 Pasos) + +``` +┌─────────────────────────────────────────────────────────────────────────┐ +│ BOOTLOADER MIINVENTARIO - 5 PASOS │ +├─────────────────────────────────────────────────────────────────────────┤ +│ │ +│ PASO 1: Cargar L0 (Sistema - Workspace) │ +│ ════════════════════════════════════════ │ +│ ├── Leer workspace-v2/CLAUDE.md │ +│ └── Tokens: ~4000 │ +│ │ │ +│ ▼ │ +│ PASO 2: Cargar L1 (Proyecto) │ +│ ════════════════════════════════════════ │ +│ ├── Leer orchestration/CONTEXT-MAP.yml │ +│ ├── Leer orchestration/_inheritance.yml (STANDALONE) │ +│ └── Tokens: ~2000 │ +│ │ │ +│ ▼ │ +│ PASO 3: Determinar Dominio │ +│ ════════════════════════════════════════ │ +│ ├── ¿Tarea de Backend? → Cargar BACKEND_INVENTORY.yml │ +│ ├── ¿Tarea de Mobile? → Cargar FRONTEND_INVENTORY.yml │ +│ ├── ¿Tarea de Database? → Cargar DATABASE_INVENTORY.yml │ +│ └── Cargar perfil de agente correspondiente │ +│ │ │ +│ ▼ │ +│ PASO 4: Verificar Estado y Sincronizacion │ +│ ════════════════════════════════════════ │ +│ ├── git fetch origin && git status │ +│ ├── Verificar PROXIMA-ACCION.md (checkpoint anterior) │ +│ └── Cargar PROJECT-STATUS.md si es necesario │ +│ │ │ +│ ▼ │ +│ PASO 5: Iniciar Tarea │ +│ ════════════════════════════════════════ │ +│ ├── Crear carpeta de tarea si no existe │ +│ └── Ejecutar FASE C de CAPVED │ +│ │ +└─────────────────────────────────────────────────────────────────────────┘ +``` + +--- + +## 4. Rol STANDALONE + +MiInventario NO hereda de otros proyectos: + +```yaml +herencia: + parent: null + tipo: STANDALONE + razon: "Sistema independiente con stack y logica propia" + +modulos_propios: + - auth # Autenticacion OTP/Email + - users # Gestion de usuarios + - stores # Multi-tenancy (tiendas) + - inventory-sessions # Sesiones de conteo + - products # Catalogo de productos + - wallet # Sistema de creditos + - payments # Pagos (Stripe, OXXO, 7-Eleven) + - referrals # Sistema de referidos + - ai-processing # Procesamiento IA + - feedback # Retroalimentacion ML + - admin # Administracion SaaS +``` + +--- + +## 5. Variables Pre-Resueltas + +```yaml +PROJECT_ROOT: projects/miinventario +BACKEND_ROOT: projects/miinventario/apps/backend +MOBILE_ROOT: projects/miinventario/apps/mobile +DATABASE_ROOT: projects/miinventario/database + +PUERTOS: + backend: 3142 + mobile: 8082 + postgres: 5433 + redis: 6380 + minio: 9002 + minio_console: 9003 + +SCHEMAS: + - public + - auth + - catalog + - inventory + - wallet + - payments + - referrals + - ai + - admin +``` + +--- + +## 6. Checklist de Arranque + +- [ ] PASO 1: workspace-v2/CLAUDE.md leido +- [ ] PASO 2: CONTEXT-MAP.yml cargado +- [ ] PASO 2: _inheritance.yml verificado (STANDALONE) +- [ ] PASO 3: Dominio identificado (Backend/Mobile/Database) +- [ ] PASO 3: Inventario del dominio cargado +- [ ] PASO 4: git fetch ejecutado +- [ ] PASO 4: PROXIMA-ACCION.md revisado +- [ ] PASO 5: Tarea iniciada + +--- + +## 7. Integraciones Externas + +| Servicio | Uso | Estado | +|----------|-----|--------| +| Stripe | Pagos tarjeta + OXXO voucher | Implementado | +| OXXO | Pagos efectivo | Implementado | +| 7-Eleven | Pagos efectivo | Implementado | +| Firebase FCM | Push notifications | Implementado | +| S3/MinIO | Almacenamiento videos/frames | Implementado | +| IA Provider | Deteccion productos (vision) | Implementado | + +--- + +## 8. Estado del Proyecto + +``` +Completitud: 80% +Estado: Activo +Fase actual: 4 (Crecimiento) +Epicas completadas: 15/15 + +Pendiente: +- Optimizacion de modelos IA +- Expansion de SKUs soportados +- Mejoras UX mobile +``` + +--- + +## 9. Referencias + +- **BOOTLOADER Global:** `workspace-v2/orchestration/directivas/simco/SIMCO-BOOTLOADER.md` +- **CONTEXT-MAP:** `orchestration/CONTEXT-MAP.yml` +- **PROJECT-STATUS:** `orchestration/PROJECT-STATUS.md` + +--- + +*BOOTLOADER MiInventario v1.0.0 - Sistema NEXUS v4.0* +*Tipo: STANDALONE - Sistema Independiente* diff --git a/orchestration/PROJECT-PROFILE.yml b/orchestration/PROJECT-PROFILE.yml new file mode 100644 index 0000000..740f774 --- /dev/null +++ b/orchestration/PROJECT-PROFILE.yml @@ -0,0 +1,298 @@ +# =============================================================================== +# PROJECT-PROFILE.yml - MiInventario +# =============================================================================== +# +# Sistema: SIMCO v4.3.0 + NEXUS v4.0 +# Proposito: Perfil y metadata del proyecto +# Fecha: 2026-01-24 +# +# =============================================================================== + +proyecto: + nombre: "MiInventario" + codigo: "miinventario" + alias: "MII" + tipo: "STANDALONE" + nivel: "2A" + version: "1.2.0" + +descripcion: | + Sistema de inventario con IA para PyMEs mexicanas. + Permite realizar conteos de inventario mediante video, + procesando los frames con vision por computadora para + detectar y contar productos automaticamente. + + Caracteristicas principales: + - Captura de video para conteo automatico + - Procesamiento IA (vision ML) + - Sistema de creditos (wallet) + - Pagos en efectivo (OXXO, 7-Eleven) + - Sistema de referidos + - Multi-tenancy (tiendas) + +# ----------------------------------------------------------------------------- +# STACK TECNOLOGICO +# ----------------------------------------------------------------------------- + +stack: + backend: + framework: "NestJS" + lenguaje: "TypeScript" + version: "10.x" + orm: "TypeORM" + + mobile: + framework: "React Native" + version: "0.72+" + estado: "Expo managed" + + database: + motor: "PostgreSQL" + version: "15+" + schemas: + - "public" + - "auth" + - "catalog" + - "inventory" + - "wallet" + - "payments" + - "referrals" + - "ai" + - "admin" + + cache: + motor: "Redis" + uso: "Sesiones, cache temporal" + + storage: + motor: "S3/MinIO" + uso: "Videos, frames, imagenes" + +# ----------------------------------------------------------------------------- +# MODULOS +# ----------------------------------------------------------------------------- + +modulos: + backend: + - id: "MII-MOD-001" + nombre: "auth" + descripcion: "Autenticacion OTP/Email" + estado: "completado" + + - id: "MII-MOD-002" + nombre: "users" + descripcion: "Gestion de usuarios" + estado: "completado" + + - id: "MII-MOD-003" + nombre: "stores" + descripcion: "Multi-tenancy (tiendas)" + estado: "completado" + + - id: "MII-MOD-004" + nombre: "inventory-sessions" + descripcion: "Sesiones de conteo" + estado: "completado" + + - id: "MII-MOD-005" + nombre: "products" + descripcion: "Catalogo de productos" + estado: "completado" + + - id: "MII-MOD-006" + nombre: "wallet" + descripcion: "Sistema de creditos" + estado: "completado" + + - id: "MII-MOD-007" + nombre: "payments" + descripcion: "Pagos Stripe/OXXO/7-Eleven" + estado: "completado" + + - id: "MII-MOD-008" + nombre: "referrals" + descripcion: "Sistema de referidos" + estado: "completado" + + - id: "MII-MOD-009" + nombre: "ai-processing" + descripcion: "Procesamiento IA" + estado: "completado" + + - id: "MII-MOD-010" + nombre: "feedback" + descripcion: "Retroalimentacion ML" + estado: "completado" + + - id: "MII-MOD-011" + nombre: "admin" + descripcion: "Administracion SaaS" + estado: "completado" + +# ----------------------------------------------------------------------------- +# EPICAS +# ----------------------------------------------------------------------------- + +epicas: + fase_1_mvp: + - id: "MII-001" + nombre: "Infraestructura Base" + sp: 8 + estado: "completado" + + - id: "MII-002" + nombre: "Autenticacion" + sp: 13 + estado: "completado" + + - id: "MII-003" + nombre: "Gestion de Tiendas" + sp: 8 + estado: "completado" + + - id: "MII-004" + nombre: "Captura de Video" + sp: 21 + estado: "completado" + + - id: "MII-005" + nombre: "Procesamiento IA" + sp: 34 + estado: "completado" + + - id: "MII-006" + nombre: "Reportes de Inventario" + sp: 13 + estado: "completado" + + fase_2_retroalimentacion: + - id: "MII-007" + nombre: "Retroalimentacion" + sp: 13 + estado: "completado" + + - id: "MII-008" + nombre: "Validacion Aleatoria" + sp: 8 + estado: "completado" + + fase_3_monetizacion: + - id: "MII-009" + nombre: "Wallet y Creditos" + sp: 13 + estado: "completado" + + - id: "MII-010" + nombre: "Paquetes de Recarga" + sp: 8 + estado: "completado" + + - id: "MII-011" + nombre: "Pagos con Tarjeta" + sp: 8 + estado: "completado" + + - id: "MII-012" + nombre: "Pagos OXXO" + sp: 13 + estado: "completado" + + - id: "MII-013" + nombre: "Pagos 7-Eleven" + sp: 8 + estado: "completado" + + fase_4_crecimiento: + - id: "MII-014" + nombre: "Sistema de Referidos" + sp: 21 + estado: "completado" + + - id: "MII-015" + nombre: "Administracion SaaS" + sp: 13 + estado: "completado" + +# ----------------------------------------------------------------------------- +# INTEGRACIONES EXTERNAS +# ----------------------------------------------------------------------------- + +integraciones: + - nombre: "Stripe" + tipo: "payment_provider" + uso: "Pagos con tarjeta y OXXO voucher" + estado: "implementado" + + - nombre: "OXXO" + tipo: "cash_payment" + uso: "Pagos en efectivo en OXXO" + estado: "implementado" + + - nombre: "7-Eleven" + tipo: "cash_payment" + uso: "Pagos en efectivo en 7-Eleven" + estado: "implementado" + + - nombre: "Firebase FCM" + tipo: "notifications" + uso: "Push notifications mobile" + estado: "implementado" + + - nombre: "S3/MinIO" + tipo: "storage" + uso: "Almacenamiento de videos y frames" + estado: "implementado" + + - nombre: "IA Provider" + tipo: "ml_vision" + uso: "Deteccion y conteo de productos" + estado: "implementado" + +# ----------------------------------------------------------------------------- +# ESTADO +# ----------------------------------------------------------------------------- + +estado: + general: "activo" + madurez: "beta" + completitud: "80%" + en_produccion: false + + fases_completadas: 4 + fases_totales: 4 + epicas_completadas: 15 + epicas_totales: 15 + story_points_totales: 202 + +# ----------------------------------------------------------------------------- +# RUTAS +# ----------------------------------------------------------------------------- + +rutas: + proyecto: "projects/miinventario" + backend: "projects/miinventario/apps/backend" + mobile: "projects/miinventario/apps/mobile" + database: "projects/miinventario/database" + docs: "projects/miinventario/docs" + orchestration: "projects/miinventario/orchestration" + +# ----------------------------------------------------------------------------- +# EQUIPO +# ----------------------------------------------------------------------------- + +equipo: + owner: "ISEM Development" + agentes_principales: + - "Claude Code" + - "Trae" + +# ----------------------------------------------------------------------------- +# NOTAS +# ----------------------------------------------------------------------------- + +notas: + - "Proyecto STANDALONE - no hereda de template-saas" + - "Enfocado en PyMEs mexicanas" + - "Pagos en efectivo son criticos para el mercado objetivo" + - "IA vision requiere optimizacion continua" + - "Multi-tenancy por tienda (no por empresa)" diff --git a/orchestration/_MAP.md b/orchestration/_MAP.md new file mode 100644 index 0000000..dc5e14b --- /dev/null +++ b/orchestration/_MAP.md @@ -0,0 +1,140 @@ +# _MAP.md - MiInventario Orchestration + +**Sistema:** SIMCO v4.3.0 + NEXUS v4.0 +**Proyecto:** MiInventario +**Tipo:** STANDALONE +**Fecha:** 2026-01-24 + +--- + +## Estructura de Navegacion + +``` +orchestration/ +├── _MAP.md <- ESTE ARCHIVO (mapa de navegacion) +├── _inheritance.yml <- Declaracion de herencia (STANDALONE) +├── BOOTLOADER.md <- Protocolo de arranque +├── CONTEXT-MAP.yml <- Mapa central de contexto +├── PROJECT-PROFILE.yml <- Perfil y metadata +├── PROJECT-STATUS.md <- Estado actual detallado +├── PROXIMA-ACCION.md <- Checkpoint de sesion +├── DEPENDENCY-GRAPH.yml <- Grafo de dependencias +├── TRACEABILITY.yml <- Trazabilidad del proyecto +├── MAPA-DOCUMENTACION.yml <- Mapa de documentacion +├── PLAN-IMPLEMENTACION.md <- Plan de implementacion +├── README.md <- Descripcion general +│ +├── _refs/ <- Referencias externas +│ └── WS-REFERENCES.yml <- Referencias al workspace +│ +├── 00-guidelines/ <- Guias del proyecto +│ ├── CONTEXTO-PROYECTO.md <- Contexto general +│ └── HERENCIA-SIMCO.md <- Como hereda de SIMCO +│ +├── 90-transversal/ <- Configuraciones transversales +│ └── PRODUCTION-CONFIG.md <- Configuracion de produccion +│ +├── agents/ <- Configuracion de agentes +│ ├── README.md +│ ├── perfiles/ <- Perfiles especializados +│ │ ├── PERFIL-BACKEND-AGENT.md +│ │ ├── PERFIL-DDL-AGENT.md +│ │ └── PERFIL-MOBILE-AGENT.md +│ └── trazas/ +│ └── _INDEX.yml +│ +├── analisis/ <- Analisis realizados +│ ├── ANALISIS-BRECHAS-*.md +│ ├── ANALISIS-DEPENDENCIAS-*.md +│ ├── PLAN-*.md +│ └── VALIDACION-*.md +│ +├── directivas/ <- Directivas locales +│ ├── README.md +│ └── proyecto-triggers/ +│ ├── TRIGGER-COHERENCIA-CAPAS.md +│ └── TRIGGER-INVENTARIOS.md +│ +├── environment/ <- Configuracion de ambiente +│ └── ENVIRONMENT-INVENTORY.yml +│ +├── inventarios/ <- Inventarios del proyecto +│ ├── MASTER_INVENTORY.yml <- Inventario maestro +│ ├── DATABASE_INVENTORY.yml <- Tablas DDL +│ ├── BACKEND_INVENTORY.yml <- Entities/Services +│ └── FRONTEND_INVENTORY.yml <- Componentes mobile +│ +└── trazas/ <- Trazas de ejecucion + ├── TRAZA-TAREAS-BACKEND.md + ├── TRAZA-TAREAS-DATABASE.md + └── TRAZA-TAREAS-MOBILE.md +``` + +--- + +## Archivos por Proposito + +### Arranque y Contexto +| Archivo | Proposito | +|---------|-----------| +| BOOTLOADER.md | Protocolo de arranque (5 pasos) | +| CONTEXT-MAP.yml | Variables, rutas, aliases | +| PROJECT-PROFILE.yml | Metadata y stack tecnologico | +| _inheritance.yml | Declaracion STANDALONE | + +### Estado y Seguimiento +| Archivo | Proposito | +|---------|-----------| +| PROJECT-STATUS.md | Estado detallado del proyecto | +| PROXIMA-ACCION.md | Checkpoint para siguiente sesion | +| PLAN-IMPLEMENTACION.md | Plan de desarrollo | + +### Trazabilidad +| Archivo | Proposito | +|---------|-----------| +| DEPENDENCY-GRAPH.yml | Dependencias internas/externas | +| TRACEABILITY.yml | Historial de cambios | +| trazas/*.md | Trazas por dominio | + +### Inventarios +| Archivo | Proposito | +|---------|-----------| +| MASTER_INVENTORY.yml | Totales consolidados | +| DATABASE_INVENTORY.yml | 9 schemas, ~40 tablas | +| BACKEND_INVENTORY.yml | 11 modulos NestJS | +| FRONTEND_INVENTORY.yml | Componentes React Native | + +--- + +## Aliases Rapidos + +``` +@MII-CONTEXT -> CONTEXT-MAP.yml +@MII-STATUS -> PROJECT-STATUS.md +@MII-BOOT -> BOOTLOADER.md +@MII-INVENTORY -> inventarios/MASTER_INVENTORY.yml +@MII-TRAZAS -> trazas/ +``` + +--- + +## Navegacion Recomendada + +### Nuevo en el Proyecto +1. Leer `BOOTLOADER.md` (arranque) +2. Revisar `PROJECT-PROFILE.yml` (overview) +3. Consultar `CONTEXT-MAP.yml` (variables) + +### Continuar Trabajo +1. Cargar `PROXIMA-ACCION.md` (checkpoint) +2. Verificar `PROJECT-STATUS.md` (estado actual) +3. Consultar inventario del dominio + +### Hacer Cambios +1. Verificar `DEPENDENCY-GRAPH.yml` (impacto) +2. Actualizar inventario correspondiente +3. Registrar en `TRACEABILITY.yml` + +--- + +*_MAP.md MiInventario v1.0.0 - Sistema SIMCO v4.3.0*