system board
原创APIConfigArchitecture

把主题配置做成可接 API 的契约

真正方便后续接 API 的方式,不是先写请求,而是先把页面依赖的数据形状稳定下来。

发表于 04/07/26 分类 系统设计 字数 219 阅读 1 分钟 浏览 0 次 停留 0 分钟
AI-摘要 立体科幻风格摘要卡片 · shijianus AI
待生成 进入视区后自动生成

AI 初始化中...

为什么先做契约

如果一个主题的每个板块都直接在模板里读取原始数据,那么一旦以后要从本地 Markdown 切到 API,几乎每个页面都要重写。

当前的处理方式

这次我先把这些能力抽离成统一的 helper:

  • 文章排序
  • 归档聚合
  • 分类聚合
  • 标签聚合
  • 相关文章推荐

这样做的收益

当数据源变化时,理论上只需要替换数据入口,而不是改动 UI 组件本身。

对主题扩展的意义

这意味着以后要接:

  • 自定义 dashboard API
  • 外部搜索 API
  • 远程文章摘要服务

都不会把当前的组件层撕开重来。

shijianus shijianus
shijianus
构建者 / 学生 / 通才型实践者
本文属于长期维护中的写作记录。允许分享与引用,但请保留原文链接、作者署名,并避免脱离上下文的片段搬运。
打赏作者 打赏作者

文章页和关于页共用同一套地区化打赏配置。当前开放中国大陆、中国香港与英国三个区域,会优先按访问地区、时区与语言画像推荐方式;高风险渠道会先弹窗提醒并按当前环境收紧,加密钱包只会在高置信度的英国访问环境下展示。

查看支持记录 看看已经收到的心意 感谢你赐予我继续写下去的动力。
分享这篇文章

阅读导航

上一篇 / 下一篇

2 个跳转入口
提示