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

154 lines
4.7 KiB
Markdown

# Services Catalog - MiInventario
**Alias:** @PROJ_DEF_SERVICES
**Version:** 1.0.0
**Ultima actualizacion:** 2026-01-16
---
## 1. RESUMEN
| Metrica | Valor |
|---------|-------|
| **Total Services** | 16 |
| **Por Modulo** | Ver seccion 2 |
---
## 2. SERVICES POR MODULO
### 2.1 Modulo: Auth
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| AuthService | `auth.service.ts` | JwtService, UsersService | Autenticacion JWT, OTP, login |
### 2.2 Modulo: Users
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| UsersService | `users.service.ts` | UserRepository | Gestion de usuarios y perfiles |
### 2.3 Modulo: Stores
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| StoresService | `stores.service.ts` | StoreRepository, StoreUserRepository | Gestion de tiendas multi-tenant |
### 2.4 Modulo: Inventory
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| InventoryService | `inventory.service.ts` | InventoryItemRepository | Gestion de items de inventario |
### 2.5 Modulo: Videos
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| VideosService | `videos.service.ts` | VideoRepository, S3, IaProviderService | Upload y procesamiento de videos |
### 2.6 Modulo: Credits
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| CreditsService | `credits.service.ts` | CreditBalanceRepository, CreditTransactionRepository | Sistema de creditos |
### 2.7 Modulo: Payments
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| PaymentsService | `payments.service.ts` | PaymentRepository, CreditsService, Stripe | Procesamiento de pagos |
### 2.8 Modulo: Referrals
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| ReferralsService | `referrals.service.ts` | ReferralRepository, CreditsService | Sistema de referidos |
### 2.9 Modulo: Notifications
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| NotificationsService | `notifications.service.ts` | NotificationRepository, FCM | Notificaciones push |
### 2.10 Modulo: IA Provider
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| IaProviderService | `ia-provider.service.ts` | OpenAI, Anthropic | Abstraccion multi-proveedor IA |
### 2.11 Modulo: Admin
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| DashboardService | `services/dashboard.service.ts` | Multiple repositories | Dashboard de metricas |
| ModerationService | `services/moderation.service.ts` | ProductSubmissionRepository | Moderacion de contenido |
| PackagesService | `services/packages.service.ts` | CreditPackageRepository | Gestion de paquetes |
| PromotionsService | `services/promotions.service.ts` | PromotionRepository | Gestion de promociones |
| ProvidersService | `services/providers.service.ts` | IaProviderRepository | Config de proveedores IA |
| AuditLogService | `services/audit-log.service.ts` | AuditLogRepository | Registro de auditoria |
### 2.12 Modulo: Feedback
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| FeedbackService | `feedback.service.ts` | CorrectionRepository, GroundTruthRepository | Sistema de feedback |
### 2.13 Modulo: Validations
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| ValidationsService | `validations.service.ts` | ValidationRequestRepository | Validaciones |
| ValidationEngineService | `validation-engine.service.ts` | IaProviderService | Motor de validacion |
---
## 3. INYECCION DE DEPENDENCIAS
```yaml
dependencias:
AuthService:
inyecta:
- JwtService
- UsersService
- ConfigService
inyectado_en:
- AuthController
PaymentsService:
inyecta:
- CreditsService
- NotificationsService
- ConfigService (Stripe)
inyectado_en:
- PaymentsController
IaProviderService:
inyecta:
- ConfigService
inyectado_en:
- VideosService
- ValidationEngineService
CreditsService:
inyecta:
- CreditBalanceRepository
- CreditTransactionRepository
inyectado_en:
- PaymentsService
- ReferralsService
- VideosService
```
---
## 4. REFERENCIAS
- Entities: @PROJ_DEF_ENTITIES
- Controllers: Ver documentacion API
- Ubicacion: `apps/backend/src/modules/*/`
---
*Generado: 2026-01-16*