# Modules Catalog - MiInventario

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

---

## 1. RESUMEN

| Metrica | Valor |
|---------|-------|
| **Total Modulos** | 14 |
| **Implementados** | 14 |
| **En Desarrollo** | 0 |

---

## 2. INDICE DE MODULOS

### 2.1 Modulos Core (Fundacionales)

| ID | Nombre | Estado | Endpoints | Descripcion |
|----|--------|--------|-----------|-------------|
| MII-MOD-001 | Auth | Implementado | 5 | Autenticacion JWT, OTP |
| MII-MOD-002 | Users | Implementado | 3 | Gestion de usuarios |
| MII-MOD-003 | Stores | Implementado | 5 | Tiendas multi-tenant |
| MII-MOD-004 | Health | Implementado | 2 | Health checks |

### 2.2 Modulos de Negocio

| ID | Nombre | Estado | Endpoints | Descripcion |
|----|--------|--------|-----------|-------------|
| MII-MOD-005 | Inventory | Implementado | 7 | Gestion de inventario |
| MII-MOD-006 | Videos | Implementado | - | Captura y procesamiento (interno) |
| MII-MOD-007 | Credits | Implementado | 3 | Sistema de creditos |
| MII-MOD-008 | Payments | Implementado | 4 | Procesamiento de pagos |
| MII-MOD-009 | Referrals | Implementado | 5 | Sistema de referidos |

### 2.3 Modulos de Soporte

| ID | Nombre | Estado | Endpoints | Descripcion |
|----|--------|--------|-----------|-------------|
| MII-MOD-010 | Notifications | Implementado | 5 | Notificaciones push |
| MII-MOD-011 | IA Provider | Implementado | - | Multi-proveedor IA (interno) |
| MII-MOD-012 | Admin | Implementado | 17 | Panel de administracion |
| MII-MOD-013 | Feedback | Implementado | 6 | Sistema de feedback |
| MII-MOD-014 | Validations | Implementado | 4 | Validaciones IA |

---

## 3. DETALLE POR MODULO

### MII-MOD-001: Auth

```yaml
modulo:
  id: "MII-MOD-001"
  nombre: "Authentication"
  estado: "implementado"
  version: "1.0.0"

  documentacion:
    epica: "MII-002"
    descripcion: "Autenticacion JWT con OTP para verificacion"

  objetos:
    tablas: [otps, refresh_tokens]
    entities: [Otp, RefreshToken]
    services: [AuthService]
    controllers: [AuthController]
    guards: [JwtAuthGuard]
    strategies: [JwtStrategy]

  endpoints:
    - POST /auth/register
    - POST /auth/verify-otp
    - POST /auth/login
    - POST /auth/refresh
    - POST /auth/logout

  dependencias:
    modulos: [users]
    externos: [JWT, bcrypt]
```

### MII-MOD-005: Inventory

```yaml
modulo:
  id: "MII-MOD-005"
  nombre: "Inventory"
  estado: "implementado"
  version: "1.0.0"

  documentacion:
    epica: "MII-006"
    descripcion: "Gestion de items de inventario detectados por IA"

  objetos:
    tablas: [inventory_items]
    entities: [InventoryItem]
    services: [InventoryService]
    controllers: [InventoryController]

  endpoints:
    - GET /stores/:storeId/inventory
    - GET /stores/:storeId/inventory/statistics
    - GET /stores/:storeId/inventory/low-stock
    - GET /stores/:storeId/inventory/categories
    - GET /stores/:storeId/inventory/:itemId
    - PATCH /stores/:storeId/inventory/:itemId
    - DELETE /stores/:storeId/inventory/:itemId

  dependencias:
    modulos: [auth, stores]
    externos: []
```

### MII-MOD-012: Admin

```yaml
modulo:
  id: "MII-MOD-012"
  nombre: "Admin"
  estado: "implementado"
  version: "1.0.0"

  documentacion:
    epica: "MII-015"
    descripcion: "Panel de administracion SaaS"

  objetos:
    tablas: [audit_logs, promotions, ia_providers]
    entities: [AuditLog, Promotion, IaProvider]
    services:
      - DashboardService
      - ModerationService
      - PackagesService
      - PromotionsService
      - ProvidersService
      - AuditLogService
    controllers: [AdminController]

  endpoints:
    - GET /admin/dashboard
    - GET /admin/dashboard/stats
    - GET /admin/moderation
    - PATCH /admin/moderation/:id
    - GET /admin/packages
    - POST /admin/packages
    - PATCH /admin/packages/:id
    - DELETE /admin/packages/:id
    - GET /admin/promotions
    - POST /admin/promotions
    - PATCH /admin/promotions/:id
    - DELETE /admin/promotions/:id
    - GET /admin/providers
    - PATCH /admin/providers/:id
    - GET /admin/audit-log
    - GET /admin/audit-log/:id
    - GET /admin/users

  dependencias:
    modulos: [auth, users]
    externos: []
```

---

## 4. MATRIZ DE DEPENDENCIAS

```
                Auth Users Stores Inventory Videos Credits Payments Referrals Notif IAP Admin Feedback Valid
Auth             -
Users            x     -
Stores           x     x     -
Inventory        x           x       -
Videos           x           x       x         -
Credits          x     x                                -
Payments         x                             x        x     -
Referrals        x     x                                x             -
Notifications    x     x                                                        -
IA Provider                                                                           -
Admin            x     x                                                                   -
Feedback         x     x     x                                                                    -
Validations      x           x       x                                                                  -
```

---

## 5. REFERENCIAS

- Database: @PROJ_DEF_DB
- Entities: @PROJ_DEF_ENTITIES
- Services: @PROJ_DEF_SERVICES
- Navegacion rapida: @PROJ_QUICK_MODULES

---

*Generado: 2026-01-16*