更新:models/routes/services/templates/docs

This commit is contained in:
hmo
2026-04-26 18:02:36 +08:00
parent f7a82ac48a
commit 6abdd49c04
31 changed files with 1480 additions and 676 deletions
+18 -8
View File
@@ -1,7 +1,7 @@
# 钢琴练习方案系统 - 部署 SOP
> 版本:v1.3
> 日期:2026-04-24
> 版本:v1.3.6
> 日期:2026-04-26
> 核心原则:**不删除,只备份后新增/替换**
---
@@ -135,7 +135,7 @@ docker save piano-plan:v1.3.0 -o releases/v1.3.0/toRelease/program/piano-plan.ta
### 4.1 SSH 到服务器
```bash
ssh -i ~/.ssh/id_rsa root@47.106.65.108
ssh -i ~/.ssh/id_rsa root@47.115.32.206
```
### 4.2 创建版本目录并备份上次生产环境
@@ -163,14 +163,14 @@ cp -r /opt/piano-plan/config /opt/piano-plan/releases/v1.3.0/bk/config.bak.$(dat
exit # 先退出服务器 SSH
# 上传发布包
scp -i ~/.ssh/id_rsa -r releases/v1.3.0/toRelease/* root@47.106.65.108:/opt/piano-plan/releases/v1.3.0/toRelease/
scp -i ~/.ssh/id_rsa -r releases/v1.3.0/toRelease/* root@47.115.32.206:/opt/piano-plan/releases/v1.3.0/toRelease/
```
### 4.4 服务器执行部署
```bash
# SSH 再次连接
ssh -i ~/.ssh/id_rsa root@47.106.65.108
ssh -i ~/.ssh/id_rsa root@47.115.32.206
cd /opt/piano-plan/releases/v1.3.0
@@ -294,7 +294,7 @@ docker start piano-plan
| 项目 | 值 |
|------|-----|
| 生产地址 | https://piano.yoin.fun |
| SSH | `ssh -i ~/.ssh/id_rsa root@47.106.65.108` |
| SSH | `ssh -i ~/.ssh/id_rsa root@47.115.32.206` |
| 容器名 | piano-plan |
| 端口 | 5001 |
| 数据库位置 | piano-plan-data volume |
@@ -348,6 +348,9 @@ A: 检查数据库是否成功执行了 schema 迁移,新增了 goals, goal_re
### Q: SSE 不完整?
A: nginx 需要为 SSE 配置特定的代理设置,参考之前文档
### Q: v1.3.2 部署后评估功能不工作?
A: 检查是否执行了 migrate_goals_v3.py 迁移脚本,该脚本创建 student_goal_evaluations 表
---
## 十、检查清单(部署完成后必填)
@@ -355,8 +358,9 @@ A: nginx 需要为 SSE 配置特定的代理设置,参考之前文档
```
[ ] 容器状态:running
[ ] 服务响应:HTTP 200/302
[ ] 数据库表完整:users, students, classes, student_problems, practice_plans, problems, goals, goal_relations, student_goals
[ ] 数据库表完整:users, students, classes, student_problems, practice_plans, problems, goals, goal_relations, student_goals, student_goal_evaluations
[ ] 目标管理功能正常:创建目标、分配目标、评估目标
[ ] 时间线正常显示阶段评估和最终评估
[ ] API 配置正确
[ ] 功能验证:能生成练习方案
```
@@ -367,6 +371,12 @@ A: nginx 需要为 SSE 配置特定的代理设置,参考之前文档
| 版本 | 日期 | 变更 |
|------|------|------|
| v1.3.6 | 2026-04-24 | 方案详情导航优化(学员名→学员详情、返回按钮修复);典型方案开关移至方案详情;方案列表显示问题级别+严重程度;plan.content新增level字段;学员生成方案增加模板选择器;生成时禁用按钮;完成后显示提示词/报告字数;学员目标删除支持级联删除评估;目标模板删除增加依赖检查;API文档更新 |
| v1.3.5 | 2026-04-24 | 班级班主任字段;用户姓名name字段;班级/学员/方案增加"我的"筛选;用户管理:姓名字段+可编辑;方案管理:模板列表权限修复;时间线"我的"按钮样式优化 |
| v1.3.4 | 2026-04-24 | 方案编辑按钮;问题增量添加;teachers API公开;用户管理权限修复 |
| v1.3.3 | 2026-04-24 | 评估日期编辑;最终评估关联 StudentGoal 同步 |
| v1.3.2 | 2026-04-24 | StudentGoal 新增 status 字段;新增 StudentGoalEvaluation 表;阶段评估+最终评估功能;时间线增强(尚余天数/提前或延迟达成) |
| v1.3.1 | 2026-04-24 | DRY 规范;Fragment 复用方案;班级批量分配目标 |
| v1.3 | 2026-04-24 | 目标管理模块:Goal/GoalRelation/StudentGoal;问题分类重构;学习历程时间线 |
| v1.2 | 2026-04-23 | 问题迁移到数据库;移除个性化方案挂载 |
| v1.1 | 2026-04-20 | 模板管理;API配置界面 |
@@ -375,4 +385,4 @@ A: nginx 需要为 SSE 配置特定的代理设置,参考之前文档
---
> **最后更新**2026-04-24
> **更新原因**v1.3.1 代码更新;DRY 规范入撰;Fragment 复用方案;班级批量分配目标
> **更新原因**v1.3.6 发布;方案详情导航优化;典型方案开关移至详情页;列表显示级别+严重程度;生成方案增加模板选择器;提示词字数确认