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

7.6 KiB

Raw Blame History

MiInventario - Contexto del Proyecto

Identificacion

Campo	Valor
Nombre	MiInventario
Codigo	MII
Tipo	Standalone SaaS
Nivel SIMCO	L2-A (Standalone)
Estado	Desarrollo Activo
Version	1.0.0
Creado	2026-01-10
Actualizado	2026-01-10

Descripcion

SaaS Movil que permite a negocios pequenos (tienditas, miscelaneas, puestos) en Mexico generar inventario automatico a partir de un video de anaqueles (30-60 segundos). El sistema utiliza inteligencia artificial para detectar productos (SKU) y contarlos.

Propuesta de Valor

Automatizacion - Inventario en segundos, no horas
Accesibilidad - Pagos en efectivo (OXXO, 7-Eleven)
Aprendizaje Continuo - El modelo mejora con retroalimentacion
Crecimiento Organico - Sistema de referidos multinivel
Costo Justo - Precio = 2x costo IA (transparente)

Stack Tecnologico

Componente	Tecnologia	Version
Mobile	React Native (Expo)	SDK 52
Navegacion	expo-router	4.x
Estado	Zustand	5.x
Backend	NestJS + TypeScript	10.x
Base de Datos	PostgreSQL + TypeORM	15.x
Cache/Cola	Redis + Bull	7.x
Almacenamiento	S3 Compatible (MinIO)	-
Pagos	Stripe + Agregadores	-
Notificaciones	Firebase FCM	-
IA	OpenAI GPT-4o Vision + Claude	-

Variables del Proyecto

Database

DB_NAME: miinventario_dev
DB_PORT: 5433
ORM: TypeORM
SCHEMA: public  # Schema unico en lugar de multiples
TABLAS: 13
ENUMS: 10
INDICES: 17
FOREIGN_KEYS: 13
MIGRACION: 1768099560565-Init

Backend

BACKEND_PORT: 3142
MODULOS_IMPLEMENTADOS: 11
ENDPOINTS: 45
TESTS_E2E: 53
MODULES:
  - auth              # Autenticacion JWT, OTP
  - users             # Gestion usuarios
  - stores            # Gestion tiendas multi-tenant
  - inventory         # Items de inventario
  - videos            # Upload y procesamiento
  - credits           # Sistema de creditos
  - payments          # Procesamiento pagos Stripe
  - referrals         # Sistema referidos
  - notifications     # Push notifications FCM
  - ia-provider       # Abstraccion IA (OpenAI/Claude)
  - health            # Health checks

Mobile

MOBILE_PORT: 8082
SCREENS_IMPLEMENTADOS: 20
STORES: 7
SERVICES: 10
NAVEGACION: expo-router (file-based)
SCREENS:
  - Auth: login, register, verify-otp
  - Tabs: home, scan, inventory, profile
  - Credits: buy, history
  - Stores: index, new, [id]
  - Inventory: [id]
  - Notifications: index
  - Referrals: index
  - Profile: edit
  - Payments: methods
  - Help: index
  - Support: index
  - Legal: terms, privacy

Arquitectura de Carpetas

miinventario/
├── apps/
│   ├── backend/          # API NestJS
│   │   └── src/
│   │       ├── modules/  # 11 modulos implementados
│   │       ├── config/   # Configuracion TypeORM
│   │       └── migrations/ # Migraciones DB
│   └── mobile/           # React Native Expo
│       └── src/
│           ├── app/      # expo-router screens
│           ├── stores/   # Zustand stores
│           ├── services/ # API services
│           └── types/    # TypeScript types
├── database/
│   ├── schemas/          # (No usado - TypeORM migrations)
│   └── seeds/            # Datos iniciales
├── docs/                 # Documentacion SIMCO
│   ├── 00-vision-general/
│   ├── 01-epicas/
│   ├── 02-especificaciones/
│   ├── 02-integraciones/
│   ├── 90-transversal/
│   └── 97-adr/
├── orchestration/        # Orquestacion
│   ├── 00-guidelines/
│   ├── inventarios/
│   ├── environment/
│   ├── trazas/
│   └── analisis/
└── deploy/               # Configuracion despliegue

Puertos Asignados (Desarrollo)

Servicio	Puerto	Notas
PostgreSQL	5433	Docker
Redis	6380	Docker
MinIO (S3 API)	9002	Docker
MinIO (Console)	9003	Docker
Backend API	3142	NestJS
Mobile (Expo)	8082	Expo dev server

Epicas y Progreso

FASE 1: MVP Core - 100% COMPLETADO

ID	Nombre	SP	Estado
MII-001	Infraestructura Base	8	Completado
MII-002	Autenticacion	13	Completado
MII-003	Gestion de Tiendas	8	Completado
MII-004	Captura de Video	21	Completado
MII-005	Procesamiento IA	34	Completado
MII-006	Reportes de Inventario	13	Completado

FASE 2: Retroalimentacion - 0% PENDIENTE

ID	Nombre	SP	Estado
MII-007	Retroalimentacion y Correcciones	13	Pendiente
MII-008	Validacion Aleatoria	8	Pendiente

FASE 3: Monetizacion - 100% COMPLETADO

ID	Nombre	SP	Estado
MII-009	Wallet y Creditos	13	Completado
MII-010	Paquetes de Recarga	8	Completado
MII-011	Pagos con Tarjeta	8	Completado
MII-012	Pagos OXXO	13	Completado
MII-013	Pagos 7-Eleven	8	Completado

FASE 4: Crecimiento - 60% PARCIAL

ID	Nombre	SP	Estado
MII-014	Sistema de Referidos	21	Completado
MII-015	Administracion SaaS	13	Pendiente

Total: 15 epicas, ~202 Story Points Completadas: 11/15 epicas (73%)

Integraciones Externas

Servicio	Proposito	Prioridad	Estado
Stripe	Pagos tarjeta + OXXO	P0	Implementado
Agregador 7-Eleven	Pagos efectivo	P1	Planificado
Firebase FCM	Push notifications	P1	Implementado
S3/MinIO	Almacenamiento videos	P0	Implementado
OpenAI GPT-4o	Deteccion productos	P0	Implementado
Anthropic Claude	Fallback IA	P0	Implementado

Modelo de Negocio

Concepto	Descripcion
Unidad	Credito/Token
Costo	2x COGS IA
Paquetes	$50, $100, $200, $500 MXN
Referidos	1 credito por activacion
Regla	Referido activado = compra + primer inventario

Estado Actual de Implementacion

Componente	Estado	Progreso
Documentacion	Actualizada	80%
Database	Implementado	100% (13 tablas)
Backend	Implementado	100% (11 modulos, 45 endpoints)
Mobile	Implementado	100% (20 screens, 7 stores)
Integraciones	Parcial	83% (5/6 activas)
Tests E2E	Implementado	53 tests pasando

Referencias

Documentacion Principal

Orchestration del Workspace

Inventarios

Ultima Actualizacion: 2026-01-10 Version SIMCO: 4.0.0

7.6 KiB Raw Blame History