How juliocua/hrconnect works
HRConnect is a Philippine-focused HR information system with an HR portal, employee self-service hub, and client approval/billing workflows. Users enter through the React app; its API client connects to Express routes, which implement domain operations against PostgreSQL. The README documents the broader employee, attendance, leave, payroll, and statutory-reporting capabilities; sampled source confirms app routing, API calls, server route mounting, and database access in client-management routes. Some domain wiring is documented but not shown in sampled route source.
Main entry points: api.ts API client · prisma.ts PostgreSQL data · App.tsx Portal routing · billing.ts Client billing
Components 23
Web portals
- Portal routing
client/src/App.tsx - Sign-in
client/src/pages/Login.tsx - Employee hub
client/src/pages/hub - Client hub
client/src/pages/client-hub - HR workspace
client/src/pages - API client
client/src/lib/api.ts
People operations
- Employee records
server/src/routes/employees.ts - Attendance
server/src/routes/attendance.ts - Leave management
server/src/routes/leave.ts - Overtime
server/src/routes/overtime.ts
Payroll and compliance
- Payroll runs
server/src/routes/payroll.ts - Statutory deductions
server/src/lib/payroll.ts - BIR reporting
server/src/routes/bir.ts
Client operations
- Client records
server/src/routes/clients.ts - Client billing
server/src/routes/billing.ts - Client approvals
server/src/routes/client-hub.ts
API and persistence
- Authentication
server/src/routes/auth.ts - PostgreSQL data
server/src/lib/prisma.ts - Email service
server/src/lib/email.ts - Invoice PDF
server/src/lib/invoice-pdf.ts
Other components
- HR staff
- Employees
- Client users
Connections 32
- HR staff → Portal routing: uses
- Employees → Portal routing: uses
- Client users → Portal routing: uses
- Portal routing → Sign-in: routes to
- Portal routing → Employee hub: routes to
- Portal routing → Client hub: routes to
- Portal routing → HR workspace: routes to
- Sign-in → API client: requests
- Employee hub → API client: requests
- Client hub → API client: requests
- HR workspace → API client: requests
- API client → Authentication: calls
- API client → Employee records: calls
- API client → Attendance: calls
- API client → Leave management: calls
- API client → Overtime: calls
- API client → Payroll runs: calls
- API client → BIR reporting: calls
- API client → Client records: calls
- API client → Client billing: calls
- API client → Client approvals: calls
- Employee records → PostgreSQL data: reads/writes
- Attendance → PostgreSQL data: reads/writes
- Leave management → PostgreSQL data: reads/writes
- Overtime → PostgreSQL data: reads/writes
- Payroll runs → PostgreSQL data: reads/writes
- Client records → PostgreSQL data: reads/writes
- Client billing → PostgreSQL data: reads/writes
- Client approvals → PostgreSQL data: reads/writes
- Payroll runs → Statutory deductions: computes with
- Client billing → Invoice PDF: generates
- Client billing → Email service: sends invoice