RavanaAPMS

RavanaAPMS copied to clipboard

RAVANA ADVENCTURE PARK MANAGEMENT SYSTEM

Java Based Information Management System

Explore the docs »

View Repo . Report Bug . Request Feature

Table of Contents

• 📖 Introduction
• ✨ Features
• 👥 Roles and Responsibilities
  • 👨‍💼 Admin
  • 👑 Super Admin
  • 🔧 Equipment Manager
• ⚙️ Installation
• 🚀 Usage
• 🤝 Contributing
• 📜 License
• 📞 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.

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
• MySQL
• JFreeChart
• FlatLaf
• Jaspersoft

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

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

4. 🔄 Restore the SQL backup file:

   Open your MySQL client and run the following command to restore the database:

   mysql -u yourusername -p yourdatabase < path/to/your/sqlbackupfile.sql
   

5. 📥 Clone the repository:

   git clone https://github.com/yourusername/ravana-adventure-park.git
   

6. 📂 Navigate to the project directory:

   cd ravana-adventure-park
   

7. 📦 Install the required dependencies:

   npm install
   

8. 🚀 Run the application:

   npm start
   

9. 🌐 Open your browser and visit:

   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.

Contact 📞

For any questions or further information, please contact us at:

• ✉️ Email: [email protected]
• 💬 Project Discussion: Talk

Thank you for using the Ravana Adventure Park Management System! 🌟