Safe local startup and verification guidance for the Encik Beku frontend and backend.
PHP and Composer do not need to be installed on the host when the documented Docker workflows are used.
The Laravel API is served locally on http://localhost:8080.
cd backend
cp .env.example .env
docker compose run --rm app php artisan key:generate
docker compose up -d --build
docker compose logs -f app
The inspected checkout does not contain
backend/.env.example, although the README refers to it. Until a sanitized example is added, obtain the approved key-name template from the current owner. Do not copy production values into a developer file.
Useful diagnostics:
docker compose exec app php artisan route:list
docker compose exec app php artisan tinker
docker compose exec app php artisan config:clear
Laravel caches configuration when the container starts. Clear and rebuild configuration after changing environment values.
The frontend requires the keys in frontend/.env.local.example and runs on port 3000 by default.
cd frontend
pnpm install
pnpm dev
Use the documented shared-domain development host when testing silent SSO; localhost alone does not reproduce shared parent-domain cookies.
The backend test suite connects to the shared development Supabase database. It does not build a local SQLite copy.
Two safeguards are intentional:
Tests\TestCase refuses to run unless it recognizes the development project.Do not use RefreshDatabase; it can destroy shared Supabase tables, including identity data.
Run tests in the application container when it is available:
docker compose exec app php artisan test
The source guidance also documents a temporary PHP 8.4 container for environments without the required PHP extensions.
| Change area | Minimum verification |
|---|---|
| Order creation or dispatch | OrderDispatchTest plus an exercised draft-to-dispatch path |
| Permissions or route guards | PermissionGateSweepTest, PermissionMatrixTest, RequirePermissionTest and affected route tests |
| Itemize persistence | ItemizeSaveTest, OpsItemizeEndpointTest, snapshot/discount tests |
| Finance feeds or verification | Finance feed, scope, balance and verification tests |
| Quotation conversion | QuotationToOrderFlowTest |
| Frontend user journeys | Relevant Playwright tests plus pnpm build |
| Schema change | Migration review, development apply, backward-compatibility check and affected tests |
The frontend currently exposes:
pnpm build
pnpm e2e
The repository has Playwright coverage for portal items and orders, but this is not a complete end-to-end suite. Manual verification remains required for authentication, real-device field behavior, uploads, cross-application dispatch and production-only integrations.
Real operational data begins at 2026-08-19 00:00 Malaysia time (2026-08-18 16:00:00+00). Earlier rows are predominantly test or imported AppSheet history. Always state which side of this cut-off an observed defect or count belongs to.
A change is not verified merely because it builds. Record: