How handikasinaga/project-ta-logbook-presensi works
This is a role-based attendance, leave, and work-logbook management application. Users submit attendance, activity logs, and leave requests; supervisors review team activity and requests, while administrators manage users and divisions and monitor operations. The React application exposes role-specific screens backed by an Express API, whose controllers use Sequelize models for persistent data. Reporting and bulk user import/export are distinct administrative capabilities. The shown source establishes route dispatch and several controller dependencies; frontend-to-API calls and real-time notification implementation were not shown, so those links are omitted.
Main entry points: adminRoutes.js Admin routes · userRoutes.js User routes · index.js Domain models · supervisorRoutes.js Supervisor routes
Components 25
Role-based frontend
- React app
frontend/src/App.jsx - Public access
frontend/src/roles/public/PublicRoutes.jsx - User workspace
frontend/src/roles/user - Supervisor workspace
frontend/src/roles/supervisor - Admin workspace
frontend/src/roles/admin
API and workflows
- Authentication routes
backend/routes/authRoutes.js - User routes
backend/routes/userRoutes.js - Supervisor routes
backend/routes/supervisorRoutes.js - Admin routes
backend/routes/adminRoutes.js - Authentication
backend/controllers/AuthController.js - Attendance workflow
backend/controllers/AttendanceController.js - Logbook review
backend/controllers/LogbookController.js - Leave workflow
backend/controllers/LeaveController.js - Users and divisions
backend/controllers/UserController.js - Dashboards
backend/controllers/DashboardController.js - Reports and exports
backend/controllers/ReportController.js - System settings
backend/controllers/SettingsController.js
Domain data
- Domain models
backend/models/index.js - MySQL database
Operational support
- Excel export
backend/services/ExportService.js - Bulk user transfer
backend/services/ImportExportUserService.js - Location validation
backend/utils/locationHelper.js - File uploads
backend/utils/uploadHelper.js - Auto checkout
backend/utils/autoCheckoutScheduler.js
Other components
- Staff and administrators
Connections 39
- React app → Public access: mounts routes
frontend/src/App.jsx - React app → User workspace: mounts routes
frontend/src/App.jsx - React app → Supervisor workspace: mounts routes
frontend/src/App.jsx - React app → Admin workspace: mounts routes
frontend/src/App.jsx - User workspace → User routes: calls API
- Supervisor workspace → Supervisor routes: calls API
- Admin workspace → Admin routes: calls API
- Staff and administrators → React app: uses
- Authentication routes → Authentication: dispatches
backend/routes/authRoutes.js - User routes → Attendance workflow: dispatches
backend/routes/userRoutes.js - User routes → Logbook review: dispatches
backend/routes/userRoutes.js - User routes → Leave workflow: dispatches
backend/routes/userRoutes.js - User routes → Users and divisions: dispatches
backend/routes/userRoutes.js - User routes → Dashboards: dispatches
backend/routes/userRoutes.js - User routes → System settings: dispatches
backend/routes/userRoutes.js - Supervisor routes → Attendance workflow: dispatches
backend/routes/supervisorRoutes.js - Supervisor routes → Logbook review: dispatches
backend/routes/supervisorRoutes.js - Supervisor routes → Leave workflow: dispatches
backend/routes/supervisorRoutes.js - Supervisor routes → Users and divisions: dispatches
backend/routes/supervisorRoutes.js - Supervisor routes → Dashboards: dispatches
backend/routes/supervisorRoutes.js - Admin routes → Attendance workflow: dispatches
backend/routes/adminRoutes.js - Admin routes → Logbook review: dispatches
backend/routes/adminRoutes.js - Admin routes → Leave workflow: dispatches
backend/routes/adminRoutes.js - Admin routes → Users and divisions: dispatches
backend/routes/adminRoutes.js - Admin routes → Dashboards: dispatches
backend/routes/adminRoutes.js - Admin routes → Reports and exports: dispatches
backend/routes/adminRoutes.js - Admin routes → System settings: dispatches
backend/routes/adminRoutes.js - Attendance workflow → Domain models: queries
backend/controllers/AttendanceController.js - Logbook review → Domain models: queries
backend/controllers/LogbookController.js - Leave workflow → Domain models: queries
backend/controllers/LeaveController.js - Reports and exports → Domain models: queries
backend/controllers/ReportController.js - Reports and exports → Excel export: generates workbook
backend/controllers/ReportController.js - Users and divisions → Domain models: queries
backend/controllers/UserController.js - Users and divisions → Bulk user transfer: delegates transfer
backend/controllers/UserController.js - Attendance workflow → Location validation: validates location
backend/controllers/AttendanceController.js - Attendance workflow → File uploads: stores photos
backend/controllers/AttendanceController.js - Leave workflow → File uploads: stores attachments
backend/controllers/LeaveController.js - Domain models → MySQL database: persists data
backend/models/index.js - Auto checkout → Domain models: updates attendance
backend/utils/autoCheckoutScheduler.js