rckrdmrd
97f407c661
- Prefijo v2: MCH - TRACEABILITY-MASTER.yml creado - Listo para integracion como submodulo Workspace: v2.0.0 | SIMCO: v4.0.0
127 lines
4.5 KiB
Markdown
127 lines
4.5 KiB
Markdown
# 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
|