修改bug 完善文档

2026-03-26 20:14:45 +08:00
parent e3dcfde190
commit 7f917991f5
5 changed files with 146 additions and 500 deletions
@@ -86,7 +86,8 @@ offerpie/back-end
            │   ├─ JobRegionRelationMapper.java       # 岗位-地区关联Mapper
            │   ├─ JobSkillTagRelationMapper.java     # 岗位-技能标签关联Mapper
            │   ├─ IndustryMapper.java                # 行业Mapper
-            │   ├─ SkillTagMapper.java                # 技能标签Mapper
+            │   ├─ SkillTagMapper.java                # 技能标签Mapper（含insertIgnore自定义SQL）
+            │   ├─ MajorCategoryMapper.java           # 专业分类Mapper
            │   ├─ UserJobFavoriteMapper.java         # 用户收藏岗位Mapper
            │   ├─ UserJobApplicationMapper.java      # 用户投递记录Mapper
            │   ├─ UserJobDislikeMapper.java          # 用户不感兴趣记录Mapper
@@ -116,7 +117,8 @@ offerpie/back-end
            │   │   ├─ JobRegionRelation.java          # 岗位-地区关联表（bg_job_region_relation）
            │   │   ├─ JobSkillTagRelation.java        # 岗位-技能标签关联表（bg_job_skill_tag_relation）
            │   │   ├─ Industry.java                   # 行业字典表（bg_industry）
-            │   │   ├─ SkillTag.java                   # 技能标签表（bg_skill_tag）
+            │   │   ├─ 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）
@@ -129,10 +131,10 @@ offerpie/back-end
            │   │   ├─ UserProfileCompetition.java     # 用户竞赛经历表（bg_user_profile_competition）
            │   │   ├─ UserProfileSkillTagRelation.java  # 用户技能标签关联表（bg_user_profile_skill_tag_relation）
            │   │   └─ AppJobData.java                # 爬虫岗位原始数据表（app_job_data）
-            │   └─ vo/               # ViewObject（OssUrlVo、DescriptionParagraph、JobListItemVo 等）
+            │   └─ vo/               # ViewObject（OssUrlVo、DescriptionParagraph、JobListItemVo、UserHonorsVo 等）
            ├─ resources/mapper/     # MyBatis XML 映射文件
            │   └─ JobMapper.xml     # 岗位自定义SQL（selectJobPage）
-            └─ service/               # 业务 Service（OssService、SmsService、DictCacheService、JobCleanService、JobCleanTransactionService、CompanyCleanService、CompanyCleanTransactionService、UserSkillTagMatchService、JobMatchService 等）
+            └─ service/               # 业务 Service（OssService、SmsService、DictCacheService、JobCleanService、JobCleanTransactionService、CompanyCleanService、CompanyCleanTransactionService、UserProfileAnalyzeService、JobMatchService 等）
 ```
 > **设计理念** – 业务实体和 Mapper 位于 `manager`，B 端和 C 端共享；C 端特有的注解、切面、权限服务、路由菜单服务位于 `client-api`，避免 B 端误用；`common` 提供统一的技术支撑。

@@ -160,21 +162,22 @@ offerpie/back-end
 | `ChinaRegionsCode` | manager | 地区表（bg_china_regions_code），行政区划编码，省/市/区三级，code为主键。 |
 | `JobCategory` | manager | 岗位类型表（bg_job_category），树形结构，一级/二级分类。 |
 | `Company` | manager | 公司表（bg_company），公司基本信息、融资、规模、新闻动态等。 |
-| `Job` | manager | 岗位表（bg_job），岗位信息、薪资、标签、技能标签，关联公司和岗位类型。 |
+| `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），挂在岗位类型下，不分级，用于匹配度计算。 |
+| `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、技能标签、证书标签。 |
+| `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），预定义技能标签与岗位的关联，用于匹配度计算。 |
+| `JobSkillTagRelation` | manager | 岗位-技能标签关联表（bg_job_skill_tag_relation），AI提取的技能标签与岗位的关联，用于匹配度计算。 |
 | `UserProfileSkillTagRelation` | manager | 用户技能标签关联表（bg_user_profile_skill_tag_relation），记录用户匹配的技能标签，由AI自动识别生成。 |
 | `AppJobData` | manager | 爬虫岗位原始数据表（app_job_data），存储爬虫抓取的原始岗位数据，供清洗服务读取并写入业务表。 |

@@ -241,79 +244,52 @@ offerpie/back-end
 ### 整体架构
 - **触发时机**：用户访问岗位列表接口（支持筛选条件：地区/岗位类型/行业/工作类型）
 - **核心流程**：扩展层级筛选 → 查询不感兴趣记录 → 扩展排除列表 → SQL分页查询 → 查询收藏状态 → 批量计算匹配度 → 组装返回
- **匹配度计算**：行业30% + 技能40% + 经验20%，在Java层批量计算（避免SQL性能问题）
-
-### 数据库表（使用）
-| 表名 | 用途 |
-|------|------|
-| `bg_job` | 岗位主表（查询岗位列表） |
-| `bg_company` | 公司表（关联查询公司信息） |
-| `bg_china_regions_code` | 地区表（关联查询地区名称、扩展子级） |
-| `bg_job_category` | 岗位类型表（关联查询类型名称、扩展子级） |
-| `bg_industry` | 行业表（扩展子级、判断父级匹配） |
-| `bg_user_job_dislike` | 不感兴趣记录（排除岗位/公司/地区/行业） |
-| `bg_user_job_favorite` | 收藏记录（查询收藏状态） |
-| `bg_user_profile` | 用户简历（匹配度计算） |
-| `bg_job_skill_tag_relation` | 岗位技能标签（技能匹配） |
-| `bg_user_profile_skill_tag_relation` | 用户技能标签（技能匹配） |
+- **匹配度计算**：教育30% + 经历40% + 技能30%，在Java层批量计算

 ### 匹配度计算规则
-#### 行业匹配（30分）
- 岗位无要求（required_industry_id=null）→ 30分
- 用户无简历（profile不存在或experienceIndustryIds为空）→ 0分
- 完全匹配（用户行业包含岗位行业）→ 30分
- 父级匹配（用户行业与岗位行业有相同父级）→ 22分
- 不匹配 → 0分

-#### 技能匹配（40分）
- 岗位无要求（无技能标签关联）→ 40分
- 用户无技能（无技能标签关联）→ 0分
- 匹配公式：`(匹配数量 / 岗位要求数量) * 40`
+总分公式：`MatchScore = Sedu × 30% + Sexp × 40% + Sskill × 30%`

-#### 经验匹配（20分）
- 岗位无要求（min_experience=0）→ 20分
- 用户无简历（profile不存在或workYears=null）→ 0分
- 计算公式：`min((workYears - minExp) / minExp * 0.8 + 0.2, 1.0) * 20`
+#### 教育维度（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)、不限(仅学校分)

-### 排除逻辑
- **排除岗位**：直接排除 `jobId`
- **排除公司**：直接排除 `companyId`
- **排除地区**：排除 `regionCode` + 其所有子级地区
- **排除行业**：排除 `requiredIndustryId` + 其所有子级行业
+#### 经历维度（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分
+- 匹配公式：`(匹配数量 / 岗位要求数量) × 100`

 ### 核心服务
 - **JobService**（client-api）：岗位列表查询主流程编排
- **JobMatchService**（manager）：批量计算匹配度（行业/技能/经验三个维度）
+- **JobMatchService**（manager）：批量计算匹配度（教育/经历/技能三个维度）

-### 接口定义
- **路径**：`POST /job/list`
- **入参**：`JobQueryParam`（分页 + 地区/岗位类型/行业/工作类型筛选）
- **出参**：`PageResult<JobDto>`（岗位列表 + 匹配度 + 收藏状态）
-
-## 4.5️⃣ 用户技能标签匹配设计
+## 4.5️⃣ 用户简历分析设计
 ### 整体架构
 - **触发时机**：用户保存个人资料（主表或任意子表）后异步触发
- **匹配流程**：两次 AI 调用 → 第一次识别用户所属的二级岗位分类（1-10个），第二次从候选技能标签中匹配用户技能
- **数据存储**：全量替换 `bg_user_profile_skill_tag_relation` 表
-
-### 数据库表（1张）
-| 表名 | 说明 |
-|------|------|
-| `bg_user_profile_skill_tag_relation` | 用户技能标签关联（user_id + skill_tag_id 唯一约束） |
+- **分析流程**：三次 AI 调用 → 第一次综合分析（学校等级、公司背书、经历时长、职责深度、量化产出、荣誉），第二次专业归一化（匹配到 bg_major_category ID），第三次技能提取（自由提取，入 bg_skill_tag）
+- **数据存储**：维度数据更新 bg_user_profile，技能全量替换 bg_user_profile_skill_tag_relation

 ### 核心流程
 1. 查询用户完整个人资料（主表 + 5张子表）
 2. 数据有效性检查（主表或所有子表为空 → 清空关联表）
-3. 第一次 AI 调用：识别用户所属的二级岗位分类（1-10个），信息不足返回空数组
-4. 查询三级分类：根据二级分类 ID 查询所有三级分类（技能标签挂在三级分类下）
-5. 查询候选技能标签（WHERE category_id IN 三级分类列表）
-6. 第二次 AI 调用：从候选标签中匹配用户技能标签
-7. 全量替换关联表（先 DELETE，结果非空则 BATCH INSERT）
+3. 第一次 AI 调用：综合分析（schoolRank、companyPrestige、experienceDuration、roleDepth、outputQuality、honors）→ 更新 bg_user_profile
+4. 第二次 AI 调用：专业归一化（传三级专业分类列表）→ 更新 bg_user_profile.major_ids
+5. 第三次 AI 调用：技能提取（自由提取，prompt与岗位侧一致）→ INSERT IGNORE 入 bg_skill_tag → 全量替换 bg_user_profile_skill_tag_relation

 ### 异步执行
- 使用 Spring `@Async` 注解，配置独立线程池（核心5线程，最大10线程，队列200）
- 异常统一记录日志，不影响主流程
- AI 调用失败不修改关联表（保持原状）
+- 使用 Spring `@Async` 注解，配置独立线程池
+- 每次 AI 调用独立容错，某一次失败不影响其他维度
+- 核心服务：**UserProfileAnalyzeService**（manager）

 ## 4.6️⃣ 邀请模块设计
 ### 数据库表（1张）