AFFiNE IT 服務應用

客戶專案的 IT 文件。

IT 文件說明系統如何建置、設定、運作與交接。使用 AFFiNE 將架構圖連結至設定筆記、決策與支援程序。實用的交接資料應明確列出目前負責人、來源參照、未解決問題,以及接手團隊的下一步行動。

30 分鐘 Google Meet 工作流程、部署方式與團隊需求

示意工作區:解決方案摘要 — 入口網站移轉

工作區檢視
解決方案摘要 — 入口網站移轉實作工作區技術交接支援知識筆記會議筆記

頁面 · 解決方案團隊 · 虛構範例

解決方案摘要 — 入口網站移轉

範圍
更換文件存取入口
決策
沿用現有身分識別提供者
交接
維運問題

待解設計問題:與客戶確認保留需求。

同一專案 · 無界畫布
解決方案摘要 — 入口網站移轉 — 示意畫布節點:使用者、新入口網站、文件儲存區、身分識別提供者、維運交接。連線:使用者 → 新入口網站;新入口網站 → 文件儲存區;新入口網站 → 身分識別提供者 (登入 · 沿用);身分識別提供者 → 維運交接 (問題)。
使用者
新入口網站
文件儲存區
身分識別提供者
維運交接
登入 · 沿用
問題
  • 範圍內的新入口位於使用者與既有文件儲存區之間。
  • 在登入路徑上呈現沿用現有身分識別提供者的決策。
  • 將維運團隊的問題從圖表連結至交接資料。

無界

實作工作區

繪製系統元件及其連線,在圖旁的解決方案摘要中說明設計選擇、假設與待解問題。

假設
現有身分識別服務
方案
共用文件入口
問題
確認保留需求
同一專案 · 無界畫布
實作工作區 — 示意畫布節點:客戶需求、系統圖、方案、決策、保留需求?。連線:客戶需求 → 系統圖;系統圖 → 方案;方案 → 決策 (已選擇);保留需求? → 決策 (阻礙)。
客戶需求
系統圖
方案
決策
保留需求?
已選擇
阻礙

頁面 + 表格

技術交接

集中保存專案範圍、設定筆記與交付檢查清單。以表格記錄負責人與待辦事項,並由專案團隊更新。

項目負責人狀態
文件移轉試行交付團隊檢視假設
保留需求解決方案架構師待解問題
維運程序顧問撰寫中

手動維護表格 · 無工單自動化

同一專案 · 無界畫布
技術交接 — 示意畫布節點:使用者、新入口網站、文件儲存區、身分識別提供者、維運交接。連線:使用者 → 新入口網站;新入口網站 → 文件儲存區;新入口網站 → 身分識別提供者 (登入 · 沿用);身分識別提供者 → 維運交接 (問題)。
使用者
新入口網站
文件儲存區
身分識別提供者
維運交接
登入 · 沿用
問題
  • 範圍內的新入口位於使用者與既有文件儲存區之間。
  • 在登入路徑上呈現沿用現有身分識別提供者的決策。
  • 將維運團隊的問題從圖表連結至交接資料。

頁面

支援知識筆記

從同一交接頁面連結架構概覽、操作程序與未解決問題。交付前確認分享方式或 Markdown 匯出流程。

系統背景
架構筆記
維運
已知程序
待辦事項
交給接手團隊的問題

可匯出 Markdown · 請先測試分享方式

嵌入的無界框架

Markdown 匯出 — 交付前先測試結果

同一專案 · 無界畫布
支援知識筆記 — 示意畫布節點:使用者、新入口網站、文件儲存區、身分識別提供者、維運交接。連線:使用者 → 新入口網站;新入口網站 → 文件儲存區;新入口網站 → 身分識別提供者 (登入 · 沿用);身分識別提供者 → 維運交接 (問題)。
使用者
新入口網站
文件儲存區
身分識別提供者
維運交接
登入 · 沿用
問題
  • 範圍內的新入口位於使用者與既有文件儲存區之間。
  • 在登入路徑上呈現沿用現有身分識別提供者的決策。
  • 將維運團隊的問題從圖表連結至交接資料。

頁面

會議筆記

將重複的支援問題轉為可重用頁面,納入設定、選擇理由與實作筆記連結。

為何採用此設定?

設計依據記錄一次,再由支援筆記連結。

相關
實作筆記
同一專案 · 無界畫布
會議筆記 — 示意畫布節點:使用者、新入口網站、文件儲存區、身分識別提供者、維運交接。連線:使用者 → 新入口網站;新入口網站 → 文件儲存區;新入口網站 → 身分識別提供者 (登入 · 沿用);身分識別提供者 → 維運交接 (問題)。
使用者
新入口網站
文件儲存區
身分識別提供者
維運交接
登入 · 沿用
問題
  • 範圍內的新入口位於使用者與既有文件儲存區之間。
  • 在登入路徑上呈現沿用現有身分識別提供者的決策。
  • 將維運團隊的問題從圖表連結至交接資料。
示意工作區 — 使用虛構內容,並非產品截圖或客戶案例。在無界模式中,可拖曳物件、使用手形工具平移,或以 Ctrl/⌘ + 捲動縮放。繪圖工具僅供視覺參考。

從任務到工作區

從架構到支援的 IT 文件。

建立解決方案摘要、追蹤實作筆記、準備交接並重用支援答案。

本頁四個範例的任務與功能對照
任務文件無界表格團隊匯出產出
01 · 解決方案架構師撰寫軟體架構文件文件無界解決方案摘要
02 · 交付主管整理實作文件文件表格團隊實作工作區
03 · 顧問準備技術交接文件無界匯出技術交接
04 · 支援團隊建立 IT 知識庫文件團隊支援知識筆記

01解決方案架構師

撰寫軟體架構文件

繪製系統元件及其連線,在圖旁的解決方案摘要中說明設計選擇、假設與待解問題。

任務
向客戶說明架構提案
在 AFFiNE 中
在無界繪製系統關係,於頁面說明各項選擇
產出
解決方案摘要

使用功能

無界虛構範例

解決方案摘要

解決方案摘要 — 示意畫布節點:客戶需求、系統圖、方案、決策、保留需求?。連線:客戶需求 → 系統圖;系統圖 → 方案;方案 → 決策 (已選擇);保留需求? → 決策 (阻礙)。
客戶需求
系統圖
方案
決策
保留需求?
已選擇阻礙
假設
現有身分識別服務
方案
共用文件入口
問題
確認保留需求
使用虛構內容的版面示意,並非產品截圖。

02交付主管

整理實作文件

集中保存專案範圍、設定筆記與交付檢查清單。以表格記錄負責人與待辦事項,並由專案團隊更新。

任務
集中目前討論內容,啟動交付工作
在 AFFiNE 中
範圍頁面搭配團隊維護的簡易表格
產出
實作工作區

使用功能

頁面 + 表格虛構範例

實作工作區

項目負責人狀態
文件移轉試行交付團隊檢視假設
保留需求解決方案架構師待解問題
維運程序顧問撰寫中

手動維護表格 · 無工單自動化

使用虛構內容的版面示意,並非產品截圖。

03顧問

準備技術交接

從同一交接頁面連結架構概覽、操作程序與未解決問題。交付前確認分享方式或 Markdown 匯出流程。

任務
提供客戶團隊易於查閱的交接資料
在 AFFiNE 中
交接頁面連結架構筆記與畫布;交付前測試 Markdown 匯出
產出
技術交接

使用功能

頁面虛構範例

技術交接

系統背景

架構筆記

維運

已知程序

待辦事項

交給接手團隊的問題

嵌入的無界框架

Markdown 匯出交付前先測試結果

可匯出 Markdown · 請先測試分享方式

使用虛構內容的版面示意,並非產品截圖。

04支援團隊

建立 IT 知識庫

將重複的支援問題轉為可重用頁面,納入設定、選擇理由與實作筆記連結。

任務
為常見問題記錄一次完整答案與理由
在 AFFiNE 中
共享工作區中的可重用頁面,連結至實作筆記
產出
支援知識筆記

使用功能

頁面虛構範例

支援知識筆記

為何採用此設定?

設計依據記錄一次,再由支援筆記連結。

相關實作筆記

使用虛構內容的版面示意,並非產品截圖。

從範例到評估

討論您的客戶文件工作流程。

討論架構筆記、專案交接與團隊存取需求。

預約展示

選擇與 AFFiNE 團隊會談的時間。

相互連結的工作區

在頁面撰寫,再將同一份文件切換為畫布。

上述範例皆使用相同的基本功能。

  • 示意範例

    文件

    包含參照、圖片與豐富區塊的易讀頁面。

    探索 Docs
  • 示意範例

    無界白板

    呈現想法與系統關係的畫布。

    探索無界
  • 示意範例

    表格與團隊工作區

    追蹤待辦事項,在共享空間共同編輯。

    探索 Teamhub

文件、白板與表格的示意範例,並非產品截圖或產業客戶案例。

部署與評估

選擇工作區的運作方式。

與工作區維運人員共同評估工作需求、基礎設施與 AI 設定。

託管雲端工作區示意圖

託管工作區

擴大使用前,先以獲准使用的範例資料試行一種工作流程。

  • AFFiNE 網頁應用程式
  • 一個團隊工作區
  • 無須維運伺服器
討論雲端部署
自行託管 AFFiNE

必要條件

1 / Docker

在您的電腦安裝 Docker 與 Docker Compose。

2 / 下載最新 Compose 檔案

從 AFFiNE 儲存庫下載 compose.yml。

3 / 準備環境設定檔

檢視部署所需的環境變數。

自行託管

對於自行託管的 AFFiNE,Docker Compose 是文件中說明的部署方式。工作區資料與上傳檔案使用您設定的基礎架構與儲存空間。

  • Docker Compose
  • PostgreSQL
  • 檔案或 S3 儲存空間
  • OIDC 登入
  • 透過您的身分識別提供者登入自行託管的 AFFiNE 支援 OIDC。請依自身需求檢視工作區角色與文件存取權限。
  • AI 可自由選用自行託管的 AI 需要設定供應商,也可停用。自備金鑰功能標示為實驗性質。
  • 受限網路授權可安裝授權無須呼叫 AFFiNE 授權伺服器即可啟用,但不代表所有功能皆可離線使用。
  • 備份與還原文件載有完整程序,包含測試還原。請在自身環境執行。
  1. 客戶資料會與內部知識共用工作區嗎?
  2. 每份交接資料將如何分享或匯出?
  3. 試行應使用哪個身分識別提供者?

本頁未宣稱支援 SAML、SCIM、取得產業認證或獲准用於任何特定工作。

產品參考資料:AFFiNE Enterprise,以及 Docker Compose、OIDC 登入與 AI 設定的英文文件。

繼續探索 · 通用範本

既有 SOP 範本

記錄可重複維運任務的通用程序範本。

開始之前

團隊常見疑問。

服務團隊如何將 AFFiNE 作為 IT 文件軟體?

文件用於設定筆記與操作程序,白板用於架構圖,表格用於負責人與待解問題。這些範例僅涵蓋文件作業;資產探索、密碼保管庫、RMM 與工單自動化仍由專業工具處理。

軟體架構文件應包含哪些內容?

記錄系統目的、使用者、元件、介面與部署環境,再說明設計決策與待解問題。為圖中的元素及連線加上標籤,讓其他團隊不必依賴原作者也能理解。在 AFFiNE 中,將圖表與其假設、來源參照及決策筆記並列保存。

繪圖參考資料(英文):軟體架構的 C4 模型。

可以分隔不同客戶的資訊嗎?

使用客戶資料前,請依需求評估工作區成員、文件存取與分享設定。此範例不代表已建立租戶隔離。

可以評估自行託管嗎?

可以。文件說明了 Docker Compose 自行託管方式,以及透過 OIDC 使用身分識別提供者登入。請與基礎設施團隊檢閱 Enterprise 文件,再於擴大導入前測試一項具代表性的工作流程。

這個工作區必須使用 AI 嗎?

不必。這些工作流程使用頁面、畫布與表格,不需要 AI。自行託管的 AFFiNE 若要使用 AI,必須設定供應商,也可停用。啟用前請檢視供應商與資料流向。

團隊應如何開始?

選擇一項現有文件任務與少量獲准使用的範例資料。先評估團隊是否能找到、理解並交接工作,再擴大使用。

聊聊您的團隊

評估 AFFiNE 是否適合客戶交付工作。

討論架構筆記、專案交接與團隊存取需求。

30 分鐘 Google Meet · 選擇可預約時段

偏好電子郵件?聯絡業務