An open API service indexing awesome lists of open source software.

https://github.com/ashokrimal/rass


https://github.com/ashokrimal/rass

ashokrimal bca cct college-projects crimsoncollegeoftechnology departmental-store-management-system dsms lamirkohsa pokhara-university rass rohitshrestha shishirpandey shushilbhusal students

Last synced: 9 months ago
JSON representation

Awesome Lists containing this project

README

          

# DSMS - Departmental Store Management System


Banner




[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![React](https://img.shields.io/badge/React-18.2.0-blue)](https://reactjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.2.2-blue)](https://www.typescriptlang.org/)
[![MongoDB](https://img.shields.io/badge/MongoDB-6.0.7-green)](https://www.mongodb.com/)

---

## Overview
RASS is a modern Departmental Store Management System built with **React + TypeScript** for the frontend and **MongoDB** for the database. It is designed to streamline retail operations, including inventory management, sales, and customer management.

## Features
- **Product Management:** Add, update, and delete products.
- **Inventory Tracking:** Monitor stock levels and get alerts for low inventory.
- **Sales Processing:** Handle billing efficiently with support for multiple payment methods.
- **Customer Management:** Maintain customer profiles and purchase histories.
- **Reporting:** Generate sales and inventory reports for analysis.

## Tech Stack
- **Frontend:** React, TypeScript, Tailwind CSS
- **Backend:** Node.js, Express
- **Database:** MongoDB
- **Other Tools:** Mongoose for database interactions, Axios for API calls

## Installation

1. **Clone the repository:**
```bash
git clone https://github.com/ashokrimal/rass.git

2. **Navigate to the project directory:
```bash
cd rass

3. **Install Dependencies
```bash
npm install

4. **Setup MongoDB:
- Create a MongoDB database.
- Update the .env file with your MongoDB connection string:

5. **Start the development Server:
```bash
npm run dev
The app should now be running on http://localhost:3000 by default (or the port your Vite/React app is configured to use).

6. **Usage**
- **Admin Panel:** Manage products, view sales reports, and update inventory.
- **Customer Interface:** Browse products and make purchases through the intuitive UI.

7. **Contributing**

Contributions are welcome! Please fork the repository, create a new branch, and submit a pull request.


## Team Members

Meet the awesome team behind RASS:

| Avatar | Name | Role | GitHub | LinkedIn | Portfolio |
|--------|----------------|--------------------------|--------|----------|-----------|
| | Ashok Rimal | Project Lead / Developer | [GitHub](https://github.com/ashokrimal) | [LinkedIn](https://www.linkedin.com/in/ashokrimal) | [Portfolio](https://ashokrimal.com.np) |
| | Rohit Shrestha | Frontend Developer | [GitHub](https://github.com/username4) | [LinkedIn](https://www.linkedin.com/in/username4) | [Portfolio](https://username4.dev) |
| | Shishir Pandey | Developer / Designer | [GitHub](https://github.com/username2) | [LinkedIn](https://www.linkedin.com/in/username2) | [Portfolio](https://username2.dev) |
| | Shushil Bhusal | Backend Developer | [GitHub](https://github.com/shushilbhusal) | [LinkedIn](https://www.linkedin.com/in/shushilbhusal) | [Portfolio](https://shushilbhusal.com.np) |