Inventory System is a production-ready, multi-tenant inventory management platform. Each company operates in a fully isolated workspace with its own products, users, sales records, and analytics. It is built with Next.js 16 (App Router), React 19, Prisma 5, and Neon Serverless Postgres, and ships with a complete REST API, role-based access control, and a real-time notification system.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/juadariasmar/inventory_project/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Set up a local development environment and have the app running in minutes.
Environment Variables
Reference for every required and optional environment variable.
Core Features
Explore products, sales, purchase orders, quotes, analytics, and notifications.
API Reference
Full REST API documentation — endpoints, request/response schemas, and examples.
What’s included
Multi-Tenant
Every company is isolated at the database level. All queries are scoped by
empresaId.Role-Based Access
Three roles — SUPER_ADMIN, ADMIN, USUARIO — with granular per-user permission flags.
Product Catalog
Products with auto-generated codes, categories, price history, and stock-minimum alerts.
Sales & Quotes
Quick-sell terminal, quotations with stock reservation, and one-click quote-to-sale conversion.
Purchase Orders
Purchase orders with PDF export, supplier management, and automatic stock entry on receipt.
Analytics
Dashboard charts for daily sales, stock distribution, high-rotation products, and movement history.
Technology stack
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router) + React 19 |
| Language | TypeScript 5 |
| ORM | Prisma 5 with @prisma/adapter-neon |
| Database | Neon Serverless Postgres |
| Auth | Neon Auth (@neondatabase/auth) |
| UI | Tailwind CSS 4 + Radix UI |
| Charts | Recharts 3 |
| Rate limiting | Upstash Redis (with in-memory fallback) |
| Testing | Jest 30 + Playwright |
| Deployment | Vercel (primary) or Docker |
Configure environment
Copy
.env.example to .env and fill in DATABASE_URL, NEXTAUTH_SECRET, and NEON_AUTH_BASE_URL.Run migrations and seed
Run
npm run prisma:migrate then npm run seed to populate the database with initial data.Start development server
Run
npm run dev and open http://localhost:3000. Sign in with [email protected].