docs: update v1.5.0 docs - statistics API, PDF watermark, class teacher_id, sidebar order

This commit is contained in:
hmo
2026-04-27 21:39:18 +08:00
parent c4f5559c59
commit 13a3bed557
4 changed files with 78 additions and 8 deletions
+28 -4
View File
@@ -1,12 +1,12 @@
# 钢琴练习方案系统 - 部署 SOP
> 版本:v1.4.0
> 版本:v1.5.0
> 日期:2026-04-27
> 核心原则:**不删除,只备份后新增/替换**
---
## 重要更新(v1.4.0
## 重要更新(v1.5.0
### ⚠️ 问题文件已迁移到数据库
@@ -30,6 +30,17 @@ $env:HTTPS_PROXY="http://127.0.0.1:15000"
docker build -t piano-plan:latest .
```
### ⚠️ PDF 水印配置
PDF 水印文本在 API 设置页面(`/api-settings`)中配置,存储在 `api_config.json``watermark_text` 字段。
- 留空 = 不显示水印
- 填写文字 = 每页中央斜向显示该文字(56pt,25%透明度)
### ⚠️ 中文字体
Docker 镜像已内置 `fonts-wqy-microhei`,无需额外挂载。
---
## 一、部署原则(铁律)
@@ -384,7 +395,19 @@ A: 检查是否执行了 migrate_goals_v3.py 迁移脚本,该脚本创建 stud
---
## 十、检查清单(部署完成后必填)
```
[ ] 容器状态:running
[ ] 服务响应:HTTP 200/302
[ ] 数据库表完整:users, students, classes, student_problems, practice_plans, templates, problems, goals, goal_relations, student_goals, student_goal_evaluations
[ ] practice_plans 表有新字段:created_by, updated_by, updated_at, template_id, is_typical
[ ] 目标管理功能正常:创建目标、分配目标、评估目标
[ ] 时间线正常显示阶段评估和最终评估
[ ] API 配置正确
[ ] 功能验证:能生成练习方案
[ ] 方案列表支持删除
[ ] 学员列表"暂无方案/问题"样式正常
[ ] PDF 水印功能正常(配置后导出可见)
[ ] 数据统计页面正常显示
```
[ ] 容器状态:running
[ ] 服务响应:HTTP 200/302
@@ -404,6 +427,7 @@ A: 检查是否执行了 migrate_goals_v3.py 迁移脚本,该脚本创建 stud
| 版本 | 日期 | 变更 |
|------|------|------|
| v1.5.0 | 2026-04-27 | 数据统计页面(问题/级别分布可视化);PDF水印配置(可自定义文本);编辑页按钮吸底;侧边栏顺序调整;MySQL字体问题修复(Linux |
| v1.4.0 | 2026-04-27 | 典型方案采纳;推荐方案列表;方案编辑/详情页导航优化(bfcache处理);审计字段完善(created_by/updated_by/updated_at);方案列表支持删除;学员列表"暂无方案/问题"样式统一 |
| v1.3.6 | 2026-04-24 | 方案详情导航优化;典型方案开关移至方案详情;方案列表显示问题级别+严重程度 |
| v1.3.5 | 2026-04-24 | 班级班主任字段;用户姓名name字段;班级/学员/方案增加"我的"筛选 |
@@ -419,4 +443,4 @@ A: 检查是否执行了 migrate_goals_v3.py 迁移脚本,该脚本创建 stud
---
> **最后更新**2026-04-27
> **更新原因**v1.4.0 发布;问题文件已废弃(迁移到数据库);添加代理配置说明;审计字段;方案列表删除功能
> **更新原因**v1.5.0 发布;数据统计页面;PDF水印;编辑页吸底按钮;Linux中文字体路径