# SuccessFactors 未来入职者字段契约（提前 24h 建号所需）

**目的**：Helix 在员工**本地入职日前约 24 小时**就创建账号（Google / 飞书）并发出欢迎/密码信（SF-agreed 2026-07-06）。这些下游动作需要员工的**部门、直属经理、HRBP、HR Ops**。这些数据都存放在 SF 的 **effective-dated（按生效日期）实体**上——如果这些行只在入职**当天**才录入并生效，那么建号那一刻（提前 24h）Helix 拉不到，就会出现：

- 飞书账号建到**根部门 `"0"`**（无部门、不进部门群）；
- 欢迎邮件**抄送不到 HRBP / HR Ops**（当地 Ops 收不到副本）；
- 欢迎信里的"你的部门 / 你的经理"渲染为占位符。

Helix 已内置**兜底逻辑**（数据晚到也会在入职当天自动补齐部门 + 补发飞书卡片 + 补送 HR Ops/HRBP 抄送），但**要让"建号当场就正确"，HR 必须把下列字段在入职前录好、并让其生效日期覆盖入职日**。

---

## 1. HR 需要在 SF 里为未来入职者提前录入的字段

以下全部是**已有的标准 SF EC 字段**，无需新建自定义字段。要求：**行必须在入职前（≥ 本地入职日前 24 小时，理想在 offer/确认阶段）就存在于 SF，且其生效区间覆盖入职日**。

### 1.1 `EmpJob`（岗位记录，effective-dated）

| Helix 用途 | SF 字段 | 值 | 生效要求 |
|---|---|---|---|
| 部门（飞书部门 + 部门群 + 欢迎信部门） | `department` | FODepartment 的 `externalCode`（叶子部门码） | `startDate` = 本地入职日；行须提前录入 |
| 直属经理（欢迎信/卡片"你的经理"、经理可见下属） | `managerId` | 经理的 SF `userId` | 同一 `EmpJob` 行 |
| 劳动主体/公司（决定语言 + 报销工具） | `company` | FOCompany 的 `externalCode` | 同一 `EmpJob` 行 |
| 工作地 | `location` | FOLocation externalCode | 同一 `EmpJob` 行 |
| 职位 | `position` | Position externalCode | 同一 `EmpJob` 行 |

### 1.2 `EmpJobRelationships`（工作关系，effective-dated）

| Helix 用途 | SF `relationshipType` | SF 字段 | 值 | 生效要求 |
|---|---|---|---|---|
| **HRBP**（欢迎信抄送 + 飞书 HRBP 字段 + 汇联易审批） | `2448` | `relUserId` | HRBP 的 SF `userId` | 关系生效日 ≤ 本地入职日；行须提前录入 |
| **HR Ops / 当地 Ops**（欢迎信抄送 + 建号成功卡） | `2450` | `relUserId` | HR Ops 的 SF `userId` | 同上 |
| （可选）调薪/预算负责人 | `2447` | `relUserId` | | 同上 |

> **"当地 Ops" = 按人分配的 HR Ops（relationshipType 2450）**。Helix 没有"按办公室/地区"的独立 Ops 概念——谁是这名员工的 Ops，就取其 2450 关系指向的人。目前大陆员工的 2450 基本都指向肖静 Jenny Xiao（P0067）。

---

## 2. Helix 侧如何消费（无需 HR 关心，仅供参考）

- 建号（提前 24h）时，Helix 对**未入职者**按 `asOfDate/fromDate=<入职日>` 拉取 `EmpJob` + `EmpJobRelationships`，取生效日 = 入职日的未来切片（只对未入职者启用，绝不把在职员工的未来调动提前生效）。
- 若上述字段已按本契约录好 → 建号当场部门/经理/HRBP/HR Ops 齐全，飞书账号直接落对部门、欢迎邮件当场抄送 HR Ops/HRBP。
- 若**未录好 / 晚到** → Helix 兜底：入职当天数据落库后，自动
  1. 飞书账号从根部门 `"0"` 迁到真实部门（#1987）；
  2. 补发飞书欢迎卡片给已激活的账号；
  3. 补送一份欢迎信副本给 HRBP + HR Ops。

即：**HR 提前录 = 最佳体验；没录 = 不会出错，只是部门/卡片/抄送延到入职当天补齐。**

---

## 3. 给 HR 的一句话总结

> 请在**新人入职日之前**，把 SF 里这名新人的 **EmpJob（部门 `department`、经理 `managerId`）** 和 **工作关系（`2448` HRBP、`2450` HR Ops）** 录好，并让生效日期覆盖入职当天。这样系统在入职前一天建号时就能把飞书部门、部门群、欢迎信抄送一次性配齐。