chore: perauset customer project

CLAUDE.md

@@ -0,0 +1,42 @@
+# Perauset
+
+Village operations platform.
+
+## Project Structure
+
+- `backend/` — Backend server (uWebSockets + Pikku)
+- `packages/functions/` — Shared business logic / Pikku functions
+- `sql/` — Database migrations (postgres-migrations)
+
+## Running
+
+### Backend
+
+```sh
+cd backend && yarn dev
+```
+
+Runs `tsx watch` with env files (`../.env` and `.env.local`). Watches for changes and auto-restarts.
+
+### Port
+
+| Service | Port |
+|---------|------|
+| Backend | 6002 |
+
+## Commands
+
+- `yarn pikku` — Run Pikku CLI codegen (`pikku all`)
+- `yarn pikku:watch` — Run Pikku CLI codegen in watch mode
+- `yarn prebuild` — Bootstrap + codegen
+- `yarn tsc` — Type-check all workspaces
+- `cd backend && yarn dbmigrate` — Run database migrations
+- `cd packages/functions && yarn db:types` — Regenerate Kysely DB types
+
+## Package Manager
+
+Uses **Yarn 4.9.2** (with workspaces). Node >= 22 required.
+
+## Database
+
+PostgreSQL, database name `perauset`, default schema `app`.