Skip to content

docs(spec): sync SPEC.md to actual architecture (ADR-014) - #82

Merged
Seungpyo1007 merged 1 commit into
mainfrom
docs/spec-architecture-reality-sync
Sep 24, 2026
Merged

Seungpyo1007 merged 1 commit into
mainfrom
docs/spec-architecture-reality-sync

Conversation

@Seungpyo1007

Copy link
Copy Markdown
Member

Summary

SPEC.md's §4/§16/§17 still described the original 2026-05 plan (FastAPI on Railway/Fly.io, Supabase Postgres, Sentry/Better Stack/UptimeRobot) — none of which was ever actually deployed. Adds ADR-014 documenting the real architecture that's been in production for months (static JSON dump + GitHub Pages, no live server), marks ADR-002/ADR-010 as superseded rather than deleting them, and rewrites §16.1 (CI/CD workflow tables) and §17 (ops/observability) to match the real workflows and TechMachine-based monitoring. Also refreshes §3.1's dataset scope numbers from the original ~500-phone target to the actual current counts (93,396 smartphones etc.).

Details

  • ADR-014: static-dump-only architecture, supersedes ADR-002/ADR-010 without deleting their rationale (kept for the Phase 4+ re-trigger condition).
  • §16.1: replaced fictional workflow table with the real TechAPI/TechEngine/TechMachine workflow lists.
  • §16.2-16.4: replaced Railway/Fly.io/Sentry deploy+rollback steps with the actual GitHub Pages flow.
  • §17: replaced Sentry/Better Stack/UptimeRobot/Supabase monitoring with TechMachine's actual daily health-check + issue-comment model.
  • §3.1: real per-category record counts as of 2026-09-24, noting the game-catalog split and the software/websites identity-based retention decision.

Test plan

  • Markdown structure spot-checked (no broken headers/tables)
  • Doc-only change, no code/data affected

@Seungpyo1007 Seungpyo1007 self-assigned this Sep 24, 2026
@Seungpyo1007
Seungpyo1007 merged commit d860dbb into main Sep 24, 2026
1 check passed
@Seungpyo1007
Seungpyo1007 deleted the docs/spec-architecture-reality-sync branch September 24, 2026 10:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

1 participant