8.5 KiB

Raw Blame History

本人在线简历：非 AI 接入约定

范围：基础信息与联系方式、求职意向、多段教育/工作/项目经历、技能详情、自我评价、在线简历保存与 DOCX 生成。此文对应工作区新增实现，不代表已经部署。既有附件上传下载、附件版本和权限规则继续使用原接口。

接口

以下路径均加 /api/v1；所有接口需要当前 STUDENT 的 Bearer Token。身份只来自认证上下文，不接受 userId 指定他人。COMPANY、ADMIN 不可使用，企业候选人响应不新增手机号或邮箱。

方法	路径	用途
GET	`/profile/me/online-resume`	整份读取，首次 revision=0，不自动写库
PUT	`/profile/me/online-resume`	整份保存，body 为 `{revision, content}`
GET	`/profile/me/online-resume/{section}`	某类条目列表
POST	`/profile/me/online-resume/{section}`	新增条目，body 为 `{revision, entry}`
GET	`/profile/me/online-resume/{section}/{id}`	本人条目详情
PUT	`/profile/me/online-resume/{section}/{id}`	替换一条，body 为 `{revision, entry}`
DELETE	`/profile/me/online-resume/{section}/{id}?revision=数字`	删除一条
GET	`/profile/me/online-resume/download`	当前已保存内容生成 DOCX，二进制响应

section 仅限 education-experiences、work-experiences、project-experiences、skills。动态路由不表示可修改其他字段。

GET、保存和条目修改的成功响应仍用 {code:200,message:"ok",data:...}。整份 data 为 {revision,content,attachment,updatedAt}；条目列表/详情只返回条目自身。attachment 无附件时为 null 或省略，有附件时包含 fileName/contentType/size/downloadUrl；downloadUrl 为鉴权接口地址，不能直接把存储键拼成公网 URL。

完整保存示例

{
  "revision": 0,
  "content": {
    "basicInfo": {
      "realName": "合成测试",
      "phone": "13800000000",
      "email": "synthetic@example.test",
      "location": "测试城市",
      "education": "本科",
      "school": "合成大学",
      "graduationYear": 2022
    },
    "jobIntention": {
      "targetPosition": "后端工程师",
      "expectedSalaryMin": 10000,
      "expectedSalaryMax": 20000,
      "preferredCities": ["测试城市"],
      "employmentTypes": ["FULL_TIME"],
      "preferredIndustries": [],
      "preferredJobTypes": [],
      "remoteAllowed": false,
      "jobSeekingStatus": "LOOKING",
      "employmentStatus": "UNEMPLOYED",
      "availableFrom": "2026-11-01"
    },
    "educationExperiences": [
      {"school":"合成大学","major":"计算机","degree":"本科","startDate":"2018-09-01","endDate":"2022-06-30","ongoing":false,"description":"合成教育描述"}
    ],
    "workExperiences": [
      {"company":"合成企业","position":"开发工程师","startDate":"2022-07-01","ongoing":true,"description":"合成工作内容"}
    ],
    "projectExperiences": [
      {"name":"合成项目","role":"开发","startDate":"2023-01-01","ongoing":true,"description":"合成项目内容"}
    ],
    "skills": [{"name":"Java","level":"PROFICIENT","years":3,"description":"合成技能说明"}],
    "selfEvaluation": "合成自我评价"
  }
}

这是完整替换接口，不能只提交当前编辑的一小块 content：空数组删除该类全部条目，可选字段 null/空字符串清空；省略某个集合会使用空集合，不能把省略理解为保持原值。局部编辑经历优先使用条目接口；基础信息、意向、自评编辑应先读完整内容，再修改相应块后整体保存。

新条目省略 id，服务器返回 UUID。保留既有条目时必须保留其 id；不存在或重复 id 返回 400，不接受自行指定新 id。条目 PUT 为完整替换，不能只提交某一个属性。条目顺序就是显示与导出的顺序。

字段及兼容

basicInfo.phone/email 是本人简历联系方式，首次未保存时从账号手机号/邮箱带出。保存不修改登录手机号、账号邮箱或密码，不表示邮箱已验证。空联系方式可以清空；联系电话支持数字、开头加号、空格和常见座机分隔符，最多 30 字符。
姓名、所在地、单组学历/学校/毕业年份复用既有个人资料；selfEvaluation 对应既有 bio；skills 的 name 同步到既有技能列表。旧资料接口更新后，再读在线简历会反映最新基础资料和技能名称；同名技能保留熟练度等扩展信息。老接口 skills 仍为历史字符串，新接口 skills 才是对象数组。
多段 educationExperiences 与旧的单组 education/school/graduationYear 不自动推断相互覆盖；前端需要展示主学历时明确填写 basicInfo 对应字段。
薪资单位为元/月、非负且下限不得高于上限；城市、用工类型、行业、岗位类型、远程意愿复用已有求职偏好。
jobSeekingStatus：LOOKING 正在求职、OPEN_TO_OPPORTUNITIES 考虑机会、NOT_LOOKING 暂不求职、STUDENT 在校求职身份。employmentStatus：EMPLOYED 在职、UNEMPLOYED 离职/未就业、STUDENT 在校。availableFrom 是可到岗日期。
每段经历 startDate 必填，使用 YYYY-MM-DD。ongoing=true 时 endDate 必须省略或为 null；否则 endDate 必填且不早于 startDate。教育必填学校/学历，工作必填公司/职位，项目必填名称。
教育最多 20 段，工作/项目各 30 段，技能 50 项；技能 name 不重复，level 为 BEGINNER/FAMILIAR/PROFICIENT/EXPERT，years 为 0—80 的整数。经历 description、自评各最多 5000 字；技能 description 最多 1000 字。其他长度约束见 OpenAPI。
在线简历保存不修改现有附件、不创建附件快照，也不把多段经历自动下发给企业或恢复任何简历授权。

保存、登录回填和错误

页面进入或切回账号后 GET 完整简历，按当前账号重建页面状态。不能只依赖上传控件、缓存或上一次登录的本地对象。
修改时提交最近一次成功响应中的 revision。成功后用响应整体替换页面数据，包括服务器分配的 id 和新 revision。
所有在线简历入口共用 revision，整份保存和条目修改都会加一。HTTP 409 / code 6002 表示版本过期：提示用户刷新并合并编辑，不能自动拿新 revision 盲重试覆盖。
HTTP 404 / code 6003 表示 section 或本人条目不存在；400 表示字段、日期、id 或大小不合法；401/403 按既有登录、角色流程处理。
revision 保护的是这些新增在线简历写入入口。不要并发用旧资料/偏好接口和新接口编辑同一份表单；旧接口并未加入在线简历 revision 协议。

附件、预览与导出

已有附件仍使用 POST/GET/DELETE /profile/me/resume。文件名、大小从新 GET 的 attachment 恢复展示，不能通过简历控件是否还保留本地 File 对象判断服务器有无附件。

在线预览可由前端根据 content 渲染。下载按钮携带 Bearer 获取 /profile/me/online-resume/download 的 Blob，按响应文件名保存 .docx；生成内容为服务器当前已保存的各段内容，不包含上传附件正文，编辑后应先保存再下载。此接口生成可编辑 Word 文件，不提供 PDF 排版或 AI 处理。

数据与验证边界

V59 新建 online_resumes，保存扩展内容与 revision；不回写历史迁移，不迁移或解析真实简历内容。新增数据纳入本人个人数据导出，账号注销完成时清理相应在线简历记录。未自动开放企业读取。

后端测试和制品证据单独保存在 D 盘；测试通过不表示已发布，前端接入与线上发布仍需分别安排。

本批本地验证（2026-10-20）：最终源码的在线简历业务测试在 H2 和 MySQL 8 各 16 项通过；MySQL 5.7/8 的 V58→V59 迁移及 V58 重投回归通过；两种 MySQL 的运行时/静态接口集合一致。最新 16 个测试套件报告合并为 502 项，0 失败、0 错误、0 跳过，是多次定向执行的汇总，不是一次全量测试。静态契约为 205 paths / 253 operations，既有 paths 和 schema 未改写。

证据目录：D:\Workspaces\qsp-online-resume-20261020-113017，详见 verification-summary.json、source-manifest.json、artifact-identity.json、logs/。构建副本基于 67b0957，只叠加本批白名单文件，不含两个受保护文件的工作区修改。本批尚未执行无筛选的全量 mvn verify、独立 JAR HTTP 黑盒或前端验收；DOCX 已做 ZIP/XML 结构检查，未做 Word 视觉渲染。未提交、推送、部署或运行线上迁移。

8.5 KiB Raw Blame History