michangarrito/docs/_definitions/ENTITIES-CATALOG.md

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

Entities Catalog - MiChangarrito

Alias: @MCH_DEF_ENTITIES Version: 1.0.0 Ultima actualizacion: 2026-01-17

---

1. RESUMEN

Metrica	Valor
Total Entities	35+
Por Modulo	Ver seccion 2

---

2. ENTITIES POR MODULO

2.1 Modulo: Core/Base

Entity	Archivo	Tabla BD	Descripcion
BaseEntity	base.entity.ts	-	Entity base abstracta
AuditEntity	audit.entity.ts	-	Entity con auditoria

2.2 Modulo: Auth

Entity	Archivo	Tabla BD	Descripcion
User	user.entity.ts	users	Usuarios del sistema
Session	session.entity.ts	sessions	Sesiones activas
RefreshToken	refresh-token.entity.ts	refresh_tokens	Tokens de refresco

2.3 Modulo: Stores

Entity	Archivo	Tabla BD	Descripcion
Store	store.entity.ts	stores	Changarritos
StoreSettings	store-settings.entity.ts	store_settings	Configuracion de tienda
StoreHours	store-hours.entity.ts	store_hours	Horarios de operacion

2.4 Modulo: Products

Entity	Archivo	Tabla BD	Descripcion
Product	product.entity.ts	products	Productos del catalogo
Category	category.entity.ts	categories	Categorias de productos
Inventory	inventory.entity.ts	inventory	Control de inventario

2.5 Modulo: Sales (POS)

Entity	Archivo	Tabla BD	Descripcion
Sale	sale.entity.ts	sales	Ventas realizadas
SaleItem	sale-item.entity.ts	sale_items	Items de venta
Payment	payment.entity.ts	payments	Pagos recibidos
CashRegister	cash-register.entity.ts	cash_registers	Caja registradora

2.6 Modulo: Orders

Entity	Archivo	Tabla BD	Descripcion
Order	order.entity.ts	orders	Pedidos
OrderItem	order-item.entity.ts	order_items	Items del pedido
Delivery	delivery.entity.ts	deliveries	Entregas a domicilio

2.7 Modulo: Customers

Entity	Archivo	Tabla BD	Descripcion
Customer	customer.entity.ts	customers	Clientes del changarrito
CustomerAddress	customer-address.entity.ts	customer_addresses	Direcciones de entrega

2.8 Modulo: Fiados

Entity	Archivo	Tabla BD	Descripcion
Fiado	fiado.entity.ts	fiados	Creditos otorgados
FiadoPayment	fiado-payment.entity.ts	fiado_payments	Pagos de fiados

2.9 Modulo: Subscriptions

Entity	Archivo	Tabla BD	Descripcion
Plan	plan.entity.ts	plans	Planes de suscripcion
Subscription	subscription.entity.ts	subscriptions	Suscripciones activas

2.10 Modulo: Tokens

Entity	Archivo	Tabla BD	Descripcion
TokenPackage	token-package.entity.ts	token_packages	Paquetes de tokens
TokenUsage	token-usage.entity.ts	token_usage	Uso de tokens IA

2.11 Modulo: AI/MCP

Entity	Archivo	Tabla BD	Descripcion
Conversation	conversation.entity.ts	ai.conversations	Conversaciones con LLM
Message	message.entity.ts	ai.messages	Mensajes de conversacion
ToolCall	tool-call.entity.ts	ai.tool_calls	Llamadas a tools MCP

2.12 Modulo: Predictions

Entity	Archivo	Tabla BD	Descripcion
InventoryPrediction	inventory-prediction.entity.ts	predictions.inventory_predictions	Cache de predicciones
ReorderSuggestion	reorder-suggestion.entity.ts	predictions.reorder_suggestions	Sugerencias de compra

2.13 Modulo: Onboarding

Entity	Archivo	Tabla BD	Descripcion
OnboardingSession	onboarding-session.entity.ts	onboarding.sessions	Sesiones de onboarding
ProductTemplate	product-template.entity.ts	templates.product_templates	Templates de productos

2.14 Modulo: Notifications

Entity	Archivo	Tabla BD	Descripcion
Notification	notification.entity.ts	notifications.notifications	Notificaciones del sistema
NotificationTemplate	notification-template.entity.ts	notifications.templates	Templates de notificacion
PushToken	push-token.entity.ts	notifications.push_tokens	Tokens FCM de dispositivos

---

3. RELACIONES ENTRE ENTITIES

relaciones:
  User:
    has_many: [Store, Session, RefreshToken, Subscription]
    belongs_to: []

  Store:
    has_many: [Product, Sale, Order, Customer, Fiado, StoreSettings]
    belongs_to: [User]

  Product:
    has_many: [SaleItem, OrderItem, Inventory]
    belongs_to: [Store, Category]

  Sale:
    has_many: [SaleItem, Payment]
    belongs_to: [Store, Customer]

  Order:
    has_many: [OrderItem, Delivery]
    belongs_to: [Store, Customer]

  Customer:
    has_many: [Sale, Order, Fiado, CustomerAddress]
    belongs_to: [Store]

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

  Conversation:
    has_many: [Message, ToolCall]
    belongs_to: [Store, User]

  OnboardingSession:
    has_many: []
    belongs_to: [Store]

  Notification:
    has_many: []
    belongs_to: [Store, User]

---

4. REFERENCIAS

• Database Schema: @MCH_DEF_DB
• Services: @MCH_DEF_SERVICES
• Ubicacion: apps/backend/src/modules/*/entities/

---

Definicion canonica v1.0.0 - MiChangarrito