docs+site: Nightjar brand, hosted service, infrastructure plan, saved site
Some checks failed
ci / firmware (pull_request) Failing after 31s
ci / openapi (pull_request) Failing after 33s
ci / emulator (pull_request) Failing after 24s
ci / server (pull_request) Failing after 37s

Persists the branding/commercial/infrastructure work (previously only in chat and
on the live site) into version control.

What changed:
- docs/naming.md: due-diligence and the decision to brand the product Nightjar
  (OpenScribe domain/GitHub/trademark collisions; alternatives screened; why Nightjar).
- docs/hosted-service.md: the commercial model - plan tiers (Self-host / Cloud
  Starter / Cloud Pro / Private), indicative pricing, backend mapping, and the
  build-to-sell roadmap (metering, billing, provisioning, DPA).
- docs/infrastructure.md: backend infra plan. Primary option = self-host on the
  3x Minisforum MS-02 cluster (one with an RTX 3050 6GB) fronted by a Cloudflare
  Tunnel, with node roles, the 3050 capacity reality, caveats, and a Hetzner cloud
  fallback. Provision-later.
- site/: reproducible marketing-site source - block content for all 11 pages
  (rebranded to Nightjar), the navigation, the Contact Form 7 config (honeypot),
  the ApisCP SOAP helper (tools/apiscp.php, no secret), and a README on how the
  WordPress site is built and managed via the API.
- state/: DECISIONS (Nightjar rebrand, hosted service, MS-02 backend), PROJECT
  (brand + commercial section), TODO (rename decision, trademark, mailbox, pricing,
  hosted-service build, infra provisioning).

Why:
- User asked to save everything to the repo. Captures the product rebrand, the
  commercialisation plan, and the infrastructure decision so a cold session has the
  full picture.

Notes:
- The repo is still named `openscribe`; the product/brand is Nightjar. A full
  codebase rename is deferred (tracked in TODO + docs/naming.md).
- No secrets committed: the ApisCP API key is read from a local scratch file, never
  the repo.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Laurence 2026-07-05 22:24:24 +01:00
parent a3bdc3c6cf
commit 8fd9b694f8
21 changed files with 592 additions and 0 deletions

View file

@ -3,6 +3,49 @@
> A dated, append only log of decisions and their rationale. Newest at the top. Never
> rewrite past entries; if a decision is reversed, add a new entry that says so.
## 2026-07-05 - Backend infra: self-host on the MS-02 cluster (provision later)
- **Decision:** The hosted service will run primarily on owned hardware - 3x Minisforum
MS-02-class mini-workstations, one with an RTX 3050 6GB - fronted by a Cloudflare Tunnel.
Node A (GPU) = AI worker (faster-whisper + local LLM), Node B = app/API/Postgres/Redis,
Node C = MinIO storage + overflow + HA. Cloud VMs (Hetzner) are the fallback/hybrid.
**Not provisioned yet**; stand up at first beta / paying users. Full plan:
`docs/infrastructure.md`.
- **Context:** User has the MS-02 cluster on hand and prefers self-host for small scale.
- **Rationale:** The 3050 handles whisper easily and a 7-8B summary model fits 6GB; owned
hardware is cheaper than cloud and strengthens the Private-tier privacy story (audio
never leaves our premises). Cloud fallback covers uptime-sensitive growth.
- **Consequences:** Need Cloudflare Tunnel, backups/UPS, and to mind home-hosting uptime;
6GB VRAM caps local LLMs at ~8B until a bigger GPU is added.
## 2026-07-05 - Commercialise via a managed "hosted" service + plan tiers
- **Decision:** 12 Hobbies Studio offers a managed backend so people can use Nightjar
without self-hosting. Plans: Self-host (free), Cloud Starter (~GBP 6), Cloud Pro
(~GBP 18) on commercial AI, and Private (~GBP 39) on self-hosted open models (audio never
touches a third-party AI). Marketing site live; billing/signup not built yet (lead-gen
only). See `docs/hosted-service.md`.
- **Context:** User asked for commercial options where they host the backend.
- **Rationale:** Open project + managed convenience; the two backends map to the two plan
families. Cloud tiers keep good margin (cheap per-minute AI); Private is the privacy
premium.
- **Consequences:** Need metering, billing (Stripe), provisioning, a DPA, real pricing, and
a `hello@12hobbies.studio` mailbox before launch.
## 2026-07-05 - Rebrand product to "Nightjar" (repo stays `openscribe` for now)
- **Decision:** The product/commercial brand is **Nightjar** (site:
nightjar.12hobbies.studio). The repository keeps the name `openscribe` until a full
codebase rename is decided.
- **Context:** Due-diligence found "OpenScribe" unusable for a commercial brand (taken
domains, heavy in-category GitHub collision, weak/uncleared trademark). See
`docs/naming.md`.
- **Rationale:** "Nightjar" is distinctive, low-collision, and an arbitrary (strong)
trademark for AI software. Rejected: Mockingjay (Lionsgate TM), Lyrebird/Fathom
(in-category), dictionary words (taken/crowded), Recita (common).
- **Consequences:** Website rebranded. A full project/repo rename (SPDX, firmware
namespaces, docs, Forgejo repo) is deferred. Formal trademark clearance still needed.
## 2026-07-03 - Pluggable AI providers (bring your own AI)
- **Decision:** Transcription and summarisation each select a provider via config. LLM: