@lark-apaas/coding-steering 0.1.13 → 0.1.15-alpha.0

package/steering/nestjs-react-fullstack/skills/user-identity/SKILL.md

@@ -43,6 +43,8 @@ match-template-name: nestjs-react-fullstack
 > （范围限定：上一条只约束 `useCurrentUserProfile()` 的消费代码。**项目其他场景** —— 例如调 spark `id_convert`、调飞书通讯录 API —— 出现 `open_id` / `union_id` 是正常且必要的，不在禁止之列。）
 >
 > **严禁**：当 `lark_user_id` 为空时回退到 `user_id` 展示。两套 ID 含义完全不同，回退会误导用户。正确做法是条件渲染：有值则展示，无值则不展示或展示"未关联飞书账号"。
+>
+> **严禁（大整数精度）**：妙搭 `user_id` 与飞书 `lark_user_id` / `employee_id` 虽是"纯数字字符串"，但实为 **I64 大整数（可超 9e15，超出 JS `Number.MAX_SAFE_INTEGER` 53 位安全整数上限）**。跨 JS ↔ SQL / Dataloom / 飞书插件边界一律**按 string 透传**，严禁 `Number()` / `parseInt()` / `+id` 转换——会静默丢精度，把通知/查询打到错误用户。
 
 ---
 
@@ -81,7 +83,7 @@ match-template-name: nestjs-react-fullstack
         └─ 是 ──→ 注入 AuthNPaasService 编写 Controller（第四节，仅适用于 user_id）
 ```
 
-> **相关技能**：接口认证/守卫/401 参见 `authn-guide`；登录/登出/获取用户信息等 Dataloom SDK 操作参见 `client-builtins-user-service`；**"用户能做什么"**（角色/权限点位鉴权）参见 `authz-guide`。本 skill 只解决**"用户是谁"**。
+> **相关技能**：接口认证/守卫/401 参见 `authn-guide`；登录/登出/获取用户信息等 Dataloom SDK 操作参见 `client-builtins-user-service`；**搜人 / 人员·部门·群组选择器返回的 ID 处理与字段获取**（employee_id / open_department_id、禁用字段、id_convert）参见 `contacts-service`；**"用户能做什么"**（角色/权限点位鉴权）参见 `authz-guide`。本 skill 只解决**"用户是谁"**（当前登录用户），其 `lark_user_id` == `employee_id`。
 
 ---
 
@@ -208,7 +210,6 @@ const UserInfoPanel = () => {
 ```
 
 **注意**：
-
 - `lark_user_id` 通过额外异步请求获取，可能晚于 `user_id` 等基础字段就绪
 - 请求失败或用户无对应飞书账号时值为 `undefined`，**必须用条件渲染**
 - `useCurrentUserProfile()` 的返回值里**不存在** `open_id`、`feishu_id`、`openId` 字段——在这个 Hook 的消费代码里飞书 ID 唯一字段名是 `lark_user_id`（仅约束本 Hook；项目其他场景调 spark `id_convert` / 通讯录 API 出现 `open_id` 是正常的）