https://github.com/wahidpanda/hr-employee-managment-system
A system where HR and Employee can follow up their employability, leave, salary, department managment and so on. THis will help both HR and Employee for a company to track their works through this Web-App
https://github.com/wahidpanda/hr-employee-managment-system
Last synced: 3 months ago
JSON representation
A system where HR and Employee can follow up their employability, leave, salary, department managment and so on. THis will help both HR and Employee for a company to track their works through this Web-App
- Host: GitHub
- URL: https://github.com/wahidpanda/hr-employee-managment-system
- Owner: wahidpanda
- License: mit
- Created: 2024-10-29T08:03:38.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-29T08:15:41.000Z (about 1 year ago)
- Last Synced: 2025-01-21T20:48:58.246Z (9 months ago)
- Language: Python
- Size: 11 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Human Resources Management System (HRMS)
HRMS is a web-based application provides a basic, beautiful, and modern solution for managing various aspects of human resources within an organization. With a user-friendly interface and robust functionalities, HRMS simplifies HR-related tasks and enhances efficiency.
Please kindly note that Hrms is currently in its early stages of development. Your valuable feedback and contributions play a crucial role in shaping the future of the app. We sincerely appreciate your willingness to be a part of this journey and thank you in advance for your valuable contributions! :)
## Technologies Used
- Python: A powerful programming language used for the backend development of HRMS.
- Flask Framework: A lightweight and flexible web framework for building web applications in Python.
- Flask SQLAlchemy: An extension for Flask that provides an easy-to-use interface for interacting with SQL databases.
- Bootstrap: A popular CSS framework for creating responsive and appealing frontend designs.
- SQLite3: A lightweight, serverless database engine used for storing HRMS data.
## Project Structure
The repository has the following structure:
```
.
├── CHANGELOG.md
├── configure-python3.10.txt
├── images
├── instance
│ ├── db.sqlite3
│ └── insert.sql
├── LICENSE
├── main.py
├── README.md
├── requirements.txt
├── src
│ ├── admin
│ │ ├── __init__.py
│ │ ├── modules.py
│ │ └── routes.py
│ ├── app.py
│ ├── auth
│ │ ├── __init__.py
│ │ ├── modules.py
│ │ └── routes.py
│ ├── config.py
│ ├── home
│ │ ├── __init__.py
│ │ └── routes.py
│ ├── models.py
│ ├── static
│ │ ├── css
│ │ │ └── styles.css
│ │ └── js
│ │ ├── datatables-simple-demo.js
│ │ └── scripts.js
│ ├── templates
│ │ ├── admin
│ │ │ ├── edit.html
│ │ │ ├── list_dep.html
│ │ │ ├── list_employees.html
│ │ │ ├── manage_advances.html
│ │ │ └── manage_leave.html
│ │ ├── auth
│ │ │ ├── login.html
│ │ │ ├── password.html
│ │ │ └── register.html
│ │ ├── base.html
│ │ ├── errors
│ │ │ ├── 401.html
│ │ │ ├── 404.html
│ │ │ └── 500.html
│ │ ├── home
│ │ │ └── home.html
│ │ └── user
│ │ ├── followup.html
│ │ ├── request_advance.html
│ │ └── request_leave.html
│ └── user
│ ├── __init__.py
│ ├── modules.py
│ └── routes.py
└── TODO.md
16 directories, 42 files
```
## Getting Started
To get started with HRMS on your local machine, follow these steps:
1. Clone the repository: `git clone https://github.com/Oussama1403/HRMS`
2. Navigate to the project directory: `cd hrms`
3. Install the project dependencies: `pip install -r requirements.txt`
4. Run the application: `python main.py`
5. Access HRMS in your browser at `ttp://127.0.0.1:5000/`
## How to Contribute
We welcome contributions to HRMS from the community. If you would like to contribute, please follow these steps:
1. Fork the repository on GitHub.
2. Create a new branch with a descriptive name: `git checkout -b feature/my-new-feature`
3. Make changes and add your enhancements.
4. Commit your changes: `git commit -am 'Add new feature'`
5. Push the branch to your forked repository: `git push origin feature/my-new-feature`
6. Submit a pull request to the main repository.
7. Provide a detailed description of your changes and why they should be merged.
## Developer
HRMS is developed and maintained by [Osama Ben Sassi](https://www.linkedin.com/in/osama-ben-sassi/).
Feel free to contact me with any questions or feedback regarding HRMS.
## License
HRMS is released under the [MIT License](LICENSE). Feel free to use, modify, and distribute it as per the license terms.
Thank you for your interest in HRMS! I appreciate your contribution and hope you find the project useful.