个人工具经常从一个临时需求开始。真正困难的部分不是做出第一个页面,而是让半年后的自己仍然知道数据从哪里来、什么情况下不能相信,以及出了问题该从哪里查。
先定义什么叫当前
只显示一个更新时间并不等于数据是当前的。需要区分页面生成时间、输入数据更新时间和外部数据发布日期。只有这些时间语义被说清楚,过期判断才有依据。
如果当前来源读取失败,最诚实的结果是“暂时不可用”。旧快照可以保留作对照,但不能悄悄顶替当前数据。
把失败设计成产品的一部分
可靠系统不会把异常吞掉,也不会让用户在数据缺失时继续执行高风险动作。失败状态应该说明缺了什么、影响什么,以及下一步能做什么。
对于涉及资产或状态变更的工具,读取和建议可以自动化,最后确认必须留给人。这个边界需要写进接口和测试,而不只是写在说明里。
验证路径要比记忆可靠
每个关键结论最好都有一个短而明确的验证路径:一个测试、一条只读请求,或者一个能复现问题的最小步骤。这样下次维护时,不需要重新依赖人的记忆。