michangarrito/backups/docs-backup-2026-01-10/docs/02-especificaciones/_MAP.md

MiChangarrito - Mapa de Especificaciones Tecnicas

Indice de Documentos

Documento	Descripcion	Estado
INVESTIGACION-REFERENCIAS.md	Analisis de codigo reutilizable y proyectos de referencia	Completo
ARQUITECTURA-DATABASE.md	Schema completo de base de datos (9 schemas, 25+ tablas)	Completo
INTEGRACIONES-EXTERNAS.md	Documentacion de todas las integraciones (Stripe, WhatsApp, LLM, etc.)	Completo
PLAN-DESARROLLO.md	Plan de desarrollo por epicas con cronograma	Completo

---

Resumen de Investigacion

Codigo Reutilizable

Fuente	Reutilizable	Ubicacion
POS-Micro Backend	80%	erp-suite/apps/products/pos-micro/backend
POS-Micro Frontend	60%	erp-suite/apps/products/pos-micro/frontend
Shared-Libs Core	100%	erp-suite/apps/shared-libs/core
Trading-Platform LLM	70%	trading-platform/apps/llm-agent

Integraciones Principales

Integracion	Prioridad	SDK Disponible
Stripe	P0	npm install stripe
WhatsApp Cloud API	P0	REST API
OpenRouter/LLM	P0	npm install openai
MCP Server	P0	npm install @modelcontextprotocol/server
Mercado Pago	P1	npm install mercadopago
Firebase FCM	P1	npm install firebase-admin

---

Arquitectura de Base de Datos

Schemas

public          → Tenants, configuracion global
auth            → Usuarios, sesiones, OTP
catalog         → Productos, categorias, templates
sales           → Ventas, pagos, cortes
inventory       → Stock, movimientos, alertas
customers       → Clientes, fiados
orders          → Pedidos, entregas
subscriptions   → Planes, tokens IA
messaging       → WhatsApp, notificaciones

Tablas Principales

Schema	Tablas
public	tenants, tenant_configs
auth	users, sessions, otp_codes
catalog	categories, products, 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, token_packages, token_usage, tenant_token_balance
messaging	conversations, messages, notifications

---

Plan de Desarrollo

Fases

Fase	Epicas	Duracion Estimada
FASE 1: MVP Core	MCH-001 a MCH-005	6-7 semanas
FASE 2: Inteligencia	MCH-006 a MCH-009	4-5 semanas
FASE 3: Asistente IA	MCH-010 a MCH-013	5-6 semanas
FASE 4: Pedidos	MCH-014 a MCH-017	4-5 semanas
FASE 5: Monetizacion	MCH-018 a MCH-021	5-6 semanas
FASE 6: Crecimiento	MCH-022 a MCH-025	4-6 semanas

Prioridades Criticas (P0)

1. MCH-001: Infraestructura Base
2. MCH-002: Autenticacion
3. MCH-003: Catalogo de Productos
4. MCH-004: Punto de Venta Basico
5. MCH-005: Integraciones de Pago
6. MCH-010: MCP Server
7. MCH-011: WhatsApp Service
8. MCH-018: Planes y Suscripciones
9. MCH-020: Pagos Suscripcion

---

Proximo Paso: Desarrollo

Con la documentacion completa, el siguiente paso es:

1. Copiar POS-Micro como base para backend
2. Ejecutar scripts de database para crear schemas
3. Configurar Docker Compose para desarrollo
4. Iniciar desarrollo de MCH-001

---

Version: 1.0.0 Fecha: 2026-01-04