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

5.0 KiB

id type title simco_version updated_at validated
DEF-MCH-SERVICES Definition Services Catalog 4.0.1 2026-01-17 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

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