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

9.7 KiB

Raw Blame History

Reporte de Implementacion - MiChangarrito

Fecha: 2026-01-07 Version: 3.1.0 Autor: @PERFIL_DEVENV Fases cubiertas: FASE 2, FASE 3, FASE 4, FASE 5, FASE 5.1

Resumen Ejecutivo

Este reporte documenta la implementacion de las FASES 2 a 5.1 del proyecto MiChangarrito, un sistema POS inteligente para micro-negocios con asistente IA via WhatsApp.

Logros Principales

FASE 2: Backend integrado con TypeORM, frontend conectado a API
FASE 3: Aplicacion movil completa con 10 pantallas y modo offline
FASE 4: Sistema de monetizacion con Stripe, suscripciones y tokens
FASE 5: Docker, CI/CD, Nginx y scripts de deployment
FASE 5.1: Integraciones multi-tenant (WhatsApp/LLM por tenant)

Progreso General

Metrica	Valor
Tareas completadas	37 de 39
Progreso total	95%
Schemas BD	10
Tablas BD	29
ENUMs	2
Modulos Backend	14

FASE 5: Despliegue

5.1 Docker Compose

Estado: Completado

Archivo docker-compose.yml con servicios:

backend (NestJS)
frontend (React + nginx)
whatsapp-service (NestJS)
postgres (PostgreSQL 15)
redis (Redis 7)

5.2 CI/CD GitHub Actions

Estado: Completado

Archivo .github/workflows/ci.yml:

Build y test automatizados
Publicacion a GitHub Container Registry
Deploy automatico en push a main

5.3 Nginx Reverse Proxy

Estado: Completado

Archivos:

deploy/nginx/nginx.conf
deploy/nginx/conf.d/default.conf

Caracteristicas:

Rate limiting
Compresion gzip
Headers de seguridad
Proxy a servicios backend

5.4 Scripts de Deployment

Estado: Completado

deploy/scripts/deploy.sh
deploy/scripts/backup.sh

FASE 5.1: Integraciones Multi-Tenant

5.1.1 Arquitectura

+-------------------+     +--------------------+
|   WhatsApp        |     |    Backend API     |
|   Service         |<--->|    (NestJS)        |
|   :3143           |     |    :3141           |
+--------+----------+     +----------+---------+
         |                           |
         v                           v
+-------------------+     +--------------------+
| Credentials       |     | Integrations       |
| Provider          |     | Module             |
| (cache 5min)      |     | (CRUD + fallback)  |
+--------+----------+     +----------+---------+
         |                           |
         +-------------+-------------+
                       |
                       v
              +--------+--------+
              |   PostgreSQL    |
              | tenant_integ... |
              +-----------------+

5.1.2 Schema de Base de Datos

Archivo: database/schemas/12-integrations.sql

ENUMs creados:

CREATE TYPE integration_type AS ENUM (
    'whatsapp', 'llm', 'stripe', 'mercadopago', 'clip'
);

CREATE TYPE integration_provider AS ENUM (
    'meta', 'openai', 'openrouter', 'anthropic', 'ollama',
    'azure_openai', 'stripe', 'mercadopago', 'clip'
);

Tablas creadas:

Tabla	Descripcion
`tenant_integration_credentials`	Credenciales por tenant (WhatsApp, LLM, pagos)
`tenant_whatsapp_numbers`	Mapeo phoneNumberId -> tenantId

Columnas agregadas a tenants:

Columna	Tipo	Default
`preferred_llm_provider`	`integration_provider`	`'openai'`
`preferred_payment_provider`	`integration_provider`	`'stripe'`
`uses_platform_number`	`boolean`	`true`

5.1.3 Modulo Backend Integrations

Ubicacion: apps/backend/src/modules/integrations/

Archivos:

Archivo	Descripcion
`entities/tenant-integration-credential.entity.ts`	Entidad con ENUMs e interfaces
`entities/tenant-whatsapp-number.entity.ts`	Mapeo WhatsApp
`services/tenant-integrations.service.ts`	CRUD + resolucion con fallback
`controllers/integrations.controller.ts`	API REST publica
`controllers/internal-integrations.controller.ts`	API interna (X-Internal-Key)
`dto/integration-credentials.dto.ts`	DTOs de validacion
`integrations.module.ts`	Configuracion del modulo

5.1.4 Endpoints REST

Publicos (requieren JWT):

Metodo	Endpoint	Descripcion
GET	`/integrations/status`	Estado de todas las integraciones
GET	`/integrations/whatsapp`	Config de WhatsApp
PUT	`/integrations/whatsapp`	Configurar WhatsApp propio
DELETE	`/integrations/whatsapp`	Eliminar WhatsApp propio
GET	`/integrations/llm`	Config de LLM
PUT	`/integrations/llm`	Configurar LLM propio
DELETE	`/integrations/llm/:provider`	Eliminar LLM

Internos (requieren X-Internal-Key):

Metodo	Endpoint	Descripcion
GET	`/internal/integrations/:tenantId/whatsapp`	Credenciales WhatsApp
GET	`/internal/integrations/:tenantId/llm`	Config LLM
GET	`/internal/integrations/resolve-tenant/:phoneNumberId`	Resolver tenant

5.1.5 WhatsApp Service Refactorizado

Ubicacion: apps/whatsapp-service/src/

Nuevos archivos:

Archivo	Descripcion
`common/credentials-provider.service.ts`	Cache de credenciales con TTL 5min
`common/common.module.ts`	Modulo global exportado

Archivos modificados:

Archivo	Cambios
`whatsapp/whatsapp.service.ts`	`tenantId` en todos los metodos
`llm/llm.service.ts`	Config LLM dinamica por tenant
`webhook/webhook.service.ts`	Resolucion de tenant en webhooks
`app.module.ts`	Import de CommonModule

5.1.6 Proveedores LLM Soportados

Proveedor	Modelo Default	Base URL
OpenAI	`gpt-4o-mini`	`api.openai.com/v1`
OpenRouter	`anthropic/claude-3-haiku`	`openrouter.ai/api/v1`
Anthropic	`claude-3-haiku-20240307`	`api.anthropic.com/v1`
Ollama	`llama2`	`localhost:11434/v1`
Azure OpenAI	`gpt-4o-mini`	Custom

Correcciones Aplicadas (2026-01-07)

tenant-integrations.service.ts

Error	Correccion
Falta `provider` en whatsapp	Agregado `provider: whatsappCred?.provider \|\| 'meta'`
Falta `isVerified` en llm	Agregado `isVerified: llmCred?.isVerified ?? false`
Falta `isVerified` en payments	Agregado a stripe, mercadopago, clip
Firma de metodo incorrecta	Actualizada para coincidir con DTO

Validacion de Base de Datos

Estructura Final

Schemas: 10 (public + 9 funcionales)
Tablas: 29
ENUMs: 2 (integration_type, integration_provider)
Funciones: 82

Tablas por Schema

Schema	Tablas
public	tenants, tenant_configs, tenant_integration_credentials, tenant_whatsapp_numbers
auth	users, sessions, otp_codes
catalog	products, categories, product_templates
sales	sales, sale_items, payments, daily_closures
inventory	inventory_movements, stock_alerts
customers	customers, fiados, fiado_payments
orders	orders, order_items
subscriptions	plans, subscriptions, tenant_token_balance, token_usage, token_packages
messaging	conversations, messages, notifications

Validacion ENUMs

-- integration_provider
meta, openai, openrouter, anthropic, ollama, azure_openai, stripe, mercadopago, clip

-- integration_type
whatsapp, llm, stripe, mercadopago, clip

Builds Verificados

Backend

$ npm run build
> nest build
Build completed successfully

Frontend

$ npm run build
> tsc -b && vite build
Built in 4.84s
Bundle: 344.98 KB (gzip: 106.82 KB)

WhatsApp Service

$ npm run build
> nest build
Build completed successfully

Mobile

$ npx tsc --noEmit
No TypeScript errors

Archivos Modificados/Creados (FASE 5.1)

Database

database/schemas/
└── 12-integrations.sql      (creado - 146 lineas)

Backend

apps/backend/src/modules/integrations/
├── integrations.module.ts                    (creado)
├── entities/
│   ├── tenant-integration-credential.entity.ts (creado - 121 lineas)
│   └── tenant-whatsapp-number.entity.ts        (creado)
├── services/
│   └── tenant-integrations.service.ts          (creado - 415 lineas)
├── controllers/
│   ├── integrations.controller.ts              (creado)
│   └── internal-integrations.controller.ts     (creado)
└── dto/
    └── integration-credentials.dto.ts          (creado - 183 lineas)

WhatsApp Service

apps/whatsapp-service/src/
├── app.module.ts             (modificado)
├── common/
│   ├── common.module.ts      (creado)
│   └── credentials-provider.service.ts (creado)
├── whatsapp/
│   └── whatsapp.service.ts   (modificado - tenantId)
├── llm/
│   └── llm.service.ts        (modificado - config dinamica)
└── webhook/
    └── webhook.service.ts    (modificado - resolucion tenant)

Pendientes Externos

Tarea	Tipo	Responsable
Cuenta Meta Business verificada	Externa	Usuario
API keys Stripe produccion	Externa	Usuario
API key OpenAI/OpenRouter	Externa	Usuario
Servidor de produccion	Infraestructura	Usuario

Conclusion

El proyecto MiChangarrito esta al 95% de completitud:

29 tablas en base de datos validadas
14 modulos backend funcionales
10 pantallas moviles implementadas
Sistema multi-tenant de integraciones completo
Todos los builds pasando exitosamente

Las unicas tareas pendientes requieren configuracion externa (cuentas Meta, Stripe, OpenAI) que dependen del usuario.

Documento generado: 2026-01-07 Perfil: @PERFIL_DEVENV Proxima revision: Post-deployment a produccion

9.7 KiB Raw Blame History

Reporte de Implementacion - MiChangarrito

Resumen Ejecutivo

Logros Principales

Progreso General

FASE 5: Despliegue

5.1 Docker Compose

5.2 CI/CD GitHub Actions

5.3 Nginx Reverse Proxy

5.4 Scripts de Deployment

FASE 5.1: Integraciones Multi-Tenant

5.1.1 Arquitectura

5.1.2 Schema de Base de Datos

5.1.3 Modulo Backend Integrations

5.1.4 Endpoints REST

5.1.5 WhatsApp Service Refactorizado

5.1.6 Proveedores LLM Soportados

Correcciones Aplicadas (2026-01-07)

tenant-integrations.service.ts

Validacion de Base de Datos

Estructura Final

Tablas por Schema

Validacion ENUMs

Builds Verificados

Backend

Frontend

WhatsApp Service

Mobile

Archivos Modificados/Creados (FASE 5.1)

Database

Backend

WhatsApp Service

Pendientes Externos

Conclusion

9.7 KiB

Raw Blame History