跟新项目结构说明文档

This commit is contained in:
zk
2026-04-28 11:17:47 +08:00
parent 22fa349e5c
commit 0c61b89736
+4 -1
View File
@@ -118,6 +118,7 @@ offerpie/back-end
│ ├─ ResumeDiagnosisIssueMapper.java # 简历诊断问题Mapper
│ ├─ JobAgentConfigMapper.java # 求职助手配置Mapper
│ ├─ JobAgentChatMessageMapper.java # 求职助手对话消息Mapper
│ ├─ UserJobCustomizeResumeMapper.java # 用户岗位定制简历Mapper
│ └─ AppJobDataMapper.java # 爬虫岗位原始数据Mapper
├─ pojo/
│ ├─ po/ # 持久化实体
@@ -159,6 +160,7 @@ offerpie/back-end
│ │ ├─ ResumeDiagnosisIssue.java # 简历诊断问题表(bg_resume_diagnosis_issue
│ │ ├─ JobAgentConfig.java # 求职助手配置表(bg_job_agent_config
│ │ ├─ JobAgentChatMessage.java # 求职助手对话消息表(bg_job_agent_chat_message
│ │ ├─ UserJobCustomizeResume.java # 用户岗位定制简历表(bg_user_job_customize_resume
│ │ └─ AppJobData.java # 爬虫岗位原始数据表(app_job_data
│ └─ vo/ # ViewObjectOssUrlVo、DescriptionParagraph、JobListItemVo、UserHonorsVo 等)
├─ resources/mapper/ # MyBatis XML 映射文件
@@ -172,7 +174,7 @@ offerpie/back-end
|------|----------|-----------|
| **client-api** | - 面向终端用户的 REST API <br> - 启动 Spring Boot 应用 <br> - 短信验证码登录(含自动注册、邀请码绑定) <br> - **功能权限校验**:注解 + 切面 + 权限服务(校验、扣减、回退) <br> - **路由菜单**:获取用户有效菜单树 <br> - **求职助手**:配置管理、AI岗位推荐、任务列表 | `ClientApplication``LoginController``RouteMenuController``JobController``JobAgentConfigController``UserResumeController``FuncPermission``FuncPermissionAspect``FuncPermissionService``RouteMenuService``JobService``JobAgentConfigService``UserRegisterService``RouteMenuVo` |
| **common** | - **统一配置**OSS、Redis、Security、WxPay、Sms、Async 等 <br> - **跨层工具**:HTTP、IP、认证、验证码、Redis Server 等 <br> - **全局拦截/切面**:日志、TraceId、黑名单、SQL 打印 <br> - **统一异常/响应**`GlobalExceptionAdvice``UnifiedResponse` <br> - **业务抽象**:邮件发送、微信支付(Native/JS/Transfer)、异步任务 <br> - **公共 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` <br> - **MyBatis Mapper**(对应全部业务实体的 Mapper,含 `JobAgentConfigMapper` <br> - **业务 API**:文件上传/下载、健康检查、地区/岗位分类/行业字典查询 <br> - **业务逻辑**OssService、SmsService、DictCacheService、JobCleanService、CompanyCleanService、UserProfileAnalyzeService、JobMatchService 等 <br> - **既供 B 端 UI(待实现)使用,也供 C 端业务直接调用** | `controller/`, `mapper/`, `pojo/po/`, `pojo/vo/`, `service/`, `constant/` |
| **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``UserJobCustomizeResume``AppJobData` <br> - **MyBatis Mapper**(对应全部业务实体的 Mapper,含 `JobAgentConfigMapper``UserJobCustomizeResumeMapper` <br> - **业务 API**:文件上传/下载、健康检查、地区/岗位分类/行业字典查询 <br> - **业务逻辑**OssService、SmsService、DictCacheService、JobCleanService、CompanyCleanService、UserProfileAnalyzeService、JobMatchService 等 <br> - **既供 B 端 UI(待实现)使用,也供 C 端业务直接调用** | `controller/`, `mapper/`, `pojo/po/`, `pojo/vo/`, `service/`, `constant/` |
## 3️⃣ 关键业务实体
| 实体 | 所属模块 | 作用概述 |
@@ -219,6 +221,7 @@ offerpie/back-end
| `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),文本存contentJSON数据存extra由前端维护。 |
| `UserJobCustomizeResume` | manager | 用户岗位定制简历表(bg_user_job_customize_resume),一个用户+一个岗位=一份定制简历,content字段存完整CustomizeResume JSON,唯一索引(user_id, job_id)。 |
## 4️⃣ 权限体系设计
### 整体架构