← 项目
webplatformfull-stack

ADAM Platform

The open development & community platform you're looking at — built end to end on a free-tier edge stack.

ADAM Platform

ADAM is the platform you're looking at right now — an open development studio site, built end to end and running entirely on a free-tier, edge-first stack.

Architecture

API-first by design. A single Cloudflare Workers backend owns all logic; every client — the web app and the adam CLI — is a thin shell over the same HTTP API.

  • Backend — Cloudflare Workers + Hono (TypeScript), D1 (SQLite) as the database, KV for sessions and caching, native rate limiting, and Analytics Engine for visit metrics
  • Web — Astro 5, server-rendered on Cloudflare Pages, 8-language i18n
  • CLIadam, a token-authenticated admin tool — the primary control surface (web admin is secondary)

Engineering highlights

  • CLI-first operations. Every resource is fully manageable from the command line, with strict create↔delete symmetry. Project bodies are README.md files — local images auto-upload to a CDN and get rewritten on publish.
  • One markdown pipeline. Community posts, bug notes, and project bodies share a single renderer — stored as source, rendered on read.
  • Cascade-correct data model. Soft deletes throughout; deleting a project cascades its changelog, versions, and bug reports.

Security

  • Google sign-in (OpenID Connect) — no passwords ever stored; CLI tokens kept as SHA-256 hashes, shown once at issue
  • Token auth re-loads the issuer on every request — demote the admin and the token dies instantly
  • Bot-resistant by design — Google verifies real humans at sign-in, backed by UA filtering and native rate limiting; login-anomaly detection (IP / country)

The stack, in full

Cloudflare Workers · D1 · KV · Pages · Astro · Hono · Google OAuth · ImageKit — all within free-tier limits.

该项目的改进记录

  • 功能 Secret posts: any member can now post privately — only you and the operators can read it 已完成
  • 功能 Staff-only community posts — hidden from the board, its count, neighbours and comments 已完成
  • 改进 Added an automated test suite so this class of regression is caught before release 已完成
  • 严重 Fixed: the open bug count never went down, even after reports were resolved 已完成
  • 严重 Fixed: posting a notice from the admin CLI failed after the English migration 已完成
  • 改进 Support notification channel can now be changed without a redeploy 已完成
  • 改进 Privacy policy corrected: removed a retired processor, disclosed project notifications 已完成
  • 改进 Privacy notice now shown during signup, in all 8 languages 已完成
  • 改进 Renamed "My purchases" to "My projects" — there is no payment flow 已完成
  • 改进 Live chat errors now shown in your own language instead of English 已完成
完整改进追踪 →