家庭身份（后台网关）

机构后台 / 机构端患者详情页「家庭成员」字段展示。家庭信息作为 member 详情的扩展字段返回，不再单独提供接口，通过 expand=family 挂载。业务逻辑在 sd-member-service。

获取家庭信息：GET /members/:id?expand=family

患者详情页加载时随详情一并请求。后端按当前患者身份自动分支查询，返回 family 字段，前端依据 familyFieldVisible 决定是否渲染「家庭成员」行。

expand 由网关透传至 sd-member-service 的 member 详情；sd-console-server（云医端）与 sd-organization-server（机构端）的 GET /members/:id 均支持该扩展。

请求参数（Query String）

参数名	示例值	类型	必须	说明
id	100	number	是	路径参数，当前查看的患者 memberId
expand	family	string	否	传入 family 返回家庭扩展信息

返回参数（挂载在 member 详情对象上的 family 字段）

参数名	示例值	说明
memberId	100	当前患者 memberId
familyIdentityType	1	当前患者家庭身份 0=未设置 1=家长 2=青少年 3=成年
familyFieldVisible	true	是否展示「家庭成员」字段
members	[]	家庭成员列表

members 数组元素：

参数名	示例值	说明
memberId	200	家庭成员 memberId
name	'张三'	姓名
familyIdentityType	2	该成员家庭身份

请求示例

curl 'https://<网关域名>/members/100?expand=family' \
  -H 'Token: <authorization>'

返回示例

以下仅展示 family 相关字段，其余 member 详情字段按 GET /members/:id 原接口返回，此处省略。

{
  "code": 0,
  "message": "success",
  "data": {
    "id": 100,
    "name": "王五",
    "familyIdentityType": 1,
    "familyFieldVisible": true,
    "family": {
      "memberId": 100,
      "familyIdentityType": 1,
      "familyFieldVisible": true,
      "members": [
        {
          "memberId": 200,
          "name": "张三",
          "familyIdentityType": 2
        }
      ]
    }
  }
}

---

前端渲染规则

当前身份	展示文案	members 长度
1 家长	孩子：张三（姓名可点击，跳转该成员详情）	0..1
2 青少年	家长：王五（姓名可点击，跳转该成员详情）	0..1
0 / 3	不渲染该行	0

本期范围

• 后台为只读展示，不提供新增/解绑亲子关系的操作入口
• 家长不可查看孩子的业务数据（量表、日记、服药记录等），仅展示关系本身
• family.members 中每个成员的姓名渲染为链接，点击跳转 /members/{memberId} 详情页

前端页面实现不在本仓库。本仓库（sd-console-server / sd-organization-server）仅提供上述网关透传能力，患者详情页「家庭成员」字段的 UI 由前端团队在其仓库中按本文档规则另行开发。

详细业务规则见 sd-member-service/docs/apis/member-family-api.md