3.9 KiB
AI-001 工作经历AI优化后端整合说明
日期：2026-10-23；目标仓库baskbuddy/zhangshun，分支qingsongpin-AIDevelop，移植基线8c94291；由用户提交推送。本交付尚无AI提交SHA。
功能与文件
新增mydreamjob-server/src/main/java/com/mydreamjob/resume/optimization/下12个Java文件：Controller入口、Service权限与校验、Router模式选择、局部Advice安全错误、请求响应DTO、模型接口、模拟及DeepSeek实现、配置、输入guard和模型异常。 新增src/main/resources/ai/下work-experience-v1.txt及work-experience-deepseek-v1.txt；新增src/test/java/com/mydreamjob/resume/optimization/下8个测试类。src均相对mydreamjob-server。 修改docs/openapi-rc.json仅新增AI路径；docs/verify_openapi.py同步183 paths/221 operations和AI断言；docs/resume-api.md追加模块说明。交付本说明、前端对接方案和质量评审。无新依赖、迁移、数据库写入、全局认证或配置文件修改。
配置与启动
复用原后端基础设施/JWT运行配置；不提交任何真实凭据。模式配置AI_WORK_EXPERIENCE_MODE=off/stub/deepseek，默认off；未指定mode且旧ai.work-experience.stub-enabled=true时兼容stub。deepseek要求SPRING_PROFILES_ACTIVE含dev，其他profile不允许真实模式。显式mode优先且非法值失败，Key缺失不降级。 真实模式仅开发合成数据使用：DEEPSEEK_API_KEY通过本机或部署环境安全注入；DEEPSEEK_MODEL默认deepseek-flash，可选deepseek-v4-pro；DEEPSEEK_TIMEOUT_SECONDS默认20秒（1至60）。无需开启DEEPSEEK_LIVE_TEST或DEEPSEEK_QUALITY_TEST启动服务。可选SERVER_PORT=8081避免冲突，API前缀/api/v1。 官方端点固定https://api.deepseek.com/chat/completions，非流式、关闭思考、JSON、1500最大输出token，不跟随重定向、不自动重试，64KiB响应上限。异常不携带原始cause或上游正文。输入guard只覆盖列举模式，不保证全面脱敏；JSON结构不能证明事实忠实。
整合与验收
先检查AI路径及共享契约冲突，保留目标其他模块；不整包覆盖认证/业务代码。目标定向命令在mydreamjob-server执行：
mvn -q '-Dtest=*WorkExperience*Test' test
离线验证时保证DEEPSEEK_LIVE_TEST和DEEPSEEK_QUALITY_TEST未设为true，否则会触发付费真实请求；两项默认跳过。在仓库根执行python ./docs/verify_openapi.py。 负责人后续在隔离开发环境启动，以STUDENT开发账号向POST /api/v1/profile/me/work-experience-optimization发送合成请求，检查simulated=false、promptVersion=work-experience-deepseek-v1及错误路径；请求示例见前端方案。不要用refresh-token访问业务接口。完整JWT过滤链及实际HTTP尚未验收，不能用standalone MockMvc替代。生产限流、数据政策供应商确认、正式告知/授权及至少30例评测尚未完成；不得直接生产发布。 源历史证据：用户IDEA单例真实调用通过；5例合成质量评审未见描述事实新增，有表达提升有限及建议措辞观察项，见质量评审。本次不会重复外呼。
回滚与交付边界
回滚先mode=off重启；必要时撤销本批精确文件，无数据库回滚。无自动保存、前端修改、评分变化；复用现有保存流程。暂停AI-002不在本交付。不要提交target、日志、.idea、.env、真实Key或用户资料。用户核对精确暂存清单后自行提交/推送，先确认分支CI是否自动部署；助手不提交推送、不触发Jenkins。
目标仓库实际验证（2026-10-23）
在qingsongpin-AIDevelop基线8c94291移入后，定向测试22项：20通过、2跳过、0失败0错误；OpenAPI183 paths/221 operations及AI断言通过；git diff --check通过。Key长字串模式扫描未发现疑似真实Key（仅模式检查，不代表全面秘密检测）。无生产环境、HTTP黑盒或真实模型新增调用；未提交/推送。关键认证及pom未修改。