michangarrito/docs/02-especificaciones/_MAP.md

MiChangarrito - Mapa de Especificaciones Tecnicas

Indice de Documentos

Documento	Descripcion	Estado
ARQUITECTURA-DATABASE.md	Schema completo de base de datos (12 schemas, ~49 tablas)	Actualizado
ESPECIFICACION-COMPONENTES.md	Especificacion de backend (18 modulos) y frontend (12 paginas)	Actualizado
INTEGRACIONES-EXTERNAS.md	Documentacion de integraciones (Stripe, WhatsApp, LLM, etc.)	Actualizado
INVESTIGACION-REFERENCIAS.md	Analisis de codigo reutilizable y proyectos de referencia	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 (12 total)

public          → Tenants, configuracion global, credenciales
auth            → Usuarios, sesiones, OTP
catalog         → Productos, categorias, templates
sales           → Ventas, pagos, CoDi, SPEI
inventory       → Stock, movimientos, alertas
customers       → Clientes, fiados
orders          → Pedidos, entregas
subscriptions   → Planes, tokens IA, referidos
messaging       → WhatsApp, notificaciones
billing         → Facturacion electronica SAT
marketplace     → Marketplace B2B proveedores
integrations    → Configuracion de integraciones

Tablas por Schema (~49 total)

Schema	Tablas
public	tenants, tenant_configs, tenant_integration_credentials, tenant_whatsapp_numbers
auth	users, sessions, otp_codes
catalog	categories, products, product_templates
sales	sales, sale_items, payments, daily_closures, virtual_accounts, codi_transactions, spei_transactions, payment_config
inventory	inventory_movements, stock_alerts
customers	customers, fiados, fiado_payments
orders	orders, order_items
subscriptions	plans, subscriptions, token_packages, token_usage, tenant_token_balance, referral_codes, referrals, referral_rewards
messaging	conversations, messages, notifications
billing	tax_configs, invoices, invoice_items, invoice_item_taxes, invoice_history
marketplace	suppliers, supplier_products, supplier_orders, supplier_order_items, supplier_reviews, supplier_favorites
integrations	integration_configs, integration_logs

---

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

---

Estado Actual: MVP 95%

El desarrollo del MVP esta al 95% completado:

Completado

• Infraestructura base (Docker, PostgreSQL, Redis)
• Autenticacion y multi-tenancy
• Catalogo y punto de venta
• Integraciones core (Stripe, WhatsApp, LLM)
• Sistema de fiados y clientes
• Suscripciones y tokens

Pendiente

• Integracion SAT CFDI (requiere PAC)
• Integracion SPEI real (requiere STP.mx)
• Push notifications (Firebase FCM)
• Expansion LATAM (Fase 7)

---

Version: 2.0.0 Fecha: 2026-01-10 Actualizado por: Reestructuracion Documental