This project is a comprehensive Employee Management System featuring a secure FastAPI backend and a modern React frontend. It provides role-based access control, employee data management, leave management, and AI-driven analytics insights.
- Build a scalable full-stack application.
- Implement secure JWT authentication and role-based access control (RBAC).
- Provide a responsive and intuitive user interface using React and Tailwind CSS.
- Deliver actionable analytics insights for HR management.
- Python & FastAPI
- SQLAlchemy (ORM)
- SQLite (Database)
- JWT Authentication (OAuth2)
- Pandas (Analytics)
- React (Vite)
- TypeScript
- Tailwind CSS
- Axios (API Communication)
- React Router DOM
- Lucide React (Icons)
- Authentication: Secure Login/Signup with JWT.
- RBAC: Distinct dashboards for Admins and Employees.
- Employee Management: CRUD operations for employee profiles.
- Leave Management: Request, approve, and reject leaves.
- Analytics: Visual insights on department distribution, salary stats, and attrition risk.
- Settings: User preferences for notifications and theme (Dark Mode).
![Home Page]
![Login Page]
![Registration Page]
![Admin Dashboard]
![Employees Page]
Note: Please add the screenshot images to the
screenshots/directory with the filenames specified above.
- Python 3.8+
- Node.js & npm
# Clone the repository
git clone https://github.com/AgreementMudau05/Employees-Management-System.git
cd Employees-Management-System
# Create virtual environment (optional but recommended)
python -m venv venv
# Windows: venv\Scripts\activate
# Mac/Linux: source venv/bin/activate
# Install dependencies
pip install -r requirements.txt
# Run the server
uvicorn app.main:app --reloadThe Backend API will run at http://127.0.0.1:8000.
Docs available at http://127.0.0.1:8000/docs.
Open a new terminal:
cd frontend
# Install dependencies
npm install
# Run the development server
npm run dev