How lamdayne/humify works
Humify is a multi-tenant HR and workforce-management backend. Its user-facing workflow centers on authenticated company users managing employees and organizational records, then handling attendance, leave, payroll, and performance reviews. The tree also exposes project/task management, media uploads, and mail capabilities. The supplied excerpts show the performance-review controller delegating review operations and KPI refresh, and Google OAuth coordinating identity and token creation. Most other feature paths are represented by the tree only, so their internal call links are left unverified rather than inferred.
Main entry points: GoogleOAuthService.java Google sign-in · PerformanceReviewServiceImpl.java Review workflows · PerformanceReviewController.java Review API · Company.java Company records
Components 26
Identity and Access
- Authentication
src/main/java/com/lamdayne/humify/auth/security/auth/AuthenticationService.java - Google sign-in
src/main/java/com/lamdayne/humify/auth/security/oauth2/GoogleOAuthService.java - User principal
src/main/java/com/lamdayne/humify/auth/security/principal/UserPrincipal.java - Roles and permissions
src/main/java/com/lamdayne/humify/auth/controller/RoleController.java - User accounts
src/main/java/com/lamdayne/humify/user/service/UserService.java
Workforce Records
- Company records
src/main/java/com/lamdayne/humify/company/entity/Company.java - Branches
src/main/java/com/lamdayne/humify/branch/controller/BranchController.java - Departments
src/main/java/com/lamdayne/humify/department/controller/DepartmentController.java - Employee records
src/main/java/com/lamdayne/humify/employee/service/EmployeeService.java
Attendance and Payroll
- Attendance tracking
src/main/java/com/lamdayne/humify/attendance/service/AttendanceService.java - Leave management
src/main/java/com/lamdayne/humify/attendance/service/LeaveBalanceService.java - Shift scheduling
src/main/java/com/lamdayne/humify/attendance/service/WorkShiftService.java - Payroll periods
src/main/java/com/lamdayne/humify/payroll/service/PayrollPeriodService.java - Payslips
src/main/java/com/lamdayne/humify/payroll/service/PayslipService.java
Performance Management
- Performance reviews
src/main/java/com/lamdayne/humify/performance/service/PerformanceReviewService.java - Review workflows
src/main/java/com/lamdayne/humify/performance/service/impl/PerformanceReviewServiceImpl.java - Review API
src/main/java/com/lamdayne/humify/performance/controller/PerformanceReviewController.java - KPI calculation
src/main/java/com/lamdayne/humify/performance/service/KpiService.java
Projects and Services
- Projects and sprints
src/main/java/com/lamdayne/humify/project/service/ProjectService.java - Tasks and comments
src/main/java/com/lamdayne/humify/task/service/TaskService.java - Media uploads
src/main/java/com/lamdayne/humify/media/service/MediaService.java - Email delivery
src/main/java/com/lamdayne/humify/mail/service/MailService.java
Other components
- Company user
- Google identity
- Relational database
- Cloudinary
Connections 15
- Company user → Authentication: signs in
- Company user → Review API: manages reviews
- Google identity → Google sign-in: authenticates
- Google sign-in → User accounts: finds or creates
src/main/java/com/lamdayne/humify/auth/security/oauth2/GoogleOAuthService.java - Google sign-in → Employee records: links employee
src/main/java/com/lamdayne/humify/auth/security/oauth2/GoogleOAuthService.java - Google sign-in → Company records: resolves company
src/main/java/com/lamdayne/humify/auth/security/oauth2/GoogleOAuthService.java - Google sign-in → User principal: loads identity
src/main/java/com/lamdayne/humify/auth/security/oauth2/GoogleOAuthService.java - Review API → Performance reviews: delegates reviews
src/main/java/com/lamdayne/humify/performance/controller/PerformanceReviewController.java - Review API → KPI calculation: refreshes KPIs
src/main/java/com/lamdayne/humify/performance/controller/PerformanceReviewController.java - Performance reviews → Review workflows: implemented by
src/main/java/com/lamdayne/humify/performance/service/impl/PerformanceReviewServiceImpl.java - Review workflows → Employee records: uses employee records
src/main/java/com/lamdayne/humify/performance/service/impl/PerformanceReviewServiceImpl.java - Review workflows → Company records: uses company data
src/main/java/com/lamdayne/humify/performance/service/impl/PerformanceReviewServiceImpl.java - Employee records → Relational database: persists records
- Company records → Relational database: persists records
- Cloudinary → Media uploads: stores uploads