Stockenza

Stockenza is a comprehensive full-stack Point of Sale (POS), Billing, and Inventory Management system designed to streamline business operations.

Features

• Point of Sale (POS) & Billing: Configurable tax rates, comprehensive transaction histories, and a seamless checkout experience.
• Inventory Management: Track products with detailed attributes (SKU, Category) and integrate with Cloudinary for product image uploads.
• Dashboard & Analytics: Real-time revenue and profit metrics with global date range filtering applied across charts and tables (Revenue & Profit Graph, Profit & Loss by Product).
• Order Management: Detailed order history with the ability to automatically generate and download PDF invoices for past transactions.
• Advanced Authentication: Secure user management leveraging robust authentication patterns, including password reset flows ("Forgot Password") and secure email verification logic.

Tech Stack

Frontend (/stockenza_frontend)

• Core: Next.js 16, React 19
• Styling: Tailwind CSS
• Data Visualization: Recharts
• Utilities: Axios, jsPDF, html2canvas (for PDF invoice generation)

Backend (/stockenza_backend)

• Core: Node.js, Express.js
• Database: MongoDB with Mongoose
• Security: JWT (JSON Web Tokens), bcryptjs
• Media & Email Storage: Cloudinary (Image handling), Nodemailer & Resend (Email distribution)

Project Structure

• stockenza_frontend/: The client-facing Next.js application containing the dashboard, POS views, inventory management, order history, and authentication forms.
• stockenza_backend/: The Node.js Express API handling business logic, database transactions, image uploads, and email token verification.

Getting Started

Prerequisites

• Node.js (v18 or higher recommended)
• MongoDB instance (Atlas or local)
• Cloudinary API credentials
• Resend / Nodemailer configured email service

Installation & Setup

1. Clone the repository:

   git clone https://github.com/JhaSourav07/stockenza.git
   cd Stockenza

2. Backend Setup:

   cd stockenza_backend
   npm install

   Create a .env file in the stockenza_backend directory with the following necessary variables: MONGO_URI, JWT_SECRET, your CLOUDINARY_* keys, and your RESEND_API_KEY or SMTP settings.

   Start the backend development server:

   npm run dev

3. Frontend Setup:

   # Open a new terminal
   cd ../stockenza_frontend
   npm install

   Create a .env.local file in the stockenza_frontend directory (e.g., NEXT_PUBLIC_API_URL=http://localhost:5000/api).

   Start the frontend development server:

   npm run dev

License

This project is licensed under the ISC License.