Claude Opus 5
b96997501a
All checks were successful
CI / Build container images (pull_request) Successful in 3m53s
CI / Auth e2e pack (pull_request) Successful in 8m42s
CI / Auth e2e pack (push) Successful in 8m41s
CI / Lint, typecheck, test (pull_request) Successful in 6m30s
CI / Import/export fidelity gate (pull_request) Successful in 58s
CD / Build and push images (push) Successful in 18s
CD / Smoke tests against Test (push) Successful in 1m19s
CD / Deploy to Test (push) Successful in 16s
CD / Promote to Int (push) Successful in 12s
CI / Lint, typecheck, test (push) Successful in 6m41s
CI / Build container images (push) Has been skipped
CI / Import/export fidelity gate (push) Successful in 52s
An operator holding a font licence could only use it by baking the file into a custom image, which tied every change to a rebuild and left the file out of the backup. ADR 0016 said there is no runtime font management. It also listed this exact case under "Alternatives considered" — *may become a Site-Admin- level feature later*. The amendment takes that option and answers the two objections it raised: licensing risk (Site Admins only, licence recorded with the family) and file-format attack surface (magic-byte check and a size cap, never a parse). - `CUSTOM_FONTS_DIR` (default `./data/fonts`) — a sibling of uploads and plugins, NOT inside the image-baked `FONTS_DIR`, where a deploy would overwrite it and no backup would ever see it. - One list of data directories (`apps/backup/src/data-dirs.ts`) now feeds both the nightly archive and the restore, so they cannot drift. #306 and #307 add one line each instead of a second mechanism. - Both Dockerfiles bake the path. The backup image sets its volume paths itself ("self-sufficient without compose env" — #71's lesson) and reads no *_DIR from compose; without the ENV entry the archive would have skipped the directory silently. - The PDF path already read WOFF2 from disk at request time, so it only had to pick the other base directory for a custom family. - `fontStack`/`fontEntry` take the instance's uploaded families as an argument — they are runtime data. The catalog is searched first, and a colliding family name is rejected at upload, so a custom font can never shadow a catalog one. - Deletion is never blocked by usage: an unknown family already falls back to the system stack, so affected ponds degrade instead of breaking. The count of affected ponds travels into the audit entry. - Audit catalogue v1.6 (`font.uploaded`, `font.deleted`). Verified: api full suite against a fresh database, 102 files / 571 tests. The upload suite writes into a real temp directory and reads the bytes back off disk, so the storage layer is exercised rather than mocked.
46 lines
1.7 KiB
SQL
46 lines
1.7 KiB
SQL
-- #303: operator-uploaded font families (ADR 0016 §#303).
|
|
-- The bytes live on disk under CUSTOM_FONTS_DIR; these rows record only what
|
|
-- the upload form stated, because the api never parses the font file.
|
|
|
|
CREATE TABLE "custom_fonts" (
|
|
"id" TEXT NOT NULL,
|
|
"family" TEXT NOT NULL,
|
|
"slug" TEXT NOT NULL,
|
|
"category" TEXT NOT NULL,
|
|
"licence" TEXT NOT NULL,
|
|
"licence_url" TEXT,
|
|
"uploaded_by" TEXT NOT NULL,
|
|
"created_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
|
"updated_at" TIMESTAMP(3) NOT NULL,
|
|
|
|
CONSTRAINT "custom_fonts_pkey" PRIMARY KEY ("id")
|
|
);
|
|
|
|
-- Both unique: `family` keeps `fonts.<slot>.family` in pond settings
|
|
-- unambiguous, `slug` owns a directory under CUSTOM_FONTS_DIR.
|
|
CREATE UNIQUE INDEX "custom_fonts_family_key" ON "custom_fonts"("family");
|
|
CREATE UNIQUE INDEX "custom_fonts_slug_key" ON "custom_fonts"("slug");
|
|
|
|
ALTER TABLE "custom_fonts" ADD CONSTRAINT "custom_fonts_uploaded_by_fkey"
|
|
FOREIGN KEY ("uploaded_by") REFERENCES "users"("id")
|
|
ON DELETE RESTRICT ON UPDATE CASCADE;
|
|
|
|
CREATE TABLE "custom_font_weights" (
|
|
"id" TEXT NOT NULL,
|
|
"font_id" TEXT NOT NULL,
|
|
"weight" INTEGER NOT NULL,
|
|
"has_woff" BOOLEAN NOT NULL DEFAULT false,
|
|
"byte_size" INTEGER NOT NULL,
|
|
|
|
CONSTRAINT "custom_font_weights_pkey" PRIMARY KEY ("id")
|
|
);
|
|
|
|
CREATE UNIQUE INDEX "custom_font_weights_font_id_weight_key"
|
|
ON "custom_font_weights"("font_id", "weight");
|
|
|
|
-- Deleting a family takes its weights with it; the files on disk are removed
|
|
-- by the service in the same operation.
|
|
ALTER TABLE "custom_font_weights" ADD CONSTRAINT "custom_font_weights_font_id_fkey"
|
|
FOREIGN KEY ("font_id") REFERENCES "custom_fonts"("id")
|
|
ON DELETE CASCADE ON UPDATE CASCADE;
|