| Item | Value |
|---|---|
| Live Site | buildright.sonandigital.com |
| API Endpoint | buildright-api.sonandigital.com |
| Repository | sonantechai/contractor-portal |
| Database | contractor_db (D1 SQLite) |
| Stack | React 18 + TypeScript + Vite 5 + Cloudflare Pages + Cloudflare Worker |
| Status | Live — July 2026 |
| Commit HEAD | af3fd7f3 |
What It Does
Public site — Prospective clients visit the site to learn about the business and submit a service request. The hero section displays the business logo on the left (when uploaded, ~200px) with business name, tagline, and call-to-action buttons on the right. When no logo is uploaded, the text fills the full width. The navigation bar always shows the "BuildRight" business name as text (never the logo image) and provides quick access to Admin Login and Team Login (orange, bold) buttons in the top-right corner.
Admin portal — The business owner logs in at /#login (Admin Login button in nav) to manage the full business workflow. The portal includes 11 modules: Dashboard, Engagements (Appointments), Projects, Calendar, Clients, Estimates, Invoices, Service Requests, Reports, Settings, and Team (Employees). Engagements support recurring schedules — Daily, Weekly, Bi-Weekly, Monthly, or Custom Weekdays with a day-picker (Sun–Sat buttons).
Employee portal — Team members log in at /#employee-login (Team Login button in nav, orange) using their name and a 4-digit PIN set by the admin. Employees can view their assigned jobs and update job status from the field.
Business Workflow
| Step | Module | Description |
|---|---|---|
| 1 | Service Requests | Customer submits request from public site; appears in admin inbox with New status |
| 2 | Appointments | Admin schedules on-site visit or follow-up; assign contractor, set date/time |
| 3 | Projects | Active job tracked with service type, address, scheduled date, labor/material costs, status, recurrence |
| 4 | Estimates | Formal estimate with line items issued to client before work begins; Draft → Sent → Accepted/Declined |
| 5 | Invoices | Invoice issued after job completion; tracks payment status: Draft → Sent → Paid/Overdue |
Documentation Pages
| Page | What You'll Find |
|---|---|
| Admin Guide | Day-to-day portal usage, all module walkthroughs, employee management |
| User Guide | Step-by-step instructions for both admin and employee users |
| Credentials | Live URLs, login info, Worker secrets, D1 database ID |
| Dev Reference | Architecture, DB schema, file structure, API routes, deployment pattern |
| AI Handoff | Session context, latest commit, key file sizes, known gotchas |
| Deployment | Build, deploy, and migration procedures |