KeyTime - Equipment Management

An awesome tool for managing equipment!
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. Our Team
2. About The Project
3. Getting Started
   • Prerequisites
   • Installation
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

Our Team

• Leader: Nguyen Hoang Duy - 22520328 - Github
• Architect Consultant: Nguyen Ngoc Minh Quoc - 22521214 - Github
• Member: Hoang Ho Quoc Bao - 22520102
• Member: Tran Duc Chinh - 22520158
• Supervisor: Nguyen Tan Toan

About The Project

KeyTime is an equipment management software designed to help companies track, organize and manage their equipment inventory efficiently.

Features

• Equipment tracking - Add equipment details like name, ID, category, specs, etc. Easily search and filter equipment.
• Rental manage - Allow user to request rental equipments. The property manager can Approve/Decline and review requests.
• Inventory reporting - Get reports on equipment inventory status, utilization, maintenance metrics, etc.
• Access controls - Manage user roles and permissions. Restrict access as needed.

(back to top)

Getting Started

You can run directly by download Installer folder Download and then install by running setup.exe If you want to run local database:

1. Create new database (can use pgsql command prompt or PgAdmin/DBeaver)
2. Restore db.sql to the database created in step 2.
3. Edit DB config in config.ini

Or to get a local copy up, please running follow these simple example steps below. Video instructions: Youtube

Prerequisites

You need to install Visual Studio and PostgreSQL first.

• Visual Studio
• PostgreSQL

Installation

1. Clone the repo

   git clone https://github.com/hoangduy0610/it008-keytime.git

2. Create new database (can use pgsql command prompt or PgAdmin/DBeaver)
3. Restore db.sql to the database created in step 2.
4. Edit DB config in config.ini
5. Open the IT008-KeyTime.sln file by Visual Studio.
6. Press the "Run" button.

Note: Default admin user is: admin/admin

(back to top)

Roadmap

• Rental Report
• Inventory Report
• Import through Excel files
• Add Changelog
• Support Barcode Inventory

See the open issues for a full list of proposed features (and known issues).

(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)

License

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

(back to top)

Contact

Nguyen Hoang Duy (PO) - @hoangduy0610 - [email protected]

Nguyen Ngoc Minh Quoc (Technical Leading) - @gundamdouble00

Project Link: https://github.com/hoangduy0610/it008-keytime

(back to top)

Acknowledgments

Use this space to list resources you find helpful and would like to give credit to. I've included a few of my favorites to kick things off!

• Choose an Open Source License
• GitHub Pages
• Font Awesome

(back to top)