开发实践 · 原创
本地优先的评论与论坛:localStorage 数据模型设计
V62/V63 给站点加评论和论坛时还没有后端。当时的做法是本地优先:交互全量实现,数据落在访客自己的 localStorage,界面处处写明。
结论:本地优先不是妥协,是把「数据模型设计」提前到后端存在之前——schema 对了,接后端只是换存储。
为什么本地优先
假后端(伪造别人的评论)违反站点的编辑原则;没有交互又验证不了设计。本地优先是第三条路:真交互、真数据、真隔离,只是数据的主人恰好是访客本人。
两个存储的形状
az-comments 是 {"页面键": [评论]},页面键形如 article:slug / work:slug / game:slug,天然按页隔离。az-forum 是 {threads:[], replies:{帖子id:[]}}——主题与回复分表,回复挂在任意帖(含种子帖)之下。
种子与覆盖层
种子内容全部由作者署名、带「作者」徽章,解释规则或开启话题;访客内容叠加其上,可删除、标「我」。两层永不混淆:种子在 data 里随版本发布,覆盖层只在访客本机。
冻结为 API 契约
下一步把这两个 schema 原样冻结成 REST 契约:POST /api/comments 的请求体就是本地条目的形状。前端代码届时只换存储适配层,交互零改动——这就是本地优先阶段真正买到的东西。
后记(V68)
这套 schema 后来原样冻结成了 API 契约,并在 V68 接入 Supabase 成为真实后端——评论与论坛的交互代码零改动,只换了存储适配层。本地优先阶段承诺的那笔收益,如数兑现。
这篇文章有对应的论坛讨论串:站点问题与建议收集帖
讨论
1 条评论公开可见,支持 Markdown。后端不可达时本区自动进入只读模式。
- Randy Hopkins 作者
欢迎讨论。登录后即可发言,评论公开可见,你可以随时删除自己的评论。这里期待的是围绕文章内容的经验与勘误——我会定期回来逐条处理。
正在加载讨论…