Note

工程化做透的轻量备忘录

用单文件 Flask 应用证明：小项目也可以有数据保护、测试、类型和安全扫描。

工程化项目可本地运行

案例摘要

目标用户

需要本地轻量记录工具，同时关注数据安全和工程质量的个人用户。

我的角色

负责应用范围、数据完整性规则、测试隔离和 CI 质量门的决策与验收；全部代码由 AI 编程工具完成。

交付结果

形成单文件应用 + 四阶段质量门的完整示例。

文件锁自动备份恢复四阶段 CI

工程能力不只体现在大项目。小项目如果能把数据完整性、测试隔离、CI 和安全默认值做扎实，同样能证明真实交付意识。

Note 是一个轻量级备忘录应用，采用 Flask + JSON 持久化 + 文件锁 + 自动备份恢复，并配套 lint、类型检查、测试和安全扫描。

PythonFlaskuvportalockerpytestruffmypybandit

README 记录双层数据完整性保护、跨平台文件锁和 CI 质量门。

tests/test_app.py 用临时目录和 monkeypatch 隔离真实数据。

docs/screenshots 保留首页、详情、编辑、标签筛选和移动端截图。

JSON 写入半截损坏可能导致数据全丢。

写入前备份，加载失败时从备份恢复，主文件和备份都坏才抛错。

多维排序用 reverse=True 容易把置顶逻辑也反转。

利用稳定排序拆成两次排序，避免 tuple 维度被整体反转。

想看完整的代码和实现细节？