隐私设置（Privacy Settings）API 联调说明

模块：学生隐私设置。用于控制简历可见性与联系方式可见性，仅 STUDENT 角色可用。

1. 接口概览

方法	路径	角色	说明
GET	`/profile/me/privacy`	STUDENT	查询当前学生隐私设置；无记录返回默认对象，不写库
PUT	`/profile/me/privacy`	STUDENT	更新当前学生隐私设置；upsert 确保同一学生至多一行

其余角色：COMPANY / ADMIN → 403 / 2002；未登录 → HTTP 401。

身份一律从 JWT / SecurityContext 获取，不接受 userId、studentUserId、candidateId 等请求参数。

2. 枚举 `ResumeVisibility`

值	含义
`PRIVATE`（默认）	企业不可见
`APPLIED_COMPANIES`	仅当学生在该企业存在有效投递时企业可见（WITHDRAWN / REJECTED 不算有效投递）
`VERIFIED_COMPANIES`	仅 `verified=true` 的企业可见

3. GET /profile/me/privacy

无 Path / Query / Body 参数。

无历史记录时返回默认对象（不会向数据库写入任何记录）：

{
  "code": 200,
  "message": "ok",
  "data": {
    "studentUserId": 2,
    "resumeVisibility": "PRIVATE",
    "contactVisible": false,
    "version": 0
  },
  "timestamp": "2026-08-25T10:00:00Z"
}

有历史记录时额外包含 id、createdAt、updatedAt。

状态码	业务码	说明
200	200	成功
401	401	未登录
403	2002	非 STUDENT 角色

4. PUT /profile/me/privacy

请求体（ContactVisible、resumeVisibility 必填，version 可选）：

{
  "resumeVisibility": "APPLIED_COMPANIES",
  "contactVisible": true,
  "version": 0
}

首次调用创建记录，之后更新，始终保证同一学生只有一行。
version 不传或传 0 表示非严格校验；传了且与当前版本不一致 → 409 / 9201。

响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "id": 1,
    "studentUserId": 2,
    "resumeVisibility": "APPLIED_COMPANIES",
    "contactVisible": true,
    "version": 0,
    "createdAt": "2026-08-25T10:00:00",
    "updatedAt": "2026-08-25T10:00:00"
  },
  "timestamp": "2026-08-25T10:00:00Z"
}

状态码	业务码	说明
200	200	成功
400	1001	缺少必填字段 / 非法枚举
401	401	未登录
403	2002	非 STUDENT 角色
409	9201	乐观锁版本冲突

5. 隐私脱敏接入说明

现有企业候选人详情 /company/candidates/{applicationId} 与候选人列表 /company/candidates 已在响应中排除 resumeUrl 与联系方式字段，保持原路径、原权限、原白名单不变，且本轮不新增联系方式字段。

隐私策略方法 canCompanyViewResume(studentUserId, companyId, applicationId) 已随本模块提供，供企业侧按 ResumeVisibility 判定简历可见性。

6. 审计

更新隐私设置会写入审计日志 UPDATE_PRIVACY_SETTINGS。审计中不得写入 phone / email / password / jwt / resumeUrl 等敏感值。

3.1 KiB Raw Blame History