Inventario

Monorepo base para una aplicación de inventario de mudanzas con frontend móvil en Expo y backend NestJS.

Estructura

• apps/mobile: aplicación React Native + Expo + TypeScript.
• apps/api: API NestJS con prefijo global /api/v1 y documentación Swagger en /api/docs.
• .github/workflows/ci.yml: CI básico para lint, tests y build.

Modelo inicial

El backend define entidades iniciales para:

• Usuarios con email, nombre, hash de contraseña y hash de refresh token.
• Mudanzas asociadas a usuarios, con origen, destino, estado y fecha.
• Habitaciones asociadas a mudanzas.
• Categorías para clasificar objetos.
• Objetos asociados a mudanzas, habitaciones, categorías y kit diario.
• Cajas asociadas a mudanzas/habitaciones, con etiqueta, QR y estado de sellado.
• Asignaciones objeto-caja para registrar qué objetos van en cada caja.

La persistencia actual es en memoria para acelerar el arranque del producto. La siguiente iteración debería conectar una base de datos y migraciones.

Artefacto interactivo HTML

Además de las bases mobile/API, el repositorio incluye un prototipo navegable en apps/artifact/index.html para revisar el flujo del producto sin instalar dependencias. Abre el archivo directamente en el navegador para explorar resumen, mudanzas, inventario, modelo de datos, API y comandos de desarrollo.

Requisitos

• Node.js 22+
• npm 10+
• Expo CLI vía npx expo o los scripts npm incluidos

Instalación

npm install

Ejecución en desarrollo

Backend:

npm run dev:api

Frontend móvil:

npm run dev:mobile

API

• Base URL local: http://localhost:3000/api/v1
• Swagger UI: http://localhost:3000/api/docs

Endpoints base:

• POST /api/v1/auth/register
• POST /api/v1/auth/login
• POST /api/v1/auth/refresh
• GET|POST /api/v1/moves
• GET|POST /api/v1/rooms
• GET|POST /api/v1/categories
• GET|POST /api/v1/items
• GET|POST /api/v1/boxes
• POST /api/v1/boxes/assign-items
• GET /api/v1/moves/:moveId/daily-kit
• GET /api/v1/moves/:moveId/stats
• GET /api/v1/moves/:moveId/report

Lint, tests y build

npm run lint
npm test
npm run build