第15章 综合项目:学习平台
第 15 节 / 共 17 节
课程:前后端穿透
前面每一章都是一个零件。这一章把它们装成一台能跑的车:一个前后端分离的学习平台。目标不是“功能多”,而是“链路完整、能部署、能验收”。
15.1 项目范围
第一版只做四件事:
- 课程列表:显示已上架课程,按 sort_no 排序;
- 章节学习:左侧章节树,右侧正文,支持上一节/下一节;
- 登录:注册、登录、退出、当前用户;
- 练习:选择题作答、保存、批改、显示得分。
文件上传、后台管理、评论、支付先不做。范围越小,越容易真正上线。
15.2 技术选型
| 层 | 选择 | 理由 |
|---|---|---|
| 前端 | Vue 3 + Vite + Vue Router 4 + axios | 上手快,构建快,生态成熟 |
| 后端 | Spring Boot 3 + Java 17 | 企业常用,资料多 |
| 数据库 | MySQL 8 + InnoDB | 事务、索引、运维成熟 |
| 部署 | Nginx + systemd | 单机足够,结构清晰 |
| 版本控制 | Git | 分支、回滚、审计 |
15.3 目录结构
study-platform/
frontend/
src/
api/ # 接口封装
components/ # 通用组件
views/ # 页面
router/ # 路由
stores/ # 状态(可选)
assets/
vite.config.js
backend/
src/main/java/cn/jssp/study/
controller/
service/
repository/
entity/
dto/
common/ # Result、异常、拦截器
src/main/resources/application.yml
deploy/
nginx.conf
study.service
15.4 数据库设计
CREATE TABLE course (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(20) NOT NULL,
intro VARCHAR(1200),
bref VARCHAR(20),
valid CHAR(1) NOT NULL DEFAULT '0',
sort_no INT NOT NULL DEFAULT 0,
datetime DATETIME DEFAULT CURRENT_TIMESTAMP
);
CREATE TABLE chapter (
id INT PRIMARY KEY AUTO_INCREMENT,
course_id INT NOT NULL,
code VARCHAR(20) NOT NULL,
name VARCHAR(30) NOT NULL,
content MEDIUMTEXT,
parent_code VARCHAR(20) NOT NULL DEFAULT '000000',
score INT DEFAULT 0,
UNIQUE KEY uk_course_code (course_id, code),
KEY idx_course (course_id, code)
);
CREATE TABLE quiz (
id INT PRIMARY KEY AUTO_INCREMENT,
chapter_id INT NOT NULL,
type TINYINT NOT NULL,
title VARCHAR(255) NOT NULL,
options TEXT,
answer VARCHAR(255),
score INT DEFAULT 2,
KEY idx_chapter (chapter_id)
);
课程用 valid 控制上下架,用 sort_no 控制顺序;章节用 code 表达层级(010000 是一级,010100 是二级)。这样前端不用递归查 parent_id。
15.5 接口清单
| 方法 | 路径 | 作用 | 是否登录 |
|---|---|---|---|
| GET | /api/courses | 已上架课程列表 | 否 |
| GET | /api/chapters?courseId=39 | 章节树 | 否 |
| GET | /api/chapter/{code} | 章节正文 | 否 |
| POST | /api/login | 登录 | 否 |
| GET | /api/me | 当前用户 | 是 |
| POST | /api/logout | 退出 | 是 |
| POST | /api/quiz/submit | 提交答案 | 是 |
| GET | /api/quiz/result?chapterId=1 | 本章得分 | 是 |
接口先定,前后端可以并行。前端用 mock 数据先写页面,后端按契约实现,最后联调只对字段。
15.6 四个迭代
| 迭代 | 目标 | 验收 |
|---|---|---|
| 第 1 周 | 项目骨架、课程列表、章节树 | 首页能看到课程,点进去能看章节 |
| 第 2 周 | 登录、当前用户、退出 | 未登录不能提交,登录后状态保持 |
| 第 3 周 | 答题、保存、批改、得分 | 答对得分,刷新后答案还在 |
| 第 4 周 | Nginx 部署、HTTPS、日志 | 公网可访问,刷新不 404 |
每个迭代结束都要能演示,而不是“代码写完了但跑不起来”。不能演示的进度等于零。
15.7 关键实现顺序
- 建库建表,插入 2 门课程、10 个章节;
- 后端跑通
/api/courses,用 curl 验证; - 前端搭页面,接课程列表;
- 加章节接口与路由;
- 加登录与拦截器;
- 加答题与批改;
- 部署到 Nginx,配 HTTPS;
- 写 README 与部署脚本。
15.8 验收标准
| 维度 | 合格 | 不合格 |
|---|---|---|
| 功能 | 主流程能走通 | 点两下就 500 |
| 数据 | 刷新后答案与得分还在 | 只存在内存 |
| 权限 | 未登录不能提交,不能看后台 | 前端藏按钮但接口能调 |
| 部署 | 重启服务器自动恢复 | 手动 nohup 跑着 |
| 文档 | 新人能按 README 跑起来 | 只有作者会 |
15.9 本章练习
- 按上面的表建库,插入两门课程和十个章节。
- 完成课程列表与章节树两个接口,并用 curl 验证。
- 把项目部署到一台服务器,记录每一步命令。
下一章讲调试:接口 500、页面白屏、跨域、慢查询,分别怎么定位。
《前后端穿透》课程目录
从浏览器里的一次点击出发,把 Vue 3 前端、Spring Boot 后端、MySQL 与 Nginx 串成一条完整链路