miinventario-v2/orchestration/directivas/proyecto-triggers/TRIGGER-INVENTARIOS.md
rckrdmrd 7988c7f9f8
Some checks failed
Build / Build Backend (push) Has been cancelled
Build / Build Mobile (TypeScript Check) (push) Has been cancelled
Lint / Lint Backend (push) Has been cancelled
Lint / Lint Mobile (push) Has been cancelled
Test / Backend E2E Tests (push) Has been cancelled
Test / Mobile Unit Tests (push) Has been cancelled
Build / Build Docker Image (push) Has been cancelled
[MIINVENTARIO] feat: Add SaaS documentation structure from template-saas
- Add orchestration/directivas/ with proyecto-triggers
  - TRIGGER-COHERENCIA-CAPAS.md for DDL/Backend coherence
  - TRIGGER-INVENTARIOS.md for inventory synchronization
- Add orchestration/agents/ with perfiles
  - PERFIL-DDL-AGENT.md
  - PERFIL-BACKEND-AGENT.md
  - PERFIL-MOBILE-AGENT.md (React Native/Expo specialized)
- Add MAPA-DOCUMENTACION.yml as central reference

Inheritance: INTEGRATES from template-saas

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-16 19:47:59 -06:00

125 lines
3.0 KiB
Markdown

# TRIGGER: Inventarios Sincronizados
**ID:** TRIGGER-MI-INVENTARIOS
**Version:** 1.0.0
**Prioridad:** P2 (Importante)
**Activacion:** Post-tarea con cambios de codigo
**Hereda de:** template-saas (INTEGRATES)
---
## Proposito
Mantener los inventarios del proyecto sincronizados con el codigo real.
Detectar discrepancias entre lo documentado y lo implementado.
## Contexto del Proyecto
MiInventario tiene estructura monorepo con:
- `apps/backend/` - API NestJS
- `apps/mobile/` - App React Native (Expo)
- Servicios AI para procesamiento de video
## Activacion
Este trigger se activa cuando:
- Se completa una tarea que modifica codigo
- Se ejecuta validacion manual con `@MI_VALIDATE_INVENTARIOS`
- Se prepara release
## Inventarios a Validar
| Inventario | Ubicacion | Valida |
|------------|-----------|--------|
| DATABASE_INVENTORY.yml | orchestration/inventarios/ | Schemas, tablas, enums, funciones |
| BACKEND_INVENTORY.yml | orchestration/inventarios/ | Modulos, services, entities, tests |
| MOBILE_INVENTORY.yml | orchestration/inventarios/ | Screens, components, navigation |
| MASTER_INVENTORY.yml | orchestration/inventarios/ | Totales consolidados |
## Validaciones
### 1. DATABASE_INVENTORY.yml
```bash
# Validar schemas
ls database/schemas/ | wc -l # Debe coincidir con total_schemas
# Validar tablas
find database/schemas -name "*.sql" -path "*tables*" | wc -l
```
### 2. BACKEND_INVENTORY.yml
```bash
# Validar entities
find apps/backend/src/modules -name "*.entity.ts" | wc -l
# Validar services
find apps/backend/src/modules -name "*.service.ts" | wc -l
# Validar controllers
find apps/backend/src/modules -name "*.controller.ts" | wc -l
```
### 3. MOBILE_INVENTORY.yml
```bash
# Validar screens
find apps/mobile/src/screens -name "*.tsx" | wc -l
# Validar components
find apps/mobile/src/components -name "*.tsx" | wc -l
```
### 4. MASTER_INVENTORY.yml
```yaml
# Totales deben coincidir con suma de inventarios individuales
backend_entities: sum(BACKEND_INVENTORY.entities)
mobile_screens: sum(MOBILE_INVENTORY.screens)
database_tables: sum(DATABASE_INVENTORY.tablas)
```
## Resultado de Validacion
### Exito
```yaml
status: "pass"
inventarios:
database: "sync"
backend: "sync"
mobile: "sync"
master: "sync"
discrepancias: 0
```
### Advertencia
```yaml
status: "warning"
inventarios:
database: "sync"
backend: "desync"
mobile: "sync"
master: "desync"
discrepancias:
- inventario: "BACKEND_INVENTORY.yml"
campo: "total_entities"
documentado: <doc>
real: <real>
accion: "Actualizar inventario"
```
## Acciones Correctivas
1. **Actualizar totales:** Corregir numeros en inventarios
2. **Agregar items faltantes:** Documentar nuevos artefactos
3. **Eliminar items obsoletos:** Remover referencias a codigo eliminado
4. **Actualizar MASTER:** Recalcular totales consolidados
## Referencias
- `@MI_INV_MASTER` - Inventario maestro
- `@MI_INV_DB` - Inventario database
- `@MI_INV_BE` - Inventario backend
- `@MI_INV_MOBILE` - Inventario mobile