Skip to content
/ JSSATS Public
forked from ngckinhluan/JSSATS

This app streamlines jewelry sales with features for staff to handle transactions, promotions, real-time gold price updates, and buy-backs. Managers can access dashboards and stats, while admins manage promotions, inventory, and customer data with CRUD operations.

License

Notifications You must be signed in to change notification settings

luantnk/JSSATS

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Static Badge Forks Stargazers Issues MIT License LinkedIn Build & Test


Logo

Jewelry Sales System At The Store

This software is designed to manage the sales operations for a jewelry business with a single store that includes multiple counters.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

API Backend

The API backend serves as the core of the jewelry sales management system, handling all the business logic and database interactions. Below is a screenshot showcasing the API backend:

API Screenshot Backend

Database Management

ERD

JssatsERD

ARD

image

Front-End Page

The front-end of the application is designed for staff and managers to manage jewelry sales efficiently. Here are some key pages:

  • This is the entry point for staff to access the jewelry sales management system. Users must authenticate themselves to gain access to the system.

front-end

  • Once logged in, staff are directed to the main page where they can manage jewelry sales. This page allows staff to browse through items and assist customers.

front-end

  • Staff can select items that customers wish to purchase. The interface is designed to be intuitive, ensuring that the sales process is smooth and efficient.

front-end

  • Staff can easily find and verify customer information, ensuring personalized service and accurate record-keeping.

front-end

  • This dashboard provides managers and administrators with an overview of the jewelry inventory and sales performance. It is the central hub for managing the system.

front-end

  • Managers can use this page to manage the jewelry inventory, including adding, updating, and removing items from the system.

front-end

  • This page provides detailed information about individual jewelry items, allowing managers to make informed decisions regarding inventory management.

front-end

  • This app also use Jenkis to facilitate the CI/CD pipeline. jenkins

(back to top)

Built With

  • React
  • .NET
  • C#
  • Jira
  • Visual Studio
  • Supabase
  • Postgres
  • Jwt
  • TypeScript
  • MUI
  • Tailwind
  • Vercel
  • MongoDb
  • Nodejs
  • Js
  • React-router

(back to top)

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

  • npm
    npm install npm@latest -g

Installation

  1. Clone the repo
    git clone https://github.com/ngckinhluan/Jewelry-Sale-System-At-The-Store.git
  2. Frontend Setup
  • Navigate to the front-end directory
    cd FE
    
  1. Install NPM packages
    npm install
  2. To start the development server and run the project locally, use the following command:
    npm run dev
    
  3. Backend Setup
  • Navigate to the backend directory
    cd BE
    
  • Open the .sln file in your IDE (e.g., Visual Studio).
  • Change the ConnectionString in the configuration file to match your database setup.
  • Migrate the database to your local datbase machine
  • Run the project
  1. Now you can start using the project.

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

Members

A special thanks to the following team members for their invaluable contributions to this project:

  • Nguyen Hung Nghia (K16 HCM): Backend development and database management
  • Le Minh Tan (K16 HCM): Backend development
  • Tran Huy Hoang (K18 HCM): Frontend development
  • Tran Ngoc Kinh Luan (K18 HCM): Frontend development (me)

Your dedication and support made this project possible.

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Tran Ngoc Kinh Luan - LinkedIn - [email protected]

Project Link: https://github.com/ngckinhluan/JSSAT

(back to top)

About

This app streamlines jewelry sales with features for staff to handle transactions, promotions, real-time gold price updates, and buy-backs. Managers can access dashboards and stats, while admins manage promotions, inventory, and customer data with CRUD operations.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 53.3%
  • TypeScript 40.6%
  • CSS 5.4%
  • Other 0.7%