michangarrito/docs/_definitions/ENTITIES-CATALOG.md

id	type	title	simco_version	updated_at	validated
DEF-MCH-ENTITIES	Definition	Entities Catalog	4.0.1	2026-01-17	true

Entities Catalog - MiChangarrito

Alias: @MCH_DEF_ENTITIES Version: 2.0.0 Ultima actualizacion: 2026-01-17 Estado: VALIDADO vs Codigo

---

1. RESUMEN

Metrica	Valor
Total Entities	38
Total Modulos con Entities	15
Modulos sin Entities	2 (billing, widgets)

---

2. ENTITIES POR MODULO

2.1 Modulo: Auth (2 entities)

Entity	Archivo	Descripcion
Tenant	tenant.entity.ts	Tiendas/Changarritos (multi-tenant)
User	user.entity.ts	Usuarios del sistema

2.2 Modulo: Categories (1 entity)

Entity	Archivo	Descripcion
Category	category.entity.ts	Categorias de productos

2.3 Modulo: CoDi-SPEI (3 entities)

Entity	Archivo	Descripcion
CodiTransaction	codi-transaction.entity.ts	Transacciones CoDi
SpeiTransaction	spei-transaction.entity.ts	Transacciones SPEI
VirtualAccount	virtual-account.entity.ts	Cuentas virtuales para recepcion

2.4 Modulo: Customers (3 entities)

Entity	Archivo	Descripcion
Customer	customer.entity.ts	Clientes del changarrito
Fiado	fiado.entity.ts	Creditos/fiados otorgados
FiadoPayment	fiado-payment.entity.ts	Pagos de fiados

2.5 Modulo: Integrations (2 entities)

Entity	Archivo	Descripcion
TenantIntegrationCredential	tenant-integration-credential.entity.ts	Credenciales por tenant
TenantWhatsappNumber	tenant-whatsapp-number.entity.ts	Numeros WhatsApp por tenant

2.6 Modulo: Inventory (2 entities)

Entity	Archivo	Descripcion
InventoryMovement	inventory-movement.entity.ts	Movimientos de inventario
StockAlert	stock-alert.entity.ts	Alertas de stock bajo

2.7 Modulo: Invoices (3 entities)

Entity	Archivo	Descripcion
Invoice	invoice.entity.ts	Facturas CFDI
InvoiceItem	invoice-item.entity.ts	Items de factura
TaxConfig	tax-config.entity.ts	Configuracion fiscal

2.8 Modulo: Marketplace (6 entities)

Entity	Archivo	Descripcion
Supplier	supplier.entity.ts	Proveedores B2B
SupplierProduct	supplier-product.entity.ts	Productos de proveedores
SupplierOrder	supplier-order.entity.ts	Ordenes a proveedores
SupplierOrderItem	supplier-order-item.entity.ts	Items de orden
SupplierReview	supplier-review.entity.ts	Resenas de proveedores
SupplierFavorites	supplier-favorites.entity.ts	Proveedores favoritos

2.9 Modulo: Messaging (3 entities)

Entity	Archivo	Descripcion
Conversation	conversation.entity.ts	Conversaciones (WhatsApp/Chat)
Message	message.entity.ts	Mensajes de conversacion
Notification	notification.entity.ts	Notificaciones push/in-app

2.10 Modulo: Orders (2 entities)

Entity	Archivo	Descripcion
Order	order.entity.ts	Pedidos de clientes
OrderItem	order-item.entity.ts	Items del pedido

2.11 Modulo: Payments (1 entity)

Entity	Archivo	Descripcion
PaymentMethod	payment-method.entity.ts	Metodos de pago configurados

2.12 Modulo: Products (1 entity)

Entity	Archivo	Descripcion
Product	product.entity.ts	Productos del catalogo

2.13 Modulo: Referrals (3 entities)

Entity	Archivo	Descripcion
Referral	referral.entity.ts	Referidos registrados
ReferralCode	referral-code.entity.ts	Codigos de referido
ReferralReward	referral-reward.entity.ts	Recompensas por referidos

2.14 Modulo: Sales (2 entities)

Entity	Archivo	Descripcion
Sale	sale.entity.ts	Ventas POS
SaleItem	sale-item.entity.ts	Items de venta

2.15 Modulo: Subscriptions (4 entities)

Entity	Archivo	Descripcion
Plan	plan.entity.ts	Planes de suscripcion
Subscription	subscription.entity.ts	Suscripciones activas
TokenBalance	token-balance.entity.ts	Balance de tokens IA
TokenUsage	token-usage.entity.ts	Uso de tokens IA

---

3. MODULOS SIN ENTITIES

Modulo	Razon
billing	Logica de facturacion sin entity propia (usa Invoice)
widgets	Componentes UI, sin persistencia

---

4. RELACIONES PRINCIPALES

relaciones:
  Tenant:
    has_many: [User, Product, Sale, Order, Customer, Subscription]
    belongs_to: []

  User:
    has_many: [Conversation, Notification]
    belongs_to: [Tenant]

  Product:
    has_many: [SaleItem, OrderItem, InventoryMovement]
    belongs_to: [Tenant, Category]

  Sale:
    has_many: [SaleItem]
    belongs_to: [Tenant, Customer]

  Order:
    has_many: [OrderItem]
    belongs_to: [Tenant, Customer]

  Customer:
    has_many: [Sale, Order, Fiado]
    belongs_to: [Tenant]

  Fiado:
    has_many: [FiadoPayment]
    belongs_to: [Tenant, Customer]

  Conversation:
    has_many: [Message]
    belongs_to: [Tenant, User]

  Subscription:
    has_many: []
    belongs_to: [Tenant, Plan]

  Supplier:
    has_many: [SupplierProduct, SupplierOrder, SupplierReview]
    belongs_to: []

---

5. UBICACION EN CODIGO

backend/src/modules/
├── auth/entities/
│   ├── tenant.entity.ts
│   └── user.entity.ts
├── categories/entities/
│   └── category.entity.ts
├── codi-spei/entities/
│   ├── codi-transaction.entity.ts
│   ├── spei-transaction.entity.ts
│   └── virtual-account.entity.ts
├── customers/entities/
│   ├── customer.entity.ts
│   ├── fiado.entity.ts
│   └── fiado-payment.entity.ts
├── integrations/entities/
│   ├── tenant-integration-credential.entity.ts
│   └── tenant-whatsapp-number.entity.ts
├── inventory/entities/
│   ├── inventory-movement.entity.ts
│   └── stock-alert.entity.ts
├── invoices/entities/
│   ├── invoice.entity.ts
│   ├── invoice-item.entity.ts
│   └── tax-config.entity.ts
├── marketplace/entities/
│   ├── supplier.entity.ts
│   ├── supplier-product.entity.ts
│   ├── supplier-order.entity.ts
│   ├── supplier-order-item.entity.ts
│   ├── supplier-review.entity.ts
│   └── supplier-favorites.entity.ts
├── messaging/entities/
│   ├── conversation.entity.ts
│   ├── message.entity.ts
│   └── notification.entity.ts
├── orders/entities/
│   ├── order.entity.ts
│   └── order-item.entity.ts
├── payments/entities/
│   └── payment-method.entity.ts
├── products/entities/
│   └── product.entity.ts
├── referrals/entities/
│   ├── referral.entity.ts
│   ├── referral-code.entity.ts
│   └── referral-reward.entity.ts
├── sales/entities/
│   ├── sale.entity.ts
│   └── sale-item.entity.ts
└── subscriptions/entities/
    ├── plan.entity.ts
    ├── subscription.entity.ts
    ├── token-balance.entity.ts
    └── token-usage.entity.ts

---

6. REFERENCIAS

• Database Schema: @MCH_DEF_DB
• Services: @MCH_DEF_SERVICES
• Backend Inventory: orchestration/inventarios/BACKEND_INVENTORY.yml

---

Definicion canonica v2.0.0 - MiChangarrito - VALIDADO