Decisions

Articles

• ~/internals/prototype-4/decisions/0017-feed-enrichment-full-content-rss.md

  ADR-0017: Full-content RSS 2.0 feed as a frontend-derived artifact; api limiter raised to 120 rpm

  ADR-0017 — Accepted 2026-07-07. Part of the platform's decision record.

  Bogdan Florian · July 7, 2026 · 5 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0016-event-driven-on-demand-revalidation.md

  ADR-0016: Event-driven on-demand revalidation via a backend relay and a signed frontend webhook

  ADR-0016 — Accepted 2026-07-07. Part of the platform's decision record.

  Bogdan Florian · July 7, 2026 · 6 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0015-unlisted-pages-curated-nav-one-h1.md

  ADR-0015: Unlisted pages, curated nav in root metadata, and the one-h1 rendering invariant

  ADR-0015 — Accepted 2026-07-07. Part of the platform's decision record.

  Bogdan Florian · July 7, 2026 · 8 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0014-site-identity-in-root-content-metadata.md

  ADR-0014: Site identity lives in the root content metadata

  ADR-0014 — Accepted 2026-07-07. Part of the platform's decision record.

  Bogdan Florian · July 7, 2026 · 5 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0013-authors-are-free-label-strings.md

  ADR-0013: Authors are free-label strings, not accounts

  ADR-0013 — Accepted 2026-07-06. Part of the platform's decision record.

  Bogdan Florian · July 6, 2026 · 6 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0012-mermaid-diagrams-render-client-side.md

  ADR-0012: Mermaid diagrams render client-side; the server pipeline leaves the fence inert

  ADR-0012 — Accepted 2026-07-06. Part of the platform's decision record.

  Bogdan Florian · July 6, 2026 · 7 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0011-asset-serving-endpoint-and-media-allowlist.md

  ADR-0011: Assets are served by a backend endpoint, as-is, behind a servable media-type allowlist

  ADR-0011 — Accepted 2026-07-06. Part of the platform's decision record.

  Bogdan Florian · July 6, 2026 · 9 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0010-client-api-separate-hosts-v1-base-path.md

  ADR-0010: Client and API on separate hosts; API base path `/v1`

  ADR-0010 — Accepted 2026-07-06. Part of the platform's decision record.

  Bogdan Florian · July 6, 2026 · 4 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0009-content-sync-and-content-root.md

  ADR-0009: Content sync mechanism and CONTENT_ROOT location

  ADR-0009 — Accepted 2026-07-05. Part of the platform's decision record.

  Bogdan Florian · July 5, 2026 · 4 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0008-scheduled-publishing-read-time-gating.md

  ADR-0008: Scheduled publishing via read-time gating, with a scheduler for warm-up

  ADR-0008 — Accepted 2026-07-05. Part of the platform's decision record.

  Bogdan Florian · July 5, 2026 · 3 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0007-server-side-markdown-rendering-and-sanitisation.md

  ADR-0007: Markdown is rendered to sanitised HTML server-side

  ADR-0007 — Accepted 2026-07-05. Part of the platform's decision record.

  Bogdan Florian · July 5, 2026 · 3 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0006-read-only-public-api-no-admin-panel.md

  ADR-0006: The public API is read-only and unauthenticated; no admin panel

  ADR-0006 — Accepted 2026-07-05. Part of the platform's decision record.

  Bogdan Florian · July 5, 2026 · 3 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0005-filesystem-content-source-of-truth.md

  ADR-0005: Filesystem is the content source of truth; Postgres indexes, Redis caches

  ADR-0005 — Accepted 2026-07-05. Part of the platform's decision record.

  Bogdan Florian · July 5, 2026 · 3 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0004-application-stack.md

  ADR-0004: Application stack — Laravel backend, Next.js frontend

  ADR-0004 — Accepted (template baseline). Part of the platform's decision record.

  Bogdan Florian · July 4, 2026 · 2 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0003-ddev-postgres-redis-baseline.md

  ADR-0003: DDEV + PostgreSQL 16 + Redis as environment baseline

  ADR-0003 — Accepted (template baseline). Part of the platform's decision record.

  Bogdan Florian · July 4, 2026 · 2 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0002-contract-first-team-boundary.md

  ADR-0002: Contract-first team boundary with strict tier direction

  ADR-0002 — Accepted (template baseline). Part of the platform's decision record.

  Bogdan Florian · July 4, 2026 · 2 min read

  • internals
  • decisions

• ~/internals/prototype-4/decisions/0001-record-architecture-decisions.md

  ADR-0001: Record architecture decisions

  ADR-0001 — Accepted (template baseline). Part of the platform's decision record.

  Bogdan Florian · July 4, 2026 · 2 min read

  • internals
  • decisions