# 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*