miinventario-v2/README.md
rckrdmrd 1a53b5c4d3 [MIINVENTARIO] feat: Initial commit - Sistema de inventario con análisis de video IA
- Backend NestJS con módulos de autenticación, inventario, créditos
- Frontend React con dashboard y componentes UI
- Base de datos PostgreSQL con migraciones
- Tests E2E configurados
- Configuración de Docker y deployment

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-13 02:25:48 -06:00

112 lines
2.7 KiB
Markdown

# 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