rckrdmrd
97f407c661
- Prefijo v2: MCH - TRACEABILITY-MASTER.yml creado - Listo para integracion como submodulo Workspace: v2.0.0 | SIMCO: v4.0.0
94 lines
3.6 KiB
Markdown
94 lines
3.6 KiB
Markdown
# MiChangarrito - Documentacion
|
|
|
|
## Descripcion
|
|
|
|
Documentacion completa del proyecto MiChangarrito, punto de venta inteligente para micro-negocios informales en Mexico (tiendas de abarrotes, puestos de comida, fondas).
|
|
|
|
## Propuesta de Valor
|
|
|
|
- **WhatsApp First**: El dueno opera su negocio desde WhatsApp
|
|
- **IA Asistente**: Consulta ventas, inventario, ganancias por chat
|
|
- **Pagos Integrados**: Terminal Mercado Pago, Clip, CoDi
|
|
- **Precio Accesible**: $99-199/mes + tokens de IA
|
|
|
|
## Estructura de Documentacion
|
|
|
|
| Directorio | Contenido | Archivos |
|
|
|------------|-----------|----------|
|
|
| [00-vision-general/](./00-vision-general/) | Vision, requerimientos, arquitectura | 3 |
|
|
| [01-epicas/](./01-epicas/) | 28 epicas del proyecto (MCH-001 a MCH-028) | 29 |
|
|
| [02-especificaciones/](./02-especificaciones/) | Especificaciones tecnicas | 6 |
|
|
| [02-integraciones/](./02-integraciones/) | Documentacion de integraciones externas | 5 |
|
|
| [90-transversal/](./90-transversal/) | Documentacion transversal | 2 |
|
|
| [97-adr/](./97-adr/) | Decisiones arquitectonicas | 4 |
|
|
|
|
## Navegacion Rapida
|
|
|
|
### Por Tipo de Documento
|
|
|
|
| Tipo | Ubicacion | Descripcion |
|
|
|------|-----------|-------------|
|
|
| Vision | [VISION-PROYECTO.md](./00-vision-general/VISION-PROYECTO.md) | Propuesta de valor y target market |
|
|
| Requerimientos | [REQUERIMIENTOS-FUNCIONALES.md](./00-vision-general/REQUERIMIENTOS-FUNCIONALES.md) | Requisitos del sistema |
|
|
| Arquitectura | [ARQUITECTURA-TECNICA.md](./00-vision-general/ARQUITECTURA-TECNICA.md) | Stack tecnico |
|
|
| Epicas | [01-epicas/_MAP.md](./01-epicas/_MAP.md) | Indice de 28 epicas |
|
|
| Integraciones | [02-integraciones/_MAP.md](./02-integraciones/_MAP.md) | WhatsApp, Stripe, LLM, etc |
|
|
| ADRs | [97-adr/_MAP.md](./97-adr/_MAP.md) | Decisiones arquitectonicas |
|
|
|
|
### Mapa Principal
|
|
|
|
- **[_MAP.md](./_MAP.md)** - Mapa completo de documentacion con metricas
|
|
|
|
## Estado del Proyecto
|
|
|
|
| Metrica | Valor |
|
|
|---------|-------|
|
|
| **Progreso MVP** | 95% |
|
|
| **Fases Completadas** | 5.1 de 7 |
|
|
| **Epicas Completadas** | 22 de 28 |
|
|
| **Schemas BD** | 11 |
|
|
| **Tablas BD** | 47 |
|
|
| **Modulos Backend** | 17 |
|
|
| **Sistema** | SIMCO v3.7.0 |
|
|
|
|
## Componentes del Sistema
|
|
|
|
| Componente | Tecnologia | Puerto |
|
|
|------------|------------|--------|
|
|
| Backend API | NestJS 10.3.0 | 3141 |
|
|
| Frontend Web | React + Vite | 3140 |
|
|
| Mobile App | React Native + Expo | 8081 |
|
|
| MCP Server | TypeScript + MCP SDK | 3142 |
|
|
| WhatsApp Service | NestJS + Meta API | 3143 |
|
|
| Database | PostgreSQL 16+ | 5432 |
|
|
| Cache | Redis 7 | 6379 |
|
|
|
|
## Integraciones Principales
|
|
|
|
| Servicio | Tipo | Estado |
|
|
|----------|------|--------|
|
|
| WhatsApp Business API | Comunicacion | Implementado |
|
|
| Stripe | Pagos/Suscripciones | Implementado |
|
|
| OpenRouter | LLM Gateway | Implementado |
|
|
| Mercado Pago | Terminal Pago | Pendiente |
|
|
|
|
## Referencias
|
|
|
|
### Documentacion de Orchestration
|
|
- [CONTEXTO-PROYECTO.md](../orchestration/00-guidelines/CONTEXTO-PROYECTO.md) - Variables del proyecto
|
|
- [HERENCIA-SIMCO.md](../orchestration/00-guidelines/HERENCIA-SIMCO.md) - Directivas heredadas
|
|
- [PROJECT-STATUS.md](../orchestration/PROJECT-STATUS.md) - Estado actual
|
|
- [PROXIMA-ACCION.md](../orchestration/PROXIMA-ACCION.md) - Siguiente paso
|
|
|
|
### Inventarios (SSOT)
|
|
- [MASTER_INVENTORY.yml](../orchestration/inventarios/MASTER_INVENTORY.yml)
|
|
- [DATABASE_INVENTORY.yml](../orchestration/inventarios/DATABASE_INVENTORY.yml)
|
|
- [BACKEND_INVENTORY.yml](../orchestration/inventarios/BACKEND_INVENTORY.yml)
|
|
- [FRONTEND_INVENTORY.yml](../orchestration/inventarios/FRONTEND_INVENTORY.yml)
|
|
|
|
---
|
|
|
|
**Ultima actualizacion:** 2026-01-10
|
|
**Version:** 1.0.0
|
|
**Sistema:** SIMCO v3.7.0
|