Skip to content

pantho0/brhex-inventory-management

Repository files navigation

📦 BRHEX Inventory Management System

A complete inventory, sales, and invoice management system designed for small to medium businesses.

Live Demo Requirement Analysis

Features include barcode scanning, serial-based inventory tracking, dynamic invoice creation, PDF & POS bill generation, and advanced sales analytics.


📘 ER Diagram

The system is designed using a clean relational structure.

BRHEX Inventory ER Diagram


💻 Tech Stack

This system is built using the T3 stack principles, utilizing TypeScript for robust type safety and Next.js for full-stack functionality.

Core Technologies

Component Technologies Used
Framework Next.js (Full-stack)
Language TypeScript
Database MongoDB with Mongoose ODM
Authentication JSON Web Tokens (JWT)

Tools & Libraries

Next.js TypeScript MongoDB
Mongoose JWT Vercel
PDF-LIB JSBarcode Postman

🚀 Features

User & Authentication

  • Secure JWT-based login
  • Role management: admin, user
  • Admin controls all modules

🏷️ Category Management

  • Create, update, delete categories
  • Organize products clearly

📦 Product Management

  • Add/edit/delete products
  • Assign categories
  • Search & filter products

🛠️ Inventory Management

  • Serial number–based tracking
  • Auto update inventory status:
    • in_stock
    • sold
    • in_warranty
    • returned
  • Purchase price, selling price, warranty
  • Auto barcode generator for non-serial items

🧾 Invoice Management

  • Add items via barcode/serial scanning
  • Auto fetch inventory data
  • Full invoice calculation:
    • Subtotal
    • Discount
    • Tax
    • Total
    • Paid / Due
  • Payment history tracking

🖨️ Invoice Output

  • Auto-generate:
    • A4 PDF Invoice
    • POS-size thermal bill

📊 Dashboard Analytics

  • Daily, monthly, yearly sales charts
  • Bar & line charts
  • Summary cards:
    • Total Sales
    • Total Paid
    • Total Due
    • Total Invoices
    • Inventory Status

🔑 Default Admin Credentials

Upon initial clone and setup, a default admin user will be automatically created for immediate login:

Field Value
Email admin@brhex.com
Password Brhex@123

📥 Clone the Repository

git clone [https://github.com/pantho0/brhex-inventory-management.git](https://github.com/pantho0/brhex-inventory-management.git)
cd your-repo-name

npm install
npm run start:dev
npm run start:prod

Releases

No releases published

Packages

No packages published