这是《Python Web 全栈开发》的综合实战项目：用 Flask 造后端、Vue 3 造前端、 MySQL 存数据，三头合龙成一个真正上线的网站。它不只用来「看」——演示站、API、源码、图纸（流程图 / 原型图）、 十步开发教程全部公开，零基础也能照着一步步搭出同款。
项目的线上真身：注册 / 登录、赏文学、写书评、收藏、个人中心，点开即玩（数据存于浏览器本地；想调真后端请去 API 实验室）。
🧪全部接口的在线文档：点开任意接口 → Try it out → Execute，直接看到服务器返回的真实结果。
🧪接口的中文讲解 + 调试台：每个参数是什么意思、为什么要这么设计，配合 Swagger 一起用。
📚技术栈、目录结构、数据库设计、接口约定、部署方式与排错手册——把项目「说清楚」的那部分。
| 课程 | 在这个项目里负责 | 关键产出 |
|---|---|---|
| 课程一 · MySQL | 7 张表的库表设计 + SQL 脚本（hiwen.sql） | ER 图、建库脚本、索引与约束 |
| 课程二 · Flask | 18 个 REST 接口：统一响应、JWT 鉴权、分页、CORS | hiflask 工程蓝图（models / views / utils） |
| 课程三 · Vue 3 | 5 个页面 + axios 封装 + Pinia 登录态 + 路由守卫 | hivue 工程（Vite 构建，npm run build 即上线） |
# 窗口一：后端（MySQL 已导入 hiwen.sql 的前提下）
cd pyweb/code/hiflask
python -m venv venv && venv/bin/pip install -r requirements.txt # Windows: venv\Scripts\pip
python app.py # → http://127.0.0.1:5000/api/health
# 窗口二：前端
cd pyweb/code/hivue
npm install
npm run dev # → http://localhost:5173（Vite 已把 /api 代理给 5000）DB_ENGINE 换成 sqlite。这本身就是很好的一课：ORM 的意义就是让你换数据库不用改业务代码。