# 一期范围、责任与验收清单

冻结日期：2026-09-08。范围依据：负责人本轮明确确认。本文是一期范围与交付状态的权威清单；历史路线图与本文冲突时，以本文为准。

范围冻结不等于设计批准或验收通过。八个待交付功能组全部属于一期，不再以“后置建议”将其排除。新增接口、迁移、计分规则和权限变化仍需在各模块设计中明确后编码。本文不预分配版本号、迁移号或接口数量。

## 1. 责任与完成定义

- 张顺（你）：业务与产品负责人，主责评分、监测、消息和简历相关能力。
- 小刘：主责内容与数据型功能、积分独立模块及交付环境。
- 表中负责人负责设计、实现、测试和文档；另一位负责独立审查。模块作者不能用自己的完成报告代替独立验收。
- 前端由现有前端同学实现，后端负责人提供契约并组织联调；未指定具体前端人员，不虚构责任人。
- 状态采用：待设计、设计待确认、实现中、待独立复验、待真库验收、待前端验收、一期验收完成。Git 已提交与功能已验收分别记录。
- 每项完成必须具备：需求用例、权限与隐私边界、可执行自动化、适用的真实 MySQL 验证、前端流程验收、文档和可追溯提交。无需迁移的模块不强行新增迁移。

下面代码路径均相对项目根目录 `C:/Users/15642/Desktop/zhilai`。生产包根为 `mydreamjob-server/src/main/java/com/mydreamjob/`，测试包根为 `mydreamjob-server/src/test/java/com/mydreamjob/`。拟新增包只是定位建议，不代表已存在。

## 2. 已有核心能力：保留在一期，执行集成回归

这些能力已有代码及历史验证记录；本轮仅核查入口和 Git，不重新宣称所有历史黑盒已通过。

| 编号/能力 | 一期需要什么 | 现有代码入口（生产包根下） | 如何验收 | 主责 / 复核 |
|---|---|---|---|---|
| C01 认证与企业认证 | 注册登录、身份校验、企业认证与权限隔离 | auth/、verification/、config/SecurityConfig.java | 登录失败/过期/匿名/角色越权；企业审核主链路；生产短信配置验证 | 小刘 / 张顺 |
| C02 档案与岗位 | 学生资料、偏好、企业资料、岗位发布搜索收藏比较 | profile/、preference/、company/、job/ | 企业只能改本企业岗位；公开字段白名单；筛选分页与资料更新页面联调 | 小刘 / 张顺 |
| C03 招聘主链路 | 投递、面试、结构化评分、Offer、进度 | application/、interview/、interviewscore/、offer/、careerprogress/ | 从注册到投递、面试、Offer逐步操作；拒绝/撤回/过期/重复请求与并发 | 张顺 / 小刘 |
| C04 沟通与安全 | 匹配、会话、消息、通知、举报屏蔽 | messaging/、notification/、bidirectionalmatch/、safety/ | 非成员不能读写；屏蔽生效；DIRECT与邀约会话隔离；重试不重复 | 张顺 / 小刘 |
| C05 简历与账户隐私 | 简历版本导出、个人数据导出、注销与隐私授权 | resume/、privacy/、deletion/、dataexport/ | 文件下载归属；导出内容脱敏；注销状态机；保留策略和恢复验证 | 张顺 / 小刘 |
| C06 评价与企业回复 | 评价、预审、管理员决策、企业官方回复 | review/、feedback/ | 公开载荷无学生身份；仅通过回复公开；幂等及审核并发；企业归属 | 小刘 / 张顺 |
| C07 测评与评分治理 | RIASEC、四维能力、评分卡、排名、申诉回滚、防刷 | assessment/、ability/、candidatescore/、competition/、risk/ | 抽题/计时/有效期/规则开关；申诉回滚；评分读取与写入边界；结果解释 | 张顺 / 小刘 |
| C08 推荐与人才邀约 | 岗位推荐、学生授权发现、企业邀约与接受后沟通 | recommendation/、talentdiscovery/、talentinvitation/ | 默认不发现；同企业历史投递排除；限额/冷却/幂等；接受后会话隐私 | 张顺 / 小刘 |
| S01 认证安全整改 | 验证码不落日志、受控取码、`/jobs` 认证边界 | auth/、docs/smoke-test.sh、job/JobController.java | 双开关受控取码；mock=false 完整回滚；`/jobs` 权限矩阵（独立代码复验与真实 MySQL/Docker 黑盒已通过） | 张顺 / 独立复验 |
| S02 Token 隔离与会话吊销 | Access/Refresh 类型与密钥隔离、轮换、重放处置、会话吊销 | auth/（JwtTokenProvider、AuthSessionService、AuthTokenHasher、JwtAuthenticationFilter、AuthController）、V42__auth_token_sessions.sql | Refresh 不能访问普通接口；Access 不能刷新；二次使用撤销当前会话；并发刷新最多成功一次；登出/注销完成使会话失效 | 张顺 / 独立复验 |

## 3. 一期必须补齐的八个功能组

以下交付边界用于控制设计范围；涉及产品参数的内容明确列为待评审，不得由实现者自行锁定。

| 编号/功能 | 当前状态与一期需要什么 | 代码在哪里 | 如何验收 | 主责 / 复核 |
|---|---|---|---|---|
| N01 V43过程公平性与稳定性监测 | 独立代码复验、真实 MySQL/Docker 验收及 Git 检查点已完成（cf39737）；历史不足返回UNAVAILABLE | 现有 scoringmonitoring/；docs/v43-candidate-scoring-fairness-design.md | 版本内补集、申诉集合、权限、只读性及30/300/3000查询预算通过；EXPLAIN扩容风险纳入容量观察 | 张顺 / 小刘 |
| N02 评分规则解释与合理性 | 独立代码复验、真实 MySQL/Docker 验收及 Git 检查点已完成（dbd27e6） | candidatescore/CandidateScoringCalculator.java、CandidateScoringEngineService.java、candidatescore/explanation/；docs/candidate-scoring-explanation-design.md、docs/candidate-scoring-rule-evidence.md | 未知规则安全失败；真实 H2 时间边界、四入口单次 capturedNow、企业完整 JSON 脱敏、运行时 OpenAPI 与真库回归均已通过 | 张顺 / 小刘 |
| N03 行业技能词云 | 未确认有独立实现；用有授权、可追溯的数据生成技能频次，支持空数据与更新时间；不是装饰性随机词云 | 现有 job/、recommendation/ 可复用数据入口；拟新增 skillinsight/ | 同义词归一/去重/计数用已知样本对账；行业筛选与来源日期准确；无数据不编造；批量性能与页面联调 | 小刘 / 张顺 |
| N04 入职清单与公司知识介绍 | 未确认有独立实现；清单模板、个人完成进度、公司可公开介绍；公司原有介绍与新增入职知识明确区分 | 现有 company/、offer/、careerprogress/；拟新增 onboarding/ | 本人进度隔离、企业内容归属、模板变更行为、重复更新；未认证内容不得冒充平台核验；页面完整走通 | 小刘 / 张顺 |
| N05 薪资计算器与薪资参考 | 未确认有独立实现；可解释的计算明细与有来源的薪资参考；明确币种、周期、地区、规则生效期和估算性质 | 现有 job/、offer/ 可提供薪资字段；拟新增 salary/ | 经确认的规则用独立算例验证舍入与边界；来源/版本/更新时间；缺地区或参考样本时明确不可计算/不足；不伪造市场数据 | 小刘 / 张顺 |
| N06 诚信积分与激励 | 独立积分能力未完成，现有INTEGRITY不是积分账户；先确定合格行为、积分流水、撤销和展示语义，不以简单行为推断人格 | 现有 candidatescore/CandidateScoringCalculator.java#computeIntegrity、audit/；拟新增 incentive/ | 积分事件幂等、并发不重复加分、撤销可追溯、余额与流水一致、刷行为不无限获益；与候选评分默认隔离，接入必须单独评审 | 小刘 / 张顺 |
| N07 消息撤回 | N07 定向整改完成并通过自动化与干净构建，待独立代码复验与真实 MySQL/Docker 验收；发送者在两分钟窗口内撤回，列表/响应统一显示撤回态并覆盖原正文 | 现有 messaging/MessagingService.java、talentinvitation/；docs/message-recall-design.md、docs/message-recall-implementation-instruction.md、docs/messaging-api.md | 非本人不可撤回；时间边界、并发读取/撤回、幂等；撤回后正文不从当前数据库、响应、日志或审计泄漏；DIRECT与邀约会话回归 | 张顺 / 小刘 |
| N08 简历查重 | 未确认有独立实现；先界定同人重复上传与跨文档相似检测，给出依据和局限；不得直接判抄袭或自动扣分 | 现有 resume/ResumeVersionService.java、profile/storage/；拟新增 resumededup/ | 重复文件/改名/模板相似/不同格式/解析失败样例；阈值误报验证；不得借查重返回他人简历、姓名或联系方式；上传性能与租户隔离 | 张顺 / 小刘 |

### 编码前必须补齐的产品决策

范围已确认，以下细节未确认。负责人先交付短设计，双方评审后再实现，不因缺细节将功能移出一期。

- N02：各规则的业务含义、兼容解释方式、测评试测样本与证据门槛已形成；本版不改变现有分数、企业聚合或排名，后续规则调整必须另开评分版本。
- N03：行业受控字典、数据来源和授权、统计窗口、最小样本、更新方式。
- N04：清单适用人群与触发点、模板维护方、公司内容发布/审核机制、进度保存方式。
- N05：税前/税后/年包范围、支持地区、规则与市场参考数据来源、更新责任。涉及税费规则时设计阶段查验权威资料。
- N06：积分名称、可积分事件、额度、冷却、撤销、兑换或仅展示；不能默认涉及现金/奖品。
- N07：撤回时间窗、附件与引用、离线/缓存同步、审计及数据保留口径。
- N08：查重范围、合法数据边界、文件类型、指纹或文本相似算法、阈值和提示对象；跨用户查重需单独隐私评审。

## 4. 一期交付保障，同样属于未完成工作

| 编号 | 需要什么 | 入口 | 如何验收 | 主责 / 复核 |
|---|---|---|---|---|
| G01 可复现构建与持续验证 | 干净环境构建、PR检查、MySQL兼容验证、精确版本产物 | mydreamjob-server/pom.xml、测试目录、backend-infra/；CI落点待设计 | 新环境按文档运行；提交触发测试；失败阻断；JAR摘要关联提交 | 小刘 / 张顺 |
| G02 部署与恢复 | 环境隔离、密钥管理、必要外部服务、文件持久化、数据库/文件备份恢复、发布回退 | backend-infra/、profile/storage/、resume/storage/、dataexport/storage/ | 隔离环境部署演练、恢复演练和回退证据；不把启动成功当恢复完成 | 小刘 / 张顺 |
| G03 监控、安全与容量 | 指标告警、权限隐私、依赖失败、重试、压测、敏感信息检查 | config/、audit/、健康检查、各模块 | 定义预计并发与SLA后实测；故障有告警、可定位；依赖中断和重复请求不破坏一致性 | 小刘 / 张顺 |
| G04 一期前端联调与用户验收 | 核心招聘链路与N01–N08对应页面可用，空态/错误态明确 | docs/frontend-integration.md、各API文档、前端仓库待登记 | 前端同学参与逐项签收；合成账号端到端录证；缺陷关闭后小范围试运营 | 张顺 / 小刘 |

这四项是交付工作包，不代表恰好四个代码模块。已有资产可复用，但必须提供当前证据。

## 5. 排期与合并顺序

1. 张顺先收尾N01并完成N02规则评审；小刘同步搭建G01及设计N03。N01真库验收通过前不宣称V43冻结。
2. 张顺实现N07；小刘实现N03，再实现N04。各模块先短设计、后实现、再独立验收。
3. 张顺实现N08；小刘实现N05。数据来源、隐私与阈值未确认时先处理其他不依赖的工作。
4. N02语义确认后，小刘实现N06，张顺复核与评分引擎的边界。
5. G02/G03从第一阶段持续推进，最后执行G04和整体发布演练，不等所有业务代码写完才准备环境。

并行开发前登记各自改动路径。共享文件（ErrorCode、SecurityConfig、OpenAPI、路线图）由当次集成负责人串行合并。新Flyway号在准备合并前从实际主线分配；不得两人各自假定下一号。每个模块独立提交，可以批量推送，但不要将整个一期积累成一个巨型提交。

不承诺未估算的日期。每个短设计确认后再估工时、依赖和验收时间。当前是“8个待闭环功能组 + 4个交付工作包 + 既有核心回归”，不能折算成未经验证的完成百分比。

## 6. 明确移出一期

以下进入后续候选池，不占一期验收范围：

- AI简历诊断与生成式优化；
- AI模拟面试与面试题预测；
- SHAP高级模型解释；一期仍包含确定性规则解释；
- 受保护人口属性公平性分析；一期不推断敏感属性；
- 需要新增不可变历史快照才能实现的历史分数漂移、历史排名稳定性；V43一期返回UNAVAILABLE；
- 自动调整评分/排名/权重、自动封禁；
- 超出已确认模块的现金奖励、交易/付费及新增商业化功能。

行业技能词云、入职清单/公司知识介绍、薪资计算器/参考、诚信积分/激励、消息撤回、简历查重均明确保留在一期。

## 7. 范围变更与状态证据

新增或删减一期项须记录负责人决定、原因、影响、验收变化。变更实现细节不得隐式改变产品范围。每次交付更新本清单状态与证据链接；不靠版本号大小代表完成度。

本轮仅冻结范围和责任，没有新增业务代码、迁移或测试执行。历史测试数不能视为本轮复验结果。已核实提交包括V39 55e3975、V40 2698d06、V41 5cc2c86、V42 96b3113；V43仍未提交且待整改复验。