C54

后端综合

任务说明

Python 本机运行

后端综合题：完成学习记录模块的三块拼图——数据类（StudyRecord 已给）、入参校验（add_record 内完成，规则同 C48：缺字段/空文本/超长标题/minutes 1-240/status 枚举）、sqlite 持久化与统计查询。标准库 sqlite3 内存库，init_db 已提供。测试覆盖全部行为：合法写入、非法拦截（不落库）、列表与筛选、统计口径。

要求

def add_record(conn, payload: dict) -> StudyRecord：校验通过后插入 study_records 表并返回带 id/created_at 的 StudyRecord；校验失败抛 ValueError 且不写入
校验规则：id/title/minutes/status 必填；id 正整数（bool 不算）；title 非空、去空白后 ≤50 字（入库保存去空白值）；minutes 1-240 的整数；status ∈ todo/doing/done
def list_records(conn, status=None)：按 id 升序返回 StudyRecord 列表；status 非 None 时筛选，取值不在枚举内抛 ValueError
def stats(conn) -> dict：返回 {"total": 总条数, "total_minutes": minutes 总和, "by_status": {"todo": n, "doing": n, "done": n}}（三种状态都出现，没数据为 0）
只使用标准库（dataclasses + sqlite3 + datetime）；不要改动 init_db 的表结构

P19 学习记录 API 实战 P05 类型标注与数据模型 P11 数据库与持久化

分层提示

先自己试，再逐层展开。

参考答案

卡住时再看；查看操作会记录下来用于复盘。测试版本 1.0.0

后端综合

Command Palette