See docs/architecture/buyer-portal.md for the full foundation spec and docs/architecture/buyer-portal-provider-linking-ui-spec.md for the provider-linking UI design.
What it is
The buyer portal gives client companies visibility into their service providers' workforce — attendance, documents, contract status — without granting full HR access.
Access model
- Client company admins log in to a scoped portal view
- They see only data for workers assigned to their contracts
- No cross-company data leakage — queries filter by
client_company_id
Key routes
| Route | Purpose |
|---|---|
/client |
Client portal home |
/client/contracts |
Active contracts with the service provider |
/client/approvals |
Pending attendance approval items |
/hr/reports/client-attendance |
Attendance sheet for assigned workers (ClientAttendanceSheetPage.tsx) |
Provider linking
A service provider links a client via the clientCompanies table; a member's link is held on company_members.clientCompanyId. The UI is in ClientPortalPage.tsx and ClientAttendanceSheetPage.tsx.
Spec documents
docs/architecture/buyer-portal.md— foundation specdocs/architecture/buyer-portal-provider-invoice-linking.md— invoice linking designdocs/architecture/buyer-portal-provider-linking-ui-spec.md— UI spec