michangarrito/docs/_definitions/SERVICES-CATALOG.md
2026-01-16 04:14:27 -06:00

147 lines
4.3 KiB
Markdown

# Services Catalog - MiChangarrito
**Alias:** @MCH_DEF_SERVICES
**Version:** 1.0.0
**Ultima actualizacion:** 2026-01-16
---
## 1. RESUMEN
| Metrica | Valor |
|---------|-------|
| **Total Services** | 18+ |
| **Por Modulo** | Ver seccion 2 |
---
## 2. SERVICES POR MODULO
### 2.1 Modulo: Auth
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| AuthService | `auth.service.ts` | JwtService, UsersService | Autenticacion de usuarios |
| JwtService | `jwt.service.ts` | ConfigService | Generacion/validacion JWT |
| SessionService | `session.service.ts` | Repository | Gestion de sesiones |
### 2.2 Modulo: Users
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| UsersService | `users.service.ts` | Repository | CRUD de usuarios |
### 2.3 Modulo: Stores
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| StoresService | `stores.service.ts` | Repository | CRUD de tiendas |
| StoreSettingsService | `store-settings.service.ts` | Repository | Configuracion de tiendas |
### 2.4 Modulo: Products
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| ProductsService | `products.service.ts` | Repository | CRUD de productos |
| CategoriesService | `categories.service.ts` | Repository | CRUD de categorias |
| InventoryService | `inventory.service.ts` | Repository | Control de stock |
### 2.5 Modulo: Sales (POS)
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| SalesService | `sales.service.ts` | Repository, ProductsService | Procesamiento de ventas |
| PaymentsService | `payments.service.ts` | StripeService | Procesamiento de pagos |
| CashRegisterService | `cash-register.service.ts` | Repository | Control de caja |
### 2.6 Modulo: Customers
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| CustomersService | `customers.service.ts` | Repository | CRUD de clientes |
### 2.7 Modulo: Fiados
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| FiadosService | `fiados.service.ts` | Repository, CustomersService | Gestion de creditos |
| CreditService | `credit.service.ts` | Repository | Limites de credito |
### 2.8 Modulo: Orders
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| OrdersService | `orders.service.ts` | Repository, ProductsService | Gestion de pedidos |
| DeliveriesService | `deliveries.service.ts` | Repository | Entregas a domicilio |
### 2.9 Modulo: Subscriptions
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| SubscriptionsService | `subscriptions.service.ts` | Repository, StripeService | Gestion de suscripciones |
| PlansService | `plans.service.ts` | Repository | CRUD de planes |
| TokensService | `tokens.service.ts` | Repository | Gestion de tokens IA |
### 2.10 Modulo: Integraciones
| Service | Archivo | Dependencias | Descripcion |
|---------|---------|--------------|-------------|
| WhatsAppService | `whatsapp.service.ts` | HttpService, ConfigService | Integracion Meta API |
| LLMService | `llm.service.ts` | HttpService, ConfigService | Integracion OpenRouter |
| StripeService | `stripe.service.ts` | Stripe SDK | Integracion Stripe |
---
## 3. INYECCION DE DEPENDENCIAS
```yaml
dependencias:
AuthService:
inyecta:
- JwtService
- UsersService
- SessionService
inyectado_en:
- AuthController
- JwtAuthGuard
SalesService:
inyecta:
- ProductsService
- InventoryService
- PaymentsService
inyectado_en:
- SalesController
- OrdersService
FiadosService:
inyecta:
- CustomersService
- CreditService
inyectado_en:
- FiadosController
- SalesService
WhatsAppService:
inyecta:
- HttpService
- ConfigService
- LLMService
inyectado_en:
- WhatsAppController
- OrdersService
- NotificationsService
```
---
## 4. REFERENCIAS
- Entities: @MCH_DEF_ENTITIES
- Controllers: Ver documentacion API en `/api/docs`
- Ubicacion: `apps/backend/src/modules/*/services/`
---
*Definicion canonica v1.0.0 - MiChangarrito*