Appearance
Rules carried over from the old plan, and parked work
Rules
| Rule | Reason | Where it is enforced |
|---|---|---|
| Nothing contractual (quotes, contracts, payment links, account creation) goes out without an explicit owner action | Mistakes cost money or legal trouble. | Procedures that send are owner-only and take an explicit confirmation. |
| Access rules live in one place on the server | Hiding a button is not security. | packages/api/src/access.ts |
| Out-of-scope records return "not found" | Nobody can discover what exists by guessing ids. | notFound() in the access module |
| Form needs consent and shows a privacy notice | UK data protection. | Public form, milestone 4 |
| Integrations optional, with a manual fallback | The agency must work if Stripe, email or the scraper is down. | packages/api/src/integrations/ |
| Never invent figures | Missing data is shown as missing. | not_configured results; "couldn't load" states |
| Sent quotes and signed contracts are immutable snapshots | Price changes apply only to future documents. | freezeSnapshot + template triggers (Versioning) |
| Migrations are append-only | History is never rewritten. | bun run db:check, CI |
| No secrets in code or chat; use deployment secrets | Keeps credentials out of the repo and AI tools. | Varlock schemas, Alchemy secrets |
| Any button that starts background work first shows what it will do | A click never starts work the user can't see. | UI convention |
New ideas go on roadmap.md, not into the change in hand | Keeps each change small and reviewable. | Roadmap |
Not in this build (parked)
Native/Expo app; the Reroot app bridge; AI assistant/@ai agents; Meta/TikTok ads management and the growth dashboard; inbound social comment scraping; business map and sweeps; automated post-metric fetching; Google sign-in for clients; Google Drive; voice/auto-dialling; UK bank holidays in date maths (use plain calendar days until added).