michangarrito/docs/_definitions/MODULES-CATALOG.md
rckrdmrd 343ff55271 [MCH-DOC-VAL] docs: Completar definiciones técnicas con SIMCO 4.0.1
Actualiza catálogos de definiciones técnicas con nuevos módulos,
servicios, entidades y esquemas de base de datos.

Cambios por archivo:

DATABASE-SCHEMA.md (+138 líneas):
- Agregado simco_version: 4.0.1
- Schemas: 12 -> 15 (ai, onboarding, predictions)
- Tablas: ~49 -> ~65
- Nuevas tablas documentadas: conversations, inventory_predictions
- Diagrama de relaciones actualizado

ENTITIES-CATALOG.md (+54 líneas):
- Agregado simco_version: 4.0.1
- Entities: 25 -> 35+
- Nuevos módulos: AI/MCP, Predictions, Onboarding, Notifications
- Relaciones actualizadas para nuevas entidades

MODULES-CATALOG.md (+94 líneas):
- Agregado simco_version: 4.0.1
- Módulos: 18 -> 24
- Agregados: MCH-M19 a MCH-M24 (Offline, Referrals, CoDi, Widgets, i18n, SAT)
- Detalles completos de MCH-M10 (Predictions) y MCH-M11 (MCP Server)
- Matriz de dependencias expandida

SERVICES-CATALOG.md (+60 líneas):
- Agregado simco_version: 4.0.1
- Services: 18+ -> 30+
- Nuevos módulos: MCP Server, Predictions, Onboarding, Notifications
- Inyección de dependencias actualizada

_INDEX.yml:
- version: 1.0.0 -> 1.1.0
- Totales actualizados (entities: 35, services: 30, modules: 24)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 04:50:04 -06:00

226 lines
6.5 KiB
Markdown

---
id: DEF-MCH-MODULES
type: Definition
title: "Modules Catalog"
simco_version: "4.0.1"
updated_at: 2026-01-17
---
# Modules Catalog - MiChangarrito
**Alias:** @MCH_DEF_MODULES
**Version:** 1.0.0
**Ultima actualizacion:** 2026-01-17
---
## 1. RESUMEN
| Metrica | Valor |
|---------|-------|
| **Total Modulos** | 24 |
| **En Produccion** | 24 |
| **En Desarrollo** | 0 |
---
## 2. INDICE DE MODULOS
### 2.1 Modulos Core (Fase 1)
| ID | Nombre | Estado | Epica |
|----|--------|--------|-------|
| MCH-M01 | Auth | Produccion | MCH-002 |
| MCH-M02 | Users | Produccion | MCH-001 |
| MCH-M03 | Stores | Produccion | MCH-001 |
| MCH-M04 | Products | Produccion | MCH-003 |
| MCH-M05 | Sales (POS) | Produccion | MCH-004 |
| MCH-M06 | Payments | Produccion | MCH-005 |
### 2.2 Modulos Inteligencia (Fase 2-3)
| ID | Nombre | Estado | Epica |
|----|--------|--------|-------|
| MCH-M07 | Onboarding | Produccion | MCH-006 |
| MCH-M08 | Templates | Produccion | MCH-007 |
| MCH-M09 | Fiados | Produccion | MCH-008 |
| MCH-M10 | Predictions | Produccion | MCH-009 |
| MCH-M11 | MCP Server | Produccion | MCH-010 |
| MCH-M12 | WhatsApp | Produccion | MCH-011 |
| MCH-M13 | LLM Chat | Produccion | MCH-012/013 |
| MCH-M13a | Analytics | Produccion | MCH-016 |
### 2.3 Modulos Negocio (Fase 4-5)
| ID | Nombre | Estado | Epica |
|----|--------|--------|-------|
| MCH-M14 | Customers | Produccion | MCH-014 |
| MCH-M15 | Orders | Produccion | MCH-015 |
| MCH-M16 | Deliveries | Produccion | MCH-016 |
| MCH-M17 | Notifications | Produccion | MCH-017 |
| MCH-M18 | Subscriptions | Produccion | MCH-018/019/020 |
| MCH-M19 | Offline | Produccion | MCH-022 |
| MCH-M20 | Referrals | Produccion | MCH-023 |
| MCH-M21 | CoDi/SPEI | Produccion | MCH-024 |
| MCH-M22 | Widgets | Produccion | MCH-025 |
| MCH-M23 | i18n | Produccion | MCH-026 |
| MCH-M24 | SAT/Facturacion | Produccion | MCH-027 |
---
## 3. DETALLE POR MODULO
### MCH-M01: Auth
```yaml
modulo:
id: "MCH-M01"
nombre: "Authentication"
estado: "produccion"
version: "1.0.0"
documentacion:
especificacion: "docs/01-epicas/MCH-002-autenticacion.md"
requerimientos: ["RF-AUTH-001", "RF-AUTH-002"]
objetos:
tablas: ["users", "sessions", "refresh_tokens"]
entities: ["User", "Session", "RefreshToken"]
services: ["AuthService", "JwtService", "SessionService"]
controllers: ["AuthController"]
dependencias:
modulos: []
externos: ["@nestjs/jwt", "@nestjs/passport"]
```
### MCH-M05: Sales (POS)
```yaml
modulo:
id: "MCH-M05"
nombre: "Punto de Venta"
estado: "produccion"
version: "1.0.0"
documentacion:
especificacion: "docs/01-epicas/MCH-004-punto-venta.md"
requerimientos: ["RF-POS-001", "RF-POS-002", "RF-POS-003"]
objetos:
tablas: ["sales", "sale_items", "payments", "cash_registers"]
entities: ["Sale", "SaleItem", "Payment", "CashRegister"]
services: ["SalesService", "PaymentsService", "CashRegisterService"]
controllers: ["SalesController", "PaymentsController"]
dependencias:
modulos: ["MCH-M04", "MCH-M14"]
externos: ["stripe"]
```
### MCH-M09: Fiados
```yaml
modulo:
id: "MCH-M09"
nombre: "Sistema Fiados"
estado: "produccion"
version: "1.0.0"
documentacion:
especificacion: "docs/01-epicas/MCH-008-sistema-fiados.md"
objetos:
tablas: ["fiados", "fiado_payments", "credit_limits"]
entities: ["Fiado", "FiadoPayment", "CreditLimit"]
services: ["FiadosService", "CreditService"]
controllers: ["FiadosController"]
dependencias:
modulos: ["MCH-M14", "MCH-M05"]
externos: []
```
### MCH-M10: Predictions
```yaml
modulo:
id: "MCH-M10"
nombre: "Predictions"
estado: "produccion"
version: "1.0.0"
documentacion:
especificacion: "docs/01-epicas/MCH-009-prediccion-inventario.md"
objetos:
tablas: ["inventory_predictions", "reorder_suggestions"]
entities: ["InventoryPrediction", "ReorderSuggestion"]
services: ["PredictionsService", "ReorderService", "AlertsService"]
controllers: ["PredictionsController"]
dependencias:
modulos: ["MCH-M04", "MCH-M05"]
externos: []
```
### MCH-M11: MCP Server
```yaml
modulo:
id: "MCH-M11"
nombre: "MCP Server"
estado: "produccion"
version: "1.0.0"
documentacion:
especificacion: "docs/01-epicas/MCH-010-mcp-server.md"
requerimientos: ["RF-MCP-001", "RF-MCP-002"]
objetos:
tablas: ["conversations", "messages", "tool_calls"]
entities: ["Conversation", "Message", "ToolCall"]
services: ["MCPService", "ToolsService", "ConversationsService"]
controllers: ["MCPController"]
dependencias:
modulos: ["MCH-M04", "MCH-M05", "MCH-M09", "MCH-M14"]
externos: ["openrouter", "@anthropic-ai/sdk"]
```
---
## 4. MATRIZ DE DEPENDENCIAS
```
┌────────────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┐
│ │ Auth │ User │Store │ Prod │ Sale │ Cust │ Pred │ MCP │
├────────────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┼──────┤
│ Auth │ - │ -> │ │ │ │ │ │ │
│ Users │ <- │ - │ -> │ │ │ │ │ │
│ Stores │ │ <- │ - │ -> │ -> │ -> │ │ │
│ Products │ │ │ <- │ - │ │ │ -> │ -> │
│ Sales │ │ │ <- │ <- │ - │ <- │ -> │ -> │
│ Customers │ │ │ <- │ │ -> │ - │ │ -> │
│ Fiados │ │ │ │ │ <- │ <- │ │ -> │
│ Orders │ │ │ <- │ <- │ │ <- │ │ │
│ Predictions│ │ │ │ <- │ <- │ │ - │ │
│ MCP │ │ │ │ <- │ <- │ <- │ │ - │
└────────────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┘
Leyenda: -> depende de, <- es dependido por
```
---
## 5. REFERENCIAS
- Database: @MCH_DEF_DB
- Entities: @MCH_DEF_ENTITIES
- Services: @MCH_DEF_SERVICES
- Navegacion rapida: @MCH_QUICK_MODULES
---
*Definicion canonica v1.0.0 - MiChangarrito*