rckrdmrd
5552e64ce6
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>
225 lines
6.7 KiB
Markdown
225 lines
6.7 KiB
Markdown
---
|
|
id: DEF-MCH-DB
|
|
type: Definition
|
|
title: "Database Schema"
|
|
simco_version: "4.0.1"
|
|
updated_at: 2026-01-17
|
|
validated: true
|
|
---
|
|
|
|
# Database Schema - MiChangarrito
|
|
|
|
**Alias:** @MCH_DEF_DB
|
|
**Version:** 2.0.0
|
|
**Ultima actualizacion:** 2026-01-17
|
|
**Estado:** VALIDADO vs Codigo
|
|
|
|
---
|
|
|
|
## 1. RESUMEN
|
|
|
|
| Metrica | Valor |
|
|
|---------|-------|
|
|
| **ORM** | TypeORM 0.3.19 |
|
|
| **DB Engine** | PostgreSQL 16+ |
|
|
| **Schema** | public (unico) |
|
|
| **Total Tablas** | 38 (generadas por entities) |
|
|
| **Multi-tenant** | Si (tenant_id en todas las tablas) |
|
|
|
|
**Nota:** Este proyecto utiliza TypeORM con migraciones automaticas. Las tablas se generan a partir de las entities definidas en `backend/src/modules/*/entities/`.
|
|
|
|
---
|
|
|
|
## 2. TABLAS POR MODULO
|
|
|
|
### 2.1 Auth (2 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| tenants | Tenant | Tiendas/Changarritos (multi-tenant root) |
|
|
| users | User | Usuarios del sistema |
|
|
|
|
### 2.2 Categories (1 tabla)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| categories | Category | Categorias de productos |
|
|
|
|
### 2.3 CoDi-SPEI (3 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| codi_transactions | CodiTransaction | Transacciones CoDi |
|
|
| spei_transactions | SpeiTransaction | Transacciones SPEI |
|
|
| virtual_accounts | VirtualAccount | Cuentas virtuales |
|
|
|
|
### 2.4 Customers (3 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| customers | Customer | Clientes del changarrito |
|
|
| fiados | Fiado | Creditos/fiados |
|
|
| fiado_payments | FiadoPayment | Pagos de fiados |
|
|
|
|
### 2.5 Integrations (2 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| tenant_integration_credentials | TenantIntegrationCredential | Credenciales por tenant |
|
|
| tenant_whatsapp_numbers | TenantWhatsappNumber | Numeros WhatsApp |
|
|
|
|
### 2.6 Inventory (2 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| inventory_movements | InventoryMovement | Movimientos de stock |
|
|
| stock_alerts | StockAlert | Alertas de stock bajo |
|
|
|
|
### 2.7 Invoices (3 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| invoices | Invoice | Facturas CFDI |
|
|
| invoice_items | InvoiceItem | Items de factura |
|
|
| tax_configs | TaxConfig | Configuracion fiscal |
|
|
|
|
### 2.8 Marketplace (6 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| suppliers | Supplier | Proveedores B2B |
|
|
| supplier_products | SupplierProduct | Productos de proveedores |
|
|
| supplier_orders | SupplierOrder | Ordenes a proveedores |
|
|
| supplier_order_items | SupplierOrderItem | Items de orden |
|
|
| supplier_reviews | SupplierReview | Resenas |
|
|
| supplier_favorites | SupplierFavorites | Favoritos |
|
|
|
|
### 2.9 Messaging (3 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| conversations | Conversation | Conversaciones |
|
|
| messages | Message | Mensajes |
|
|
| notifications | Notification | Notificaciones |
|
|
|
|
### 2.10 Orders (2 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| orders | Order | Pedidos |
|
|
| order_items | OrderItem | Items del pedido |
|
|
|
|
### 2.11 Payments (1 tabla)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| payment_methods | PaymentMethod | Metodos de pago |
|
|
|
|
### 2.12 Products (1 tabla)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| products | Product | Productos del catalogo |
|
|
|
|
### 2.13 Referrals (3 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| referrals | Referral | Referidos |
|
|
| referral_codes | ReferralCode | Codigos |
|
|
| referral_rewards | ReferralReward | Recompensas |
|
|
|
|
### 2.14 Sales (2 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| sales | Sale | Ventas POS |
|
|
| sale_items | SaleItem | Items de venta |
|
|
|
|
### 2.15 Subscriptions (4 tablas)
|
|
|
|
| Tabla | Entity | Descripcion |
|
|
|-------|--------|-------------|
|
|
| plans | Plan | Planes de suscripcion |
|
|
| subscriptions | Subscription | Suscripciones |
|
|
| token_balances | TokenBalance | Balance de tokens IA |
|
|
| token_usages | TokenUsage | Uso de tokens |
|
|
|
|
---
|
|
|
|
## 3. RELACIONES PRINCIPALES
|
|
|
|
```
|
|
┌─────────────┐
|
|
│ tenants │ (Multi-tenant root)
|
|
└──────┬──────┘
|
|
│ 1:N
|
|
┌─────────────────┼─────────────────┐
|
|
│ │ │
|
|
┌────▼────┐ ┌─────▼─────┐ ┌──────▼──────┐
|
|
│ users │ │ products │ │ customers │
|
|
└─────────┘ └─────┬─────┘ └──────┬──────┘
|
|
│ 1:N │ 1:N
|
|
┌──────┴──────┐ │
|
|
│ │ │
|
|
┌────▼────┐ ┌─────▼─────┐ │
|
|
│ sales │ │ orders │◄───┘
|
|
└────┬────┘ └─────┬─────┘
|
|
│ │
|
|
┌────▼────┐ ┌─────▼─────┐
|
|
│sale_items│ │order_items│
|
|
└─────────┘ └───────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 4. INDICES Y CONSTRAINTS
|
|
|
|
### 4.1 Indices Principales
|
|
|
|
```sql
|
|
-- Multi-tenant
|
|
CREATE INDEX idx_products_tenant ON products(tenant_id);
|
|
CREATE INDEX idx_sales_tenant ON sales(tenant_id);
|
|
CREATE INDEX idx_customers_tenant ON customers(tenant_id);
|
|
|
|
-- Busquedas frecuentes
|
|
CREATE INDEX idx_products_barcode ON products(barcode);
|
|
CREATE INDEX idx_sales_date ON sales(created_at);
|
|
CREATE UNIQUE INDEX idx_users_email ON users(email);
|
|
```
|
|
|
|
### 4.2 Foreign Keys
|
|
|
|
- Todas las tablas tienen `tenant_id` -> `tenants.id`
|
|
- `products.category_id` -> `categories.id`
|
|
- `sales.customer_id` -> `customers.id`
|
|
- `sale_items.product_id` -> `products.id`
|
|
- `fiados.customer_id` -> `customers.id`
|
|
|
|
---
|
|
|
|
## 5. CONFIGURACION TYPEORM
|
|
|
|
```yaml
|
|
# backend/src/config/database.config.ts
|
|
typeorm:
|
|
type: "postgres"
|
|
synchronize: false # Usar migrations
|
|
logging: ["error", "warn"]
|
|
entities: ["dist/**/*.entity.js"]
|
|
migrations: ["dist/database/migrations/*.js"]
|
|
```
|
|
|
|
---
|
|
|
|
## 6. REFERENCIAS
|
|
|
|
- Entities: @MCH_DEF_ENTITIES
|
|
- Backend Inventory: orchestration/inventarios/BACKEND_INVENTORY.yml
|
|
- Database Inventory: orchestration/inventarios/DATABASE_INVENTORY.yml
|
|
|
|
---
|
|
|
|
*Definicion canonica v2.0.0 - MiChangarrito - VALIDADO*
|