# 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