2.2 KiB
AI-001 工作经历AI优化前端对接方案
日期：2026-10-23。交付范围：后端AI建议生成；前端由前端负责人实施，复用原页面及保存流程。
POST /api/v1/profile/me/work-experience-optimization，Content-Type application/json，Authorization: Bearer ，仅当前STUDENT。不得传用户ID。
{"position":"后端开发工程师","description":"负责订单查询接口开发，使用Java和MySQL，参与问题排查。","targetPosition":"Java后端开发","externalProcessingConsent":true}
position、targetPosition可选各最多100字符；description必填非空最多3000字符；externalProcessingConsent必填true，仅保留现有接口契约，不代表正式告知/授权闭环已完成。
成功HTTP200使用ApiResponse，code=200、message=ok，data字段：status为OPTIMIZED/NEED_MORE_INFO；optimizedDescription为建议，信息不足可null或省略；suggestions、followUpQuestions为字符串数组；promptVersion为可信提示词版本；simulated标识是否模拟。真实dev模式为false/work-experience-deepseek-v1，stub为true/work-experience-v1。无流式或分页。
错误HTTP400参数或敏感输入拒绝（code可能400/1001）；401未登录；403角色拒绝（可能code2002）；404用户不存在；502无效模型结果；503关闭或模型不可用；504超时。模型错误仅安全固定文案，不回传上游正文。HTTP状态与业务code不能一概等同。
按钮流程：取当前一条描述→显示加载并防重复点击→展示原文/建议/补充问题→允许编辑、采用、取消→采用回填工作内容→沿用已有保存。失败/取消保留原文，原文已改变则丢弃旧响应。可设置25秒前端等待，超时不自动重试（供应商仍可能计费）。本接口不写数据库，不改变公司/时间、评分或企业可见性。
验证：源目录离线22项20通过2跳过；用户本机单例真实调用与5例合成质量评审有证据。目标仓库移植验证见后端整合说明。实际启动后的HTTP/JWT黑盒、前端、完整生产数据治理与至少30例评测仍未完成。当前只允许dev合成联调，告知文案按用户要求暂缓，不视为可上线。