How fjdvm/hrms works
This is a staff-facing HRMS covering hiring, employee onboarding and records, performance, training, and operational dashboards. The principal workflow shown is an authenticated Staff member opening the applicant list, which loads and presents application data; the broader hiring lifecycle includes postings, interviews, and offers. The README also documents audit delivery and live staff notifications. Several major modules appear only in the tree or index, so their components are included without guessed call paths; edges are limited to relationships supported by excerpts, index references, or README statements.
Main entry points: applications.ts Applications · database.ts Postgres access · page.tsx Applicant list · staff-notifications.ts Staff notifications
Components 22
Access and shell
- HRMS shell
app/(hrms)/layout.tsx - Staff access
lib/portal/staff.ts - Module access
lib/portal/access.ts - Portal client
lib/portal/client.ts
Hiring lifecycle
- Applicant list
app/(hrms)/applicants/page.tsx - Application request
lib/portal/applications.ts - Applications
lib/applications.ts - Application views
lib/application-view.ts - Job postings
lib/job-postings.ts - Interview scheduling
lib/interview-booking.ts - Offers
lib/offers.ts
Employee operations
- Employee records
lib/employees.ts - Employee onboarding
app/(hrms)/employee-onboarding/page.tsx
Performance and training
- Performance management
lib/performance.ts - Training management
lib/trainings.ts
Shared services
- Dashboard data
lib/dashboard-data.ts - Postgres access
lib/database.ts - Audit delivery
lib/audit.ts - Staff notifications
lib/staff-notifications.ts
Other components
- Staff member
- Staff Portal
- API gateway
Connections 25
- Staff member → Applicant list: opens
app/(hrms)/applicants/page.tsx - Applicant list → Staff access: requires module
app/(hrms)/applicants/page.tsx - Applicant list → Application request: loads list
app/(hrms)/applicants/page.tsx - Application request → Applications: creates request
lib/portal/applications.ts - Applications → Application views: supplies types
lib/application-view.ts - Applications → Postgres access: queries
lib/applications.ts - Applications → Module access: checks access
lib/applications.ts - Applications → Portal client: lists interviewers
lib/applications.ts - Applications → Interview scheduling: validates interview
lib/applications.ts - Staff access → Module access: checks module
lib/portal/staff.ts - Module access → Portal client: validates session
lib/portal/access.ts - Portal client → Staff Portal: calls integrations
lib/portal/client.ts - Applicant list → Application views: formats list
app/(hrms)/applicants/page.tsx - Job postings → Postgres access: reads postings
- Job postings → Postgres access: counts applications
README.md - HRMS shell → Staff access: loads shell access
- Employee onboarding → Employee records: loads onboarding data
app/(hrms)/employee-onboarding/page.tsx - Employee records → Postgres access: queries records
lib/employees.ts - Employee records → Module access: checks access
lib/employees.ts - Dashboard data → Postgres access: queries metrics
lib/dashboard-data.ts - Audit delivery → API gateway: delivers events
README.md - Staff notifications → API gateway: delivers notifications
README.md - Staff notifications → Postgres access: queues events
README.md - Staff member → Staff notifications: opens inbox
README.md - API gateway → Staff notifications: pushes live events
README.md