跳转至

Dashboard（open-dashboard）

Dashboard的维护记录。

  • 上游：ahpxex/open-dashboard1，作者 ahpx，MIT。技术栈 TanStack Start（React 19）+ Drizzle + better-auth + shadcn-on-base-ui + Tailwind v4
  • commit：钉在 aa9815f（2026-06-29），2026-07-07 首次吸收
  • 跳过：
    • 36 篇形状 reference、skill 文档和模板代码的原文都不在本地存档：活跃开源仓库钉 commit 永链就能满足「AI 可 GET 源」，750 多个 tsx 存进对象存储只会拖累部署。要一比一的成品模板，去原仓库装它的 skill 目录
  • 翻译之外的改动：蓝本分三层，各去了不同的地方
    • 每个形状的 Invariants：中文提炼进对应文章的「规矩」一节，六组（表单、列表与表格、富视图、详情与页面、展示与反馈、平台能力）
    • 实现：换成自研可玩 demo（skills/dashboard/assets/demo-*.html，源码未压缩可直读），全部内存状态、免构建
    • 原文档正本：各篇文末一行「蓝本」钉 commit 永链
    • 例外是两份系统级契约，切不进任何单篇文章，留在 skills/dashboard/assets/open-dashboard/：PATTERNS.md 是 36 形状的全局总目录加共享契约，施工前先读它建立全貌；backends/CONTRACT.md 是前后端线协议（json-server 方言 + AuthProvider 接线），demo 全是纯前端内存态，接真后端时它是唯一依据。两份里指向已删的 docs/*.md、ROADMAP.md、src/*.ts 的相对链接都改成了钉 commit 的永链

上游更新

  1. git clone 上游，git diff aa9815f..<新 commit> --stat -- .claude/skills PATTERNS.md backends/CONTRACT.md README.md 看动了什么
  2. 逐条处置：
    • references 变了：更新对应文章的「规矩」，必要时 demo 也改
    • 新增形状：照现有文章的结构补文章、demo，注册 nav
    • PATTERNS.md、backends/CONTRACT.md 变了：更新留存的这两份
    • 纯代码、模板变动：不用动，本 wiki 不镜像代码
  3. 更新本页的 commit 和日期；文章里的旧永链不用改，钉旧 commit 依然有效，只有内容实质变化的才随「规矩」一起更新
  4. 跑 python3 scripts/check-links.py

  1. ahpxex/open-dashboard @ aa9815f，2026-07-07 读。 ↩