Project Description
π HRMS Source Code | Python FastAPI, React JS, Flutter & MySQL
This Human Resource Management System (HRMS) project is a full-stack solution developed using Python FastAPI (backend), React JS (web frontend), Flutter (mobile app), and MySQL (database).
The system is designed for organizations to manage employees, roles, and attendance efficiently. One of the key highlights of this HRMS is GPS-based attendance tracking, ensuring accuracy and transparency.
It supports multiple roles including:
-
Superadmin β Full access to manage everything.
-
Admin β Manage departments, users, and system settings.
-
Manager β Track team performance and approve/reject attendance.
-
Employee β Mark attendance (with GPS), view profile, apply leave, etc.
Technologies
1. Python FastAPI Framework
2. React JS
3. MySQL -
π Features of HRMS Project
-
β GPS-based employee attendance
-
β Role-based access control (Superadmin, Admin, Manager, Employee)
-
β User-friendly React JS web panel
-
β Flutter mobile app for employees on-the-go
-
β Fast and scalable FastAPI backend
-
β Secure and reliable MySQL database integration
-
β REST APIs for communication between frontend, backend, and mobile
π οΈ Project Setup Guide
1οΈβ£ Database Setup (MySQL)
-
Create a new database named
hrmsdbin MySQL. -
Import the provided database dump file into
hrmsdb.
2οΈβ£ Run Frontend (React JS)
npm install npm start
-
This will install dependencies and start the frontend server.
-
Access the HRMS web app at http://localhost:3000
3οΈβ£ Run Backend (Python FastAPI)
python -m venv env
env\Scripts\activate pip install -r requirements.txt uvicorn main:app --reload
-
The backend server will start at http://127.0.0.1:8000
π± Mobile App (Flutter)
-
The project includes a Flutter mobile application for employees.
-
Configure the API URL inside Flutter code to point to your backend (
http://127.0.0.1:8000or server IP). -
Run the app on an emulator or device:
flutter pub get flutter run
π― Conclusion
This HRMS with source code is a complete solution for businesses to manage employees effectively. With GPS-based attendance, multi-role access, and cross-platform support (web + mobile), itβs ideal for modern HR operations.
π Tech Stack Used: Python FastAPI, React JS, Flutter, MySQL
π Use Cases: HR software, employee attendance, workforce management, payroll integrations (extendable)

