Skip to content

tsj2003/Retail-Sense

Repository files navigation

Retail Sales Management System

Overview

A comprehensive full-stack application for managing and analyzing retail sales data. Features advanced search, multi-select filtering, sorting, and pagination, built with a focus on performance and clean architecture.

Application Screenshot

Dashboard

Tech Stack

  • Frontend: React, Vite, CSS
  • Backend: Node.js, Express, SQLite

Search Implementation Summary

Full-text search is implemented using SQL LIKE queries on Customer Name and Phone Number fields. It is case-insensitive and works in conjunction with all active filters.

Filter Implementation Summary

Multi-select filtering is supported for Region, Gender, Category, and Payment Method. Date range and Age range filtering are also implemented. Filters are applied dynamically via SQL IN clauses and range comparisons.

Sorting Implementation Summary

Sorting is handled on the backend via SQL ORDER BY. Supported fields include Date, Quantity, Customer Name, and Total Amount, with toggleable Ascending/Descending order.

Pagination Implementation Summary

Server-side pagination using SQL LIMIT and OFFSET. The frontend receives total count metadata to render Next/Previous controls and page indicators.

Setup Instructions

  1. Backend Setup:

    cd backend
    npm install
    npm start

    Server runs on http://localhost:5000.

  2. Frontend Setup:

    cd frontend
    npm install
    npm run dev

    Application runs on http://localhost:5173.

  3. Access: Open your browser to http://localhost:5173.

Deployment

Live Application URL

https://retailsense.netlify.app/

Live Backend API

https://retail-sense.onrender.com

GitHub Repository

https://github.com/tsj2003/Retail-Sense.git

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published