# 00 今日改进总结与经验沉淀（2026-09-09/10 联合打磨记录）

> 对象：软件项目管理第 1 章课件（HTML 仿 PPT）＋教学包 v2.0
> 产出物目录：`dl-hub/22-软件项目管理教学包/课件成品-HTML/软件项目管理-16周课件/`
> 云端：http://111.231.0.226:1234/ （腾讯云 111.231.0.226，端口 1234，systemd `spm-web`）
> 本文件提取出**可复用的模板**（见本目录 01–06 模板文件与"引用文件"），供后续章节、其他课程直接套用。

---

## 一、今天做了什么（回顾时间线）

1. **教学包 v2.0 口径重校**：按广东金融学院学校文档把 64 学时/4 学分假设修正为 **32 学时/2 学分/纯理论**，考核改为**平时 30（作业20＋课堂10）＋期末 70**，章节学时分法对齐学校进度表，实验与综合项目转课外。
2. **课件工程化**：仿《第八章生成式人工智能》HTML 模板做出第 1 章课件 → 重构为**课程主页（16 次大课卡片）＋次课分页**结构 → 第 1 次课从 20+ 页充实到 **52 页**（约 90 分钟），其余 15 课占位"未开放观看"。
3. **云端发布**：打包上传腾讯云，systemd 静态服务端口 1234，配合安全组放行；建立一键更新流程。
4. **十三轮打磨**（详见第二节意见清单）：内容故事化、正反例、失败案例对比、交互化、字号下限、SVG 制图、拆页、口径清理、作业渠道等。

## 二、全部改进意见清单（含处理结果）

### A. 结构与导航
| # | 反馈 | 处理 |
|---|---|---|
| A1 | 首页应是课程主页，按教学安排分次大课 | 首页＝软件项目管理 16 张大课卡片（依《02-教学日历》），每次课独立 lectureN/ 分页 |
| A2 | 未制作的课不要写"制作中" | 占位页只显示"**未开放观看**＋返回主页按钮"，首页卡片标"🔒 未开放观看" |
| A3 | 授课教师信息上每次课首页 | 课程主页、第 1 次课封面/目录、占位页统一显示"授课教师：周宇文 ｜ 电话/微信" |
| A4 | 页数变化要同步 | 插入/拆分页后：总页数断言、TOC 分组、首页卡片、交叉引用页号（如"第 1.20 页→1.21"）全部重算 |

### B. 内容与表达
| # | 反馈 | 处理 |
|---|---|---|
| B1 | 案例背景内容太少、缺故事性 | 改为故事弧：**风暴→处境→回应→目标（三层次）→结局**（1.6） |
| B2 | 加失败案例对比 | 新增 IBM OS/360、微软 Vista、苹果 Newton/Lisa 对比页（1.10），形成"成败对照" |
| B3 | 5 大特征各举正反例 | 每个特征配 **✓ 正面例子＋✗ 反面例子（缺了这项会怎样）**（1.13） |
| B4 | 软件项目 3 特点也举例子 | 同上，正反例对照表（1.15） |
| B5 | 五要素怎么配合举正面例子 | 用"校园选课系统"贯穿示例列（1.32） |
| B6 | 表 1-2 分两页太散 | 合并为一页全表（字号微调），腾出的一页做"**怎么读：一行知识域的旅程**"讲解页 |
| B7 | 练习题一页放不下 | 一题一页（选择题每题 1 页）；填空题把**题干空白**放上来再揭晓 |
| B8 | 填空缺已知项没法答 | 题干改为补全式：**给出已知项＋空**（如"启动、＿＿、执行、＿＿、收尾"） |
| B9 | 作业改为学习通发布 | 作业页＝**学习通考试题库·必做**（含简答开放题），并同步《07 考核方案》与《00 总览》 |
| B10 | "不计学时学分"是废话 | 删除（32 学时课程本无独立学分口径） |
| B11 | 每章案例/知识点要有生活化例子 | 用"小组课程设计""校园选课系统"等学生熟悉场景类比 |

### C. 交互（学生可操作）
| # | 反馈 | 处理 |
|---|---|---|
| C1 | 选择题/速判应可选对也可选错 | 全部改造为**可点选**：选对绿✓锁定＋解析；选错红✗提示可继续，可"重新作答"；可多选（破冰题） |
| C2 | 提问/思考不要直接给答案 | 提问页统一"先思考→**揭晓按钮**"（案例思考、选型、绩效域、填空、鸿蒙选型等） |
| C3 | 可交互的载体 | styles.css 加 quiz 样式块＋独立 `quiz.js`（判分/揭晓/重置），生成器自动注入 |

### D. 视觉与投影
| # | 反馈 | 处理 |
|---|---|---|
| D1 | 拔下来的图太小 | 图片统一放大：证书类 400/360px，框架图 780px（约 2 倍），封面 260px |
| D2 | 字号太小、投影看不清 | 单页放映模式**字号下限**：正文 2.1rem、选项 2.0rem、按钮 1.7rem、表格 1.75rem、标签 1.35rem |
| D3 | 小结页文字堆叠难看 | 改 **SVG 流程图**（项目→软件项目→软件项目管理→五要素） |
| D4 | 分区页"全书地图在此展开"口吻差 | 改为 **SVG 五要素关系图**（价值交付系统居中＋四要素环绕连线） |
| D5 | 连线太短、标签被色块压住 | 左右节点外移、中间收窄，连线 30px→70px，标签居中于空隙 |
| D6 | 大图＋文字布局 | "左大图（55%）＋右要点卡片（42%）＋底部引述"三段式 |
| D7 | 左上 logo 看不清 | logo 加白底圆角（`background:#fff;border-radius:6px`） |

### E. 口径与"AI 味"清理（重要）
| # | 反馈 | 处理 |
|---|---|---|
| E1 | "教材与 PMBOK 一致是八大（不是九大）——别记错"是重大错误 | 整句删除（修订批注口吻，且"别记错/不是九大"是编辑痕迹） |
| E2 | 图片 caption 的加工来源 | "沿用学校课件图片/此处沿用/正式印刷请以教材为准"→ 中性图注"教材图 1-1" |
| E3 | 标题括号批注 | "案例思考（**教材原问，先写黑板**）""失败 9 大原因（**教材原文**）"等 → 去掉括号批注 |
| E4 | 课堂操作提示 | "（可举手表决）""（先口答，再揭晓）""课堂动作：请先写下""🗣 互动/开放讨论"→ 中性问句"💡 想一想/猜一猜/请判断" |
| E5 | 出处与内部编号外露 | "（原题出自教材…）""《06 综合小组项目实施方案》""（教材数据）""（呼应 1.3.1…）"→ 删除或改自然表述 |
| E6 | "全书都是这句话的展开" | 改为**课程主线**表述："本课程的主线：第 2 章启动→第 3–10 章知识域→第 16 周整合与复习" |
| E7 | "教材开篇案例/贯穿 1.1 与 1.2 全都能对上号" | 改为干净引导语"带着这个问题，开始今天的学习" |
| E8 | 教师名 | 学校报备文件写"潘琪"，实际授课"周宇文"——以教师确认为准并全站统一 |

### F. 部署与运维
| # | 反馈/事件 | 处理 |
|---|---|---|
| F1 | 80 被备课平台占用 | 课件用独立端口 1234；systemd `spm-web` 静态服务（开机自启＋崩溃重启） |
| F2 | 公网不通 | 服务端监听正常但安全组未放行→用户放行 TCP 1234 后 200 |
| F3 | 更新课件 | 本地 `python3 _build.py` → tar → scp → 解压覆盖 → `systemctl restart spm-web`（见《06 模板》） |

## 三、经验与收获（可迁移原则）

1. **学生页面只放"学生该看的内容"**：杜绝教学批注、出处注、课堂操作提示、内部文档编号、版本痕迹、AI 腔。发布前过一遍"禁词清单"（见《05 模板》）。
2. **能交互就不直接给答案**：判断/选择/填空/思考四类题型全部做成"点选判分"或"揭晓按钮"；揭晓内容用 `data-action="reveal"` 隐藏，点击才显示。
3. **投影要有字号下限**：正文 ≥2.1rem；选项/按钮 ≥1.7–2.0rem；密页**拆页**，选择题**一题一页**。
4. **填空题题干必须补全已知项**（"启动、＿＿、执行、＿＿、收尾"），否则学生无法作答。
5. **概念配正反例**（✓ 正面＋✗ 反面"缺了这项会怎样"）显著降低理解门槛；复杂关系用**贯穿示例**（选课系统、小组课程设计）。
6. **讲故事**：案例按"冲突→处境→回应→目标→结局"组织；再配一个**失败案例**做对照，说服力更强。
7. **图优先、字精简**：能用 SVG 就画 SVG；大图与文字用"左图右要点＋底部引述"布局；画完检查**连线长度与标签是否被色块遮挡**。
8. **页码是全局状态**：插入/拆分页后必须重算总页数、TOC 分组、首页卡片、交叉引用，不能只改一处。
9. **口径有唯一事实源**：学校文档（大纲/进度表/考核方案）> 教师实际安排 > 模板默认值；文档之间打架时（如考核方案 30/70 vs 大纲正文 10/10/80）要显式标注让教师定夺，不要自作主张。
10. **工程化与记录**：`_build.py` 一键重建、版本沿革文件（`_沿革与待办.md`）防口径回退、`_素材/` 预抽取学校 PPT 文本与图片供后续章节使用。
11. **云发布流水线**：tar→scp→systemd restart + 安全组放行；更新流程固化到记录文件，避免每次重查。

## 四、遗留待办（教师侧）
- [ ] 统一学校两文档考核差异：考核方案"平时30＋期末70" vs 大纲正文"作业10＋课堂10＋期末80"（本包按 30/70）
- [ ] 教材版次核对（宋莹莹等，清华大学出版社 2025；大纲标注"第 3 版"）
- [ ] 第 2–16 次课课件逐课制作（素材已抽取在 `_素材/学校PPT文本/` 与 `assets/chN/`）
- [ ] 把《08-各章自测题库》整理成学习通题库导入格式
- [ ] （可选）HTTPS：nginx 443→1234 反代