第15章 综合项目:学习平台

第 15 节 / 共 17 节 课程:前后端穿透

前面每一章都是一个零件。这一章把它们装成一台能跑的车:一个前后端分离的学习平台。目标不是“功能多”,而是“链路完整、能部署、能验收”。

前端工程 learning-front后端工程 learning-apisrc/main.jsApp.vuerouter/index.jsviews/ 页面components/ 组件api/ axios 封装vite.config.jspackage.jsonsrc/main/java/.../controller/service/repository/entity/resources/application.propertiespom.xml页面只做展示和交互接口只做业务和数据目录分开,责任才分得开;不要在前端写 SQL,也不要在 Controller 里拼页面。
图 2-1 两个工程、两条边界

15.1 项目范围

第一版只做四件事:

  1. 课程列表:显示已上架课程,按 sort_no 排序;
  2. 章节学习:左侧章节树,右侧正文,支持上一节/下一节;
  3. 登录:注册、登录、退出、当前用户;
  4. 练习:选择题作答、保存、批改、显示得分。

文件上传、后台管理、评论、支付先不做。范围越小,越容易真正上线。

同一套数据,两种职责浏览器(前端)Vue 3 + Vite模板与组件页面状态与交互表单校验与提示调用接口、渲染 JSON对用户可见的一切服务器(后端)Spring Boot + JPA接收请求、校验参数业务规则与权限事务、数据一致性读写数据库、返回 JSON对数据负责的一切HTTP 请求GET /api/...JSON 响应{ code, data }前端不信任用户输入,后端不信任前端校验;两边各自守住自己的边界。换一个客户端(小程序、App),后端接口仍然可以复用。
图 1-1 前后端分工:一个负责看见,一个负责正确

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 关键实现顺序

  1. 建库建表,插入 2 门课程、10 个章节;
  2. 后端跑通 /api/courses,用 curl 验证;
  3. 前端搭页面,接课程列表;
  4. 加章节接口与路由;
  5. 加登录与拦截器;
  6. 加答题与批改;
  7. 部署到 Nginx,配 HTTPS;
  8. 写 README 与部署脚本。

15.8 验收标准

维度合格不合格
功能主流程能走通点两下就 500
数据刷新后答案与得分还在只存在内存
权限未登录不能提交,不能看后台前端藏按钮但接口能调
部署重启服务器自动恢复手动 nohup 跑着
文档新人能按 README 跑起来只有作者会

15.9 本章练习

  1. 按上面的表建库,插入两门课程和十个章节。
  2. 完成课程列表与章节树两个接口,并用 curl 验证。
  3. 把项目部署到一台服务器,记录每一步命令。

下一章讲调试:接口 500、页面白屏、跨域、慢查询,分别怎么定位。