| Component | Technology | Responsibility |
|---|---|---|
| Web application | Next.js 16, React 19, TypeScript, Tailwind CSS 4, SWR | User interface, session-aware navigation and API consumption |
| Application API | Laravel 13 on PHP 8.4 | Business rules, access control, transactions, integration endpoints and audit operations |
| Application database | PostgreSQL / Scaffolding Supabase project | Commercial, fulfilment, inventory and finance records |
| Shared identity | UtopiaSpace Core Supabase/services | Login identity, shared profile and Scaffolding product grant |
| External operations | AppSheet/sheet sync and OE endpoints | Operational exchange, dispatch board, technicians and vehicles |
Browser → Next.js application → Laravel /api/v1 → local permission/branch checks → PostgreSQL → response.
Browser → Google/Core authentication → backend callback/session → Core product-policy check → local user provision/update → application session.
Machine client → API token or JWT middleware → integration/OE route → validated service transaction → database and job/outbox log.
| Path | Contents |
|---|---|
frontend/ |
Next.js routes, components, hooks, permission helpers and client tests |
backend/app/ |
Controllers, models, services, middleware and domain logic |
backend/routes/api.php |
Versioned HTTP contract |
backend/database/migrations/ |
Database evolution and seed/reference changes |
backend/tests/ |
Laravel feature/integration coverage |
scripts/appsheet_sync/ |
AppSheet synchronisation tooling |
scripts/appsheet_import/ |
Import tooling |
.github/workflows/ |
Frontend deployment and wiki-notification automation |