鸡翅Club项目学习文档 - 第一部分

## 学习进度 - [x] 第一部分项目整体架构与核心概念 - [ ] 第二部分设计模式详解 - [ ] 第三部分代码实战演练 --- ## 一、项目概述 ### 1.1 项目定位 | 项目名称 | 鸡翅Club刷题系统 | |----------|------------------| | 英文名 | jc-clubjingdianjichi club | | 项目类型 | 刷题系统类似刷题宝、题库系统 | | 架构风格 | 微服务 DDD领域驱动设计 | | 核心功能 | 题目管理、刷题练习、社交圈子、用户认证 | ### 1.2 类比理解 把这个项目想象成一个程序员版的刷题APP就像考研刷题软件但专门刷Java面试题。 --- ## 二、微服务架构 ### 2.1 什么是微服务 **核心特点**每个服务独立运行 **类比理解**想象一家大型餐厅 - 前台服务接待客人、安排座位 - 厨房服务负责做菜 - 收银服务负责结账 - 采购服务负责买菜 每个部门独立运行这就是微服务的思想——按**业务职责**划分。 ### 2.2 本项目的微服务划分 | 服务名 | 业务职责 | 类比 | |--------|----------|------| | jc-club-gateway | 统一入口、路由转发 | 餐厅大门引导员 | | jc-club-auth | 用户登录、权限管理 | 前台验票员 | | jc-club-subject | 题目增删改查 | 厨房管理菜谱 | | jc-club-practice | 刷题练习、记录成绩 | 上菜服务员 | | jc-club-circle | 发动态、评论、点赞 | 餐厅社交区 | | jc-club-oss | 文件上传下载 | 仓库管理员 | ### 2.3 区分服务的关键 看它负责什么**业务功能** --- ## 三、DDD分层架构 ### 3.1 什么是DDD **DDD** Domain-Driven Design领域驱动设计 **对比MVC和DDD** | MVC技术视角 | DDD业务视角 | 类比角色 | |----------------|----------------|----------| | Controller | application层应用层 | 服务员接单转达 | | Service | domain层领域层 | 厨师核心业务逻辑 | | DAO/Mapper | infra层基础设施层 | 采购员提供原材料 | | Entity | BO业务对象 | 菜谱里的菜品 | | DTO | DTO数据传输对象 | 顾客菜单上看到的菜名 | **核心区别** - MVC按代码类型划分 - DDD按业务含义划分Domain层承载核心业务知识 ### 3.2 DDD六层架构 | 层级 | 职责 | 类比 | |------|------|------| | **api层** | 定义给其他服务调用的接口 | 餐厅外卖窗口 | | **application层** | 接收请求、转换数据、MQ消费者 | 服务员 | | **domain层** | 核心业务逻辑、策略处理器 | 厨师 | | **infra层** | 数据库操作、外部服务调用 | 采购员 | | **common层** | 公共工具、枚举 | 公共设施 | | **starter层** | SpringBoot启动入口 | 餐厅开门营业 | ### 3.3 各层分割点重点 **Controller和Domain Service的分割** | Controller | Domain Service | |------------|----------------| | ✅ 接收HTTP请求参数 | ✅ 写业务判断逻辑if-else | | ✅ DTO转BO | ✅ 调用Infra层查数据 | | ✅ 调用Domain Service | ✅ 组合多个数据 | | ✅ BO转DTO返回 | ❌ 不接收HTTP请求参数 | | ❌ 不写业务判断逻辑 | ❌ 不返回HTTP响应 | | ❌ 不直接查数据库 | ❌ 不写SQL语句 | **Domain Service和Infra的分割** | Domain Service | Infra/Mapper | |----------------|--------------| | ✅ 决定要查什么数据 | ✅ 写SQL语句 | | ✅ 决定要存什么数据 | ✅ 直接操作数据库 | | ✅ 写业务判断逻辑 | ❌ 不写业务判断 | | ❌ 不写SQL语句 | ❌ 不写业务逻辑 | **一句话记住边界** | 层 | 边界口诀 | |----|----------| | Controller | 只管进门出门不写业务判断 | | Domain Service | 只管业务怎么干不写SQL | | Infra/Mapper | 只管数据库操作不写业务判断 | ### 3.4 BO和Domain Service的分割重点 **BO**数据对象 **Domain Service**操作对象 | 情况 | 写在BO | 写在Domain Service | |------|--------|---------------------| | 只涉及自己如我是单选题吗 | ✅ | ❌ | | 涉及多个对象如题目分类标签 | ❌ | ✅ | | 需要查数据库 | ❌ | ✅ | | 简单判断 | ✅ | 都可以 | | 复杂业务流程 | ❌ | ✅ | **简单记忆法** | BO | Domain Service | |-----|----------------| | 自己的事自己管 | 多个对象的事我来管 | | 不查数据库 | 可以查数据库 | | 简单判断 | 复杂流程 | --- ## 四、核心技术栈 ### 4.1 技术概览 | 技术 | 版本 | 作用 | |------|------|------| | Spring Boot | 2.4.2 | 基础框架 | | Spring Cloud | 2020.0.6 | 微服务框架 | | Spring Cloud Alibaba | 2021.1 | Nacos服务发现/配置 | | Java | 1.8 | 开发语言 | | Sa-Token | - | 认证授权 | | MySQL | - | 主数据库 | | Redis | - | 缓存 | | RocketMQ | - | 消息队列 | | XXL-Job | - | 定时任务 | | Elasticsearch | - | 全文搜索 | | MinIO | - | 对象存储 | ### 4.2 各技术详解 #### MySQL - 主数据库 **类比**图书馆书架存得多但找书慢 **用途**存储题目、用户、分类等核心数据 --- #### Redis - 内存缓存 **类比**手边的笔记本存得少但翻开就能看到 **用途** - 缓存热点数据题目分类、标签列表 - 用户登录态存储 - 点赞计数 - 分布式锁 --- #### RocketMQ - 消息队列 **类比**奶茶店排队系统 **用途**异步处理、削峰填谷 **举例**用户点赞 用户点赞 → 发到RocketMQ排队 → 后台慢慢处理 → 写入数据库 **好处** 1. 削峰填谷高峰期不崩溃 2. 解耦各模块独立 3. 可靠消息不丢失 --- #### XXL-Job - 定时任务 **类比**系统闹钟 **用途**定时执行后台任务 **举例**同步点赞数据 Redis点赞数据 → 定时任务 → 同步到MySQL --- #### Elasticsearch - 全文搜索 **类比**超级目录 **用途**全文搜索 **对比MySQL** | MySQL | Elasticsearch | |-------|---------------| | 精确查询按ID查 | 全文搜索按关键词搜 | | 存数据为主 | 搜索为主 | | 翻书找内容 | 翻目录找内容 | --- #### Nacos - 服务发现/配置中心 **类比**微服务的电话簿 配置公告栏 **两个作用** | 功能 | 说明 | |------|------| | 服务发现 | 各服务启动时告诉Nacos我在哪其他服务通过Nacos找到它 | | 配置中心 | 所有服务的配置文件放在Nacos统一管理 | **流程** jc-club-subject启动 → 告诉Nacos我在IP 192.168.1.100 jc-club-auth想调用subject → 问Nacossubject在哪 → Nacos回答 --- ## 五、数据库设计 ### 5.1 题目相关表 | 表名 | 作用 | |------|------| | subject_info | 题目基本信息题目名、类型、难度 | | subject_radio | 单选题的选项和答案 | | subject_multiple | 多选题的选项和答案 | | subject_judge | 判断题的答案对/错 | | subject_brief | 简答题的答案文本 | | subject_category | 题目分类 | | subject_label | 题目标签 | | subject_mapping | 题目与分类、标签的关联关系 | | subject_liked | 题目点赞记录 | ### 5.2 设计要点 **题型字段区分** - subject_type 1 → 单选题 - subject_type 2 → 多选题 - subject_type 3 → 判断题 - subject_type 4 → 简答题 **答案分开存储** 每种题型一张表因为答案格式不同 - 单选题选项A、B、C、D - 简答题一段文字 **关联表设计** subject_mapping用于记录题目、分类、标签的多对多关系。 --- ## 六、BO/DTO/Entity详解 ### 6.1 三者对比 | 对象 | 全称 | 作用 | 所在层级 | 类比 | |------|------|------|----------|------| | **Entity** | 实体对象 | 直接映射数据库表字段 | infra层 | 仓库里的货物 | | **BO** | 业务对象 | 承载业务数据带业务含义 | domain层 | 分拣中心的包裹 | | **DTO** | 数据传输对象 | 给前端/其他服务用的数据 | application层 | 送到客户手里的包裹 | ### 6.2 举例说明 **Entity**infra层 java // 和数据库字段一一对应 public class SubjectInfo { private Long id; private String subjectName; private Integer subjectType; private Integer isDeleted; // 用户不需要看到 } **BO**domain层 java // 带业务含义过滤无用字段 public class SubjectInfoBO { private Long id; private String subjectName; private Integer subjectType; // 不需要isDeleted // 可能加上分类名、标签列表 } **DTO**application层 java // 给前端展示用 public class SubjectInfoDTO { private Long id; private String subjectName; private String subjectTypeDesc; // 简答题而不是数字4 } ### 6.3 为什么要转换 1. **隔离变化**数据库改字段不影响业务层和前端 2. **安全**isDeleted敏感字段不会传给用户 3. **业务含义**BO可以加业务逻辑DTO可以加展示格式化 4. **复用**同一业务逻辑可被多处调用Controller、MQ、定时任务 ### 6.4 转换流程 数据库数据(Entity) ↓ BOConverter转换 业务处理(BO) ↓ DTOConverter转换 返回前端(DTO) --- ## 七、完整请求流程 ### 7.1 流程图 用户发起请求 ↓ 【Gateway网关】路由到对应服务 ↓ 【Controller】接收HTTP请求DTO转BO ↓ 【Domain Service】处理业务逻辑 ↓ 【Infra/Mapper】查询数据库 ↓ 【数据库/Redis】返回数据Entity ↓ 【Infra层】Entity转BO ↓ 【Domain Service】组合业务数据 ↓ 【Controller】BO转DTO ↓ 返回给用户 ### 7.2 代码示例 **Controller** java GetMapping(/query) public Result query(RequestParam Long id) { // 调用Domain Service SubjectInfoBO bo domainService.query(id); // BO转DTO SubjectInfoDTO dto converter.convert(bo); return Result.success(dto); } **Domain Service** java public SubjectInfoBO query(Long id) { // 业务判断 if (id null) throw new Exception(); // 调用Infra查数据 SubjectInfo entity subjectInfoService.getById(id); Integer likedCount redisUtil.get(liked: id); // 组合成BO SubjectInfoBO bo convert(entity); bo.setLikedCount(likedCount); return bo; } **Infra/Mapper** java Select(select * from subject_info where id #{id}) SubjectInfo selectById(Long id); ### 7.3 涉及技术 | 步骤 | 用到的技术 | |------|------------| | 网关路由 | Spring Cloud Gateway | | 登录认证 | Sa-Token | | 数据库查询 | MySQL MyBatis | | 缓存点赞数 | Redis | | 转换对象 | BO/DTO Converter | --- ## 八、学习小结 ### 8.1 已掌握内容 - [x] 项目整体定位鸡翅Club刷题系统 - [x] 微服务概念与划分 - [x] DDD六层架构 - [x] 各层分割点 - [x] BO/DTO/Entity区别与转换 - [x] 核心技术栈MySQL、Redis、RocketMQ、XXL-Job、ES、Nacos - [x] 数据库表结构设计 - [x] 完整请求流程 ### 8.2 核心概念速记 | 概念 | 一句话总结 | |------|------------| | 微服务 | 按业务职责划分独立运行 | | DDD | 按业务含义分层Domain层承载业务知识 | | Controller | 只管进门出门不写业务判断 | | Domain Service | 只管业务怎么干不写SQL | | Infra | 只管数据库操作不写业务判断 | | BO | 自己的事自己管不查数据库 | | Redis | 内存缓存加速查询 | | RocketMQ | 消息队列异步排队 | | XXL-Job | 定时任务系统闹钟 | | Elasticsearch | 全文搜索超级目录 | | Nacos | 服务发现电话簿 | --- ## 九、下一部分预告 - 设计模式详解策略模式 - 代码实战演练 - 添加新功能实践