miinventario-v2/docs/_definitions/ENTITIES-CATALOG.md

Entities Catalog - MiInventario

Alias: @PROJ_DEF_ENTITIES Version: 1.0.0 Ultima actualizacion: 2026-01-16

---

1. RESUMEN

Metrica	Valor
Total Entities	21
Por Modulo	Ver seccion 2

---

2. ENTITIES POR MODULO

2.1 Modulo: Auth

Entity	Archivo	Tabla BD	Descripcion
Otp	auth/entities/otp.entity.ts	otps	Codigos OTP para verificacion
RefreshToken	auth/entities/refresh-token.entity.ts	refresh_tokens	Tokens de refresco JWT

2.2 Modulo: Users

Entity	Archivo	Tabla BD	Descripcion
User	users/entities/user.entity.ts	users	Usuarios del sistema

2.3 Modulo: Stores

Entity	Archivo	Tabla BD	Descripcion
Store	stores/entities/store.entity.ts	stores	Tiendas de usuarios
StoreUser	stores/entities/store-user.entity.ts	store_users	Relacion usuarios-tiendas

2.4 Modulo: Inventory

Entity	Archivo	Tabla BD	Descripcion
InventoryItem	inventory/entities/inventory-item.entity.ts	inventory_items	Items de inventario detectados

2.5 Modulo: Videos

Entity	Archivo	Tabla BD	Descripcion
Video	videos/entities/video.entity.ts	videos	Videos subidos para procesamiento

2.6 Modulo: Credits

Entity	Archivo	Tabla BD	Descripcion
CreditBalance	credits/entities/credit-balance.entity.ts	credit_balances	Saldos de creditos
CreditPackage	credits/entities/credit-package.entity.ts	credit_packages	Paquetes disponibles
CreditTransaction	credits/entities/credit-transaction.entity.ts	credit_transactions	Transacciones

2.7 Modulo: Payments

Entity	Archivo	Tabla BD	Descripcion
Payment	payments/entities/payment.entity.ts	payments	Pagos de usuarios

2.8 Modulo: Referrals

Entity	Archivo	Tabla BD	Descripcion
Referral	referrals/entities/referral.entity.ts	referrals	Sistema de referidos

2.9 Modulo: Notifications

Entity	Archivo	Tabla BD	Descripcion
Notification	notifications/entities/notification.entity.ts	notifications	Notificaciones

2.10 Modulo: Admin

Entity	Archivo	Tabla BD	Descripcion
AuditLog	admin/entities/audit-log.entity.ts	audit_logs	Registros de auditoria
Promotion	admin/entities/promotion.entity.ts	promotions	Promociones
IaProvider	admin/entities/ia-provider.entity.ts	ia_providers	Proveedores de IA

2.11 Modulo: Feedback

Entity	Archivo	Tabla BD	Descripcion
Correction	feedback/entities/correction.entity.ts	corrections	Correcciones de usuarios
GroundTruth	feedback/entities/ground-truth.entity.ts	ground_truth	Datos verificados
ProductSubmission	feedback/entities/product-submission.entity.ts	product_submissions	Productos enviados

2.12 Modulo: Validations

Entity	Archivo	Tabla BD	Descripcion
ValidationRequest	validations/entities/validation-request.entity.ts	validation_requests	Solicitudes de validacion
ValidationResponse	validations/entities/validation-response.entity.ts	validation_responses	Respuestas de validacion

---

3. RELACIONES ENTRE ENTITIES

relaciones:
  User:
    has_many: [RefreshToken, Store, StoreUser, Video, CreditTransaction, Payment, Referral, Notification, Correction, AuditLog]
    has_one: [CreditBalance]

  Store:
    belongs_to: [User]
    has_many: [StoreUser, Video, InventoryItem]

  Video:
    belongs_to: [Store, User]
    has_many: [InventoryItem]

  InventoryItem:
    belongs_to: [Store, Video]
    has_many: [Correction]

  CreditBalance:
    belongs_to: [User]

  CreditTransaction:
    belongs_to: [User]

  Payment:
    belongs_to: [User, CreditPackage]

  Referral:
    belongs_to: [User (referrer), User (referred)]

  ValidationRequest:
    belongs_to: [Video, InventoryItem]
    has_many: [ValidationResponse]

  ValidationResponse:
    belongs_to: [ValidationRequest, IaProvider]

---

4. REFERENCIAS

• Database Schema: @PROJ_DEF_DB
• Services: @PROJ_DEF_SERVICES
• Ubicacion: apps/backend/src/modules/*/entities/

---

Generado: 2026-01-16