Appearance
0039: Company-owned configuration
Note 2026-11-06: the git host and CI moved to GitHub (
FEAW-Serv/getmy-books), ADR 0046. References below to the previous host are history; ADR 0046 says what replaces them.
Context
Get My Books Ltd is to own GetMy Books and sell it as a software licence. The code and the running service still named the people and the first two companies they were built for:
src/deadlines/company-profiles.tsheld FEAW's and WealthTechPros' company numbers, VAT quarters and payroll, so no other company could use the deadline radar, the confirmation statement check or the VAT steps.- Tool and prompt examples said "FEAW" and "WealthTechPros"; one reply said recodings were "for the owner (and Rob)".
- Production required
OWNER_EMAIL, a person's email, though the web app acts only as the person Cloudflare Access signed in. - The operator scripts acted for
OWNER_EMAILfrom Doppler. - The docs site linked into the code at one fixed address, set in the build script.
A buyer's due diligence asks what is configuration and what depends on a person, and how each is handed over.
Decision
- Each company's profile is data (SPEC-015).
entity_profile(migration 0015, row-level security like every company table) holds the company number, VAT quarter months, payroll and year end. The owner sets it withcompany_profile_set. The migration gives FEAW and WealthTechPros their profiles once, by name; it never overwrites one and skips a name two companies share. - Examples are generic: "Acme Ltd" in tool and prompt descriptions; no person is named in what the tools say.
- Production names no person.
OWNER_EMAILis removed frominfra/nas/docker-compose.ymland from the deploy's env allowlist (scripts/deploy-nas.sh,tests/infra/deploy-nas-env.test.ts). Who may sign in is the Cloudflare Access allowlist, and what they may see is theirentity_accessgrants. Until the root-owned copy at/usr/local/etc/getmy-books/docker-compose.ymlis reinstalled from the repo (ADR 0023), it still requiresOWNER_EMAIL, so the deploy sends it as an optional name while Dopplerprdholds it; it leaves the list once the installed copy matches. (Done 2026-10-09: the installed copy was reinstalled from the repo and the deploy no longer sendsOWNER_EMAIL.) - Operator scripts name who they act for when they are run:
OPERATOR_EMAIL(scripts/lib/operator-email.ts), refused with a clear message when unset. They no longer readOWNER_EMAIL. - The repository address is configuration:
REPO_URLfor the docs build, defaulting tohttps://github.com/FEAW-Serv/getmy-books. Links use GitHub's/blob/main/and/raw/main/paths.
What stays tied to people or to FEAW
| Asset | Held by today | Transfer step |
|---|---|---|
| Xero app (client id and secret) | Rob's Xero developer login | Register the app under a Get My Books Ltd developer login (or transfer it, if Xero allows), put the new client id and secret in Doppler prd, and reconnect each company's Xero |
Cloudflare (team feaw: Access, tunnel, Pages, getmy.group DNS) | The feaw team | Move the zone and Access application to a Get My Books Ltd account, or make that company the team's owner; new CF_ACCESS_TEAM_DOMAIN, CF_ACCESS_AUD and tunnel token in Doppler |
Entra ID tenant getmy.group (Access sign-in, MFA) | As configured | Confirm the tenant's owner is Get My Books Ltd; nothing in the code changes |
GitHub (FEAW-Serv/getmy-books) | Held by the FEAW organisation | Transfer or mirror the repository; set REPO_URL for the docs build and the repository address in the pipeline |
| NAS (production host, deploy user, backups) | Personally held hardware | Move the deploy (ADR 0019, 0023) to a host the company owns; restore from backup there |
Doppler (project getmy-books) | Personally held workspace | Move the project to a company workspace, or recreate it and copy each secret |
Local MCP server (src/mcp/stdio.ts) | Reads OWNER_EMAIL from Doppler dev: the person running it on their own machine | Nothing: each developer sets their own |
| Migration 0005 | Names fraser.duncan@feaw.co.uk and rob.duncan@feaw.co.uk, granted FEAW | Migrations are append-only and re-applied (ADR 0014, 0029), so it stays. A later migration may remove those grants if the buyer asks; the Access allowlist decides who can sign in at all |
| Migration 0015 | Seeds FEAW's and WealthTechPros' profiles by name | Harmless elsewhere: it only acts on entities with those names, once each, and never overwrites a profile |
| Companies House API key, ntfy alert topic | Registered by a person | Register new ones for the company and update Doppler |
Consequences
- A new company works end to end once its owner has a sign-in, an
entity_accessgrant and a profile: no code change. - Running an operator script now needs
OPERATOR_EMAIL=…on the command line; Dopplerdevno longer needsOWNER_EMAILfor the scripts (the local MCP server still reads it). - Prose docs that still mention
OWNER_EMAILfor the scripts, or FEAW as configuration, are updated on their next edit; this ADR is the record.