How kcsimfinity/hris works
This is a multi-company HRIS app with role-based portals for employees, company administrators, and a super administrator. The user journey begins at app routing and authentication, then enters a role-specific workspace for workforce administration or employee self-service. Admin capabilities span employee and organization management, attendance, leave, documents, payroll, schedules, reports, and settings; the employee portal covers personal records and those operational areas. Firebase provides authentication and Firestore-backed services. Several feature modules are present in the tree but were not sampled, so their internal call paths are not asserted.
Main entry points: components Admin workspace · EmployeePortalScreen.tsx Employee portal · documents Document records · AuthContext.tsx Auth state
Components 24
App entry and auth
- Role routing
src/app - Login screen
src/features/auth/screens/LoginScreen.tsx - Auth state
src/features/auth/context/AuthContext.tsx
Company administration
- Admin workspace
src/features/admin/components - Employee directory
src/features/employees/components - Departments and roles
src/features/employees/components/PositionManager.tsx - Attendance
src/features/attendance - Leave management
src/features/leave - Document records
src/features/documents - Payroll
src/features/payroll - Schedules
src/features/schedules - Reports
src/features/reports - Company settings
src/features/settings
Employee self-service
- Employee portal
src/features/employee/components/EmployeePortalScreen.tsx
Platform administration
- Super-admin workspace
src/app/(protected)/super-admin.tsx - System management data
src/features/superAdmin/hooks/useSuperAdminData.ts
Firebase data
- Firebase Auth
src/services/firebase/authService.ts - Cloud Firestore
src/services/firebase/firebaseConfig.ts - Employee records
src/services/firebase/employeeService.ts - Organization records
src/services/firebase/organizationService.ts - Document records store
src/services/firebase/documentService.ts - Company records
src/services/firebase/companyService.ts - System data service
src/services/firebase/superAdminService.ts
Other components
- HRIS user
Connections 27
- HRIS user → Role routing: opens app
- Role routing → Auth state: checks session
- Login screen → Auth state: uses auth hook
- Auth state → Firebase Auth: calls auth service
src/features/auth/context/AuthContext.tsx - Auth state → Cloud Firestore: loads profile
src/features/auth/context/AuthContext.tsx - Role routing → Super-admin workspace: routes role
- Super-admin workspace → System management data: renders data views
src/app/(protected)/super-admin.tsx - System management data → Company records: loads companies
src/features/superAdmin/hooks/useSuperAdminData.ts - System management data → System data service: loads system data
src/features/superAdmin/hooks/useSuperAdminData.ts - Employee directory → Employee records: loads employee records
- Departments and roles → Organization records: loads departments
src/features/employees/components/PositionManager.tsx - Document records → Document records store: loads records
src/features/documents/hooks/useAdminDocuments.ts - Document records → Employee records: loads directory
src/features/documents/hooks/useAdminDocuments.ts - Document records → Organization records: loads org data
src/features/documents/hooks/useAdminDocuments.ts - Admin workspace → Employee directory: provides feature
- Admin workspace → Attendance: provides feature
- Admin workspace → Leave management: provides feature
- Admin workspace → Document records: provides feature
- Admin workspace → Payroll: provides feature
- Admin workspace → Schedules: provides feature
- Admin workspace → Reports: provides feature
- Admin workspace → Company settings: provides feature
- Employee portal → Attendance: offers self-service
- Employee portal → Leave management: offers self-service
- Employee portal → Document records: offers self-service
- Employee portal → Payroll: offers self-service
- Employee portal → Schedules: offers self-service