From 14cfeabb0bda83c1c37a59803d06adcb88f55df5 Mon Sep 17 00:00:00 2001 From: zk Date: Fri, 31 Jul 2026 16:36:41 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .kiro/steering/项目结构说明.md | 297 ++++++++++++++++++++++----------- 1 file changed, 204 insertions(+), 93 deletions(-) diff --git a/.kiro/steering/项目结构说明.md b/.kiro/steering/项目结构说明.md index 0076b1a..3451489 100644 --- a/.kiro/steering/项目结构说明.md +++ b/.kiro/steering/项目结构说明.md @@ -10,11 +10,11 @@ offerpie/back-end │ ├─ pom.xml # 父 Maven 项目，统一管理依赖、插件、属性 │ -├─ client‑api/ # **C 端**（面向用户）API 服务 +├─ client‑api/ # **C 端**（面向用户）API 服务，启动类 ClientApplication │ ├─ pom.xml │ └─ src/main/java │ └─ org.jiayunet -│ ├─ ClientApplication.java # Spring Boot 主入口 +│ ├─ ClientApplication.java # Spring Boot 主入口（C 端） │ ├─ annotation/ │ │ └─ FuncPermission.java # 功能权限校验注解（标记在Controller方法上） │ ├─ aop/ @@ -29,6 +29,9 @@ offerpie/back-end │ │ ├─ JobIntentionController.java # 求职意向接口（查询与保存） │ │ ├─ JobController.java # 岗位接口（岗位列表查询、收藏、投递、不感兴趣、求职助手任务列表、AI岗位推荐） │ │ ├─ JobAgentConfigController.java # 求职助手配置接口（配置查询与保存） +│ │ ├─ CompanyController.java # 公司接口（查询公司类型列表，/company） +│ │ ├─ RecruitAnnouncementController.java # 招聘公告接口（公开免鉴权，/public/recruitAnnouncement） +│ │ ├─ MentorController.java # 导师接口（对接简历星球开放平台，公开免鉴权，/public/mentor） │ │ ├─ MemberProductController.java # 会员商品接口（商品列表、创建订单、查询订单详情）【暂未启用，注释@RestController】 │ │ ├─ MemberStatusController.java # 会员状态接口（查询会员状态、查询功能权限库存） │ │ └─ MessageController.java # 站内信消息接口（消息列表、未读数、按类型未读数、标记已读） @@ -43,6 +46,8 @@ offerpie/back-end │ │ ├─ JobIntentionService.java # 求职意向服务（查询与保存/更新） │ │ ├─ JobService.java # 岗位服务（岗位列表查询、匹配度计算编排、求职助手任务列表、AI岗位推荐） │ │ ├─ JobAgentConfigService.java # 求职助手配置服务（配置查询与保存） +│ │ ├─ CompanyService.java # 公司服务（公司类型去重列表，兜底过滤NULL与空白值） +│ │ ├─ RecruitAnnouncementService.java # 招聘公告服务（列表/详情/推荐/统计/筛选项/投递入口） │ │ ├─ UserResumeService.java # 用户简历服务（简历列表、主表及5张子表的CRUD、子表单条添加/编辑/删除、设置默认简历） │ │ ├─ MemberProductService.java # 会员商品服务（商品列表、创建订单、支付回调处理）【暂未启用，注释@Service】 │ │ ├─ MemberGrantService.java # 会员权益发放服务（续费会员+发放功能/菜单权限） @@ -53,9 +58,10 @@ offerpie/back-end │ └─ pojo/ │ ├─ param/ │ │ ├─ userProfile/ # 个人资料入参（UserProfileParam、各子表Param） -│ │ ├─ resume/ # 简历入参（ResumeParam、各子表Param、各子表UpdateParam、ResumeSubTableParam） +│ │ ├─ resume/ # 简历入参（ResumeParam、各子表Param、各子表UpdateParam、ResumeSubTableParam、ResumeInfoUpdateParam） │ │ ├─ job/ # 岗位相关入参（JobIntentionParam、JobQueryParam、JobAgentTaskQueryParam、JobAgentRecommendParam、JobApplyParam、JobApplyQueryParam、JobFavoriteQueryParam、JobDislikeParam） │ │ ├─ jobAgent/ # 求职助手入参（JobAgentConfigParam、ChatMessageParam） +│ │ ├─ recruitAnnouncement/ # 招聘公告入参（RecruitAnnouncementQueryParam、RecruitAnnouncementRecommendParam） │ │ ├─ memberProduct/ # 会员商品入参（CreateOrderParam） │ │ ├─ message/ # 站内信入参（MessageQueryParam） │ │ ├─ feedback/ # 用户反馈入参（UserFeedbackParam） @@ -66,6 +72,7 @@ offerpie/back-end │ │ ├─ resume/ # 简历出参（ResumeDto、ResumeListItemDto、各子表Dto） │ │ ├─ job/ # 岗位相关出参（JobIntentionDto、JobDto、JobDetailDto、JobMatchScoreDto、JobAgentRecommendDto、JobApplicationDto） │ │ ├─ jobAgent/ # 求职助手出参（JobAgentConfigDto、ChatMessageDto） +│ │ ├─ recruitAnnouncement/ # 招聘公告出参（RecruitAnnouncementDto、RecruitAnnouncementDetailDto、RecruitAnnouncementRecommendDto、RecruitAnnouncementStatisticsDto） │ │ ├─ memberProduct/ # 会员商品出参（CreateOrderDto、OrderDetailDto） │ │ ├─ memberStatus/ # 会员状态出参（MemberStatusDto、FuncStockDto） │ │ ├─ message/ # 站内信出参（MessageDto、MessageUnreadCountDto） @@ -76,6 +83,31 @@ offerpie/back-end │ ├─ JobApplyCountVo.java # 岗位投递数量统计VO │ └─ JobFavoriteCountVo.java # 岗位收藏数量统计VO │ +├─ admin/ # **B 端**管理后台服务，启动类 AdminApplication（Thymeleaf 页面 + REST 接口） +│ ├─ pom.xml +│ ├─ Dockerfile / Jenkinsfile / nginx.conf +│ └─ src/main +│ ├─ java/org.jiayunet +│ │ ├─ AdminApplication.java # Spring Boot 主入口（B 端） +│ │ └─ admin/ +│ │ ├─ constant/ +│ │ │ └─ AdminRedisKeyName.java # B 端 Redis Key 常量（login:token、login:fail、login:lock） +│ │ ├─ controller/ +│ │ │ ├─ AdminLoginController.java # 管理员登录（/public） +│ │ │ ├─ AdminUserController.java # 用户管理（列表/统计/禁用启用，/user） +│ │ │ ├─ AdminOrderController.java # 订单管理（列表/统计，/order） +│ │ │ ├─ AdminProductController.java # 商品管理（CRUD，/product） +│ │ │ └─ PageController.java # 页面路由（返回Thymeleaf视图名，不走统一响应包装） +│ │ ├─ service/ +│ │ │ ├─ AdminLoginService.java # 管理员登录（密码校验、失败累计3次锁4小时、JWT、多设备踢出、Cookie） +│ │ │ ├─ AdminUserService.java # 用户管理（分页+简历数量统计、新增数统计、禁用/启用） +│ │ │ ├─ AdminOrderService.java # 订单管理（分页+关联用户/商品、支付数与收入统计） +│ │ │ └─ AdminProductService.java # 商品管理（会员商品CRUD） +│ │ └─ pojo/ +│ │ ├─ param/ # login/AdminLoginParam、user/UserPageParam、order/OrderPageParam、product/ProductPageParam、product/ProductSaveParam +│ │ └─ dto/ # user/UserListDto、user/UserStatsDto、order/OrderListDto、order/OrderStatsDto +│ └─ resources/ # application.yml + dev/test/prod 多环境配置、Thymeleaf 模板与静态资源 +│ ├─ common/ # **共享层**：被 C 端和 B 端共同使用的代码库 │ ├─ pom.xml │ └─ src/main/java @@ -83,7 +115,7 @@ offerpie/back-end │ ├─ config/ # 统一配置 │ │ ├─ OssConfig.java # 阿里云OSS凭证配置 │ │ ├─ RedissonConf.java # Redisson客户端配置 -│ │ ├─ SecurityConfig.java # Spring Security配置（JWT过滤器、白名单路径） +│ │ ├─ SecurityConfig.java # Spring Security配置（JWT过滤器、app.ignore.urls 白名单） │ │ ├─ WxPayConfig.java # 微信支付配置 │ │ ├─ SmsConfig.java # 阿里云短信客户端配置 │ │ ├─ AsyncConfig.java # 异步线程池配置 @@ -114,8 +146,7 @@ offerpie/back-end │ │ └─ SqlLoggerInterceptor.java # SQL日志拦截器 │ ├─ aop/ │ │ └─ ControllerLogAspect.java # Controller日志切面 -│ ├─ exception/ # 业务异常统一处理 -│ │ ├─ GlobalExceptionAdvice.java # → 移至web包，此处为异常定义 +│ ├─ exception/ # 业务异常定义 │ │ ├─ BusinessException.java # 业务异常 │ │ ├─ BusinessExpCodeEnum.java # 业务异常码枚举 │ │ └─ BusinessExpCodeOperations.java # 异常码操作接口 @@ -124,7 +155,7 @@ offerpie/back-end │ │ └─ UnifiedResponseBodyAdvice.java # 统一响应体包装 │ ├─ pojo/ # 公共POJO │ │ ├─ UnifiedResponse.java # 统一响应结构 -│ │ ├─ PageParam.java # 分页请求参数基类 +│ │ ├─ PageParam.java # 分页请求参数基类（pageNum/pageSize/keyword，pageSize上限200） │ │ ├─ PageResult.java # 分页结果包装 │ │ ├─ login/ │ │ │ └─ RedisLoginTokenInfo.java # Redis中登录Token信息结构 @@ -152,7 +183,8 @@ offerpie/back-end │ ├─ WxPayNotifyController.java # 微信支付回调入口 │ ├─ WxPayNotifyMessageAbstract.java # 微信回调处理抽象接口 │ └─ server/ -│ └─ TransferServer.java # 微信转账服务端封装 +│ ├─ TransferServer.java # 微信转账服务端封装 +│ └─ model/ # 转账相关请求/响应模型（TransferBillsRequest/Response、CancelRequest/Response、BillNoQueryRequest、TransferNotification、TransferResultResponse、JsRequestPay） │ └─ manager/ # **B 端 + C 端共享** 的业务实现 ├─ pom.xml @@ -171,9 +203,18 @@ offerpie/back-end │ ├─ AgreementController.java # 协议接口（根据协议码查询最新启用版本） │ ├─ RegionController.java # 地区接口（树形/层级/搜索/批量查询） │ ├─ JobCategoryController.java # 岗位分类接口（树形/层级/搜索/批量查询） - │ └─ IndustryController.java # 行业接口（树形/层级/搜索/批量查询） + │ ├─ IndustryController.java # 行业接口（树形/层级/搜索/批量查询） + │ └─ MentorMockChatController.java # 导师模拟对话接口（/public/mentor/mockChat） + ├─ remote/jsxq/ # 简历星球（jianshixingqiu）开放平台远程调用 + │ ├─ JsxqClient.java # 平台客户端（统一请求头、拆 {code,msg,data,ok} 包装、按类型反序列化） + │ ├─ JsxqProperties.java # 域名/令牌/租户配置 + │ ├─ pojo/JsxqResponse.java # 平台统一响应结构 + │ ├─ pojo/JsxqPage.java # 平台分页结构 + │ ├─ pojo/param/ # MentorPageParam、QrCodeParam + │ └─ pojo/dto/ # MentorItemDto、MentorFullInfoDto、TeacherTalkDto、ChatEvaluateDto ├─ mapper/ # MyBatis Mapper │ ├─ UserMapper.java + │ ├─ AdminUserMapper.java # 管理员用户Mapper │ ├─ OssFileMapper.java │ ├─ UserInviteMapper.java # 用户邀请记录Mapper │ ├─ RouteMenuMapper.java # 路由菜单Mapper @@ -184,12 +225,21 @@ offerpie/back-end │ ├─ ChinaRegionsCodeMapper.java # 地区Mapper │ ├─ JobCategoryMapper.java # 岗位类型Mapper │ ├─ CompanyMapper.java # 公司Mapper - │ ├─ JobMapper.java # 岗位Mapper + │ ├─ JobMapper.java # 岗位Mapper（含selectJobPage自定义SQL） │ ├─ JobRegionRelationMapper.java # 岗位-地区关联Mapper │ ├─ JobSkillTagRelationMapper.java # 岗位-技能标签关联Mapper │ ├─ IndustryMapper.java # 行业Mapper │ ├─ SkillTagMapper.java # 技能标签Mapper（含insertIgnore自定义SQL） │ ├─ MajorCategoryMapper.java # 专业分类Mapper + │ ├─ RecruitAnnouncementMapper.java # 招聘公告主表Mapper（XML：最后更新时间、统计、列表分页、推荐分页） + │ ├─ RecruitAnnouncementYearMapper.java # 公告-招聘届数Mapper（@Select分组去重） + │ ├─ RecruitAnnouncementBatchMapper.java # 公告-批次Mapper（@Select分组去重） + │ ├─ RecruitAnnouncementTagMapper.java # 公告-标签Mapper（@Select分组去重） + │ ├─ RecruitAnnouncementCityMapper.java # 公告-热招城市Mapper（@Select分组去重） + │ ├─ RecruitAnnouncementCategoryMapper.java # 公告-岗位大类Mapper（@Select分组去重） + │ ├─ RecruitAnnouncementIndustryMapper.java # 公告-行业Mapper（@Select分组去重） + │ ├─ RecruitAnnouncementEducationMapper.java # 公告-学历要求Mapper（@Select分组去重） + │ ├─ MentorMockChatMapper.java # 导师模拟对话缓存Mapper │ ├─ UserJobFavoriteMapper.java # 用户收藏岗位Mapper │ ├─ UserJobApplicationMapper.java # 用户投递记录Mapper │ ├─ UserJobDislikeMapper.java # 用户不感兴趣记录Mapper @@ -222,11 +272,11 @@ offerpie/back-end │ ├─ MemberRouteItemMapper.java # 会员菜单配置项Mapper │ ├─ PayWechatFlowMapper.java # 微信支付流水Mapper │ ├─ PayAlipayFlowMapper.java # 支付宝支付流水Mapper - │ ├─ UserFeedbackMapper.java # 用户反馈Mapper - │ └─ AppJobDataMapper.java # 爬虫岗位原始数据Mapper + │ └─ UserFeedbackMapper.java # 用户反馈Mapper ├─ pojo/ │ ├─ po/ # 持久化实体 │ │ ├─ User.java + │ │ ├─ AdminUser.java # 管理员用户表（bg_admin_user） │ │ ├─ OssFile.java │ │ ├─ UserInvite.java # 用户邀请记录表（bg_user_invite） │ │ ├─ RouteMenu.java # 路由菜单表（bg_route_menu） @@ -243,6 +293,15 @@ offerpie/back-end │ │ ├─ Industry.java # 行业字典表（bg_industry） │ │ ├─ SkillTag.java # 技能标签表（bg_skill_tag） │ │ ├─ MajorCategory.java # 专业分类表（bg_major_category） + │ │ ├─ RecruitAnnouncement.java # 招聘公告主表（bg_recruit_announcement） + │ │ ├─ RecruitAnnouncementYear.java # 公告-招聘届数关联表（bg_recruit_announcement_year） + │ │ ├─ RecruitAnnouncementBatch.java # 公告-批次关联表（bg_recruit_announcement_batch） + │ │ ├─ RecruitAnnouncementTag.java # 公告-标签关联表（bg_recruit_announcement_tag） + │ │ ├─ RecruitAnnouncementCity.java # 公告-热招城市关联表（bg_recruit_announcement_city） + │ │ ├─ RecruitAnnouncementCategory.java # 公告-岗位大类关联表（bg_recruit_announcement_category） + │ │ ├─ RecruitAnnouncementIndustry.java # 公告-行业关联表（bg_recruit_announcement_industry） + │ │ ├─ RecruitAnnouncementEducation.java # 公告-学历要求关联表（bg_recruit_announcement_education） + │ │ ├─ MentorMockChat.java # 导师模拟对话表（bg_mentor_mock_chat，按导师ID唯一） │ │ ├─ UserJobFavorite.java # 用户收藏岗位表（bg_user_job_favorite） │ │ ├─ UserJobApplication.java # 用户投递记录表（bg_user_job_application） │ │ ├─ UserJobDislike.java # 用户不感兴趣记录表（bg_user_job_dislike） @@ -270,18 +329,22 @@ offerpie/back-end │ │ ├─ Agreement.java # 协议表（bg_agreement，版本递增） │ │ ├─ MemberProduct.java # 会员商品表（bg_member_product） │ │ ├─ MemberOrder.java # 会员订单表（bg_member_order） - │ │ ├─ MemberUser.java # 会员用户表（bg_member_user，记录会员到期时间） - │ │ ├─ MemberFuncItem.java # 会员功能配置项表（bg_member_func_item，定义会员包含的功能权限） - │ │ ├─ MemberRouteItem.java # 会员菜单配置项表（bg_member_route_item，定义会员包含的菜单权限） + │ │ ├─ MemberUser.java # 会员用户表（bg_member_user） + │ │ ├─ MemberFuncItem.java # 会员功能配置项表（bg_member_func_item） + │ │ ├─ MemberRouteItem.java # 会员菜单配置项表（bg_member_route_item） │ │ ├─ PayWechatFlow.java # 微信支付流水表（bg_pay_wechat_flow） │ │ ├─ PayAlipayFlow.java # 支付宝支付流水表（bg_pay_alipay_flow） - │ │ ├─ UserFeedback.java # 用户反馈表（bg_user_feedback） - │ │ └─ AppJobData.java # 爬虫岗位原始数据表（app_job_data） - │ └─ vo/ # ViewObject + │ │ └─ UserFeedback.java # 用户反馈表（bg_user_feedback） + │ ├─ dto/ # Mapper 入参 / 跨模块传输对象 + │ │ ├─ RecruitAnnouncementQueryDto.java # 招聘公告查询条件（供Mapper使用，避免manager反向依赖client-api） + │ │ └─ mentor/MentorMockChatDto.java # 导师模拟对话出参 + │ └─ vo/ # ViewObject / SQL查询结果 │ ├─ OssUrlVo.java # OSS签名URL返回 │ ├─ DescriptionParagraph.java # 描述段落对象（JSON字段通用结构） │ ├─ LanguageAbility.java # 语言能力对象（求职助手配置JSON字段） │ ├─ JobListItemVo.java # 岗位列表项VO + │ ├─ RecruitAnnouncementListItemVo.java # 公告列表项VO（列表与推荐共用） + │ ├─ RecruitAnnouncementStatisticsVo.java # 公告统计VO（日/月/累计） │ ├─ UserHonorsVo.java # 用户荣誉VO │ ├─ AgreementListVo.java # 协议列表VO │ ├─ RegionTreeVo.java # 地区树形VO @@ -291,7 +354,8 @@ offerpie/back-end │ ├─ IndustryTreeVo.java # 行业树形VO │ └─ IndustryVo.java # 行业VO ├─ resources/mapper/ # MyBatis XML映射文件 - │ └─ JobMapper.xml # 岗位自定义SQL（selectJobPage） + │ ├─ JobMapper.xml # 岗位自定义SQL（selectJobPage） + │ └─ RecruitAnnouncementMapper.xml # 公告自定义SQL（selectLastCreateTime、selectStatistics、selectAnnouncementPage、selectRecommendPage） └─ service/ # 业务Service ├─ OssService.java # 文件上传/下载服务 ├─ SmsService.java # 短信发送服务 @@ -300,83 +364,67 @@ offerpie/back-end ├─ JobCategoryService.java # 岗位分类服务（树形/层级/搜索/批量查询） ├─ IndustryService.java # 行业服务（树形/层级/搜索/批量查询） ├─ AgreementService.java # 协议服务（查询最新版本、列表、创建/编辑版本递增） - ├─ JobCleanService.java # 岗位清洗服务（爬虫数据→业务表） - ├─ JobCleanTransactionService.java # 岗位清洗事务服务 - ├─ CompanyCleanService.java # 公司清洗服务 - ├─ CompanyCleanTransactionService.java # 公司清洗事务服务 + ├─ MentorMockChatService.java # 导师模拟对话生成服务（查缓存→取导师信息与话题→AI生成→入库） ├─ UserProfileAnalyzeService.java # 用户简历分析服务（AI三次调用：综合分析/专业归一化/技能提取） ├─ JobMatchService.java # 岗位匹配度计算服务（教育30%+经历30%+技能40%） └─ MessageService.java # 站内信服务（发送系统/运营/订单消息） ``` -> **设计理念** – 业务实体和 Mapper 位于 `manager`，B 端和 C 端共享；C 端特有的注解、切面、权限服务、路由菜单服务位于 `client-api`，避免 B 端误用；`common` 提供统一的技术支撑。 +> **设计理念** – 业务实体和 Mapper 位于 `manager`，B 端（admin）和 C 端（client-api）共享；C 端特有的注解、切面、权限服务、路由菜单服务位于 `client-api`，B 端特有的登录与管理服务位于 `admin`；`common` 提供统一的技术支撑。 +> +> **模块依赖方向**：`client-api` / `admin` → `manager` → `common`，反向依赖不成立。因此 Mapper 需要接收复杂查询条件时，要在 `manager` 侧定义 DTO（如 `RecruitAnnouncementQueryDto`），不能直接引用 `client-api` 的 Param；SQL 查询结果同理放在 `manager/pojo/vo`。 ## 2️⃣ 各层模块职责 | 层级 | 主要职责 | 关键类/包 | |------|----------|-----------| -| **client-api** | - 面向终端用户的 REST API
- 启动 Spring Boot 应用
- 短信验证码登录（含自动注册、邀请码绑定）
- **功能权限校验**：注解 + 切面 + 权限服务（校验、扣减、回退）
- **路由菜单**：获取用户有效菜单树
- **用户管理**：查看/修改信息、注销账号、邀请统计
- **用户反馈**：提交反馈
- **会员体系**：商品下单、支付回调、会员状态查询、权益发放
- **求职助手**：配置管理、AI岗位推荐、任务列表 | `ClientApplication`、`LoginController`、`RouteMenuController`、`UserManageController`、`UserFeedbackController`、`MemberProductController`、`MemberStatusController`、`JobController`、`JobAgentConfigController`、`UserResumeController`、`MessageController`、`FuncPermission`、`FuncPermissionAspect`、`FuncPermissionService`、`MemberGrantService`、`MemberProductService`、`MemberStatusService`、`UserManageService` | -| **common** | - **统一配置**：OSS、Redis、Security、WxPay、Alipay、Sms、Async、Jackson、MyBatis、Web 等
- **跨层工具**：HTTP、IP、认证、验证码、Redis Server、用户安全
- **通用Mapper**：CommonMapper（批量插入/更新）
- **全局拦截/切面**：日志、TraceId、黑名单、防重放、SQL打印
- **统一异常/响应**：`GlobalExceptionAdvice`、`UnifiedResponse`、`PageResult`
- **业务能力抽象**：邮件（EmailAbility）、短信（AliYunSmsAbility）、OSS（AliOssAbility）、AI对话（AiChatAbility）、微信支付（Native/JS/Transfer）、支付宝支付（PagePay）
- **公共 POJO**：登录令牌、防重放信息、分页参数/结果 | `config/`, `constant/`, `mapper/`, `tool/`, `interceptor/`, `aop/`, `exception/`, `web/`, `pojo/`, `email/`, `sms/`, `oss/`, `ai/`, `alipay/`, `wxPay/` | -| **manager** | - **业务实体**（User、OssFile、UserInvite、RouteMenu、FuncPermission、库存表、地区/岗位分类/行业/技能标签/专业分类字典、岗位及关联表、用户行为表、个人资料及5张子表、简历及5张子表、诊断报告/问题、求职助手配置/对话/定制简历、站内信、协议、会员商品/订单/用户/配置项、支付流水、用户反馈、爬虫原始数据）
- **MyBatis Mapper**（对应全部业务实体）
- **字典/公共 API**：文件上传/下载、健康检查、地区/岗位分类/行业字典查询、协议查询
- **业务逻辑**：OssService、SmsService、DictCacheService、RegionService、JobCategoryService、IndustryService、AgreementService、JobCleanService、CompanyCleanService、UserProfileAnalyzeService、JobMatchService、MessageService | `controller/`, `mapper/`, `pojo/po/`, `pojo/vo/`, `service/`, `constant/` | +| **client-api** | - 面向终端用户的 REST API
- 启动 Spring Boot 应用（`ClientApplication`）
- 短信验证码登录（含自动注册、邀请码绑定）
- **功能权限校验**：注解 + 切面 + 权限服务（校验、扣减、回退）
- **路由菜单**：获取用户有效菜单树
- **用户管理**：查看/修改信息、注销账号、邀请统计
- **用户反馈**：提交反馈
- **会员体系**：商品下单、支付回调、会员状态查询、权益发放
- **求职助手**：配置管理、AI岗位推荐、任务列表
- **招聘公告**：列表/详情/推荐/统计/筛选项查询
- **导师**：对接简历星球开放平台 | `ClientApplication`、`LoginController`、`RouteMenuController`、`UserManageController`、`UserFeedbackController`、`MemberProductController`、`MemberStatusController`、`JobController`、`JobAgentConfigController`、`UserResumeController`、`MessageController`、`RecruitAnnouncementController`、`CompanyController`、`MentorController`、`FuncPermission`、`FuncPermissionAspect`、`FuncPermissionService`、`MemberGrantService`、`RecruitAnnouncementService` | +| **admin** | - B 端管理后台（`AdminApplication`），Thymeleaf 页面 + REST 接口
- **管理员登录**：账号密码 + JWT + 失败锁定
- **用户管理**：分页列表、注册统计、禁用/启用
- **订单管理**：分页列表、支付数与收入统计
- **商品管理**：会员商品 CRUD | `AdminApplication`、`AdminLoginController`、`AdminUserController`、`AdminOrderController`、`AdminProductController`、`PageController`、`AdminLoginService`、`AdminUserService`、`AdminOrderService`、`AdminProductService`、`AdminRedisKeyName` | +| **common** | - **统一配置**：OSS、Redis、Security、WxPay、Alipay、Sms、Async、Jackson、MyBatis、Web 等
- **跨层工具**：HTTP、IP、认证、验证码、Redis Server、用户安全
- **通用Mapper**：CommonMapper（批量插入/更新）
- **全局拦截/切面**：日志、TraceId、黑名单、防重放、SQL打印
- **统一异常/响应**：`GlobalExceptionAdvice`、`UnifiedResponse`、`PageResult`
- **业务能力抽象**：邮件、短信、OSS、AI对话、微信支付（Native/JS/Transfer）、支付宝支付（PagePay）
- **公共 POJO**：登录令牌、防重放信息、分页参数/结果 | `config/`, `constant/`, `mapper/`, `tool/`, `interceptor/`, `aop/`, `exception/`, `web/`, `pojo/`, `email/`, `sms/`, `oss/`, `ai/`, `alipay/`, `wxPay/` | +| **manager** | - **业务实体**（用户/管理员、OSS文件、邀请、权限与库存、地区/岗位分类/行业/技能标签/专业分类字典、岗位及关联表、招聘公告及7张关联表、用户行为表、个人资料及5张子表、简历及5张子表、诊断报告/问题、求职助手配置/对话/定制简历、导师模拟对话、站内信、协议、会员商品/订单/用户/配置项、支付流水、用户反馈）
- **MyBatis Mapper**（对应全部业务实体）
- **字典/公共 API**：文件上传/下载、健康检查、地区/岗位分类/行业字典查询、协议查询、导师模拟对话
- **远程调用**：简历星球开放平台客户端（`remote/jsxq`）
- **业务逻辑**：OssService、SmsService、DictCacheService、RegionService、JobCategoryService、IndustryService、AgreementService、MentorMockChatService、UserProfileAnalyzeService、JobMatchService、MessageService | `controller/`, `mapper/`, `remote/`, `pojo/po/`, `pojo/dto/`, `pojo/vo/`, `service/`, `constant/` | + +> **注**：岗位与公司的数据清洗已迁出后端，由独立服务 `offerpie_job_cleaner` 负责（读 PostgreSQL 爬虫原始数据 → AI 清洗 → 写入 MySQL 业务库）；招聘公告采集由 `offerpie_spider` 负责。后端只消费清洗后的业务表。 ## 3️⃣ 关键业务实体 | 实体 | 所属模块 | 作用概述 | |------|----------|----------| -| `User` | manager | 记录用户基础信息（手机号、邮箱、密码、昵称、头像、生日、性别、真实姓名、微信绑定、邀请码等），配合 `UserMapper` 完成持久化。 | -| `OssFile` | manager | 描述 OSS（对象存储）中文件的元数据（路径、大小、标签等），通过 `OssFileMapper` 进行增删改查。 | +| `User` | manager | 记录用户基础信息（手机号、邮箱、密码、昵称、头像、生日、性别、真实姓名、微信绑定、邀请码等）。 | +| `AdminUser` | manager | 管理员用户表（bg_admin_user），B 端后台登录账号。 | +| `OssFile` | manager | 描述 OSS 中文件的元数据（路径、大小、标签等）。 | | `UserInvite` | manager | 用户邀请记录表，记录邀请人与被邀请人的关系、邀请时间、奖励天数。 | | `UserFeedback` | manager | 用户反馈表（bg_user_feedback），记录用户提交的反馈类型和内容。 | -| `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），记录每次功能使用，用于免费次数统计和异常回退。 | -| `Agreement` | manager | 协议表（bg_agreement），按协议码（agreementCode）分组，版本递增管理，支持启用/禁用状态。 | -| `MemberProduct` | manager | 会员商品表（bg_member_product），定义商品名称、价格、时长天数、排序、上下架状态。 | -| `MemberOrder` | manager | 会员订单表（bg_member_order），记录用户下单信息、支付渠道、订单状态（0待支付/1已支付）、支付时间。 | -| `MemberUser` | manager | 会员用户表（bg_member_user），记录用户的会员到期时间，一个用户一条记录。 | -| `MemberFuncItem` | manager | 会员功能配置项表（bg_member_func_item），定义会员套餐包含的功能权限项（funcCode、countLimit、addCount）。 | -| `MemberRouteItem` | manager | 会员菜单配置项表（bg_member_route_item），定义会员套餐包含的菜单权限项（routeId）。 | -| `PayWechatFlow` | manager | 微信支付流水表（bg_pay_wechat_flow），记录微信支付的订单号、金额、状态、回调数据。 | -| `PayAlipayFlow` | manager | 支付宝支付流水表（bg_pay_alipay_flow），记录支付宝支付的订单号、金额、状态、交易号、回调数据。 | -| `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），一个岗位可关联多个地区。 | -| `JobSkillTagRelation` | manager | 岗位-技能标签关联表（bg_job_skill_tag_relation），AI提取的技能标签与岗位的关联，用于匹配度计算。 | -| `Industry` | manager | 行业字典表（bg_industry），树形结构，一级/二级分类。 | -| `SkillTag` | manager | 技能标签表（bg_skill_tag），AI自动入库，name唯一索引，用于匹配度计算。 | -| `MajorCategory` | manager | 专业分类表（bg_major_category），基于教育部专业目录，三级树形结构，用于专业匹配。 | -| `UserJobFavorite` | manager | 用户收藏岗位表（bg_user_job_favorite），用户与岗位唯一约束。 | -| `UserJobApplication` | manager | 用户投递记录表（bg_user_job_application），记录投递状态流转。 | -| `UserJobDislike` | manager | 用户不感兴趣记录表（bg_user_job_dislike），冗余公司ID/地区编码/行业ID方便推荐过滤。 | -| `UserJobIntention` | manager | 用户求职意向表（bg_user_job_intention），存储意向岗位类型、城市、行业（JSON数组）和工作类型。 | -| `UserProfile` | manager | 用户个人资料表（bg_user_profile），存储维度评分字段（学校等级、公司背书、经历时长、职责深度、量化产出、荣誉、技能标签、证书标签等）。 | -| `UserProfileEducation` | manager | 用户教育经历表（bg_user_profile_education，profile子表）。 | -| `UserProfileWork` | manager | 用户工作经历表（bg_user_profile_work，profile子表）。 | -| `UserProfileInternship` | manager | 用户实习经历表（bg_user_profile_internship，profile子表）。 | -| `UserProfileProject` | manager | 用户项目经历表（bg_user_profile_project，profile子表）。 | -| `UserProfileCompetition` | manager | 用户竞赛经历表（bg_user_profile_competition，profile子表）。 | -| `UserProfileSkillTagRelation` | manager | 用户技能标签关联表（bg_user_profile_skill_tag_relation），AI自动识别生成。 | -| `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种消息类型。 | -| `UserJobCustomizeResume` | manager | 用户岗位定制简历表（bg_user_job_customize_resume），唯一索引(user_id, job_id)。 | -| `Message` | manager | 站内信消息表（bg_message），支持系统(1)/运营(2)/订单(3)消息，支持指定用户和全员推送。 | -| `MessageRead` | manager | 消息已读状态表（bg_message_read），唯一索引(message_id, user_id)。 | -| `AppJobData` | manager | 爬虫岗位原始数据表（app_job_data），存储爬虫抓取的原始岗位数据，供清洗服务读取。 | +| `RouteMenu` | manager | 路由菜单表（bg_route_menu），支持多级树形结构，openAccess 标识是否公开免费。 | +| `FuncPermission` | manager | 功能权限表（bg_func_permission），func_code 唯一，daily_free_count 配置每日免费次数。 | +| `UserRouteMenuStock` | manager | 用户路由菜单库存表，记录用户拥有的菜单权限，支持时间维度。 | +| `UserFuncPermissionStock` | manager | 用户功能权限库存表，支持时间/次数/复合维度。 | +| `UserFuncUsageLog` | manager | 用户功能使用记录表，用于免费次数统计和异常回退。 | +| `Agreement` | manager | 协议表（bg_agreement），按协议码分组，版本递增管理。 | +| `MemberProduct` / `MemberOrder` / `MemberUser` | manager | 会员商品、订单、会员到期状态。 | +| `MemberFuncItem` / `MemberRouteItem` | manager | 会员套餐包含的功能权限项与菜单权限项。 | +| `PayWechatFlow` / `PayAlipayFlow` | manager | 微信 / 支付宝支付流水。 | +| `ChinaRegionsCode` | manager | 地区表（bg_china_regions_code），省/市/区三级，code 为主键。 | +| `JobCategory` | manager | 岗位类型表（bg_job_category），树形结构。 | +| `Company` | manager | 公司表（bg_company），公司基本信息、融资、规模、新闻动态、company_type、logo_url。 | +| `Job` | manager | 岗位表（bg_job），岗位信息、薪资、标签、技能标签、要求专业、专业敏感度。 | +| `JobRegionRelation` / `JobSkillTagRelation` | manager | 岗位-地区、岗位-技能标签关联表。 | +| `Industry` | manager | 行业字典表（bg_industry），树形结构。 | +| `SkillTag` | manager | 技能标签表（bg_skill_tag），AI 自动入库，name 唯一索引。 | +| `MajorCategory` | manager | 专业分类表（bg_major_category），三级树形结构，用于专业匹配。 | +| `RecruitAnnouncement` | manager | 招聘公告主表（bg_recruit_announcement），公告标题、公司简介、面向对象、专业要求、招聘岗位、笔试、投递时间与入口（announcement_url/apply_url/apply_email/invite_code）、来源、clean_status、status。 | +| `RecruitAnnouncement{Year,Batch,Tag,City,Category,Industry,Education}` | manager | 公告的 7 张多值维度关联表，统一结构（id + announcement_id + 值字段 + create_time），直接存原始值不引字典表，无唯一约束。 | +| `MentorMockChat` | manager | 导师模拟对话表（bg_mentor_mock_chat），缓存 AI 生成的对话，按导师 ID 唯一。 | +| `UserJobFavorite` / `UserJobApplication` / `UserJobDislike` / `UserJobIntention` | manager | 用户收藏、投递、不感兴趣、求职意向。 | +| `UserProfile` + 5 张子表 | manager | 用户个人资料及教育/工作/实习/项目/竞赛经历，主表存维度评分字段。 | +| `UserProfileSkillTagRelation` | manager | 用户技能标签关联表，AI 自动识别生成。 | +| `UserResume` + 5 张子表 | manager | 用户简历及教育/工作/实习/项目/竞赛经历，一个用户可有多份简历。 | +| `ResumeDiagnosisReport` / `ResumeDiagnosisIssue` | manager | 简历诊断报告与问题明细。 | +| `JobAgentConfig` / `JobAgentChatMessage` / `UserJobCustomizeResume` | manager | 求职助手配置、对话消息、岗位定制简历。 | +| `Message` / `MessageRead` | manager | 站内信消息与已读状态。 | ## 4️⃣ 权限体系设计 ### 整体架构 - **前端**：路由控制菜单/页面可见性，登录后拉取用户有效菜单树（含公开免费菜单 + 库存授权菜单） - **后端**：AOP 切面拦截 `@FuncPermission` 注解，校验权限 + 扣减库存，业务异常自动回退次数 - **权限来源**：会员购买成功后通过 `MemberGrantService` 统一发放到库存表 +- **免鉴权路径**：由配置 `app.ignore.urls` 控制（当前为 `/public/**,/job/list,/job/detail,/route/menu`），`antMatchers` 匹配完整路径，因此 `/public` 必须写在类级 `@RequestMapping` 的最前面 ### 数据库表（5张） | 表名 | 说明 | @@ -406,7 +454,7 @@ offerpie/back-end ## 5️⃣ 会员商品与支付体系 ### 整体架构 -- **商品管理**：`MemberProduct` 定义会员套餐（名称、价格、时长天数、排序、上下架） +- **商品管理**：`MemberProduct` 定义会员套餐（名称、价格、时长天数、排序、上下架），B 端由 `AdminProductService` 维护 - **下单流程**：用户选择商品 → 创建订单（`MemberOrder`） → 根据支付渠道调用微信/支付宝下单 → 返回支付凭据 - **支付回调**：微信/支付宝回调 → 验签 → 更新流水 → 调用 `handlePaySuccess` → 更新订单状态 → 发放权益 - **权益发放**：`MemberGrantService.grant()` → 续费会员时长 → 按 `MemberFuncItem` 发放功能权限 → 按 `MemberRouteItem` 发放菜单权限 @@ -438,9 +486,9 @@ offerpie/back-end | **短信** | `AliYunSmsAbility`（阿里云短信发送，ConditionalOnProperty） | `common/sms` | | **OSS** | `AliOssAbility`（阿里云OSS上传/下载/签名URL，ConditionalOnProperty） | `common/oss` | | **AI** | `AiChatAbility`（OpenAI 兼容多供应商对话）、`AiChatConfig`（供应商配置）、`AiResponseCleanTool`（AI响应文本清洗） | `common/ai` | -| **支付宝** | `AlipayClientConfig`（客户端配置）、`AlipayPagePayAbility`（电脑网站支付）、`AlipayNotifyController`（回调验签）、`AlipayNotifyMessageAbstract`（回调抽象） | `common/alipay` | -| **微信支付** | `WxJsPayAbility`, `WxNativePayAbility`, `WxTransferPayAbility`, `WxPayNotifyController`, `WxPayNotifyMessageAbstract` | `common/wxPay` | -| **全局异常** | `GlobalExceptionAdvice`, `BusinessException`, `BusinessExpCodeEnum`, `BusinessExpCodeOperations` | `common/exception`, `common/web` | +| **支付宝** | `AlipayClientConfig`、`AlipayPagePayAbility`、`AlipayNotifyController`、`AlipayNotifyMessageAbstract` | `common/alipay` | +| **微信支付** | `WxJsPayAbility`, `WxNativePayAbility`, `WxTransferPayAbility`, `WxPayNotifyController`, `WxPayNotifyMessageAbstract`, `server/TransferServer` 及 `server/model/*` | `common/wxPay` | +| **全局异常** | `GlobalExceptionAdvice`（web包）, `BusinessException`, `BusinessExpCodeEnum`, `BusinessExpCodeOperations`（exception包） | `common/exception`, `common/web` | | **日志 & AOP** | `ControllerLogAspect`, `LoggingOriginalRequestFilter`, `TraceIdFilter`, `SqlLoggerInterceptor` | `common/aop`, `common/interceptor` | | **工具类** | `HttpTool`, `HttpIpTool`, `AuthenticTool`, `ObjectTool`, `UserSecurityTool`, `VerifyImageCodeUtils`, `RedisServerTool` | `common/tool` | | **统一返回体** | `UnifiedResponse`, `UnifiedResponseBodyAdvice`, `PageParam`, `PageResult` | `common/pojo`, `common/web` | @@ -448,9 +496,10 @@ offerpie/back-end ## 7️⃣ 岗位列表与匹配度计算设计 ### 整体架构 -- **触发时机**：用户访问岗位列表接口（支持筛选条件：地区/岗位类型/行业/工作类型） +- **触发时机**：用户访问岗位列表接口（支持筛选条件：地区/岗位类型/行业/工作类型/公司类型/公司ID） - **核心流程**：扩展层级筛选 → 查询不感兴趣记录 → 扩展排除列表 → SQL分页查询 → 查询收藏状态 → 批量计算匹配度 → 组装返回 - **匹配度计算**：教育30% + 经历30% + 技能40%，在Java层批量计算 +- **分页策略**：`pageParam.setSearchCount(false)`，不查总数（前端按「加载更多」处理） ### 匹配度计算规则 @@ -480,7 +529,45 @@ offerpie/back-end - **JobService**（client-api）：岗位列表查询主流程编排 - **JobMatchService**（manager）：批量计算匹配度（教育/经历/技能三个维度） -## 8️⃣ 用户简历分析设计 +## 8️⃣ 招聘公告模块设计 +### 数据模型 +- **一主七从**：主表 `bg_recruit_announcement` + 7 张多值维度关联表（届数/批次/标签/城市/岗位大类/行业/学历） +- 从表统一结构：`id` + `announcement_id` + 单个值字段 + `create_time`，雪花主键，只有普通索引，**无唯一约束**（重复写入需按 announcement_id 先删后插） +- 刻意不引字典表，从表直接存原始文本值，避免归一化限制 AI 解析结果；筛选按名称匹配 +- 双状态：`clean_status`（0-清洗中 1-完成）、`status`（0-失效 1-有效），有效数据口径为两者皆为 1 + +### 接口一览（`/public/recruitAnnouncement`，全部免鉴权） +| 接口 | 说明 | +|------|------| +| `POST /page` | 分页列表，支持关键字（公司名/招聘岗位 LIKE）+ 发布时间区间 + 投递截止区间 + 公司类型 + 7 个多值维度筛选（条件间为「且」） | +| `GET /detail` | 详情，返回主表字段（不含三个投递入口地址）+ 公司 logo 与类型 + 全部 7 个多值维度 | +| `POST /recommend` | 推荐，按传入公告的行业或岗位大类命中任一即推荐 | +| `GET /statistics` | 统计（今日新增/本月新增/累计），一次条件聚合出三个计数 | +| `GET /lastUpdateTime` | 最后更新时间（按 id 倒序取第一条的 create_time） | +| `GET /announcementUrl` `/applyUrl` `/applyEmail` | 按公告 id 分别查询公告地址、投递地址、投递邮箱（只查单列） | +| `GET /batch` `/category` `/city` `/education` `/industry` `/tag` `/year` | 各维度筛选项，`GROUP BY` 值字段去重 | + +### 实现约定 +- **列表与推荐**：主表 + `bg_company` INNER JOIN 只取单值字段，多值维度不进 SQL；拿到本页 id 后按 `IN` 批量查从表，在 Java 侧 `groupingBy` + `mapping` 组装，避免 N+1 +- **详情**：`selectById` 取 PO + 单独查公司两列 + 7 张从表各查一次，共 9 次查询，全部走主键或 `idx_announcement_id` +- **筛选**：多值维度用 `ra.id IN (子查询)` 半连接；推荐场景两个维度是「或」关系，用 `UNION` 合并后再套单个 `IN`（避免 `OR` 连接多个 `IN` 无法半连接优化），`` 处理动态拼接 +- **统计时区**：固定 `ZoneId.of("Asia/Shanghai")` 计算今日零点与本月 1 号零点，不依赖 JVM 默认时区 +- **分页**：`setSearchCount(false)`，`total` 恒为 0 + +## 9️⃣ 导师模块设计（对接简历星球开放平台） +### 整体架构 +- **远程客户端**：`JsxqClient`（manager/remote/jsxq）统一拼公共请求头、拆平台 `{code,msg,data,ok}` 包装、按类型反序列化 data，业务接口为其 public 方法 +- **配置**：`JsxqProperties` 管理域名、令牌、租户 +- **对外接口**：`MentorController`（client-api，`/public/mentor`）透传导师分页列表、导师完整信息、老师话题、老师评价 +- **模拟对话**：`MentorMockChatController` + `MentorMockChatService`（manager，`/public/mentor/mockChat`） + +### 模拟对话流程 +1. 按 mentorId 查 `bg_mentor_mock_chat`，有缓存直接返回 +2. 无缓存则通过 `JsxqClient` 获取导师信息与话题 +3. 调用 `AiChatAbility` 生成对话 +4. 结果入库缓存，再返回 + +## 🔟 用户简历分析设计 ### 整体架构 - **触发时机**：用户保存个人资料（主表或任意子表）后异步触发 - **分析流程**：三次 AI 调用 → 第一次综合分析（学校等级、公司背书、经历时长、职责深度、量化产出、荣誉），第二次专业归一化（匹配到 bg_major_category ID），第三次技能提取（自由提取，入 bg_skill_tag） @@ -498,7 +585,7 @@ offerpie/back-end - 每次 AI 调用独立容错，某一次失败不影响其他维度 - 核心服务：**UserProfileAnalyzeService**（manager） -## 9️⃣ 邀请模块设计 +## 1️⃣1️⃣ 邀请模块设计 ### 数据库表（1张） | 表名 | 说明 | |------|------| @@ -510,17 +597,41 @@ offerpie/back-end - 注册逻辑由 `UserRegisterService` 独立承担，`LoginService` 委托调用 - 邀请统计由 `UserManageService.getInviteStats()` 提供（累计邀请人数、累计获得会员天数） -## 🔟 构建与运行 -- **父 POM**（`back-end/pom.xml`）统一管理子模块的依赖与插件。 -- 子模块 (`client-api`, `common`, `manager`) 均可单独 `mvn clean install`，生成各自的 jar 包。 -- **启动入口**：运行 `client-api` 中的 `ClientApplication`，Spring Boot 会自动扫描并加载 `common`（配置、拦截、工具）以及 `manager` 中声明的 Mapper 与 Service。 -- **条件加载**：多个能力组件使用 `@ConditionalOnProperty` 按配置启用（OSS、SMS、Alipay），未配置时不加载。 +## 1️⃣2️⃣ B 端管理后台设计 +### 整体架构 +- 独立启动类 `AdminApplication`，独立 `application.yml`（含 dev/test/prod），Thymeleaf 渲染页面 + REST 接口 +- `PageController` 返回视图名，不参与 `UnifiedResponseBodyAdvice` 统一包装 +- 复用 `manager` 的全部 Mapper 与 `common` 的技术设施，不重复定义实体 -## 1️⃣1️⃣ 小结 -- 项目采用 **三层结构**： - 1. **client-api** → C 端 REST 接口 + 功能权限校验 + 路由菜单 + 用户管理 + 会员体系 + 支付回调。 - 2. **manager** → 业务实体、Mapper 与业务 API/Service，B 端 + C 端共享层。 - 3. **common** → 所有层共同依赖的底层设施（配置、工具、拦截、异常、支付、OSS、短信、AI、邮件等）。 +### 登录与安全 +- 账号密码登录（`bg_admin_user`），JWT 令牌写入 Redis +- 失败累计：连续 3 次失败锁定账号 4 小时 +- Redis Key：`login:token:{adminId}`、`login:fail:{username}`、`login:lock:{username}`（常量见 `AdminRedisKeyName`） +- 登录成功写入 Redis 并设置 Cookie，支持多设备踢出 + +### 管理能力 +| 模块 | 能力 | +|------|------| +| 用户管理 | 分页列表（含每人简历数量）、总数/今日/本周/本月新增统计、禁用与启用 | +| 订单管理 | 分页列表（关联用户与商品信息）、总数/已支付数/今日本周本月支付数与收入统计 | +| 商品管理 | 会员商品新增、编辑、分页查询 | + +## 1️⃣3️⃣ 构建与运行 +- **父 POM**（`back-end/pom.xml`）统一管理子模块的依赖与插件，Java 17。 +- 子模块（`client-api`, `admin`, `common`, `manager`）均可单独 `mvn clean install`，生成各自的 jar 包。 +- **启动入口**：C 端运行 `client-api` 的 `ClientApplication`；B 端运行 `admin` 的 `AdminApplication`。两者都会自动扫描并加载 `common`（配置、拦截、工具）与 `manager` 中声明的 Mapper 与 Service。 +- **MyBatis XML**：`mapper-locations: classpath*:mapper/**/*.xml`，放在 `manager/src/main/resources/mapper/` 下。注意同一方法不能同时存在 `@Select` 注解和 XML 语句，否则启动报 `Mapped Statements collection already contains value`。 +- **条件加载**：多个能力组件使用 `@ConditionalOnProperty` 按配置启用（OSS、SMS、Alipay），未配置时不加载。 +- **部署**：`client-api` 与 `admin` 各有独立 `Dockerfile`、`Jenkinsfile`（含 `.test` 变体）、`nginx.conf` 与 `docker-compose.*.yml`。 + +## 1️⃣4️⃣ 小结 +- 项目采用 **四模块结构**： + 1. **client-api** → C 端 REST 接口 + 功能权限校验 + 路由菜单 + 用户管理 + 会员体系 + 支付回调 + 招聘公告 + 导师。 + 2. **admin** → B 端管理后台（管理员登录、用户/订单/商品管理，Thymeleaf 页面）。 + 3. **manager** → 业务实体、Mapper、远程调用与业务 API/Service，B 端 + C 端共享层。 + 4. **common** → 所有层共同依赖的底层设施（配置、工具、拦截、异常、支付、OSS、短信、AI、邮件等）。 +- 依赖方向单向：`client-api` / `admin` → `manager` → `common`。跨模块传参需在 `manager` 侧定义 DTO/VO。 - 权限体系分两层：前端路由控制菜单可见性，后端切面控制功能点权限与库存扣减。 - 会员体系：商品下单 → 支付回调 → `MemberGrantService` 统一发放权益（会员时长 + 功能权限 + 菜单权限）。 - 支付双通道：微信Native支付 + 支付宝电脑网站支付，各自独立流水表和回调处理。 +- 数据来源：招聘公告由 `offerpie_spider` 采集，岗位与公司由 `offerpie_job_cleaner` 清洗入库，后端只消费业务表。