makefile-dev-workflow

Run `make dev` from the repository root to start PostgreSQL, the Rust backend, and the Next.js frontend in parallel. Use `make status` afterward to verify the health of each service and see the bound URLs.

Navigate to the edgequake_webui directory and run `pnpm exec playwright test` to execute all specs, or pass a specific file like markdown-test.spec.ts. View results with `pnpm exec playwright show-report` for screenshots and traces.

Yes, `make backend-test` uses a mock LLM provider by default, so no OPENAI_API_KEY is required. The mock provider is free and fast, making it suitable for local development and CI runs.

You need make, the Rust toolchain (cargo), Node.js with pnpm or npm, and Docker Desktop with docker-compose for database and container commands. Run `make check-deps` to verify installations and get setup instructions.

Ports 3000 or 8080 may be occupied by other processes. Free them with `lsof -ti :3000 | xargs kill -9` or the equivalent for port 8080, then rerun `make dev`.

Run `make db-reset` to delete all data and reinitialize the database container, then confirm connectivity with `make status`. This is destructive, so only use it when existing data is disposable.