# MiInventario

> SaaS Movil para inventario automatico por video para negocios pequenos en Mexico

## Descripcion

MiInventario permite a tienditas, miscelaneas y puestos generar inventario automatico a partir de un video de anaqueles (30-60s). El sistema detecta productos (SKU) y los cuenta usando inteligencia artificial.

## Caracteristicas Principales

- Inventario automatico por video (30-60 segundos)
- Deteccion de productos con IA
- Sistema de creditos/tokens
- Pagos: tarjeta, OXXO, 7-Eleven
- Sistema de referidos multinivel
- Retroalimentacion y mejora continua del modelo

## Stack Tecnologico

| Componente | Tecnologia |
|------------|------------|
| Mobile | React Native (Expo) |
| Backend | NestJS + TypeScript |
| Base de Datos | PostgreSQL + Redis |
| Cola de Trabajos | Bull |
| Almacenamiento | S3 Compatible |
| Pagos | Stripe + Agregadores |

## Estructura del Proyecto

```
miinventario/
├── apps/
│   ├── backend/          # API NestJS
│   └── mobile/           # App React Native (Expo)
├── database/
│   ├── schemas/          # DDL PostgreSQL
│   └── seeds/            # Datos iniciales
├── docs/                 # Documentacion SIMCO
├── orchestration/        # Orquestacion del proyecto
└── deploy/               # Configuracion de despliegue
```

## Documentacion

- [Vision del Proyecto](./docs/00-vision-general/VISION-PROYECTO.md)
- [Requerimientos Funcionales](./docs/00-vision-general/REQUERIMIENTOS-FUNCIONALES.md)
- [Arquitectura Tecnica](./docs/00-vision-general/ARQUITECTURA-TECNICA.md)
- [Mapa de Documentacion](./docs/_MAP.md)

## Desarrollo

### Requisitos
- Node.js 18+
- PostgreSQL 15+
- Redis 7+
- Docker (opcional)

### Instalacion

```bash
# Clonar repositorio
git clone git@git.isem.site:isem/miinventario.git

# Instalar dependencias
npm install

# Levantar servicios con Docker
docker-compose up -d

# Iniciar desarrollo
npm run dev:backend
npm run dev:mobile
```

### Puertos de Desarrollo

| Servicio | Puerto |
|----------|--------|
| PostgreSQL | 5433 |
| Redis | 6380 |
| MinIO (S3) | 9002 |
| Backend API | 3150 |
| Mobile (Expo) | 8082 |

## Estado

| Campo | Valor |
|-------|-------|
| **Version** | 0.1.0 |
| **Estado** | En Planificacion |
| **Ultima Actualizacion** | 2026-01-10 |
| **SIMCO Version** | 4.0.0 |

## Modelo de Negocio

- **Modelo:** Pago por consumo (creditos/tokens)
- **Precio:** 2x costo IA
- **Paquetes:** $50, $100, $200, $500 MXN
- **Referidos:** 1 credito por activacion

## Roadmap

- **Fase 1:** MVP Core (Auth, Tiendas, Video, IA, Reportes)
- **Fase 2:** Retroalimentacion y Validacion
- **Fase 3:** Monetizacion (Wallet, Pagos)
- **Fase 4:** Crecimiento (Referidos, Admin)

---

Proyecto parte de workspace-v2 | SIMCO v4.0.0