# MiChangarrito - Mapa de Especificaciones Tecnicas

## Indice de Documentos

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