# MiChangarrito - Mapa de Especificaciones Tecnicas

## Indice de Documentos

| Documento | Descripcion | Estado |
|-----------|-------------|--------|
| [INVESTIGACION-REFERENCIAS.md](./INVESTIGACION-REFERENCIAS.md) | Analisis de codigo reutilizable y proyectos de referencia | Completo |
| [ARQUITECTURA-DATABASE.md](./ARQUITECTURA-DATABASE.md) | Schema completo de base de datos (9 schemas, 25+ tablas) | Completo |
| [INTEGRACIONES-EXTERNAS.md](./INTEGRACIONES-EXTERNAS.md) | Documentacion de todas las integraciones (Stripe, WhatsApp, LLM, etc.) | 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

```
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