joh/project-bifrost-platform
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: document decisions D-15 through D-18

Browse source
This commit is contained in:
Jonathan 2026-04-19 20:32:09 +02:00
parent 2d3391f531
commit 49f5d976fb
1 changed files with 28 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

28
DECISIONS.md
View file

@ -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. **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." **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.