202 lines
5.3 KiB
Markdown
202 lines
5.3 KiB
Markdown
# 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*
|