How sagegallant/eoms works
EOMS is an employee onboarding and statutory-compliance platform. Staff sign in, receive role-specific workspaces, and manage employee setup through phased onboarding, tasks, document review, asset provisioning, and required training; dashboards and reports expose progress, while audit and RBAC support oversight. The graph distinguishes the web workflow from API/domain handling and persistent data. README describes the overall server-to-database architecture; source-index references and excerpts support selected links, so unsampled feature internals and some server dispatch details are not expanded.
Main entry points: client.js HTTP client · controllers Domain controllers · AppRoutes.jsx Role-based routes · routes REST routes
Components 21
Web experience
- Role-based routes
client/src/routes/AppRoutes.jsx - Application shell
client/src/components/layout/AppShell.jsx - Session state
client/src/store/authStore.js - Role dashboards
client/src/features/dashboard
Employee lifecycle
- Employee directory
client/src/features/employees/EmployeeDirectory.jsx - Onboarding plans
client/src/features/onboarding/OnboardingView.jsx - Checklist tasks
client/src/features/tasks/TasksView.jsx - Statutory documents
client/src/features/documents/DocumentsView.jsx - IT assets
client/src/features - Required training
client/src/features/training/TrainingView.jsx - Notifications
client/src/features/notifications/NotificationsView.jsx - Reports and audit
client/src/features/reports/ReportsView.jsx
API and security
- HTTP client
client/src/api/client.js - Authentication and RBAC
server/src/middleware - REST routes
server/src/routes
Server domains
- Domain controllers
server/src/controllers - Audit logging
server/src/services/audit.service.js - Document storage
server/src/services/storage.service.js
Persistence
- Relational models
server/src/models - MySQL database
server/src/config/db.js
Other components
- Staff user
Connections 21
- Staff user → Role-based routes: uses
- Role-based routes → Role dashboards: selects dashboard
client/src/routes/AppRoutes.jsx - Role-based routes → Application shell: renders within
client/src/routes/AppRoutes.jsx - Application shell → Session state: reads session
client/src/components/layout/AppShell.jsx - Session state → HTTP client: authenticates through
client/src/store/authStore.js - Employee directory → HTTP client: requests employee data
client/src/features/employees/EmployeeDirectory.jsx - Onboarding plans → HTTP client: requests plan data
client/src/features/onboarding/OnboardingView.jsx - Checklist tasks → HTTP client: requests task data
client/src/features/tasks/TasksView.jsx - Statutory documents → HTTP client: requests documents
client/src/features/documents/DocumentsView.jsx - Required training → HTTP client: requests courses
client/src/features/training/TrainingView.jsx - HTTP client → REST routes: sends HTTP requests
- REST routes → Authentication and RBAC: guards routes
server/src/routes/task.routes.js - REST routes → Domain controllers: dispatches requests
server/src/routes/task.routes.js - Domain controllers → Relational models: reads and writes
server/src/controllers/training.controller.js - Domain controllers → Audit logging: records actions
server/src/controllers/training.controller.js - Domain controllers → Document storage: uses upload storage
server/src/controllers/document.controller.js - Relational models → MySQL database: persists relational data
server/src/models/index.js - Audit logging → Relational models: creates audit records
server/src/services/audit.service.js - Role dashboards → Reports and audit: includes observability
- Onboarding plans → Checklist tasks: organizes milestones
- Statutory documents → Document storage: stores uploads