rckrdmrd 97f407c661 [MIGRATION-V2] feat: Migrar michangarrito a estructura v2

- Prefijo v2: MCH
- TRACEABILITY-MASTER.yml creado
- Listo para integracion como submodulo

Workspace: v2.0.0 | SIMCO: v4.0.0

2026-01-10 11:28:54 -06:00

5.0 KiB

Raw Blame History

Reporte de Implementación - MiChangarrito

Fecha: 2026-01-05 Ejecutor: @PERFIL_DEVENV Tipo: Implementación Inicial de Infraestructura

Resumen Ejecutivo

Se completó la implementación inicial de la infraestructura de MiChangarrito, incluyendo base de datos, backend API, servicio WhatsApp, MCP Server y frontend web.

Componentes Implementados

1. Base de Datos PostgreSQL

Métrica	Valor
Schemas	9
Tablas	27
Funciones	3
Triggers	~20

Schemas creados:

public (2 tablas): tenants, tenant_configs
auth (3 tablas): users, sessions, otp_codes
catalog (3 tablas): categories, products, product_templates
sales (4 tablas): sales, sale_items, payments, daily_closures
inventory (2 tablas): inventory_movements, stock_alerts
customers (3 tablas): customers, fiados, fiado_payments
orders (2 tablas): orders, order_items
subscriptions (5 tablas): plans, subscriptions, tenant_token_balance, token_packages, token_usage
messaging (3 tablas): conversations, messages, notifications

Archivos DDL:

database/schemas/
├── 00-extensions.sql    # uuid-ossp, pgcrypto, pg_trgm, btree_gin
├── 01-schemas.sql       # Creación de 9 schemas
├── 02-functions.sql     # Funciones utilitarias
├── 03-public.sql        # Tenants
├── 04-auth.sql          # Autenticación
├── 05-catalog.sql       # Catálogo
├── 06-sales.sql         # Ventas
├── 07-inventory.sql     # Inventario
├── 08-customers.sql     # Clientes y fiados
├── 09-orders.sql        # Pedidos WhatsApp
├── 10-subscriptions.sql # Suscripciones
└── 11-messaging.sql     # Mensajería

Seeds:

database/seeds/
├── 01-plans.sql         # Planes de suscripción (2) y paquetes de tokens (4)
└── 02-templates.sql     # Categorías (6), productos ejemplo (9), templates (11)

2. Backend API (NestJS)

Métrica	Valor
Puerto	3141
Módulos	10
Framework	NestJS 10.x

Módulos implementados:

AuthModule: JWT authentication, bcrypt
UsersModule: Gestión de usuarios
ProductsModule: CRUD de productos
SalesModule: Punto de venta
CustomersModule: Clientes y fiados
InventoryModule: Movimientos de stock
OrdersModule: Pedidos WhatsApp
SubscriptionsModule: Planes y tokens
MessagingModule: Conversaciones

Ubicación: apps/backend/

3. WhatsApp Service

Métrica	Valor
Puerto	3143
Framework	NestJS 10.x
API	Meta Cloud API v18

Capacidades:

Envío de mensajes texto, botones interactivos, listas
Webhook para recibir mensajes entrantes
Procesamiento LLM con function calling
Flujos de negocio: pedidos, fiado, catálogo

Ubicación: apps/whatsapp-service/

4. MCP Server

Métrica	Valor
Tools	15
Framework	MCP SDK
Transporte	stdio

Herramientas disponibles:

Productos: list_products, get_product_details, check_availability
Pedidos: create_order, get_order_status, update_order_status, cancel_order
Fiado: get_fiado_balance, create_fiado, register_fiado_payment, get_fiado_history, check_eligibility
Clientes: get_customer_info, register_customer, get_purchase_history, get_customer_stats
Inventario: check_stock, get_low_stock, record_movement, get_inventory_value

Ubicación: apps/mcp-server/

5. Frontend Web

Métrica	Valor
Puerto	3140
Framework	React 18 + Vite
CSS	TailwindCSS 4.x

Páginas:

Dashboard - Estadísticas, pedidos recientes, alertas stock bajo
Products - Catálogo con filtros por categoría
Orders - Gestión de pedidos con flujo de estados
Customers - Lista de clientes con estadísticas
Fiado - Gestión de crédito, pagos
Inventory - Control de stock, movimientos
Settings - Configuración del negocio

Ubicación: apps/frontend/

Scripts de Base de Datos

create-database.sh (v1.1.0)

Crea usuario y base de datos
Ejecuta todos los schemas DDL
Ejecuta seeds opcionales
Opciones: --no-seeds, --force

recreate-database.sh (v1.0.0)

Elimina y recrea la base de datos
Validación opcional de schemas
Opciones: --force, --validate

Credenciales de Desarrollo

Host:     localhost
Puerto:   5432
Database: michangarrito_dev
Usuario:  michangarrito_dev
Password: MCh_dev_2025_secure

Validación

Base de datos creada correctamente
9 schemas verificados
27 tablas creadas
Seeds aplicados (2 archivos)
Backend compila sin errores
WhatsApp Service compila sin errores
MCP Server compila sin errores
Frontend compila sin errores

Próximos Pasos (Pendientes)

Mobile App: React Native con Expo
Integración Backend-DB: Configurar TypeORM con schemas
Pruebas E2E: Validar flujos completos
Docker Compose: Contenedorización

Fin del Reporte

5.0 KiB Raw Blame History