How codewithcrafter/buzzspireworkhub works
This repository is a workforce-management and HR web application: employees and administrators use its Next.js interface for attendance, staff records, leave, payroll, reporting, and administration. A key operational path is attendance capture and recalculation: the product includes employee attendance endpoints and a desktop agent, while the sampled HR engine delegates metric calculation to the working-hours service and persists the result. The tree shows additional payroll, activity-monitoring, and browser-extension capabilities. Because their implementation excerpts were not provided, the graph omits uncertain wiring between those components.
Main entry points: route.ts Employee API · hr-engine.service.ts HR recalculation · my-history/page.tsx Employee pages · employees/page.tsx Admin pages
Components 20
Web experience
- Web application
src/app/(dashboard)/layout.tsx - Employee pages
src/app/(dashboard)/my-history/page.tsx - Admin pages
src/app/(dashboard)/employees/page.tsx - Login pages
src/app/(auth)/login/page.tsx
Workforce operations
- Employee API
src/app/api/employees/route.ts - Attendance API
src/app/api/attendance/punch-in/route.ts - Leave API
src/app/api/leaves/route.ts - Payroll API
src/app/api/payroll/run/route.ts - Employee service
src/services/employee.service.ts - HR recalculation
src/services/hr-engine.service.ts - Working-hours metrics
src/services/working-hours.service.ts
Activity and insight
- Reports
src/services/report.service.ts - Activity timeline
src/services/timeline.service.ts
Identity and data
- Authentication
src/lib/auth/permissions.ts - Application database
src/lib/prisma.ts
Activity capture
- Desktop agent
workhub-agent/agent_main.py - Local event queue
workhub-agent/agent_storage.py - Browser extension
workhub-browser-extension/src/background/worker.ts
Other components
- Employee
- HR / Admin
Connections 13
- Employee → Login pages: signs in
- HR / Admin → Login pages: signs in
- Employee → Employee pages: uses
- HR / Admin → Admin pages: uses
- Employee pages → Web application: renders within
- Admin pages → Web application: renders within
- Employee API → Authentication: checks session
- Employee API → Employee service: calls
- Employee service → Application database: reads / writes
- HR recalculation → Working-hours metrics: delegates calculation
- HR recalculation → Application database: reads / updates
- Desktop agent → Local event queue: queues events
- Employee → Attendance API: submits attendance