日期:2026-10-07
状态:已确认(2026-10-07)
范围:市场基础信息「客户管理」+ 细胞存储采集协议单 + 科研捐赠协议单
biz_customer 是独立客户主数据。采集协议保存时,目前只把母亲同步进客户表,并写到当事人表唯一的 customer_id。父亲、子女姓名等信息只存在当事人子表字段上,没有客户 ID。客户详情只展示本人字段,看不到同协议其他人和关联协议。
产品要求:
customer_id。不改 biz_customer 结构。扩展两张当事人表:
biz_protocol_party_customer| 字段 | 说明 |
|---|---|
customer_id |
已有,母亲客户 ID |
father_customer_id |
新增 VARCHAR(64) NULL,父亲客户 ID |
newborn_customer_id |
新增 VARCHAR(64) NULL,子女客户 ID |
biz_research_donation_party同样增加 father_customer_id、newborn_customer_id;已有 customer_id 仍表示母亲。
不把 customer_id 改名为 mother_customer_id,避免无谓迁移;代码与 API 注释写明「母亲」。
SQL 放在 docs/sql/migrations/(例如 2026-10-07-party-father-newborn-customer-id.sql),并同步 SQLAlchemy 模型。
关联约定:同一行上的三个 ID 即同一协议家庭;查询某客户相关协议时:
customer_id = :id
OR father_customer_id = :id
OR newborn_customer_id = :id
细胞存储与科研捐赠各查一次,按租户、del_flag=0 过滤。
抽公共函数(建议 backend/app/services/party_customer_sync.py),细胞存储与科研捐赠保存当事人时调用。范围仅当前这一张协议的三个角色。
每个角色(母亲 / 父亲 / 子女)独立处理:
biz_customer 记录)。性别默认:母亲 1,父亲 0,子女用当事人 newborn_sex,缺省 2。
年龄:能从身份证推算则写入,否则空。
协议当事人上的母亲/父亲/子女姓名电话等业务字段仍照旧写入子表,客户表只存客户主数据字段。
当本单某角色「当前挂着的客户 A」与「身份证已存在的客户 B」且 A.id != B.id:
phone_no、age、sex(仅当目标为空或未知 2 时用源值)、remark:目标为空才补,不覆盖已有。customer_tags:按逗号拆开后做并集再写回 B。customer_name:保留 B(身份证命中的已有客户为准)。del_flag=1)。若身份证不撞库:不换 ID,只更新当前客户。
上线脚本(Python 或 SQL + 服务函数均可,须幂等):
biz_protocol_party_customer、biz_research_donation_party。之后日常只在保存当前协议时同步,不再全库重跑。
客户管理查看弹窗自上而下:
create_time 倒序)。每组展示:
register_date,科研捐赠用 donation_date,接口统一字段名 registerDate。ProtocolViewDialogDonationViewDialog无关联协议时,关联客户、关联协议区块展示空态文案。
GET /api/admin/customers/{id}/relations(需客户查看权限,租户隔离):
{
customer: { ...与客户详情一致 },
relatedGroups: [
{
bizType, // cell_storage | research_donation
protocolId,
protocolNo, // 细胞存储 protocol_no;科研捐赠 donation_no
protocolStatus, // protocol_status / donation_status
registerDate, // register_date / donation_date
myRole, // mother | father | newborn
members: [
{ role, customerId, name, phone, idCardNo }
]
}
],
protocols: [
{ bizType, protocolId, protocolNo, protocolStatus, registerDate, myRole }
]
}
relatedGroups 与 protocols 同源:每张相关协议一组;members 含本客户及同单其他人(有客户 ID 或至少有姓名的角色)。protocols 便于下方摘要表直接绑定。
打开协议详情:前端复用现有协议/捐赠详情接口与弹窗。无对应协议查看权限时:协议号不可点或点击后提示无权限(与现有权限码一致,不新造权限)。
biz_customer 全量未删除记录;父亲、子女会出现为独立行。biz_customer;保存后按第 4 节回写三个 ID。| 项 | 结论 |
|---|---|
| 关联落点 | 当事人表三个客户 ID,不新建关系表 |
| 母亲 ID | 沿用已有 customer_id |
| 业务范围 | 细胞存储 + 科研捐赠 |
| 无证 | 有姓名即可建客户 |
| 补证撞库 | 合并后软删临时客户,协议改挂已有客户 |
| 存量 | 上线全量脚本 + 之后仅保存当前单时同步 |
| 详情布局 | 上:按协议分组的关联客户;下:协议摘要;点协议号弹详情 |
| 中试 | 本期不动 |