# Mission: 树莓派 RFID 点唱机(RPi-Jukebox-RFID 部署)

> `teach` 教学工作区协议文件,与 [项目说明](<./!项目说明.md>) 配套(项目说明管任务与进度,本文件管「为什么学」)。
> 教学决策(下节教什么、给哪些资源、设计什么练习)都回到这份文件上。

## Why

部署级项目最锻炼「读文档 → 采购 → 最小系统 → 跑通 → 定制」的完整链路,而且产出实物 —— 课设、简历、演示都用得上。这也是把 Linux、RFID 硬件、开源项目部署串成一件作品的最短路径。

## Success looks like

- 树莓派上从零部署 RPi-Jukebox-RFID,刷 RFID 卡能触发播放本地音乐/播客/网络电台
- Web 管理界面可用(能加卡、加音频、改配置)
- 完成至少一处自己的定制(如自定义卡映射、自写脚本、外壳/接线改良)
- 留下可复现的部署记录:每步命令、踩的坑、最后的实物照片或录屏

## Constraints

- 窗口 2026-09-01 → 2026-10-15;当前状态:阶段0 调研完成,待采购下单
- 硬件预算受限于学生身份:能用现有树莓派与外设就不额外买
- 环境:Linux 侧需在树莓派上实操(本机是 Windows)

## Out of scope

- 不改 RPi-Jukebox-RFID 的核心播放引擎源码(定制限定在外围:配置、脚本、硬件)
- 不在本项目学 PHP/Web 开发 —— 只到「能读懂配置与日志」为止
- 不并联 L-ink 名片项目(那是 `2026Q4-复刻L-ink智能名片` 的窗口)

---

配套文件:[RESOURCES.md](<./RESOURCES.md>)(资源与社群)· [NOTES.md](<./NOTES.md>)(教学偏好)· `lessons/`(课程)· `reference/`(速查卡)· `learning-records/`(学习记录,按需创建)