miinventario-v2/orchestration/BOOTLOADER.md
Adrian Flores Cortes 5e5f2f9578
Some checks are pending
Build / Build Backend (push) Waiting to run
Build / Build Docker Image (push) Blocked by required conditions
Build / Build Mobile (TypeScript Check) (push) Waiting to run
Lint / Lint Backend (push) Waiting to run
Lint / Lint Mobile (push) Waiting to run
Test / Backend E2E Tests (push) Waiting to run
Test / Mobile Unit Tests (push) Waiting to run
[TASK-2026-01-24-ESTANDAR-ORCHESTRATION] docs: Add _MAP.md, BOOTLOADER.md and PROJECT-PROFILE.yml
- Add _MAP.md navigation structure
- Add standardized BOOTLOADER for STANDALONE project
- Add PROJECT-PROFILE.yml with modules and epicas info
- Compliance with SIMCO-ESTANDAR-ORCHESTRATION

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 09:38:26 -06:00

7.4 KiB

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:

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

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