diff --git a/README.md b/README.md index b529b18..72d66f0 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,212 @@ -# My Project +
+
+ +Logo + +

RAVANA ADVENCTURE PARK MANAGEMENT SYSTEM

+

+Java Based Information Management System +
+
+Explore the docs ยป +
+
+View Demo . +Report Bug . +Request Feature +

+
-This is a sample project to demonstrate adding a GIF with a border radius to a GitHub README file. +![Contributors](https://img.shields.io/github/contributors/RAVANA-Final-Project/RavanaAPMS?color=dark-green) ![Issues](https://img.shields.io/github/issues/RAVANA-Final-Project/RavanaAPMS) ![License](https://img.shields.io/github/license/RAVANA-Final-Project/RavanaAPMS) -![Alt Text](https://media.giphy.com/media/3oEjI6SIIHBdRxXI40/giphy.gif) +## Table of Contents -Example GIF +- [๐Ÿ“– Introduction](#introduction) +- [โœจ Features](#features) +- [๐Ÿ‘ฅ Roles and Responsibilities](#roles-and-responsibilities) + - [๐Ÿ‘จโ€๐Ÿ’ผ Admin](#admin) + - [๐Ÿ‘‘ Super Admin](#super-admin) + - [๐Ÿ”ง Equipment Manager](#equipment-manager) +- [โš™๏ธ Installation](#installation) +- [๐Ÿš€ Usage](#usage) +- [๐Ÿค Contributing](#contributing) +- [๐Ÿ“œ License](#license) +- [๐Ÿ“ž Contact](#contact) + +## Introduction + +The Ravana Adventure Park Management System is a standalone application aimed at optimizing the operations of our adventure park. The software supports various user roles, each with specific responsibilities to ensure smooth and efficient park management. + +
+ Example GIF +
+ +## Features + +- **๐Ÿ‘ค User Management**: Efficient management of users, roles, and permissions. +- **๐Ÿ“… Activity Management**: Comprehensive scheduling and management of adventure activities and leadership programs. +- **๐Ÿ› ๏ธ Equipment Management**: Detailed tracking of equipment inventory, maintenance, and usage. +- **๐Ÿ›๏ธ Order and Payment Management**: Handling of orders, offers, and payments with invoice generation. +- **๐Ÿ‘” Employee Management**: Management of employee details, job roles, and attendance. +- **๐Ÿ“Š Report Generation**: Extensive reporting capabilities to analyze different aspects of park operations. +- **๐Ÿ”’ Secure Access**: Role-based access control for data security and integrity. + +## Roles and Responsibilities + +### Admin ๐Ÿ‘จโ€๐Ÿ’ผ + +The Admin role includes: + +- **๐Ÿ” Login/Logout**: Secure authentication. +- **๐Ÿ‘ฅ Manage Users**: Register and update user information. +- **๐Ÿ“ฆ Manage Order**: Add, update, delete orders, and manage offers. +- **๐Ÿƒ Manage Activity**: Add new activities, update existing ones, and set activities as inactive. +- **๐Ÿ’ณ Manage Payments**: Generate and handle invoices. +- **๐Ÿ‘” Manage Employees**: Add, update, and set employees as inactive. +- **๐Ÿ“‹ Manage Employee Positions**: Add job roles and manage vacancies. +- **๐Ÿ“ˆ Generate Reports**: + - Income Reports (Daily, Monthly, Yearly) + - Employee Reports + - User/Customer Reports + +### Super Admin ๐Ÿ‘‘ + +The Super Admin role includes: + +- **๐Ÿ” All Admin Privileges** (excluding managing users, activities, and employees) +- **๐Ÿ‘จโ€๐Ÿ’ผ Manage Admins**: Oversee admin accounts. +- **๐Ÿ”ง Manage Equipment Managers**: Oversee equipment manager accounts. +- **๐Ÿ“Š View Reports**: Access various reports. +- **๐Ÿ“ˆ Generate Reports**: + - Invoices + - Orders + - Income + - Attendance + - Employee + - Customer + - Equipment + - Outdated Equipment and Tools + +### Equipment Manager ๐Ÿ”ง + +The Equipment Manager role includes: + +- **๐Ÿ”ง Register Equipment**: Add, update, and manage equipment details. +- **๐Ÿท๏ธ Manage Brand**: Add, update, and manage brand information. +- **๐Ÿ“ฆ Manage Stock**: Add new stock, manage existing stock, and remove stock. +- **๐Ÿ“ˆ Generate Reports**: + - Outdated Equipment Report (Monthly) + +### Built With + +This project was built with the following technologies: + +- [Java](https://nextjs.org/) +- [MySQL](https://react.dev/) +- [JFreeChart](https://www.jfree.org/jfreechart/) +- [FlatLaf](https://www.formdev.com/flatlaf/) +- [Jaspersoft](https://www.jaspersoft.com/) + +## Installation โš™๏ธ + +To set up the Ravana Adventure Park Management System locally, follow these steps: + +1. **๐Ÿ“ฅ Download the setup file from the repository's releases page:** + + [Download Setup File](https://github.com/yourusername/ravana-adventure-park/releases) + +2. **๐Ÿ› ๏ธ Run the setup file to install the application directly.** + +Alternatively, you can set up the application manually: + +3. **๐Ÿ“ฅ Download the SQL backup file from the repository:** + + [Download SQL Backup File](https://github.com/yourusername/ravana-adventure-park/releases) + +4. **๐Ÿ”„ Restore the SQL backup file:** + + Open your MySQL client and run the following command to restore the database: + + ```sql + mysql -u yourusername -p yourdatabase < path/to/your/sqlbackupfile.sql + ``` + +1. **๐Ÿ“ฅ Clone the repository:** + + ```bash + git clone https://github.com/yourusername/ravana-adventure-park.git + ``` + +2. **๐Ÿ“‚ Navigate to the project directory:** + + ```bash + cd ravana-adventure-park + ``` + +3. **๐Ÿ“ฆ Install the required dependencies:** + + ```bash + npm install + ``` + +4. **๐Ÿš€ Run the application:** + + ```bash + npm start + ``` + +5. **๐ŸŒ Open your browser and visit:** + + ```text + http://localhost:3000 + ``` + +## Usage ๐Ÿš€ + +After setting up the application, log in with the appropriate credentials based on your role (Admin, Super Admin, or Equipment Manager). Navigate through the dashboard to access the various functionalities provided for your role. + +### Admin Guide ๐Ÿ‘จโ€๐Ÿ’ผ + +- **๐Ÿ‘ฅ User Management**: Add, edit, or remove users. +- **๐Ÿ“ฆ Order Management**: Manage orders and offers. +- **๐Ÿƒ Activity Management**: Schedule new activities and view upcoming events. +- **๐Ÿ’ณ Payment Handling**: Generate and manage invoices. +- **๐Ÿ‘” Employee Management**: Add and manage employee details and job roles. +- **๐Ÿ“ˆ Report Generation**: Generate income, employee, and customer reports. + +### Super Admin Guide ๐Ÿ‘‘ + +- **๐Ÿ”ง System Oversight**: Manage admins and equipment managers. +- **๐Ÿ“Š Report Access**: View and generate detailed reports. +- **๐Ÿ“… Attendance Tracking**: Generate employee attendance reports. + +### Equipment Manager Guide ๐Ÿ”ง + +- **๐Ÿ”ง Equipment Registration**: Add, update, or remove equipment. +- **๐Ÿท๏ธ Brand Management**: Manage equipment brands. +- **๐Ÿ“ฆ Stock Management**: Handle stock details and inventory. +- **๐Ÿ“ˆ Report Generation**: Generate monthly outdated equipment reports. + +## Contributing ๐Ÿค + +We welcome contributions from the community! If you would like to contribute to this project, please follow these steps: + +1. **๐Ÿด Fork the repository.** +2. **๐Ÿ”€ Create a new branch.** +3. **๐Ÿ› ๏ธ Make your changes.** +4. **๐Ÿ“ฅ Submit a pull request.** + +Please ensure that your contributions align with the project's coding standards and guidelines. + +## License ๐Ÿ“œ + +This project is licensed under the [MIT License](LICENSE). + +## Contact ๐Ÿ“ž + +For any questions or further information, please contact us at: + +- **โœ‰๏ธ Email**: dulanjayawebs@gmail.com +- **๐Ÿ’ฌ Project Discussion**: [Talk](https://github.com/RAVANA-Final-Project/RavanaAPMS/discussions) + +Thank you for using the Ravana Adventure Park Management System! ๐ŸŒŸ