[TASK-2026-01-24-ESTANDAR-ORCHESTRATION] docs: Add _MAP.md, BOOTLOADER.md and PROJECT-PROFILE.yml
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

- 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>
This commit is contained in:
Adrian Flores Cortes 2026-01-24 09:38:26 -06:00
parent a75b7c75ee
commit 5e5f2f9578
3 changed files with 628 additions and 0 deletions

190
orchestration/BOOTLOADER.md Normal file
View File

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

View File

@ -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)"

140
orchestration/_MAP.md Normal file
View File

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