# Modules Catalog - MiChangarrito

**Alias:** @MCH_DEF_MODULES
**Version:** 1.0.0
**Ultima actualizacion:** 2026-01-16

---

## 1. RESUMEN

| Metrica | Valor |
|---------|-------|
| **Total Modulos** | 18 |
| **En Produccion** | 18 |
| **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 |

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

---

## 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: []
```

---

## 4. MATRIZ DE DEPENDENCIAS

```
┌──────────┬──────┬──────┬──────┬──────┬──────┬──────┐
│          │ Auth │ User │Store │ Prod │ Sale │ Cust │
├──────────┼──────┼──────┼──────┼──────┼──────┼──────┤
│ Auth     │  -   │  ->  │      │      │      │      │
│ Users    │  <-  │  -   │  ->  │      │      │      │
│ Stores   │      │  <-  │  -   │  ->  │  ->  │  ->  │
│ Products │      │      │  <-  │  -   │      │      │
│ Sales    │      │      │  <-  │  <-  │  -   │  <-  │
│ Customers│      │      │  <-  │      │  ->  │  -   │
│ Fiados   │      │      │      │      │  <-  │  <-  │
│ Orders   │      │      │  <-  │  <-  │      │  <-  │
└──────────┴──────┴──────┴──────┴──────┴──────┴──────┘

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*