Admin Portal

Admin routes are rooted at /admin and are mostly handled by AdminPortalController, AdminClientManagementController, AdminClientProjectSetupController, and AdminClientAwardMatrixController.

Platform admin setup

AdminPortalController handles:

• dashboard
• users
• user invitations
• clients
• platform-level configuration
• expense category master configuration
• master configuration items
• client create/edit/delete

Client management

AdminClientManagementController is the main client setup workhorse. It handles:

• projects and Google geocoding/places helper routes
• expense categories
• materials
• cost codes
• rates and rate classes
• allowances and allowance master imports
• ordinary hours rules
• work conditions
• event rates
• timesheets and expenses
• bulk accept, approve, reject, submit to Xero, and delete actions

Because this controller touches many areas, durable business rules should be kept in entities/services/subscribers where possible. The controller should be treated as orchestration and UI wiring.

Award matrix pages

AdminClientAwardMatrixController is rooted at /admin/clients/{id}/award-matrix and manages:

• employee classifications
• break rules
• shift rules
• travel rules
• callout rules
• master imports
• deleting matrix records

This page complements, rather than replaces, ordinary-hours and event-rate pages.