From 49f5d976fb86cf9e59cf44e936e2da3bb2b16b37 Mon Sep 17 00:00:00 2001 From: Jonathan Date: Sun, 19 Apr 2026 20:32:09 +0200 Subject: [PATCH] docs: document decisions D-15 through D-18 --- DECISIONS.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/DECISIONS.md b/DECISIONS.md index 94187b4..2e228b6 100644 --- a/DECISIONS.md +++ b/DECISIONS.md @@ -103,3 +103,31 @@ Decisions made during autonomous build. Each entry: what was chosen, why, and wh **Chose:** No forgot-password page built. Admin issues a new invite link from /admin. **Why:** SPEC §3 explicitly says: "No forgot-password flow for v1 — admin re-issues invite links." + +--- + +## D-15 · Join CTA uses fetch + in-place DOM swap (not full-page POST) + +**Chose:** The "I want to join" button fires `fetch('/api/join', { method: 'POST' })` and swaps the CTA element in-place on success. The server-rendered state (alreadyJoined) handles the persistent confirmation on subsequent visits. +**Why:** The brief specified "no navigation, replaces page content in-place". Full-page POST would cause a navigation. The server-side fallback ensures correctness without JS. + +--- + +## D-16 · Innofounder logo: file-existence check at render time + +**Chose:** `existsSync('public/innofounder-logo.svg')` at SSR render time. If missing, shows a placeholder rectangle with instructions. If present, renders the img tag. +**Why:** The brief said to show a placeholder if the file doesn't exist, and not to invent or regenerate the logo. SSR file check is the simplest approach that works without a build step. + +--- + +## D-17 · Architecture diagram is HTML/CSS using surface tiers, not SVG + +**Chose:** Four `div.arch-row` elements with inline `style="background: var(--surface-tier)"`, stacked with overflow:hidden on the parent container for rounded corners. +**Why:** The brief said "HTML using design tokens — feels editorial, not a box-and-arrow diagram." CSS surface tiers do this without any SVG coordinate math. The result is responsive and themeable. + +--- + +## D-18 · Stat figure attribution is "Stanford AI Index, 2024" — verify before launch + +**Chose:** Used "Stanford AI Index, 2024" as the attribution for the 97% figure. +**Why:** This is the most widely cited source for that statistic. Fenja should verify the exact citation and year before the hub is shown to external participants.