Skip to content

oop-it-kmitl-61/jStock

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

46 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

logo

    Inventory management system for all types of stores. With a variety of functions. Caring for a shop will be easier from now on. jStock, a java project for Object-Oriented Programming 2018, will help you to manage your both storefront and warehouse.

✏️ Functional Specification

  • Sale products.
  • Add/Edit product (only for store owners or managers).
  • Transactions record.
  • Sales Analysis.

🗄 Database structure

// User structure
	{
		name: "jStock",
		password: "pcNf4sPc",
		products: 44,
		transactions: 112,
	}

// Stock structure
	[{
		productID: "00000",
		productName: "Submarine",
		productPrice: 1000,
		productAmount: 3,
		productBrand: "China",
		productType: "vehicle"
	}]

// Transactions structure
	[{
		transactionID: "000000000",
		date: {
			day: "18",
			month: "12",
			year: "2018"
		},
		sDate: "18/12/2012",
		time: "23:59:59",
		total: 2000,
		products: [{
			productID: "00000",
			productName: "submarine",
			productPrice: 1000,
			quantity: 2,
			amount:2000
		}
	}]

📍 Getting Started

🛠 Prerequisites

  1. JDK 11
  2. MongoDB

⚙️ Configuration (optional)

  • Database Host in this file. Replace YOUR_HOST to your host.

private final String HOST = "YOUR_HOST";

  • Database Port in this file. Replace YOUR_PORT to your port.

private final int PORT = YOUR_PORT;

🏃 Running the project

  1. Clone this repository.

git clone https://github.com/oop-it-kmitl-61/jStock.git

  1. Run project.
  • Without config (mongodb must run on localhost:27017).

cd jStock

java -jar jStock.jar

📖 How to use

Open jStock. loading

For the first time you need to create new stock. create stock

Welcome page will show up when stock created successful. welcome

For the next time of use, the program will direct to sale page. sale1

Now stock is empty, so you need to add product to stock by click at "Edit Stock" button, but this function is only for store owners or managers who have a password.

password

After you insert the correct password and click Continue the program will direct to edit page and then click Add Product to go to Add Product page. edit1

You need to complete the product informations. Next step is click the Add Product button. add

After clicking the button, the program will show this dialog to confirm adding product. You need to check if the information is correctly and click Add button to add product to stock. add check

After the previous step the program will back to edit page and your product will be shown in table. If nothing happen, you can click refresh button below the table to refresh data. edit2

This is example of alert. If product amount is less than 5, the cell will change colour to yellow. And if product is out, the cell will change colour to red. edit3

You can also edit or delete product by clicking at the edit icon in Edit column. edit product

If you want to delete a product, the program will show this dialog to confirm. delete product confirm

After you confirm the deletion, the product will disappear from the stock. edit4

The product that you add from Edit page is link to Sale page. sale2

You can search product by typing the product's name even the product's ID in Search field. search1 search2

To sale the products you need to click the Add button of the product that you want to sale and then click Sale button to go to summary page. sold

After clicking Sale button the program will show this dialog to confirm to sale. reciept

If there are not enough product, the program will show this dialog and can't sale products when you click sale. out of stock

When you successfully selling, the program will back to Sale page and product amount will be reduced. sale3

You can see all of transactions by clicking at Transactions button then the program will direct to transactions page. transactions page

To view more detail of transaction you need to click at view button in View column the program will show this transaction's information dialog.

view transaction

To check profits you need to click Dashboard button, the program will direct to report by day. The report show total income, total orders, products amount(piece) and ranking of product best seller by day, mount or year. dashboard

You can also change store name and password by click at Setting button (this function require password like Edit page). enter image description here

To quit the program you just click at the Quit button the program will show this dialog to confirm to quit. quit

👩‍💻 Author 👨‍💻

60070073 60070076 60070114
Passawit Mareena Apisit
Riewthong Nuramun Wetmaha
@dekdew @skefolksy @Apisit60070114

👩‍🏫 Supervisor

Asst.prof. Thanisa Numnonda, Ph.D.

06016317 OBJECT-ORIENTED PROGRAMMING

Faculty of Information Technology

King Mongkut's Institute of Technology Ladkrabang

Releases

No releases published

Packages

No packages published

Languages