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

28 KiB

Raw Blame History

PROJECT STATUS - MiInventario

Fecha: 2026-01-12 Estado: Completado Fase Actual: Todas las fases completadas Version: 1.2.0

Resumen Ejecutivo

Aspecto	Estado	Progreso	Notas
Documentacion	Completada	100%	55+ archivos de docs + prod config
Infraestructura	Completada	100%	Docker + Monorepo + ESLint
Database	Completada	100%	16 entidades TypeORM + 3 migraciones
Backend	Completado	100%	14 modulos funcionales + 53+ tests E2E
Mobile	Completado	100%	23+ pantallas + animaciones + offline
Integraciones	Completas	100%	S3 + Stripe (prod) + FCM (prod) + Bull
UX Mobile	Completado	100%	Animaciones fluidas + modo offline

Progreso por Fase

Fase	Estado	Progreso	Story Points	Notas
FASE 1: MVP Core	Completada	100%	97/97	MII-001 a 006
FASE 2: Retroalimentacion	Completada	100%	21/21	MII-007, MII-008
FASE 3: Monetizacion	Completada	100%	50/50	MII-009 a 013
FASE 4: Crecimiento	Completada	100%	34/34	MII-014, MII-015
TOTAL	Completado	100%	202/202	15 epicas

Estado de Epicas

Fase 1: MVP Core

Epica	Nombre	SP	Estado	Backend	Mobile	DB
MII-001	Infraestructura Base	8	Completada	100%	100%	100%
MII-002	Autenticacion	13	Completada	100%	100%	100%
MII-003	Gestion de Tiendas	8	Completada	100%	100%	100%
MII-004	Captura de Video	21	Completada	100%	100%	100%
MII-005	Procesamiento IA	34	Completada	100%	-	100%
MII-006	Reportes de Inventario	13	Completada	100%	100%	100%

Fase 2: Retroalimentacion

Epica	Nombre	SP	Estado	Backend	Mobile	DB
MII-007	Retroalimentacion	13	Completada	100%	100%	100%
MII-008	Validacion Aleatoria	8	Completada	100%	100%	100%

Fase 3: Monetizacion

Epica	Nombre	SP	Estado	Backend	Mobile	DB
MII-009	Wallet y Creditos	13	Completada	100%	100%	100%
MII-010	Paquetes de Recarga	8	Completada	100%	100%	100%
MII-011	Pagos con Tarjeta	8	Completada	100%	100%	100%
MII-012	Pagos OXXO	13	Completada	100%	100%	100%
MII-013	Pagos 7-Eleven	8	Completada	100%	100%	100%

Fase 4: Crecimiento

Epica	Nombre	SP	Estado	Backend	Mobile	DB
MII-014	Sistema de Referidos	21	Completada	100%	100%	100%
MII-015	Administracion SaaS	13	Completada	100%	-	100%

Modulos Backend Implementados

Auth Module (100%)

auth.service.ts - OTP + Refresh tokens en DB
auth.controller.ts - Endpoints completos
entities/otp.entity.ts - Codigos OTP con expiracion
entities/refresh-token.entity.ts - Tokens con revocacion
guards/jwt-auth.guard.ts - Proteccion de rutas
strategies/jwt.strategy.ts - Validacion JWT

Users Module (100%)

users.service.ts - CRUD + findByPhone/Email + FCM token
users.controller.ts - Endpoints de perfil
entities/user.entity.ts - Entidad completa

Stores Module (100%)

stores.service.ts - CRUD + ownership verification
stores.controller.ts - Endpoints protegidos
entities/store.entity.ts - Con relacion a owner

Videos Module (100%)

videos.service.ts - Upload S3 + Queue integration
videos.controller.ts - Endpoints completos
entities/video.entity.ts - Status + metadata
processors/video-processing.processor.ts - Bull queue
dto/initiate-upload.dto.ts - Validacion

Credits Module (100%)

credits.service.ts - Balance + Transacciones atomicas
credits.controller.ts - Endpoints completos
entities/credit-balance.entity.ts - Por usuario
entities/credit-transaction.entity.ts - Historial
entities/credit-package.entity.ts - Paquetes

Inventory Module (100%)

inventory.service.ts - CRUD + bulkUpsert + statistics
inventory.controller.ts - Endpoints completos
entities/inventory-item.entity.ts - Productos
dto/update-inventory-item.dto.ts - Validacion

IA Provider Module (100%)

ia-provider.service.ts - OpenAI GPT-4o Vision + Claude Vision
Prompt especializado para tiendas mexicanas
Parsing robusto de respuestas JSON
Fallback a mock en desarrollo sin API keys
Metodos: detectInventory(), isConfigured(), getAvailableProviders()

Payments Module (100%)

payments.service.ts - Stripe (tarjetas + OXXO + 7-Eleven)
payments.controller.ts - Endpoints + webhook
entities/payment.entity.ts - Status + vouchers
dto/create-payment.dto.ts - Validacion
Modo simulacion para desarrollo

Notifications Module (100%)

notifications.service.ts - Firebase FCM integration
notifications.controller.ts - Endpoints completos
entities/notification.entity.ts - Tipos + data
Metodos para cada tipo de notificacion
Modo simulacion para desarrollo

Referrals Module (100%)

referrals.service.ts - Codigos + bonificaciones
referrals.controller.ts - Endpoints completos
entities/referral.entity.ts - Status + tracking + fraud detection
Generacion de codigos unicos
Bonificacion automatica

Feedback Module (100%)

feedback.service.ts - Correcciones de cantidad/SKU
feedback.controller.ts - Endpoints completos
entities/correction.entity.ts - Historial de correcciones
entities/ground-truth.entity.ts - Datos validados para ML
entities/product-submission.entity.ts - Nuevos productos

Validations Module (100%)

validations.service.ts - Micro-auditorias aleatorias
validations.controller.ts - Endpoints completos
entities/validation-request.entity.ts - Solicitudes
entities/validation-response.entity.ts - Respuestas
Sistema de probabilidad para activacion

Admin Module (100%)

admin.controller.ts - 15 endpoints de administracion
services/admin-dashboard.service.ts - Metricas MAU, DAU, revenue
services/admin-providers.service.ts - Gestion proveedores IA
services/admin-packages.service.ts - CRUD paquetes creditos
services/admin-promotions.service.ts - Gestion promociones
services/admin-moderation.service.ts - Moderacion productos/referidos
services/audit-log.service.ts - Auditoria de acciones
entities/ia-provider.entity.ts - Proveedores IA con costos
entities/promotion.entity.ts - Promociones con codigos
entities/audit-log.entity.ts - Logs de auditoria
Sistema de roles jerarquico (USER, VIEWER, MODERATOR, ADMIN, SUPER_ADMIN)

Endpoints API Implementados

Auth (`/api/v1/auth`)

Metodo	Endpoint	Estado
POST	/register	Done
POST	/verify-otp	Done
POST	/login	Done
POST	/refresh	Done
POST	/logout	Done

Stores (`/api/v1/stores`)

Metodo	Endpoint	Estado
POST	/	Done
GET	/	Done
GET	/:id	Done
PATCH	/:id	Done
DELETE	/:id	Done

Videos (`/api/v1/stores/:storeId/videos`)

Metodo	Endpoint	Estado
POST	/initiate	Done
POST	/:videoId/confirm	Done
GET	/:videoId/status	Done
GET	/:videoId/result	Done
GET	/	Done

Inventory (`/api/v1/stores/:storeId/inventory`)

Metodo	Endpoint	Estado
GET	/	Done
GET	/statistics	Done
GET	/low-stock	Done
GET	/categories	Done
GET	/:itemId	Done
PATCH	/:itemId	Done
DELETE	/:itemId	Done

Credits (`/api/v1/credits`)

Metodo	Endpoint	Estado
GET	/balance	Done
GET	/transactions	Done
GET	/packages	Done

Payments (`/api/v1/payments`)

Metodo	Endpoint	Estado
POST	/	Done
GET	/	Done
GET	/:paymentId	Done
POST	/webhook/stripe	Done

Notifications (`/api/v1/notifications`)

Metodo	Endpoint	Estado
GET	/	Done
GET	/unread-count	Done
PATCH	/:notificationId/read	Done
POST	/mark-all-read	Done
POST	/register-token	Done

Referrals (`/api/v1/referrals`)

Metodo	Endpoint	Estado
GET	/my-code	Done
GET	/stats	Done
GET	/	Done
GET	/validate	Done
POST	/apply	Done

Feedback (`/stores/:storeId/inventory/:itemId`)

Metodo	Endpoint	Estado
PATCH	/correct-quantity	Done
PATCH	/correct-sku	Done
POST	/confirm	Done
GET	/history	Done

Products

Metodo	Endpoint	Estado
POST	/products/submit	Done
GET	/products/search	Done

Validations (`/api/v1/validations`)

Metodo	Endpoint	Estado
GET	/:requestId/items	Done
POST	/:requestId/submit	Done
POST	/:requestId/skip	Done
GET	/check/:videoId	Done

Admin (`/api/v1/admin`)

Metodo	Endpoint	Estado
GET	/dashboard	Done
GET	/dashboard/revenue-series	Done
GET	/providers	Done
PATCH	/providers/:id	Done
GET	/packages	Done
POST	/packages	Done
PATCH	/packages/:id	Done
GET	/promotions	Done
POST	/promotions	Done
PATCH	/promotions/:id	Done
POST	/promotions/validate	Done
GET	/products/pending	Done
POST	/products/:id/approve	Done
POST	/products/:id/reject	Done
GET	/referrals/fraud-holds	Done
POST	/referrals/:id/approve	Done
POST	/referrals/:id/reject	Done

Mobile App - Services y Stores

Services Implementados

apps/mobile/src/services/api/
+-- client.ts              Done (Axios + interceptors)
+-- auth.service.ts        Done (Login + Register + OTP)
+-- credits.service.ts     Done (Balance + Transactions)
+-- inventory.service.ts   Done (CRUD + Search + Types)
+-- videos.service.ts      Done (Upload + Status)
+-- payments.service.ts    Done (Packages + Create + History)
+-- notifications.service.ts Done (List + Read + FCM token)
+-- referrals.service.ts   Done (Code + Stats + Apply)
+-- stores.service.ts      Done (CRUD)
+-- users.service.ts       Done (Profile + Update)

Zustand Stores Implementados

apps/mobile/src/stores/
+-- auth.store.ts          Done (User + Tokens + Refresh)
+-- credits.store.ts       Done (Balance + Transactions + Stats) + Persistencia
+-- inventory.store.ts     Done (Items + Search + Filters + Pagination) + Persistencia
+-- payments.store.ts      Done (Packages + History)
+-- notifications.store.ts Done (List + Unread + FCM) + Persistencia
+-- referrals.store.ts     Done (Stats + List + Apply)
+-- stores.store.ts        Done (List + Current + CRUD) + Persistencia

UX Mobile - Animaciones y Modo Offline (MII-MO-014)

apps/mobile/src/
+-- hooks/
|   +-- useAnimations.ts        Done (9 hooks de animacion)
|   +-- useNetworkStatus.ts     Done (Deteccion de red)
+-- theme/
|   +-- ThemeContext.tsx        Done (Sistema de temas)
+-- components/ui/
|   +-- Skeleton.tsx            Done (8 componentes skeleton base)
|   +-- OfflineBanner.tsx       Done (Banner modo offline)
|   +-- AnimatedList.tsx        Done (FlatList animada)
+-- components/skeletons/
    +-- InventoryItemSkeleton.tsx  Done (3 exports)
    +-- StoreCardSkeleton.tsx      Done (2 exports)
    +-- CreditCardSkeleton.tsx     Done (5 exports)
    +-- NotificationSkeleton.tsx   Done (3 exports)

Types Actualizados

apps/mobile/src/types/index.ts Done
- User, Store, InventoryItem
- Video, VideoStatus
- CreditBalance, CreditTransaction, CreditPackage
- Payment, PaymentStatus, PaymentMethod
- Referral, ReferralStats, ReferralStatus
- Notification, NotificationType
- Auth types (Tokens, Login, Register)

Mobile App - UI Screens

Tab Screens Mejoradas

Home Screen (`app/(tabs)/index.tsx`) - COMPLETADA

Header con nombre de usuario y tienda actual
Boton de notificaciones con badge de no leidas
Tarjeta de creditos con balance y boton de compra
Selector de tiendas (chips horizontales)
Acciones rapidas (escanear, inventario, referidos)
Grid de estadisticas (tiendas, productos, escaneos)
Alerta de stock bajo con contador
Pull-to-refresh funcional

Inventory Screen (`app/(tabs)/inventory.tsx`) - COMPLETADA

Header con nombre de tienda y total de productos
Barra de busqueda con limpiar
Filtros (Todos / Stock bajo)
Lista de productos con:
- Nombre y categoria
- Codigo de barras
- Badge "Editado" para items manuales
- Barra de confianza de deteccion
- Cantidad con colores (normal/bajo)
Estados vacios (sin resultados, sin inventario, sin tienda)
Loading state con spinner
Pull-to-refresh funcional
Banner de error con reintentar

Profile Screen (`app/(tabs)/profile.tsx`) - COMPLETADA

Avatar con inicial del nombre
Nombre y telefono del usuario
Tarjeta de creditos con:
- Balance grande centrado
- Stats (comprados, por referidos, usados)
- Boton de comprar creditos
Tarjeta de referidos con:
- Codigo de referido grande
- Botones copiar/compartir
- Stats (invitados, completados, creditos ganados)
Menu de cuenta (perfil, tiendas, pagos)
Menu de creditos (comprar, historial, referidos)
Menu de soporte (ayuda, contacto, legal)
Cerrar sesion con confirmacion
Version de la app
Pull-to-refresh funcional

Secondary Screens Implementadas

Credits Buy Screen (`app/credits/buy.tsx`) - COMPLETADA

Grid de paquetes de creditos con precios
Badge "Popular" en paquete destacado
Precio por credito calculado
Metodos de pago (OXXO, 7-Eleven, Tarjeta)
Descripcion de cada metodo
Radio buttons para seleccion
Footer con total y boton de compra
Estados de loading y error

Credits History Screen (`app/credits/history.tsx`) - COMPLETADA

Lista de transacciones con iconos por tipo
Montos con colores (verde/rojo)
Fechas formateadas
Estado vacio
Paginacion con scroll infinito
Pull-to-refresh

Referrals Screen (`app/referrals/index.tsx`) - COMPLETADA

Tarjeta de codigo referido con copiar/compartir
Estadisticas (invitados, completados, creditos)
Seccion "Como funciona" con pasos
Lista de referidos con estado
Badges de estado (Pendiente, Registrado, Calificado, Completado)
Bonificacion ganada por referido
Estado vacio
Paginacion con scroll infinito

Notifications Screen (`app/notifications/index.tsx`) - COMPLETADA

Lista de notificaciones con iconos por tipo
Indicador de no leidas (punto azul)
Formato de tiempo relativo (hace X minutos)
Navegacion contextual al tocar
Boton "Marcar leidas" en header
Estado vacio
Pull-to-refresh

Stores List Screen (`app/stores/index.tsx`) - COMPLETADA

Lista de tiendas con indicador de activa
Badge "Activa" en tienda seleccionada
Boton editar por tienda
Long press para eliminar
Boton "+ Nueva" en header
Estado vacio con CTA
Pull-to-refresh

New Store Screen (`app/stores/new.tsx`) - COMPLETADA

Formulario con nombre, direccion, ciudad, giro
Validacion de nombre requerido
Info card con tips
Estados de loading y error
KeyboardAvoidingView

Edit Store Screen (`app/stores/[id].tsx`) - COMPLETADA

Formulario de edicion pre-cargado
Boton eliminar tienda
Confirmacion de eliminacion
Estados de loading y error

Inventory Detail Screen (`app/inventory/[id].tsx`) - COMPLETADA

Tarjeta de cantidad grande con editor (+/-)
Badge "Stock bajo" cuando aplica
Campos editables (nombre, categoria, barcode, precio)
Seccion de deteccion automatica con barra de confianza
Historial (creado, actualizado, ultima deteccion)
Modo vista/edicion toggle
Boton eliminar producto
Footer con cancelar/guardar

Scan Screen (`app/(tabs)/scan.tsx`) - COMPLETADA

Permisos de camara y microfono
Grabacion de video con temporizador
Duracion maxima de 30 segundos
Upload a S3 con progreso
Polling de estado de procesamiento
Barra de progreso visual
Manejo de errores con reintentar
Alertas de exito con navegacion

Profile Edit Screen (`app/profile/edit.tsx`) - COMPLETADA

Avatar con inicial del nombre
Edicion de nombre y email
Telefono de solo lectura
Validacion de formulario
Estados de loading y error

Payment Methods Screen (`app/payments/methods.tsx`) - COMPLETADA

Lista de metodos disponibles (Tarjeta, OXXO, 7-Eleven)
Estado de disponibilidad por metodo
Seccion informativa sobre pagos
Navegacion a compra de creditos

Help Screen (`app/help/index.tsx`) - COMPLETADA

FAQs organizadas por categoria
Filtros por categoria (chips)
Accordion expandible para respuestas
10 preguntas frecuentes cubiertas
Enlace a soporte

Support Screen (`app/support/index.tsx`) - COMPLETADA

Botones de contacto rapido (WhatsApp, Email)
Formulario de mensaje con asunto
Horario de atencion
Simulacion de envio de mensaje

Terms Screen (`app/legal/terms.tsx`) - COMPLETADA

Terminos y condiciones completos
10 secciones legales
Formato legible con secciones
Fecha de ultima actualizacion

Privacy Screen (`app/legal/privacy.tsx`) - COMPLETADA

Politica de privacidad completa
11 secciones sobre datos y seguridad
Informacion sobre proveedores terceros
Derechos del usuario

Archivos Creados/Modificados en Esta Sesion

Backend - Tests E2E

apps/backend/test/
+-- jest-e2e.json              Done (Config con runInBand)
+-- setup.ts                   Done (Setup global)
+-- .env.test                  Done (Variables de test)
+-- utils/
|   +-- index.ts               Done
|   +-- test-app.ts            Done (CreateTestApp)
|   +-- test-fixtures.ts       Done (Fixtures)
+-- health.e2e-spec.ts         Done (2 tests)
+-- auth.e2e-spec.ts           Done (13 tests)
+-- users.e2e-spec.ts          Done (6 tests)
+-- stores.e2e-spec.ts         Done (12 tests)
+-- credits.e2e-spec.ts        Done (7 tests)
+-- inventory.e2e-spec.ts      Done (13 tests)

Backend - Modulos

apps/backend/src/
+-- common/interfaces/
|   +-- authenticated-request.interface.ts  Done (Tipos para Request)
+-- modules/
    +-- payments/
    |   +-- payments.service.ts     Done (Stripe + OXXO + 7-Eleven)
    |   +-- payments.controller.ts  Done (AuthenticatedRequest)
    |   +-- payments.module.ts      Done
    |   +-- entities/payment.entity.ts Done (voucherUrl/Code opcionales)
    |   +-- dto/create-payment.dto.ts Done
    +-- notifications/
    |   +-- notifications.service.ts Done (FCM + Multiple types)
    |   +-- notifications.controller.ts Done (AuthenticatedRequest)
    |   +-- notifications.module.ts Done
    |   +-- entities/notification.entity.ts Done
    +-- referrals/
    |   +-- referrals.service.ts    Done (IsNull + code init)
    |   +-- referrals.controller.ts Done (AuthenticatedRequest)
    |   +-- referrals.module.ts     Done
    |   +-- entities/referral.entity.ts Done
    +-- users/
    |   +-- users.service.ts        Done (fcmToken: string | null)
    |   +-- entities/user.entity.ts Done (fcmToken nullable)
    |   +-- dto/update-user.dto.ts  Done (stripeCustomerId)
    +-- videos/
        +-- videos.service.ts       Done (updateStatus explicit type)

Mobile

apps/mobile/src/
+-- app/(tabs)/
|   +-- index.tsx                   Done (Dashboard completo)
|   +-- inventory.tsx               Done (Lista + busqueda + filtros)
|   +-- profile.tsx                 Done (Creditos + referidos)
|   +-- scan.tsx                    Done (Grabacion video completa)
+-- app/credits/
|   +-- _layout.tsx                 Done
|   +-- buy.tsx                     Done (Paquetes + metodos de pago)
|   +-- history.tsx                 Done (Transacciones)
+-- app/referrals/
|   +-- _layout.tsx                 Done
|   +-- index.tsx                   Done (Codigo + lista referidos)
+-- app/notifications/
|   +-- _layout.tsx                 Done
|   +-- index.tsx                   Done (Lista + marcar leidas)
+-- app/stores/
|   +-- _layout.tsx                 Done
|   +-- index.tsx                   Done (Lista tiendas)
|   +-- new.tsx                     Done (Crear tienda)
|   +-- [id].tsx                    Done (Editar tienda)
+-- app/inventory/
|   +-- _layout.tsx                 Done
|   +-- [id].tsx                    Done (Detalle + editar producto)
+-- services/api/
|   +-- payments.service.ts         Done
|   +-- notifications.service.ts    Done
|   +-- referrals.service.ts        Done
|   +-- stores.service.ts           Done
|   +-- credits.service.ts          Done (totalFromReferrals)
|   +-- inventory.service.ts        Done (Tipos exportados + hasMore)
+-- stores/
|   +-- payments.store.ts           Done
|   +-- notifications.store.ts      Done
|   +-- referrals.store.ts          Done
|   +-- stores.store.ts             Done
|   +-- credits.store.ts            Done (Balance completo)
|   +-- inventory.store.ts          Done (Import InventoryItem)
+-- types/
    +-- index.ts                    Done (Actualizado)
+-- app/profile/
    +-- edit.tsx                    Done (Editar perfil)
+-- app/payments/
    +-- methods.tsx                 Done (Metodos de pago)
+-- app/help/
    +-- index.tsx                   Done (Centro de ayuda)
+-- app/support/
    +-- index.tsx                   Done (Contactar soporte)
+-- app/legal/
    +-- terms.tsx                   Done (Terminos y condiciones)
    +-- privacy.tsx                 Done (Politica de privacidad)

Errores Corregidos

Backend (42 errores TypeScript)

@Request() req implicit any - Creado AuthenticatedRequest interface
Todos los controllers actualizados con tipos explicitos
null no asignable a string para FCM - Cambiado a string | null
null en TypeORM where clause - Usado IsNull() de typeorm
Variable 'code' usada antes de asignar - Inicializado como let code = ''
Tipo de metadata en update - Creado tipo explicito para updateStatus
User posiblemente null - Agregado null check con BadRequestException
voucherCode/voucherUrl no asignables - Campos opcionales con ?
stripeCustomerId no en UpdateUserDto - Agregado al DTO

Mobile (2 errores TypeScript)

expo-camera CameraView no encontrado - Cambiado a Camera, CameraType
InventoryItem tipos duplicados - Importado del servicio

Dependencias

ERESOLVE react-test-renderer - Agregado explicitamente "18.2.0"
expo-clipboard no instalado - Instalado con npm

Tests E2E Implementados

Configuracion

test/jest-e2e.json - Configuracion Jest para E2E (runInBand)
test/setup.ts - Setup global con reflect-metadata
test/.env.test - Variables de entorno para tests
test/utils/test-app.ts - Utilities para crear app de test
test/utils/test-fixtures.ts - Fixtures para crear datos de prueba

Test Suites (53 tests total)

Health E2E (2 tests)

GET /health - health status
GET /health/ready - readiness check

Auth E2E (13 tests)

POST /auth/register - OTP flow
POST /auth/verify-otp - cuenta creation
POST /auth/login - credentials
POST /auth/refresh - token refresh
POST /auth/logout - session invalidation
Validaciones y casos de error

Users E2E (6 tests)

GET /users/me - profile
PATCH /users/me - update profile
PATCH /users/me/fcm-token - FCM token
Auth validation

Stores E2E (12 tests)

POST /stores - create
GET /stores - list
GET /stores/:id - detail
PATCH /stores/:id - update
DELETE /stores/:id - delete
Ownership validation

Credits E2E (7 tests)

GET /credits/balance - balance
GET /credits/transactions - history + pagination
GET /credits/packages - available packages
Auth validation

Inventory E2E (13 tests)

GET /stores/:storeId/inventory - list + pagination
GET /stores/:storeId/inventory/statistics - stats
GET /stores/:storeId/inventory/low-stock - alerts
GET /stores/:storeId/inventory/categories - categories
GET /stores/:storeId/inventory/:itemId - detail
PATCH /stores/:storeId/inventory/:itemId - update
DELETE /stores/:storeId/inventory/:itemId - delete
Ownership validation

Comandos de Test

# Crear base de datos de test
docker exec miinventario-postgres psql -U postgres -c "CREATE DATABASE miinventario_test;"
docker exec miinventario-postgres psql -U postgres -d miinventario_test -c "CREATE EXTENSION IF NOT EXISTS \"uuid-ossp\";"

# Ejecutar todos los tests E2E
npm run test:e2e

# Ejecutar tests especificos
npm run test:e2e -- --testPathPattern="auth"
npm run test:e2e -- --testPathPattern="stores"

Proximos Pasos

~~Implementar modulo videos~~ Done
~~Implementar modulo creditos~~ Done
~~Implementar modulo inventario~~ Done
~~Implementar IA Provider~~ Done
~~Implementar modulo de pagos (Stripe + OXXO)~~ Done
~~Implementar notificaciones (FCM)~~ Done
~~Implementar modulo de referidos~~ Done
~~Sincronizar mobile con endpoints~~ Done
~~Corregir errores TypeScript backend~~ Done
~~Corregir errores TypeScript mobile~~ Done
~~Implementar UI Home screen~~ Done
~~Implementar UI Inventory screen~~ Done
~~Implementar UI Profile screen~~ Done
~~Implementar pantallas secundarias~~ Done
- ~~credits/buy~~ Done
- ~~credits/history~~ Done
- ~~referrals~~ Done
- ~~notifications~~ Done
- ~~stores (list, new, edit)~~ Done
- ~~inventory/[id] (detail, edit)~~ Done
~~Generar migraciones TypeORM~~ Done
~~Tests E2E~~ Done (53 tests)
~~Integrar Stripe real~~ Done (webhook signature, eventos, notificaciones)
~~Configurar Firebase real~~ Done (FCM push, limpieza de tokens invalidos)
~~Documentacion de produccion~~ Done (PRODUCTION-CONFIG.md)

Comandos para Desarrollo

# Instalar dependencias
cd projects/miinventario && npm install --legacy-peer-deps

# Iniciar servicios Docker
npm run db:up

# Generar migracion
cd apps/backend
npm run migration:generate -- src/migrations/Init

# Ejecutar migracion
npm run migration:run

# Verificar tipos TypeScript
cd apps/mobile && npx tsc --noEmit
cd apps/backend && npm run build

# Iniciar desarrollo
npm run dev

Variables de Entorno Requeridas

Backend (.env)

# Database
DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_NAME=miinventario
DATABASE_USER=postgres
DATABASE_PASSWORD=postgres

# JWT
JWT_SECRET=your-secret-key
JWT_EXPIRES_IN=15m
JWT_REFRESH_EXPIRES_IN=7d

# S3/MinIO
S3_ENDPOINT=http://localhost:9000
S3_ACCESS_KEY=minio
S3_SECRET_KEY=minio123
S3_BUCKET=miinventario
S3_REGION=us-east-1

# Redis
REDIS_HOST=localhost
REDIS_PORT=6379

# Stripe (opcional para desarrollo)
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# Firebase (opcional para desarrollo)
FIREBASE_PROJECT_ID=your-project-id
FIREBASE_CLIENT_EMAIL=your-email
FIREBASE_PRIVATE_KEY=your-key

Mobile (.env)

EXPO_PUBLIC_API_URL=http://localhost:3142/api/v1

Historial de Actualizaciones

Fecha	Version	Cambios
2026-01-10	0.1.0	Creacion inicial
2026-01-10	0.1.1	Documentacion completa
2026-01-10	0.1.2	Estructura backend/mobile
2026-01-10	0.2.0	Entidades + Auth + Stores
2026-01-10	0.3.0	Videos + Credits + Inventory + IA
2026-01-10	0.4.0	Payments + Notifications + Referrals + Mobile sync
2026-01-10	0.5.0	UI mejorada (Home, Inventory, Profile) + TypeScript fixes
2026-01-10	0.6.0	Pantallas secundarias completas (credits, referrals, notifications, stores, inventory detail)
2026-01-10	0.7.0	Tests E2E completos (53 tests: health, auth, users, stores, credits, inventory)
2026-01-10	0.8.0	Stripe produccion (webhook signature, mas eventos, notificaciones), Firebase FCM mejorado, documentacion produccion
2026-01-10	0.9.0	IA Provider completo (OpenAI GPT-4o + Claude Vision), extraccion de frames con ffmpeg, notificaciones de video
2026-01-10	1.0.0	Mobile 100% completado: grabacion de video, editar perfil, metodos de pago, ayuda, soporte, terminos, privacidad
2026-01-11	1.1.0	Documentacion de produccion y configuracion
2026-01-12	1.2.0	UX Mobile: animaciones fluidas + modo offline (MII-MO-014)

Ultima Actualizacion: 2026-01-12 Responsable: Claude Opus 4.5

28 KiB Raw Blame History