14-01 添加阅读备注

题目

先列出输入、空文本与显示要求，再补数据库迁移、表单、校验、保存和模板转义，用重启后的读取核对。

推导与做法

备注属于当前用户的书。先按编号核对归属，再读取表单、校验长度并在同一连接事务中保存。数据库迁移为旧记录建立空文本默认值。

Blueprint 中的扩展路由继续使用 login_required 和原来的全局 CSRF。提交 阅读备注 后，库里保留原文，Jinja 显示转义文本；新连接读取的值与这次保存一致。

过程图

%% 每个节点保留输入、执行位置或执行后的实际状态。 flowchart TD S0["先核对登录与书籍归属"] S1["全局CSRF后校验备注"] S0 --> S1 S2["事务更新notes并提交"] S1 --> S2 S3["新连接读原文，Jinja显示转义文本"] S2 --> S3 classDef default fill:#EEF0FB,stroke:#4657B5,color:#24324A linkStyle default stroke:#4657B5

实现与运行

查看带注释实现。本题与相关处理函数放在同一章节代码文件中；启动工具负责定位相邻项目和选择题号。

在配套目录的 Flask/shelf_project 中运行。先按项目 README 执行 uv sync --locked。

# 使用项目解释器运行本题，题号决定执行哪一组演示。
uv run python "../../学习索引/参考实现/代码/ch14.py" 14-01

程序按题号输出处理后的值、查询结果或状态。先和前面的手算比较，再修改一项输入重跑。

查看本题运行结果

# 与上面的手算状态和题目数值逐项比较。
{
  "status": 200,
  "saved": "<em>阅读备注</em>",
  "escaped": true
}