zk
32 KiB
32 KiB
inclusion
| inclusion |
|---|
| manual |
OfferPie Back‑End 项目结构说明
@zk
1️⃣ 项目整体层次
offerpie/back-end
│
├─ pom.xml # 父 Maven 项目，统一管理依赖、插件、属性
│
├─ client‑api/ # **C 端**（面向用户）API 服务
│ ├─ pom.xml
│ └─ src/main/java
│ └─ org.jiayunet
│ ├─ ClientApplication.java # Spring Boot 主入口
│ ├─ annotation/
│ │ └─ FuncPermission.java # 功能权限校验注解（标记在Controller方法上）
│ ├─ aop/
│ │ └─ FuncPermissionAspect.java # 功能权限校验切面（拦截注解，校验+扣减+异常回退）
│ ├─ controller/
│ │ ├─ LoginController.java # 登录相关接口（发送验证码、短信登录、检查登录状态）
│ │ ├─ RouteMenuController.java # 路由菜单接口（获取用户有效菜单树）
│ │ ├─ UserProfileController.java # 用户个人资料接口（主表+5张子表的查询与保存）
│ │ ├─ JobIntentionController.java # 求职意向接口（查询与保存）
│ │ ├─ JobController.java # 岗位接口（岗位列表查询、收藏、投递、不感兴趣、求职助手任务列表、AI岗位推荐）
│ │ ├─ JobAgentConfigController.java # 求职助手配置接口（配置查询与保存）
│ │ └─ UserResumeController.java # 用户简历接口（简历列表、主表及5张子表的查询与保存、子表单条添加/编辑/删除、简历删除、设置默认简历）
│ ├─ service/
│ │ ├─ LoginService.java # 登录业务逻辑（验证码校验、自动注册、JWT生成、Cookie设置）
│ │ ├─ UserRegisterService.java # 用户注册服务（注册逻辑、邀请码生成与绑定）
│ │ ├─ FuncPermissionService.java # 功能权限服务（校验、扣减、查询、添加库存、回退）
│ │ ├─ RouteMenuService.java # 路由菜单服务（查询、添加库存、获取用户菜单树）
│ │ ├─ UserProfileService.java # 用户个人资料服务（主表+5张子表的CRUD）
│ │ ├─ JobIntentionService.java # 求职意向服务（查询与保存/更新）
│ │ ├─ JobService.java # 岗位服务（岗位列表查询、匹配度计算编排、求职助手任务列表、AI岗位推荐）
│ │ ├─ JobAgentConfigService.java # 求职助手配置服务（配置查询与保存）
│ │ ├─ UserResumeService.java # 用户简历服务（简历列表、主表及5张子表的CRUD、子表单条添加/编辑/删除、设置默认简历）
│ │ └─ WxPayNotifyMessageAbstractImpl.java # 微信支付回调实现
│ └─ pojo/
│ ├─ param/
│ │ ├─ userProfile/ # 个人资料入参（UserProfileParam、各子表Param）
│ │ ├─ resume/ # 简历入参（ResumeParam、各子表Param、各子表UpdateParam、ResumeSubTableParam）
│ │ ├─ job/ # 岗位相关入参（JobIntentionParam、JobQueryParam、JobAgentTaskQueryParam、JobAgentRecommendParam）
│ │ └─ jobAgent/ # 求职助手入参（JobAgentConfigParam）
│ ├─ dto/
│ │ ├─ SmsLoginDto.java # 短信登录入参（mobileNumber + code + inviteCode）
│ │ ├─ userProfile/ # 个人资料出参（UserProfileDto、各子表Dto）
│ │ ├─ resume/ # 简历出参（ResumeDto、ResumeListItemDto、各子表Dto）
│ │ ├─ job/ # 岗位相关出参（JobIntentionDto、JobDto、JobMatchScoreDto、JobAgentRecommendDto）
│ │ └─ jobAgent/ # 求职助手出参（JobAgentConfigDto）
│ └─ vo/
│ ├─ LoginVo.java # 登录返回（userId + nick）
│ ├─ LanguageAbility.java # 语言能力对象（求职助手配置JSON字段）
│ └─ RouteMenuVo.java # 路由菜单树形VO（含children子菜单）
│
├─ common/ # **共享层**：被 C 端和 B 端共同使用的代码库
│ ├─ pom.xml
│ └─ src/main/java
│ └─ org.jiayunet
│ ├─ config/ # OSS、Redis、Security、WxPay、Sms、Async 等统一配置
│ ├─ tool/ # Http、IP、Redis、认证、验证码等工具类
│ ├─ interceptor/ # 全局拦截器（日志、TraceId、黑名单、SQL 统计等）
│ ├─ aop/ # AOP 日志切面
│ ├─ exception/ # 业务异常统一处理
│ ├─ email/ # 邮件发送抽象（EmailAbility）
│ ├─ ai/ # AI 对话能力封装（AiChatAbility、AiChatConfig）
│ ├─ wxPay/ # 微信支付相关能力（Js、Native、Transfer 等）
│ ├─ pojo/ # 公共 POJO（统一响应、登录/防重放 token 等）
│ └─ web/ # Spring MVC 全局响应体 advice
│
└─ manager/ # **B 端 + C 端共享** 的业务实现（尚未搭建完整的 B 端 UI）
├─ pom.xml
└─ src/main/java
└─ org.jiayunet
├─ constant/ # 常量枚举（OSS路径、短信模板等）
├─ controller/ # 对外 REST 接口（HealthCheck、Oss、字典查询等）
│ ├─ RegionController.java # 地区接口（树形/层级/搜索/批量查询）
│ ├─ JobCategoryController.java # 岗位分类接口（树形/层级/搜索/批量查询）
│ └─ IndustryController.java # 行业接口（树形/层级/搜索/批量查询）
├─ mapper/ # MyBatis Mapper
│ ├─ UserMapper.java
│ ├─ OssFileMapper.java
│ ├─ UserInviteMapper.java # 用户邀请记录Mapper
│ ├─ RouteMenuMapper.java # 路由菜单Mapper
│ ├─ FuncPermissionMapper.java # 功能权限Mapper
│ ├─ UserRouteMenuStockMapper.java # 用户路由菜单库存Mapper
│ ├─ UserFuncPermissionStockMapper.java # 用户功能权限库存Mapper
│ ├─ UserFuncUsageLogMapper.java # 用户功能使用记录Mapper
│ ├─ ChinaRegionsCodeMapper.java # 地区Mapper
│ ├─ JobCategoryMapper.java # 岗位类型Mapper
│ ├─ CompanyMapper.java # 公司Mapper
│ ├─ JobMapper.java # 岗位Mapper
│ ├─ JobRegionRelationMapper.java # 岗位-地区关联Mapper
│ ├─ JobSkillTagRelationMapper.java # 岗位-技能标签关联Mapper
│ ├─ IndustryMapper.java # 行业Mapper
│ ├─ SkillTagMapper.java # 技能标签Mapper（含insertIgnore自定义SQL）
│ ├─ MajorCategoryMapper.java # 专业分类Mapper
│ ├─ UserJobFavoriteMapper.java # 用户收藏岗位Mapper
│ ├─ UserJobApplicationMapper.java # 用户投递记录Mapper
│ ├─ UserJobDislikeMapper.java # 用户不感兴趣记录Mapper
│ ├─ UserJobIntentionMapper.java # 用户求职意向Mapper
│ ├─ UserProfileMapper.java # 用户个人资料Mapper
│ ├─ UserProfileEducationMapper.java # 用户教育经历Mapper
│ ├─ UserProfileWorkMapper.java # 用户工作经历Mapper
│ ├─ UserProfileInternshipMapper.java # 用户实习经历Mapper
│ ├─ UserProfileProjectMapper.java # 用户项目经历Mapper
│ ├─ UserProfileCompetitionMapper.java # 用户竞赛经历Mapper
│ ├─ UserProfileSkillTagRelationMapper.java # 用户技能标签关联Mapper
│ ├─ UserResumeMapper.java # 用户简历Mapper
│ ├─ UserResumeEducationMapper.java # 简历-教育经历Mapper
│ ├─ UserResumeWorkMapper.java # 简历-工作经历Mapper
│ ├─ UserResumeInternshipMapper.java # 简历-实习经历Mapper
│ ├─ UserResumeProjectMapper.java # 简历-项目经历Mapper
│ ├─ UserResumeCompetitionMapper.java # 简历-竞赛经历Mapper
│ ├─ ResumeDiagnosisReportMapper.java # 简历诊断报告Mapper
│ ├─ ResumeDiagnosisIssueMapper.java # 简历诊断问题Mapper
│ ├─ JobAgentConfigMapper.java # 求职助手配置Mapper
│ ├─ JobAgentChatMessageMapper.java # 求职助手对话消息Mapper
│ └─ AppJobDataMapper.java # 爬虫岗位原始数据Mapper
├─ pojo/
│ ├─ po/ # 持久化实体
│ │ ├─ User.java
│ │ ├─ OssFile.java
│ │ ├─ UserInvite.java # 用户邀请记录表（bg_user_invite）
│ │ ├─ RouteMenu.java # 路由菜单表（bg_route_menu）
│ │ ├─ FuncPermission.java # 功能权限表（bg_func_permission）
│ │ ├─ UserRouteMenuStock.java # 用户路由菜单库存表（bg_user_route_menu_stock）
│ │ ├─ UserFuncPermissionStock.java # 用户功能权限库存表（bg_user_func_permission_stock）
│ │ ├─ UserFuncUsageLog.java # 用户功能使用记录表（bg_user_func_usage_log）
│ │ ├─ ChinaRegionsCode.java # 地区表（bg_china_regions_code）
│ │ ├─ JobCategory.java # 岗位类型表（bg_job_category）
│ │ ├─ Company.java # 公司表（bg_company）
│ │ ├─ Job.java # 岗位表（bg_job）
│ │ ├─ JobRegionRelation.java # 岗位-地区关联表（bg_job_region_relation）
│ │ ├─ JobSkillTagRelation.java # 岗位-技能标签关联表（bg_job_skill_tag_relation）
│ │ ├─ Industry.java # 行业字典表（bg_industry）
│ │ ├─ SkillTag.java # 技能标签表（bg_skill_tag），AI自动入库，name唯一索引
│ │ ├─ MajorCategory.java # 专业分类表（bg_major_category），三级树形结构
│ │ ├─ UserJobFavorite.java # 用户收藏岗位表（bg_user_job_favorite）
│ │ ├─ UserJobApplication.java # 用户投递记录表（bg_user_job_application）
│ │ ├─ UserJobDislike.java # 用户不感兴趣记录表（bg_user_job_dislike）
│ │ ├─ UserJobIntention.java # 用户求职意向表（bg_user_job_intention）
│ │ ├─ UserProfile.java # 用户个人资料表（bg_user_profile）
│ │ ├─ UserProfileEducation.java # 用户教育经历表（bg_user_profile_education）
│ │ ├─ UserProfileWork.java # 用户工作经历表（bg_user_profile_work）
│ │ ├─ UserProfileInternship.java # 用户实习经历表（bg_user_profile_internship）
│ │ ├─ UserProfileProject.java # 用户项目经历表（bg_user_profile_project）
│ │ ├─ UserProfileCompetition.java # 用户竞赛经历表（bg_user_profile_competition）
│ │ ├─ UserProfileSkillTagRelation.java # 用户技能标签关联表（bg_user_profile_skill_tag_relation）
│ │ ├─ UserResume.java # 用户简历表（bg_user_resume，简历维度信息+个人基本信息合并存储）
│ │ ├─ UserResumeEducation.java # 简历-教育经历表（bg_user_resume_education）
│ │ ├─ UserResumeWork.java # 简历-工作经历表（bg_user_resume_work）
│ │ ├─ UserResumeInternship.java # 简历-实习经历表（bg_user_resume_internship）
│ │ ├─ UserResumeProject.java # 简历-项目经历表（bg_user_resume_project）
│ │ ├─ UserResumeCompetition.java # 简历-竞赛经历表（bg_user_resume_competition）
│ │ ├─ ResumeDiagnosisReport.java # 简历诊断报告表（bg_resume_diagnosis_report）
│ │ ├─ ResumeDiagnosisIssue.java # 简历诊断问题表（bg_resume_diagnosis_issue）
│ │ ├─ JobAgentConfig.java # 求职助手配置表（bg_job_agent_config）
│ │ ├─ JobAgentChatMessage.java # 求职助手对话消息表（bg_job_agent_chat_message）
│ │ └─ AppJobData.java # 爬虫岗位原始数据表（app_job_data）
│ └─ vo/ # ViewObject（OssUrlVo、DescriptionParagraph、JobListItemVo、UserHonorsVo 等）
├─ resources/mapper/ # MyBatis XML 映射文件
│ └─ JobMapper.xml # 岗位自定义SQL（selectJobPage）
└─ service/ # 业务 Service（OssService、SmsService、DictCacheService、JobCleanService、JobCleanTransactionService、CompanyCleanService、CompanyCleanTransactionService、UserProfileAnalyzeService、JobMatchService 等）
设计理念 – 业务实体和 Mapper 位于
manager，B 端和 C 端共享；C 端特有的注解、切面、权限服务、路由菜单服务位于client-api，避免 B 端误用；common提供统一的技术支撑。
2️⃣ 各层模块职责
| 层级 | 主要职责 | 关键类/包 |
|---|---|---|
| client-api | - 面向终端用户的 REST API - 启动 Spring Boot 应用 - 短信验证码登录（含自动注册、邀请码绑定） - 功能权限校验：注解 + 切面 + 权限服务（校验、扣减、回退） - 路由菜单：获取用户有效菜单树 - 求职助手：配置管理、AI岗位推荐、任务列表 |
ClientApplication、LoginController、RouteMenuController、JobController、JobAgentConfigController、UserResumeController、FuncPermission、FuncPermissionAspect、FuncPermissionService、RouteMenuService、JobService、JobAgentConfigService、UserRegisterService、RouteMenuVo |
| common | - 统一配置：OSS、Redis、Security、WxPay、Sms、Async 等 - 跨层工具：HTTP、IP、认证、验证码、Redis Server 等 - 全局拦截/切面：日志、TraceId、黑名单、SQL 打印 - 统一异常/响应： GlobalExceptionAdvice、UnifiedResponse - 业务抽象：邮件发送、微信支付（Native/JS/Transfer）、异步任务 - 公共 POJO：登录令牌、防重放信息等 |
config/, tool/, interceptor/, aop/, exception/, email/, wxPay/, pojo/ |
| manager | - 业务实体（User、OssFile、UserInvite、RouteMenu、FuncPermission、UserRouteMenuStock、UserFuncPermissionStock、UserFuncUsageLog、ChinaRegionsCode、JobCategory、Company、Job、JobRegionRelation、Industry、SkillTag、UserJobFavorite、UserJobApplication、UserJobDislike、UserJobIntention、UserProfile及5张子表、UserProfileSkillTagRelation、UserResume及5张子表、ResumeDiagnosisReport、ResumeDiagnosisIssue、JobAgentConfig、AppJobData） - MyBatis Mapper（对应全部业务实体的 Mapper，含 JobAgentConfigMapper） - 业务 API：文件上传/下载、健康检查、地区/岗位分类/行业字典查询 - 业务逻辑：OssService、SmsService、DictCacheService、JobCleanService、CompanyCleanService、UserProfileAnalyzeService、JobMatchService 等 - 既供 B 端 UI（待实现）使用，也供 C 端业务直接调用 |
controller/, mapper/, pojo/po/, pojo/vo/, service/, constant/ |
3️⃣ 关键业务实体
| 实体 | 所属模块 | 作用概述 |
|---|---|---|
User |
manager | 记录用户基础信息（手机号、邮箱、密码、昵称、微信绑定、邀请码等），配合 UserMapper 完成持久化。 |
OssFile |
manager | 描述 OSS（对象存储）中文件的元数据（路径、大小、标签等），通过 OssFileMapper 进行增删改查。 |
UserInvite |
manager | 用户邀请记录表，记录邀请人与被邀请人的关系及邀请时间。 |
RouteMenu |
manager | 路由菜单表（bg_route_menu），支持多级树形结构，通过 rootId/parentId 表达层级关系，openAccess 标识是否公开免费。 |
FuncPermission |
manager | 功能权限表（bg_func_permission），定义功能点编码（func_code，最长12字符，唯一约束），daily_free_count 配置每日免费次数。 |
UserRouteMenuStock |
manager | 用户路由菜单库存表（bg_user_route_menu_stock），记录用户拥有的菜单权限，支持时间维度。 |
UserFuncPermissionStock |
manager | 用户功能权限库存表（bg_user_func_permission_stock），记录用户拥有的功能权限，支持时间/次数/复合维度。 |
UserFuncUsageLog |
manager | 用户功能使用记录表（bg_user_func_usage_log），记录每次功能使用，用于免费次数统计和异常回退。 |
RouteMenuVo |
client-api | 路由菜单树形VO，包含 children 子菜单列表，供前端渲染动态路由。 |
LoginVo |
client-api | 登录成功后返回的用户信息（userId、nick）。 |
SmsLoginDto |
client-api | 短信验证码登录的请求参数（mobileNumber、code、inviteCode）。 |
ChinaRegionsCode |
manager | 地区表（bg_china_regions_code），行政区划编码，省/市/区三级，code为主键。 |
JobCategory |
manager | 岗位类型表（bg_job_category），树形结构，一级/二级分类。 |
Company |
manager | 公司表（bg_company），公司基本信息、融资、规模、新闻动态等。 |
Job |
manager | 岗位表（bg_job），岗位信息、薪资、标签、技能标签、要求专业、专业敏感度，关联公司和岗位类型。 |
JobRegionRelation |
manager | 岗位-地区关联表（bg_job_region_relation），一个岗位可关联多个地区。 |
UserJobFavorite |
manager | 用户收藏岗位表（bg_user_job_favorite），用户与岗位唯一约束。 |
UserJobApplication |
manager | 用户投递记录表（bg_user_job_application），记录投递状态流转。 |
Industry |
manager | 行业字典表（bg_industry），树形结构，一级/二级分类。 |
SkillTag |
manager | 技能标签表（bg_skill_tag），AI自动入库，name唯一索引，用于匹配度计算。 |
MajorCategory |
manager | 专业分类表（bg_major_category），基于教育部专业目录，三级树形结构，用于专业匹配。 |
UserJobDislike |
manager | 用户不感兴趣记录表（bg_user_job_dislike），记录用户对岗位的不感兴趣原因，冗余公司ID/地区编码/行业ID方便推荐过滤。 |
UserJobIntention |
manager | 用户求职意向表（bg_user_job_intention），存储意向岗位类型、城市、行业（JSON数组，节点可能为任意级别）和工作类型。 |
UserProfile |
manager | 用户个人资料表（bg_user_profile），存储身份证号、所在城市、微信号、作品集链接、专业IDs、学校等级、公司背书、经历时长、职责深度、量化产出、荣誉、技能标签、证书标签。 |
UserProfileEducation |
manager | 用户教育经历表（bg_user_profile_education，profile子表），学校、专业、学历、起止年份、描述段落（JSON对象数组）。 |
UserProfileWork |
manager | 用户工作经历表（bg_user_profile_work，profile子表），公司、职位、起止时间、描述段落（JSON对象数组）。 |
UserProfileInternship |
manager | 用户实习经历表（bg_user_profile_internship，profile子表），公司、职位、起止时间、描述段落（JSON对象数组）。 |
UserProfileProject |
manager | 用户项目经历表（bg_user_profile_project，profile子表），公司、项目名、角色、起止时间、描述段落（JSON对象数组）。 |
UserProfileCompetition |
manager | 用户竞赛经历表（bg_user_profile_competition，profile子表），竞赛名、奖项、获奖时间、描述段落（JSON对象数组）。 |
JobSkillTagRelation |
manager | 岗位-技能标签关联表（bg_job_skill_tag_relation），AI提取的技能标签与岗位的关联，用于匹配度计算。 |
UserProfileSkillTagRelation |
manager | 用户技能标签关联表（bg_user_profile_skill_tag_relation），记录用户匹配的技能标签，由AI自动识别生成。 |
AppJobData |
manager | 爬虫岗位原始数据表（app_job_data），存储爬虫抓取的原始岗位数据，供清洗服务读取并写入业务表。 |
UserResume |
manager | 用户简历表（bg_user_resume），简历维度信息（名称、目标岗位、默认标记、排序）+ 个人基本信息（姓名、联系方式、技能、证书、个人概述等）合并存储，一个用户可有多份简历。 |
UserResumeEducation |
manager | 简历-教育经历表（bg_user_resume_education），学校、专业、学历（文本）、学习形式（文本）、起止时间、描述段落。 |
UserResumeWork |
manager | 简历-工作经历表（bg_user_resume_work），公司、职位、起止时间、描述段落。 |
UserResumeInternship |
manager | 简历-实习经历表（bg_user_resume_internship），公司、职位、起止时间、描述段落。 |
UserResumeProject |
manager | 简历-项目经历表（bg_user_resume_project），公司、项目名、角色、起止时间、描述段落。 |
UserResumeCompetition |
manager | 简历-竞赛经历表（bg_user_resume_competition），竞赛名、奖项、获奖时间、描述段落。 |
ResumeDiagnosisReport |
manager | 简历诊断报告表（bg_resume_diagnosis_report），存储AI对简历的整体诊断评级（A/B/C/D）、整体评价和各类问题统计。 |
ResumeDiagnosisIssue |
manager | 简历诊断问题表（bg_resume_diagnosis_issue），存储AI对简历各模块的诊断发现、建议、改写内容，含紧急/重点/表达三类问题子类型计数。 |
JobAgentConfig |
manager | 求职助手配置表（bg_job_agent_config），一个用户一条记录，存储Agent模式、投递目标、网申常见问题预设答案（部门调剂、地点调剂、面试方式、语言能力、到岗时间、实习天数/时长）。 |
JobAgentChatMessage |
manager | 求职助手对话消息表（bg_job_agent_chat_message），记录用户与求职助手的完整对话流，含4种消息类型（user/assistant/recommend/apply_progress），文本存content，JSON数据存extra由前端维护。 |
4️⃣ 权限体系设计
整体架构
- 前端：路由控制菜单/页面可见性，登录后拉取用户有效菜单树（含公开免费菜单 + 库存授权菜单）
- 后端：AOP 切面拦截
@FuncPermission注解，校验权限 + 扣减库存，业务异常自动回退次数 - 权限来源：商品模块下单成功后写入库存表，权限框架不关心来源
数据库表（5张）
| 表名 | 说明 |
|---|---|
bg_route_menu |
路由菜单定义（树形结构，open_access 标识公开免费菜单） |
bg_user_route_menu_stock |
用户路由菜单库存（时间维度） |
bg_func_permission |
功能权限定义（func_code 唯一，daily_free_count 配置每日免费次数） |
bg_user_func_permission_stock |
用户功能权限库存（时间/次数/复合维度） |
bg_user_func_usage_log |
用户功能使用记录（每次使用插入，用于免费次数统计和异常回退） |
库存维度
time_limit+expire_time：时间维度，0=不限时，1=限时count_limit+remain_count：次数维度，0=不限次，1=限次- 两个维度独立控制，组合形成四种模式：永久不限次、限时不限次、永久限次、限时限次
- 添加库存时不降级：已经不限时/不限次的不会被覆盖
切面校验流程
- 拿注解上的 funcCode + 当前登录用户 userId
- 查 bg_func_permission（funcCode + status=1），拿到 dailyFreeCount
- dailyFreeCount > 0 → COUNT 今日使用记录，未超额 → 插入使用记录，放行
- 免费额度用完或无免费额度 → 查付费库存表（userId + funcCode）
- 无记录 → 无权限
- time_limit=1 且过期 → 已过期
- count_limit=0 → 插入使用记录，放行
- count_limit=1 → SQL 原子扣减
remain_count = remain_count - 1（WHERE remain_count > 0）→ 插入使用记录，放行 - 业务方法异常 → 删除使用记录 + 尝试回退库存次数（count_limit=1 时 remain_count + 1）
5️⃣ 共享技术栈（位于 common）
| 类别 | 关键实现 | 位置 |
|---|---|---|
| 配置 | OssConfig, RedissonConf, SecurityConfig, WxPayConfig, SmsConfig, AsyncConfig |
common/config |
| 安全 | JWT 过滤器、登录令牌 (RedisLoginTokenInfo)、防重放 (RedisPreventReplayInfo) |
common/interceptor、common/pojo/interceptor |
| 邮件 | EmailAbility（封装邮件发送） |
common/email |
| AI | AiChatAbility（OpenAI 兼容多供应商对话）、AiChatConfig（供应商配置） |
common/ai |
| 微信支付 | WxJsPayAbility, WxNativePayAbility, WxTransferPayAbility, WxPayNotifyController |
common/wxPay |
| 全局异常 | GlobalExceptionAdvice, BusinessException, BusinessExpCodeEnum |
common/exception |
| 日志 & AOP | ControllerLogAspect, LoggingOriginalRequestFilter, SqlLoggerInterceptor |
common/aop, common/interceptor |
| 工具类 | HttpTool, HttpIpTool, AuthenticTool, ObjectTool, VerifyImageCodeUtils |
common/tool |
| 统一返回体 | UnifiedResponse, UnifiedResponseBodyAdvice |
common/pojo, common/web |
| 批量/更新 | UpdateBatchMethod（批量更新策略） |
common/config |
6️⃣ 构建与运行
- 父 POM（
back-end/pom.xml）统一管理子模块的依赖与插件。 - 子模块 (
client-api,common,manager) 均可单独mvn clean install，生成各自的 jar 包。 - 启动入口：运行
client-api中的ClientApplication，Spring Boot 会自动扫描并加载common（配置、拦截、工具）以及manager中声明的 Mapper 与 Service。
7️⃣ 小结
- 项目采用 三层结构：
- client-api → C 端 REST 接口 + 功能权限校验（注解/切面/服务） + 路由菜单服务 + 用户注册与邀请。
- manager → 业务实体、Mapper 与业务 API，B 端 + C 端共享层。
- common → 所有层共同依赖的底层设施（配置、工具、拦截、异常、支付、邮件等）。
- 权限体系分两层：前端路由控制菜单可见性，后端切面控制功能点权限与库存扣减。
- 权限和菜单作为商品维度，框架只负责校验和库存管理，不关心权限来源。
4.7️⃣ 岗位列表与匹配度计算设计
整体架构
- 触发时机：用户访问岗位列表接口（支持筛选条件：地区/岗位类型/行业/工作类型）
- 核心流程：扩展层级筛选 → 查询不感兴趣记录 → 扩展排除列表 → SQL分页查询 → 查询收藏状态 → 批量计算匹配度 → 组装返回
- 匹配度计算：教育30% + 经历30% + 技能40%，在Java层批量计算
匹配度计算规则
总分公式：MatchScore = Sedu × 30% + Sexp × 30% + Sskill × 40%
教育维度（Sedu）
- 学校等级分（Srank）：1→100, 2→80, 3→60, 4→40
- 专业相关度（Smajor）：通过 bg_major_category 树形匹配，完全匹配→100，同二级→70，同一级→30，不相关→0
- 根据 majorSensitivity 决定权重：强制(学校0.4+专业0.6，专业<40则总分减半)、优先(学校0.6+专业0.4)、不限(仅学校分)
经历维度（Sexp）
Sexp = 公司背书×30% + 时长×10% + 经历深度×60%- 公司背书：1→100, 2→60, 3→30, 4→0
- 经历时长：1→100, 2→60, 3→30
- 经历深度 = 职责深度×40% + 量化产出×30% + 荣誉×30%
- 职责深度：1→100, 2→80, 3→40
- 量化产出：1→100, 2→70, 3→40
- 荣誉：封顶累加制（national每项20、provincial每项10、school每项5、paper每项15），总分不超过100
技能维度（Sskill）
- 岗位无要求 → 100分
- 用户无技能 → 0分
- 匹配0个 → 0分
- 匹配≥1个 → 30分保底 + 70分按比例：
30 + (匹配数量 / 岗位要求数量) × 70
核心服务
- JobService（client-api）：岗位列表查询主流程编排
- JobMatchService（manager）：批量计算匹配度（教育/经历/技能三个维度）
4.5️⃣ 用户简历分析设计
整体架构
- 触发时机：用户保存个人资料（主表或任意子表）后异步触发
- 分析流程：三次 AI 调用 → 第一次综合分析（学校等级、公司背书、经历时长、职责深度、量化产出、荣誉），第二次专业归一化（匹配到 bg_major_category ID），第三次技能提取（自由提取，入 bg_skill_tag）
- 数据存储：维度数据更新 bg_user_profile，技能全量替换 bg_user_profile_skill_tag_relation
核心流程
- 查询用户完整个人资料（主表 + 5张子表）
- 数据有效性检查（主表或所有子表为空 → 清空关联表）
- 第一次 AI 调用：综合分析（schoolRank、companyPrestige、experienceDuration、roleDepth、outputQuality、honors）→ 更新 bg_user_profile
- 第二次 AI 调用：专业归一化（传三级专业分类列表）→ 更新 bg_user_profile.major_ids
- 第三次 AI 调用：技能提取（自由提取，prompt与岗位侧一致）→ INSERT IGNORE 入 bg_skill_tag → 全量替换 bg_user_profile_skill_tag_relation
异步执行
- 使用 Spring
@Async注解，配置独立线程池 - 每次 AI 调用独立容错，某一次失败不影响其他维度
- 核心服务：UserProfileAnalyzeService（manager）
4.6️⃣ 邀请模块设计
数据库表（1张）
| 表名 | 说明 |
|---|---|
bg_user_invite |
用户邀请记录（记录邀请人与被邀请人的关系及邀请时间） |
核心逻辑
- 用户注册时自动生成10位邀请码（大写字母+数字），存入
User.invite_code，碰撞检查最多重试3次 - 注册时可携带
inviteCode，有效则写入邀请记录，无效仅日志警告不阻断注册 - 注册逻辑由
UserRegisterService独立承担，LoginService委托调用