How masadipradeeprao/time-tracker-app works
Hourlog is a workforce time-tracking application for employees and administrators. Employees authenticate, record shifts, and review calendar and hours summaries; administrators oversee staff, manage profiles and shifts, and inspect reports and audit history. The sampled services show the Supabase-backed identity, time-entry, and audit layers. Several dashboard and administration pages are represented from the tree and README, but their internal wiring was not sampled, so those links are left unverified.
Main entry points: time-service.ts Time service · audit-service.ts Audit service · actions.ts Admin actions · page.tsx Reports
Components 24
Identity and access
- Sign up
src/app/signup/page.tsx - Auth context
src/components/auth-provider.tsx - Auth service
src/services/auth-service.ts - Auth actions
src/app/auth/actions.ts - Supabase auth
src/lib/supabase.ts
Employee timekeeping
- Time dashboard
src/app/(dashboard)/dashboard/page.tsx - Shift calendar
src/app/(dashboard)/calendar/page.tsx - Hours summary
src/app/(dashboard)/summary/page.tsx - Reminder settings
src/app/(dashboard)/reminders/page.tsx
Administration and oversight
- Admin dashboard
src/app/admin/page.tsx - User management
src/app/admin/users - Shift editor
src/components/admin/edit-session-dialog.tsx - Admin actions
src/app/admin/actions.ts - Reports
src/app/admin/reports/page.tsx - Audit history
src/app/(dashboard)/audit-logs
Domain services
- Time service
src/services/time-service.ts - Timezone utilities
src/lib/date-utils.ts - Time entries
- Audit service
src/services/audit-service.ts - Audit logs
- Reminder sender
supabase/functions/send-reminders/index.ts
Other components
- Employee
- Administrator
- Supabase database
Connections 24
- Employee → Sign up: creates account
- Sign up → Auth context: submits signup
src/app/signup/page.tsx - Auth context → Auth service: delegates auth
src/components/auth-provider.tsx - Auth context → Auth actions: loads profile
src/components/auth-provider.tsx - Auth service → Supabase auth: auth and profile calls
src/services/auth-service.ts - Employee → Time dashboard: tracks work
- Time dashboard → Time service: uses timekeeping
- Shift calendar → Time service: loads shift history
- Hours summary → Time service: summarizes hours
- Time service → Timezone utilities: calculates date ranges
src/services/time-service.ts - Time service → Supabase database: queries and updates
src/services/time-service.ts - Supabase database → Time entries: persists entries
- Administrator → Admin dashboard: oversees staff
- Admin dashboard → Admin actions: loads admin data
src/app/admin/page.tsx - User management → Admin actions: manages users
- Reports → Admin actions: requests report data
src/app/admin/reports/page.tsx - Reports → Time service: uses time records
src/app/admin/reports/page.tsx - Reports → Audit service: uses audit history
src/app/admin/reports/page.tsx - Shift editor → Admin actions: updates shift
src/components/admin/edit-session-dialog.tsx - Shift editor → Audit service: records change
src/components/admin/edit-session-dialog.tsx - Audit history → Audit service: displays history
- Audit service → Supabase database: reads and writes logs
src/services/audit-service.ts - Supabase database → Audit logs: persists audit trail
- Reminder settings → Reminder sender: configures reminders