【A11】统一实体标识符（UEID）规范

A11 数据同步系统 - ID 标识规范

一、核心设计哲学

1.1 设计原则

ID 设计原则 │ ├── 服务器统一分配原则 │ ├── 所有有效 ID 均由服务器生成 │ ├── 客户端不得自行指定有效 ID │ └── 客户端提交时 ID 字段可省略或填 0 │ ├── 符号语义分离原则 │ ├── 负数 → 机构/系统实体 │ ├── 正数 → 人员实体 │ └── 零值 → 未确认占位符 │ ├── 权限自然继承原则 │ ├── -1 代表 ROOT_ORG（根组织） │ ├── i64::MAX 代表 SUPER_ADMIN（超级管理员） │ └── i64::MIN 代表 DELETED_ORG（删除回收站） │ └── 排序天然有序原则 ├── 正数（人员）排在负数（机构）之后 ├── 同符号内权重小的优先 └── 权重相同数值小的优先

1.2 一句话理解

负数管组织，正数管人员，零是临时工，极值管全局

二、ID 分类总览

2.1 按符号分类

ID 符号分类 │ ├── 负数（-1, -2, -3 ...） │ ├── 实体类型：机构/系统实体 │ ├── 包含：Organization、Project、Team │ ├── 符号位：1 │ └── 特征：系统级实体，统一管理 │ ├── 正数（1, 2, 3 ...） │ ├── 实体类型：人员实体 │ ├── 包含：Person │ ├── 符号位：0 │ └── 特征：业务人员，身份绑定 │ ├── 零（0） │ ├── 实体类型：未确认占位符 │ ├── 权限：无任何权限 │ └── 用途：临时标识，等待服务器分配有效 ID │ ├── i64::MIN（-9223372036854775808） │ ├── 实体类型：删除回收站 │ ├── 符号位：1（机构类） │ └── 用途：已删除实体的归档容器 │ └── i64::MAX（9223372036854775807） ├── 实体类型：超级管理员 ├── 符号位：0（人员类） └── 用途：根组织（-1）的全权代理人

2.2 快速对照表

三、64 位 ID 位域结构

3.1 位域分配

64 位 ID 结构

位域分配速查表

四、取值对照表

五、特殊 ID 位域解析表

六、排序规则表

七、ID 操作函数示例

// 提取符号位（0=人员，1=机构）fnsign(id:i64)->i8{((id>>63)&1)asi8}// 提取权重位（15位，1-32767）fnweight(id:i64)->u16{((id>>48)&0x7FFF)asu16}// 提取数值位（48位，0-2^48-1）fnvalue(id:i64)->u64{(id&0x0000FFFFFFFFFFFF)asu64}// 判断是否为机构实体fnis_organization(id:i64)->bool{id<0&&id!=i64::MIN}// 判断是否为人员实体fnis_person(id:i64)->bool{id>0&&id!=i64::MAX}// 判断是否为根组织fnis_root_org(id:i64)->bool{id==-1}// 判断是否为超级管理员fnis_super_admin(id:i64)->bool{id==i64::MAX}// 判断是否为删除回收站fnis_deleted_org(id:i64)->bool{id==i64::MIN}

八、常量定义表