miinventario-v2/docs/_definitions/MODULES-CATALOG.md
2026-01-16 04:21:07 -06:00

5.3 KiB

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

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

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

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