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

6.5 KiB

id type title simco_version updated_at
DEF-MCH-MODULES Definition Modules Catalog 4.0.1 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

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)

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

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

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

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