# 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*