使用手冊
受眾與群組
組織系統給的是部門、班級、修課名單；單位自己的分眾——社團、幹部、志工、報名者——在「受眾與群組」（/unit#groups）自己建、分層、當受眾用。
受眾維度
| 維度 | 來源 | 範例 |
|---|---|---|
| 身分別 | SSO / 對象的 stage | 學生、教師、職員、校友、準新生 |
| 部門／系所／班級 | 組織系統同步 | 資訊學院大二、業務部 |
| 修課名單／導師班 | 業務 API（送出時查） | 某課程修課生 |
| 群組／子群組 | 單位維護 | 熱音社 → 幹部組；「活動 A 已報名」 |
| 標籤 | 對話節點走過時貼上 | 「對交換計畫有興趣」 |
| 互動歷程 | Herald 自己的紀錄 | 報名了活動 A、問卷 B 未填、通知 C 未讀／未確認 |
| 手動名單 | 上傳 uid（需個資依據，留稽核） | 獎學金候選人 |
| 管道／語言 | 地址 / 偏好語言 | 有 Email 者、英語使用者 |
| 排除 | 任一維度反向 | 排除已報名者 |
維度之間 AND，同維度內 OR，可加排除。單位只能用被授權的維度（單位設定 → 允許的受眾維度）。
群組與子群組
Herald
儀表板訊息審核劇本與 Pattern知識庫受眾與群組報表單位設定AI 設定記憶稽核紀錄
單位設定 · 群組與子群組單位 ▾
社團 動態 社團系統 = 有效社員 · 3,120 人
熱音社 動態 社團代號 MUS · 86 人
幹部組 靜態 12 人 · 依據：幹部名冊 · 至 2028-06-30
迎新演唱會 · 已報名 pattern 120 人 · 由活動報名 pattern 維護
新增群組
志工組 · 熱音社 · 靜態
志工名冊 2027 · 2028-06-30 · volunteer
加入成員
志工組 · s1130421, s1130422 · 志工名冊 2027
新增群組
- 在單位設定的「群組與子群組」區塊填 名稱（
name）。 - 選 上層群組（
parentId）：子群組成員必須是父群組成員（否則group_subset）；父群組變動時子群組自動收斂。 - 選 種類（
kind）：動態 = 查詢，送出時重算；靜態 = 手動維護名單。 - 靜態群組必填 個資依據（
legalBasis）與 有效期（validTo）；可加 標籤（tags）。 - 按 建立（
POST /unit/groups）。
加入成員（靜態群組）
- 選 群組（
groupId），貼上 uid（uids，每行一個或逗號分隔）。 - 填 個資依據（
legalBasis）。 - 按 加入（
POST /unit/groups/members）。每次變動記稽核group.member_added（人數與依據，不記名單）。
規則
- 單位擁有
- 群組屬於一個單位；成員依角色可建、改、看。
- 權限可授到群組
- 成員角色可限定
scopeGroupId：社團幹部只能對「熱音社」以下的子群組發話。 - pattern 自動入組
- 報名成功、問卷完成 → 加入指定子群組；受眾用「父 − 子」取未報名者。
- 同意仍在最外層
- 群組只是受眾維度；未同意該分類 scope 的成員一樣不會收到。