touyun-elderly-care/openspec/changes/svc-org-c1-elder/specs/shared/api-contract/spec.md

ADDED Requirements

Requirement: 老人档案接口

/elder/list、/elder/create、/elder/detail、/elder/status/change、/elder/status/log、/elder/assess-evidence/upload MUST 存在，遵循统一响应 {code,message,data,hint}。

Scenario: 状态变更必填原因

• WHEN 调用 /elder/status/change 且缺 change_reason
• THEN 返回校验错误，拒绝变更

Requirement: 身份证服务端掩码

/elder/list MUST 返回掩码后的身份证（如 5301**********1234）；明文仅在 /elder/detail 且 admin/qc 授权时返回，并 MUST 落审计。

Scenario: 列表掩码

• WHEN 调用 /elder/list
• THEN id_card_no 返回掩码值，非明文