michangarrito/docs/_definitions/SERVICES-CATALOG.md
rckrdmrd 5552e64ce6 [MCH-DOC-VAL] docs: Validar documentacion vs codigo - corregir discrepancias
Validacion completa de documentacion tecnica contra codigo real:
- ENTITIES-CATALOG.md: 35+ -> 38 entities (validado)
- SERVICES-CATALOG.md: 30+ -> 18 services (validado)
- MODULES-CATALOG.md: 24 -> 17 modulos (validado)
- DATABASE-SCHEMA.md: Corregido - TypeORM genera tablas, no hay SQL separado
- _INDEX.yml: Metricas actualizadas y marcadas como validadas
- MASTER_INVENTORY.yml: Sincronizado con conteos reales

Discrepancias corregidas:
- La doc anterior incluia objetos planificados como implementados
- Schemas 15 -> 1 (public, TypeORM)
- Tablas ~65 -> 38 (1:1 con entities)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-17 05:10:29 -06:00

206 lines
5.0 KiB
Markdown

---
id: DEF-MCH-SERVICES
type: Definition
title: "Services Catalog"
simco_version: "4.0.1"
updated_at: 2026-01-17
validated: true
---
# Services Catalog - MiChangarrito
**Alias:** @MCH_DEF_SERVICES
**Version:** 2.0.0
**Ultima actualizacion:** 2026-01-17
**Estado:** VALIDADO vs Codigo
---
## 1. RESUMEN
| Metrica | Valor |
|---------|-------|
| **Total Services** | 18 |
| **Por Modulo** | Ver seccion 2 |
---
## 2. SERVICES POR MODULO
### 2.1 Auth
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| AuthService | `auth.service.ts` | Autenticacion JWT, registro, login |
### 2.2 Billing
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| BillingService | `billing.service.ts` | Facturacion CFDI 4.0 |
### 2.3 Categories
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| CategoriesService | `categories.service.ts` | CRUD de categorias |
### 2.4 CoDi-SPEI
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| CodiSpeiService | `codi-spei.service.ts` | Transacciones CoDi y SPEI |
### 2.5 Customers
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| CustomersService | `customers.service.ts` | CRUD de clientes y fiados |
### 2.6 Integrations
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| TenantIntegrationsService | `tenant-integrations.service.ts` | Credenciales por tenant |
### 2.7 Inventory
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| InventoryService | `inventory.service.ts` | Control de stock y movimientos |
### 2.8 Invoices
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| InvoicesService | `invoices.service.ts` | Gestion de facturas |
### 2.9 Marketplace
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| MarketplaceService | `marketplace.service.ts` | Proveedores B2B y ordenes |
### 2.10 Messaging
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| MessagingService | `messaging.service.ts` | Conversaciones y notificaciones |
### 2.11 Orders
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| OrdersService | `orders.service.ts` | Gestion de pedidos |
### 2.12 Payments
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| PaymentsService | `payments.service.ts` | Metodos de pago |
| StripeService | `stripe.service.ts` | Integracion Stripe |
### 2.13 Products
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| ProductsService | `products.service.ts` | CRUD de productos |
### 2.14 Referrals
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| ReferralsService | `referrals.service.ts` | Sistema de referidos |
### 2.15 Sales
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| SalesService | `sales.service.ts` | Punto de venta |
### 2.16 Subscriptions
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| SubscriptionsService | `subscriptions.service.ts` | Planes y tokens IA |
### 2.17 Widgets
| Service | Archivo | Descripcion |
|---------|---------|-------------|
| WidgetsService | `widgets.service.ts` | Widgets y atajos |
---
## 3. INYECCION DE DEPENDENCIAS
```yaml
dependencias:
AuthService:
inyecta: [JwtService, ConfigService]
inyectado_en: [AuthController, JwtAuthGuard]
SalesService:
inyecta: [ProductsService, InventoryService, CustomersService]
inyectado_en: [SalesController]
CustomersService:
inyecta: [Repository]
inyectado_en: [CustomersController, SalesService]
InventoryService:
inyecta: [ProductsService]
inyectado_en: [InventoryController, SalesService]
SubscriptionsService:
inyecta: [StripeService, Repository]
inyectado_en: [SubscriptionsController]
MarketplaceService:
inyecta: [Repository]
inyectado_en: [MarketplaceController]
MessagingService:
inyecta: [Repository, NotificationGateway]
inyectado_en: [MessagingController]
```
---
## 4. UBICACION EN CODIGO
```
backend/src/modules/
├── auth/auth.service.ts
├── billing/billing.service.ts
├── categories/categories.service.ts
├── codi-spei/codi-spei.service.ts
├── customers/customers.service.ts
├── integrations/tenant-integrations.service.ts
├── inventory/inventory.service.ts
├── invoices/invoices.service.ts
├── marketplace/marketplace.service.ts
├── messaging/messaging.service.ts
├── orders/orders.service.ts
├── payments/
│ ├── payments.service.ts
│ └── stripe.service.ts
├── products/products.service.ts
├── referrals/referrals.service.ts
├── sales/sales.service.ts
├── subscriptions/subscriptions.service.ts
└── widgets/widgets.service.ts
```
---
## 5. REFERENCIAS
- Entities: @MCH_DEF_ENTITIES
- Modules: @MCH_DEF_MODULES
- Backend Inventory: orchestration/inventarios/BACKEND_INVENTORY.yml
---
*Definicion canonica v2.0.0 - MiChangarrito - VALIDADO*