How kumaraguru911/hr-document-management-system works
OnboardIQ is an HR onboarding portal: HR configures requirements and invites employees; employees activate accounts and submit documents; HR reviews submissions; both roles track status and notifications. The React workspaces call a FastAPI backend, which coordinates PostgreSQL records and MinIO file storage. Readiness scoring, expiry tracking, audit history, tasks, and the assistant are distinct product capabilities. Some subsystem links are documented in the README or SOURCE INDEX; unsampled internals are represented at their known directory paths.
Main entry points: api.js API client · session.py PostgreSQL · documents/service.py Document lifecycle · notifications/service.py Notifications
Components 22
Web workspaces
- Role-based portal
frontend/src/App.jsx - Employee workspace
frontend/src/pages/employee - HR workspace
frontend/src/pages/hr - Document submission
frontend/src/pages/EmployeeDocuments.jsx - Document review
frontend/src/pages/hr/DocumentReview.jsx - Readiness tasks
frontend/src/pages/hr/Tasks.jsx - API client
frontend/src/api/api.js
Identity and workforce
- Accounts and 2FA
backend/app/auth/router.py - Employee management
backend/app/employees/service.py - Readiness scoring
backend/app/employees/service.py
Document lifecycle
- Document workflows
backend/app/documents/router.py - Document lifecycle
backend/app/documents/service.py - MinIO files
backend/app/storage/minio.py
Onboarding operations
- Notifications
backend/app/notifications/service.py - Audit history
backend/app/audit/service.py - Task management
backend/app/tasks/service.py - Onboarding assistant
backend/app/assistant/service.py - Webhook automation
backend/app/automation/service.py
Persistence and services
- PostgreSQL
backend/app/database/session.py
Other components
- HR user
- Employee user
- n8n webhooks
Connections 30
- HR user → Role-based portal: uses portal
README.md - Employee user → Role-based portal: uses portal
README.md - Role-based portal → HR workspace: routes HR
frontend/src/App.jsx - Role-based portal → Employee workspace: routes employee
frontend/src/App.jsx - HR workspace → API client: calls API
frontend/src/pages/hr/Tasks.jsx - Employee workspace → API client: calls API
frontend/src/pages/employee/EmployeeDashboard.jsx - Document submission → API client: calls API
frontend/src/pages/EmployeeDocuments.jsx - Document review → API client: calls API
frontend/src/pages/hr/DocumentReview.jsx - Readiness tasks → API client: calls API
frontend/src/pages/hr/Tasks.jsx - API client → Accounts and 2FA: HTTP API
README.md - API client → Document workflows: HTTP API
README.md - API client → Employee management: HTTP API
README.md - API client → Notifications: HTTP API
README.md - API client → Audit history: HTTP API
README.md - API client → Task management: HTTP API
- Document workflows → Document lifecycle: delegates to
backend/app/documents/router.py - Document lifecycle → MinIO files: stores files
backend/app/documents/service.py - Document lifecycle → Notifications: creates alerts
backend/app/documents/service.py - Document lifecycle → Audit history: records events
backend/app/documents/service.py - Employee management → Webhook automation: sends invitations
backend/app/employees/service.py - Webhook automation → n8n webhooks: webhook request
backend/app/automation/service.py - Employee management → Readiness scoring: computes readiness
backend/app/employees/service.py - Task management → Notifications: creates alerts
backend/app/tasks/service.py - Onboarding assistant → Notifications: uses notifications
backend/app/assistant/service.py - Accounts and 2FA → PostgreSQL: reads and writes
backend/app/auth/router.py - Document lifecycle → PostgreSQL: reads and writes
backend/app/documents/service.py - Employee management → PostgreSQL: reads and writes
backend/app/employees/service.py - Notifications → PostgreSQL: reads and writes
backend/app/notifications/service.py - Audit history → PostgreSQL: reads records
backend/app/audit/service.py - Task management → PostgreSQL: reads and writes
backend/app/tasks/service.py