qingsongping-AIDevelop/docs/phase1-scope-and-acceptance.md

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

冻结日期：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/	默认不发现；同企业历史投递排除；限额/冷却/幂等；接受后会话隐私	张顺 / 小刘

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

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

编号/功能	当前状态与一期需要什么	代码在哪里	如何验收	主责 / 复核
N01 V43过程公平性与稳定性监测	独立代码复验与真实 MySQL/Docker 验收通过，待 Git 检查点；历史不足返回UNAVAILABLE	现有 scoringmonitoring/；docs/v43-candidate-scoring-fairness-design.md	版本内补集、申诉集合、权限、只读性及30/300/3000查询预算通过；EXPLAIN扩容风险纳入容量观察	张顺 / 小刘
N02 评分规则解释与合理性	独立代码复验与真实 MySQL/Docker 黑盒验收通过，待 Git 检查点	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 消息撤回	未确认有独立实现；发送者在批准窗口内撤回，列表/详情/重试响应同步显示撤回态；保留必要审计	现有 messaging/MessagingService.java、talentinvitation/；新增位置由设计确定	非本人不可撤回；时间边界、并发发送/读取/撤回、幂等；撤回后正文不从缓存或历史响应泄漏；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仍未提交且待整改复验。