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>
206 lines
5.0 KiB
Markdown
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*
|