WorkForce_Hub
Meet KanteliyaBuild a full-stack HR Management System (HRMS) web application with the following complete specifications: === PROJECT OVERVIEW === A modern, production-grade HRMS SaaS platform with 4 role-based portals: Super Admin, HR, Manager, and Employee. Dark + light mode. Premium UI feel like Linear.app meets Rippling. === TECH STACK === Frontend: Next.js 14, Tailwind CSS, Shadcn UI, Framer Motion, Recharts, React Hook Form Backend: FastAPI (Python), PostgreSQL, Redis Auth: JWT with refresh token rotation Deployment: Docker Compose + Nginx === ROLES & PERMISSIONS === SUPER ADMIN: - Manage entire organization - Create/delete HR and Manager accounts - View all analytics and reports - System settings and configuration - Audit logs of all actions HR: - Add/edit/offboard employees - Approve or reject leave requests - Run payroll for all employees - Generate HR reports - Manage departments and positions - Send announcements MANAGER: - View their team members only - Approve/reject team leave requests - Assign and track tasks for team - Write performance reviews - View team attendance EMPLOYEE: - View own profile and payslips - Apply for leaves - View assigned tasks - Check attendance history - View team announcements === CORE MODULES === 1. AUTH MODULE - Login page with smooth animation - JWT access + refresh token - Role-based redirect after login - Forgot password flow 2. DASHBOARD (role-specific) - Admin: org stats, headcount, payroll summary, recent activity - HR: pending leaves, new joiners, payroll status, department chart - Manager: team attendance today, pending approvals, task progress - Employee: my leaves balance, upcoming tasks, recent payslip 3. EMPLOYEE MANAGEMENT - Employee list with search, filter, sort by department/role/status - Employee profile page: personal info, documents, employment history - Add employee form with validation - Soft delete / offboarding flow - Export employee data as CSV 4. LEAVE MANAGEMENT - Employee applies for leave with date range + reason - Manager/HR approves or rejects - Leave balance tracker (casual, sick, earned) - Leave calendar view - Email notification on status change 5. ATTENDANCE - Daily attendance log per employee - Clock in / clock out (manual) - Monthly attendance summary table - Absent / present / late status - Manager can view full team 6. PAYROLL - HR inputs salary components: base, HRA, bonus, deductions - Auto calculate net salary - Generate payslip PDF per employee - Payroll history by month - Export payroll report 7. TASK MANAGEMENT - Manager assigns tasks to employees - Task: title, description, due date, priority, status - Employee updates task status - Kanban board view (Todo / In Progress / Done) - Task completion analytics 8. PERFORMANCE REVIEW - Manager writes quarterly review - Rating system (1-5) per skill - Employee views their review - Historical review archive 9. ANNOUNCEMENTS - HR posts company announcements - All employees see in dashboard - Filter by department 10. REPORTS & ANALYTICS - Headcount by department (bar chart) - Monthly attendance rate (line chart) - Leave utilization (pie chart) - Payroll cost over time (area chart) - Export reports as PDF/CSV === UI/UX REQUIREMENTS === - Dark mode default, light mode toggle - Sidebar navigation with icons - Smooth page transitions (Framer Motion) - Skeleton loading states - Toast notifications for actions - Responsive — works on mobile - Empty states with illustration - Consistent color system: Primary #6366F1 (indigo) Success #10B981 Warning #F59E0B Error #EF4444 Background dark: #0F0F0F Card dark: #1A1A1A === DATABASE SCHEMA === Tables needed: - users (id, name, email, password_hash, role, is_active) - employees (id, user_id, department_id, manager_id, position, salary, join_date, status) - departments (id, name, manager_id) - leaves (id, employee_id, type, start_date, end_date, reason, status, approved_by) - attendance (id, employee_id, date, clock_in, clock_out, status) - payroll (id, employee_id, month, basic, hra, bonus, deductions, net_salary, generated_at) - tasks (id, title, description, assigned_to, assigned_by, due_date, priority, status) - performance_reviews (id, employee_id, reviewer_id, quarter, year, ratings_json, comments) - announcements (id, title, content, department_id, created_by, created_at) === API ENDPOINTS === /auth/login POST /auth/refresh POST /employees GET POST PUT DELETE /employees/{id}/profile GET /leaves GET POST /leaves/{id}/approve PUT /leaves/{id}/reject PUT /attendance GET POST /payroll GET POST /payroll/{id}/payslip GET /tasks GET POST PUT DELETE /performance GET POST /announcements GET POST /reports/headcount GET /reports/attendance GET /reports/payroll GET === DEPLOYMENT === Docker Compose with: - frontend (Next.js) container - backend (FastAPI) container - postgres container - redis container - nginx reverse proxy Include .env.example file Include README with setup steps
Comments (0)
Sign in to leave a comment
Announcements
24 activeNew Health Insurance Policy Rollout — Effective August 1st
HRWe are pleased to announce the launch of our enhanced health insurance plan for all full-time employees. The updated coverage includes dental, vision, and mental health benefits with no additional premium increase for the 2026–2027 cycle. Please review the policy document and submit any dependent updates by July 20th.
Read MoreQ3 Quarterly Town Hall — Friday, June 28th at 3:00 PM
ExecutiveJoin the leadership team for our Q3 Town Hall where we will review second-quarter results, share strategic priorities for the second half of 2026, and host an open Q&A session. All employees are encouraged to submit questions in advance via the Employee Portal.
Read MoreMandatory Cybersecurity Awareness Training Due by July 5th
ITAs part of our ongoing commitment to data security, all employees must complete the annual Cybersecurity Awareness training module on the Learning Portal. The course covers phishing detection, password hygiene, and data handling best practices. Non-compliance may affect system access after the deadline.
Read MoreSummer Team Offsite — Mark Your Calendars for August 16th
OperationsWe are organizing a team offsite at the Lakeview Retreat Center for team-building activities, departmental breakouts, and strategy workshops. Transportation and meals will be provided. Please RSVP by July 28th using the registration link on the Announcements portal.
Read MorePerformance Review Cycle Opens — Self-Assessments Now Available
HRThe mid-year performance review cycle is now open. All employees should complete their self-assessment by June 25th. Managers will submit evaluations by July 10th, followed by one-on-one review meetings through July 25th. Review templates and guidelines are available on the Reviews page.
Read MoreOffice Renovation Schedule — 3rd Floor Closure June 20–24
FacilitiesThe third floor will be temporarily closed from June 20th through June 24th for scheduled renovations including new collaboration zones and upgraded AV equipment in conference rooms. Employees seated on the 3rd floor should coordinate with their managers for temporary workspace arrangements.
Read More
No comments yet. Be the first!