# 实训内容清单 · 一本书 10 个实训（全英文命名）

> 主文件夹：`03_practicum_labs`　解释器：`.venv\Scripts\python.exe`（依赖已装齐）
> 每个实训都是一套完整交付：代码 + README + run.bat + 页面截图 + 标注图 + 自包含 walkthrough.html

## 一、十个实训一览

| # | 目录 | 内容 | 端口 | 手册 |
|---|---|---|---|---|
| 01 | `lab01_flask_routing` | 路由四件套：固定/动态/转换器/跳转与 404 | 5110 | `walkthrough.html` |
| 02 | `lab02_request_response` | request 对象、Cookie、Session、自定义状态码 | 5111 | `walkthrough.html` |
| 03 | `lab03_web_frontend` | HTML/CSS/JS/Bootstrap 六节 | 5112 | `walkthrough.html` |
| 04 | `lab04_jinja2_templates` | 模板继承、宏、过滤器、include | 5113 | `walkthrough.html` |
| 05 | `lab05_forms_and_upload` | 表单校验、CSRF、安全上传、富文本 | 5101 | `walkthrough.html` |
| 06 | `lab06_sqlalchemy_crud` | 模型、建表、增删改查、分页 | 5115 | `walkthrough.html` |
| 07 | `lab07_flask_migrate` | 迁移三板斧：init / migrate / upgrade | 5129 | `walkthrough.html` |
| 08 | `lab08_app_factory_blueprints` | 应用工厂、扩展单例、蓝图、flask CLI | 5116 | `walkthrough.html` |
| 09 | `lab09_flask_login` | 登录/登出、密码哈希、权限保护 | 5117 | `walkthrough.html` |
| 10 | `lab10_blog_project` | 综合项目：登录+发文+列表+详情+删除 | 5118 | `walkthrough.html` |

## 二、每个实训文件夹里有什么

```
labNN_xxx/
├─ app.py              代码（英文标识符，一行中文短注释）
├─ README.md           运行方式 / 路由表 / 验收点 / 指令
├─ notes.md            知识点与代码的对应关系
├─ run.bat             双击启动（自动用项目 .venv）
├─ walkthrough.html    图文手册（图片全部内嵌，单文件 1–4 MB）
├─ report_labNN.docx  实训报告（图文并茂，可直接上交）
├─ knowledge/ 由 ../../knowledge/ch0N.md 提供本讲 PPT 知识点
└─ screenshots/
   ├─ pycharm_editor.png / pycharm_run.png   本 lab 在 PyCharm 里打开+运行
   ├─ pages/           全部 GET 路由截图（index.json 记录路由/状态码/说明）
   └─ annotated/       带红框、箭头、编号的标注图
```

## 三、三种启动方式

| 方式 | 怎么做 | 适合 |
|---|---|---|
| PyCharm | 右上角配置选「labNN…（端口）」→ 绿三角 | 上课演示 |
| 双击 | 进实训文件夹双击 `run.bat` | 学生自己练 |
| 命令行 | `..\.venv\Scripts\python.exe app.py` | 排错 |

## 四、通用指令

```bat
:: 看本实训的路由
..\.venv\Scripts\python.exe -m flask --app app routes

:: 清空所有实训的数据库，回到第一次上课的状态
..\.venv\Scripts\python.exe reset_all.py

:: 建环境（换电脑时）
setup_env.bat
:: 把 .venv 登记成 PyCharm 解释器（关掉 PyCharm 后跑）
fix_interpreter.ps1
```

**lab07 额外**：`-m flask --app app db upgrade` / `db current` / `db history`
**lab08 额外**：`-m flask --app app init-db` / `shell`

## 五、配套文档

| 文件 | 用途 |
|---|---|
| `RUN_COMMANDS.md` | 10 个实训的端口与全部运行指令 + 中文路径实测结论 |
| `SOP_ADD_A_LAB.md` | 再加/重做实训的标准流程（脚本化） |
| `START_HERE.md` | 学生第一课：装解释器 → 跑起来 → 看手册 |
| `LABS_OVERVIEW.md` | 本文件 |
