From 70a2637fc6c2127f0fb0961438db909b372f1fd2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=99=B3=E6=AC=A3=E6=80=A1?= <ms.mandy610425@gmail.com>
Date: Thu, 26 Mar 2026 17:42:53 +0800
Subject: [PATCH 1/2] docs: add information architecture and functional map
 diagrams
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- docs/ia/ia-diagram.md: Label Suite IA with 7 modules (儀表板,
  帳號, 任務管理, 標記任務, 標記員管理, 資料集分析, 系統管理)
  and detailed page hierarchy per module
- docs/ia/information-architecture.md: earlier graph LR draft
- docs/ia/label-studio-functional-map.md: Label Studio functional
  map for comparison reference

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 docs/ia/ia-diagram.md                  | 71 ++++++++++++++++++++++++++
 docs/ia/information-architecture.md    | 66 ++++++++++++++++++++++++
 docs/ia/label-studio-functional-map.md | 52 +++++++++++++++++++
 3 files changed, 189 insertions(+)
 create mode 100644 docs/ia/ia-diagram.md
 create mode 100644 docs/ia/information-architecture.md
 create mode 100644 docs/ia/label-studio-functional-map.md

diff --git a/docs/ia/ia-diagram.md b/docs/ia/ia-diagram.md
new file mode 100644
index 0000000..2ed17d3
--- /dev/null
+++ b/docs/ia/ia-diagram.md
@@ -0,0 +1,71 @@
+# Label Suite — IA 資訊架構
+
+```mermaid
+graph TD
+  Root["Label Suite"]
+
+  Root --> M0["儀表板"]
+  Root --> M1["帳號模組"]
+  Root --> M2["任務管理模組"]
+  Root --> M3["標記任務模組"]
+  Root --> M4["標記員管理模組"]
+  Root --> M5["資料集分析模組"]
+  Root --> M6["系統管理模組"]
+
+  M0 --> M0a["任務概況"]
+  M0 --> M0b["標記進度"]
+  M0 --> M0c["系統公告"]
+
+  M1 --> M1a["登入頁"]
+  M1a --> M1a1["Google"]
+  M1a --> M1a2["Github"]
+  M1 --> M1b["個人設定頁"]
+
+  M2 --> M2a["任務列表頁"]
+  M2 --> M2b["新增任務頁"]
+  M2b --> M2b1["資料匯入"]
+  M2b --> M2b2["範本檔案"]
+  M2 --> M2c["任務詳情頁"]
+  M2c --> M2c1["單句任務（分類 / 評分）"]
+  M2c --> M2c2["句對任務（相似度 / 蘊含）"]
+  M2c --> M2c3["序列標記（NER、詞性標記）"]
+  M2c --> M2c4["生成式標記（人工撰寫 / 評分）"]
+
+  M3 --> M3a["試標模式（Dry Run）"]
+  M3 --> M3b["正式標記模式（Official Run）"]
+  M3 --> M3c["標記作業頁"]
+  M3 --> M3d["標記結果匯出"]
+
+  M4 --> M4a["標記員列表頁"]
+  M4 --> M4b["新增標記員頁"]
+  M4 --> M4c["工時紀錄頁"]
+  M4c --> M4c1["出缺勤紀錄"]
+  M4c --> M4c2["任務次數計算"]
+  M4 --> M4d["薪資試算頁"]
+  M4d --> M4d1["時薪制計算"]
+
+  M5 --> M5a["統計總覽頁"]
+  M5a --> M5a1["統計指標"]
+  M5a1 --> M5a1a["Sentence 數量"]
+  M5a1 --> M5a1b["Token 數量"]
+  M5a1 --> M5a1c["Label 分布"]
+  M5a1 --> M5a1d["標記一致性"]
+  M5 --> M5b["品質監控頁"]
+  M5b --> M5b1["監控項目"]
+  M5b1 --> M5b1a["異常偵測"]
+
+  M6 --> M6a["使用者管理頁"]
+  M6 --> M6b["角色權限設定頁"]
+  M6b --> M6b1["管理員"]
+  M6b --> M6b2["標記員"]
+  M6b --> M6b3["審核員"]
+
+  style Root fill:#1E1B4B,color:#fff
+  style M0 fill:#FECDD3,color:#881337
+  style M1 fill:#BFDBFE,color:#1E3A8A
+  style M2 fill:#BBF7D0,color:#14532D
+  style M3 fill:#E9D5FF,color:#4C1D95
+  style M4 fill:#FECACA,color:#7F1D1D
+  style M5 fill:#BAE6FD,color:#0C4A6E
+  style M6 fill:#FED7AA,color:#7C2D12
+```
diff --git a/docs/ia/information-architecture.md b/docs/ia/information-architecture.md
new file mode 100644
index 0000000..babde79
--- /dev/null
+++ b/docs/ia/information-architecture.md
@@ -0,0 +1,66 @@
+# Label Suite — 資訊架構（Information Architecture）
+
+```mermaid
+graph LR
+  Root([Label Suite])
+
+  Root --> Login[登入]
+  Root --> Dashboard[儀表板]
+  Root --> Task[標記任務]
+  Root --> Annotate[標記介面]
+  Root --> Annotator[標記員管理]
+  Root --> Dataset[資料集分析]
+
+
+  Login --> L1[Google SSO]
+  Login --> L2[GitHub SSO]
+
+  Dashboard --> D1[任務概覽]
+  Dashboard --> D2[標記進度]
+  Dashboard --> D3[系統公告]
+
+  Task --> T1[任務設定]
+  Task --> T2[Dry Run 試標]
+  Task --> T3[Official Run 正式標記]
+
+  T1 --> T1a[YAML / JSON Config]
+  T1 --> T1b[單一句子分類]
+  T1 --> T1c[句子對標記]
+  T1 --> T1d[序列標記]
+  T1 --> T1e[生成標記]
+
+  T2 --> T2a[介面驗證]
+  T2 --> T2b[Config 正確性確認]
+
+  T3 --> T3a[資料收集]
+  T3 --> T3b[進度追蹤]
+
+  Annotate --> A1[標記操作區]
+  Annotate --> A2[說明與範例]
+  Annotate --> A3[進度指示器]
+  Annotate --> A4[儲存 / 提交]
+
+  Annotator --> M1[帳號管理]
+  Annotator --> M2[工時追蹤]
+  Annotator --> M3[薪資試算]
+
+  M1 --> M1a[新增帳號]
+  M1 --> M1b[編輯帳號]
+  M1 --> M1c[停用帳號]
+
+  M2 --> M2a[工時紀錄]
+  M2 --> M2b[出勤查詢]
+
+  M3 --> M3a[時薪設定]
+  M3 --> M3b[薪資報表]
+
+  Dataset --> S1[統計總覽]
+  Dataset --> S2[品質監控]
+
+  S1 --> S1a[Sentence 數量]
+  S1 --> S1b[Token 數量]
+  S1 --> S1c[Label 分布]
+
+  S2 --> S2a[標記一致性]
+  S2 --> S2b[異常偵測]
+```
diff --git a/docs/ia/label-studio-functional-map.md b/docs/ia/label-studio-functional-map.md
new file mode 100644
index 0000000..bf98ac2
--- /dev/null
+++ b/docs/ia/label-studio-functional-map.md
@@ -0,0 +1,52 @@
+# Label Studio — 功能地圖
+
+> 資料來源：docs/research/tool-analysis.md
+
+```mermaid
+graph LR
+  Root(["Label Studio"])
+
+  Root --> M1["帳號與存取"]
+  Root --> M2["專案管理"]
+  Root --> M3["標記任務"]
+  Root --> M4["標記介面"]
+  Root --> M5["資料匯出"]
+  Root --> M6["部署設定"]
+
+  M1 --> M1a["登入"]
+  M1 --> M1b["使用者帳號管理"]
+  M1 --> M1c["專案成員指派"]
+
+  M2 --> M2a["建立專案"]
+  M2 --> M2b["專案設定（GUI 精靈）"]
+  M2 --> M2c["資料匯入"]
+
+  M3 --> M3a["文字分類（單句）"]
+  M3 --> M3b["句對標記"]
+  M3 --> M3c["序列標記（NER / 詞性）"]
+  M3 --> M3d["生成式標記"]
+  M3 --> M3e["圖片標記"]
+  M3 --> M3f["音訊標記"]
+  M3 --> M3g["影片標記"]
+
+  M4 --> M4a["標記操作區"]
+  M4 --> M4b["快捷鍵設定"]
+  M4 --> M4c["標記審查（Review）"]
+
+  M5 --> M5a["JSON 匯出"]
+  M5 --> M5b["CSV 匯出"]
+  M5 --> M5c["CoNLL 匯出"]
+  M5 --> M5d["自訂格式匯出"]
+
+  M6 --> M6a["Docker 部署"]
+  M6 --> M6b["環境變數設定"]
+  M6 --> M6c["資料庫遷移"]
+
+  style Root fill:#FF6B35,color:#fff
+  style M1 fill:#FEE2E2,color:#7F1D1D
+  style M2 fill:#FEF3C7,color:#78350F
+  style M3 fill:#D1FAE5,color:#064E3B
+  style M4 fill:#DBEAFE,color:#1E3A8A
+  style M5 fill:#EDE9FE,color:#3B0764
+  style M6 fill:#E2E8F0,color:#1E293B
+```

From 09f3563fbbd12e0e5ab3573c2c36d088995550f4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=99=B3=E6=AC=A3=E6=80=A1?= <ms.mandy610425@gmail.com>
Date: Thu, 26 Mar 2026 17:57:17 +0800
Subject: [PATCH 2/2] fix: mark information-architecture.md as draft to avoid
 IA conflict

---
 docs/ia/information-architecture.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/ia/information-architecture.md b/docs/ia/information-architecture.md
index babde79..19b7790 100644
--- a/docs/ia/information-architecture.md
+++ b/docs/ia/information-architecture.md
@@ -1,5 +1,8 @@
 # Label Suite — 資訊架構（Information Architecture）
 
+> **Draft / Outdated** — This file is an early graph LR draft kept for reference only.
+> For the current authoritative IA, see [`ia-diagram.md`](ia-diagram.md).
+
 ```mermaid
 graph LR
   Root([Label Suite])