Skip to content

N-Emil/Store-Application

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛒 StoreApp - Management System

A comprehensive Java Swing-based desktop application for managing a retail store's operations. The project implements a modular MVC (Model-View-Controller) architecture to manage customers, products, and orders with data persistence through CSV files.


📸 Screenshots

Main Dashboard Customer Management


🚀 Key Features

  • Inventory Control: Real-time management of product stocks. Order creation automatically deducts from available quantities.
  • Order Management: Intuitive order processing with an integrated JDateChooser for visual date selection.
  • Automated Calculations: Automatic calculation of total prices based on unit price and quantity.
  • Data Persistence: Flat-file storage using CSV format for Customers, Products, and Orders, allowing data recovery across sessions.
  • Input Validation: Built-in logic to ensure data integrity, including phone number formatting and stock availability checks.

📥 Download & Run (For Users)

If you just want to use the application without setting up a development environment:

  1. Go to the Releases page.
  2. Download the App.zip file.
  3. Extract (unzip) the contents of the folder to your computer.
  4. Open the folder and double-click on StoreApp.exe to launch the application.

Important

Ensure the data folder remains in the same directory as the executable for the application to load the database correctly. No Java installation (JRE) is required as it is bundled within the package.


🛠️ Technologies & Libraries

  • Language: Java (JDK)
  • Framework: Java Swing (GUI)
  • External Library: jcalendar-1.4.jar (for DatePicker functionality)
  • Storage: CSV (stored in data/ folder)

📁 Project Structure

  • src.com.Store.Main: Entry point of the application (Main.java).
  • src.com.Store.Model: Data models including StoreModel, Product, Customer, and Order.
  • src.com.Store.View: UI components and panels (e.g., BasePanel, OrderPanel, MainFrame).
  • src.com.Store.Controller: Logic handlers that bridge the View and Model.
  • src.com.Store.Utils: Helper classes like Validation for input checks.
  • data/: Directory containing CSV files for permanent storage.
  • screenshots/: Visual documentation of the application.

🔧 Installation & Setup (For Developers)

  1. Clone the Repository:
    git clone https://github.com/N-Emil/Store-Application.git
  2. Open in IDE: Import the project into IntelliJ IDEA or Eclipse.
  3. Add Libraries: Ensure jcalendar-1.4.jar is added to your project's build path.
  4. Run: Execute Main.java to start the application.

📄 License

This project is open-source. Feel free to use and modify!

About

A Java Swing-based Store Management System implementing MVC architecture with CSV data persistence and automated stock control.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages