ITサービスのためのAFFiNE

顧客プロジェクトのIT文書を。

ITドキュメントは、システムの構築、設定、運用、引き継ぎの方法を説明します。AFFiNEで構成図を設定メモ、判断、サポート手順と結び付けましょう。役立つ引き継ぎ資料には、現在の担当者、出典、未解決の課題、引き継ぎ先のチームが行う次の対応を明記します。

30分間のGoogle Meet ワークフロー、導入方法、チームとの適合性

ワークスペースの例:ソリューション概要 — ポータル移行

ワークスペース表示
ソリューション概要 — ポータル移行実装ワークスペース技術引き継ぎサポートナレッジメモ会議メモ

ページ · ソリューションチーム · 架空の例

ソリューション概要 — ポータル移行

範囲
文書の入口を置き換える
判断
既存のIDプロバイダーを継続利用
引き継ぎ
運用上の質問

未解決の設計課題:顧客に保持要件を確認。

同じプロジェクト · エッジレスキャンバス
ソリューション概要 — ポータル移行 — キャンバスの例ノード:ユーザー、新ポータル、文書ストア、IDプロバイダー、運用引き継ぎ。接続:ユーザー → 新ポータル;新ポータル → 文書ストア;新ポータル → IDプロバイダー (サインイン · 継続利用);IDプロバイダー → 運用引き継ぎ (質問)。
ユーザー
新ポータル
文書ストア
IDプロバイダー
運用引き継ぎ
サインイン · 継続利用
質問
  • 利用者と既存文書ストアの間にある、対象範囲内の新しい入口。
  • 既存のIDプロバイダーを維持する判断を、サインイン経路に表示。
  • 運用チームへの質問を図から引き継ぎにリンク。

エッジレス

実装ワークスペース

システムの構成要素と接続を描きます。図の隣のソリューション概要で、設計の選択、前提、未解決の質問を説明します。

前提
既存のIDサービス
案
共有文書の入口
質問
保持要件を確認
同じプロジェクト · エッジレスキャンバス
実装ワークスペース — キャンバスの例ノード:顧客の要望、システム図、選択肢、判断、保持要件は?。接続:顧客の要望 → システム図;システム図 → 選択肢;選択肢 → 判断 (選択);保持要件は? → 判断 (阻害)。
顧客の要望
システム図
選択肢
判断
保持要件は?
選択
阻害

ページ + テーブル

技術引き継ぎ

プロジェクト範囲、設定メモ、納品チェックリストをまとめます。担当者と未解決事項はプロジェクトチームが更新するテーブルで管理。

項目担当者状態
文書移行の試験導入デリバリーチーム前提をレビュー
保持要件ソリューションアーキテクト未解決の質問
運用手順コンサルタント下書き中

手動管理のテーブル · チケット自動化なし

同じプロジェクト · エッジレスキャンバス
技術引き継ぎ — キャンバスの例ノード:ユーザー、新ポータル、文書ストア、IDプロバイダー、運用引き継ぎ。接続:ユーザー → 新ポータル;新ポータル → 文書ストア;新ポータル → IDプロバイダー (サインイン · 継続利用);IDプロバイダー → 運用引き継ぎ (質問)。
ユーザー
新ポータル
文書ストア
IDプロバイダー
運用引き継ぎ
サインイン · 継続利用
質問
  • 利用者と既存文書ストアの間にある、対象範囲内の新しい入口。
  • 既存のIDプロバイダーを維持する判断を、サインイン経路に表示。
  • 運用チームへの質問を図から引き継ぎにリンク。

ページ

サポートナレッジメモ

一つの引き継ぎページから、構成概要、運用手順、未解決問題をリンク。納品前に共有方法またはMarkdownエクスポートを確認します。

システムの背景
アーキテクチャメモ
運用
既知の手順
未解決事項
次のチームへの質問

Markdownエクスポート可能 · 先に共有方法をテスト

埋め込まれたエッジレスフレーム

Markdownエクスポート — 納品前に結果をテスト

同じプロジェクト · エッジレスキャンバス
サポートナレッジメモ — キャンバスの例ノード:ユーザー、新ポータル、文書ストア、IDプロバイダー、運用引き継ぎ。接続:ユーザー → 新ポータル;新ポータル → 文書ストア;新ポータル → IDプロバイダー (サインイン · 継続利用);IDプロバイダー → 運用引き継ぎ (質問)。
ユーザー
新ポータル
文書ストア
IDプロバイダー
運用引き継ぎ
サインイン · 継続利用
質問
  • 利用者と既存文書ストアの間にある、対象範囲内の新しい入口。
  • 既存のIDプロバイダーを維持する判断を、サインイン経路に表示。
  • 運用チームへの質問を図から引き継ぎにリンク。

ページ

会議メモ

繰り返されるサポート質問を再利用できるページにします。設定、選定理由、実装メモへのリンクを含めます。

なぜこの設定なのか?

設計の根拠を一度記録し、サポートメモからリンク。

関連
実装メモ
同じプロジェクト · エッジレスキャンバス
会議メモ — キャンバスの例ノード:ユーザー、新ポータル、文書ストア、IDプロバイダー、運用引き継ぎ。接続:ユーザー → 新ポータル;新ポータル → 文書ストア;新ポータル → IDプロバイダー (サインイン · 継続利用);IDプロバイダー → 運用引き継ぎ (質問)。
ユーザー
新ポータル
文書ストア
IDプロバイダー
運用引き継ぎ
サインイン · 継続利用
質問
  • 利用者と既存文書ストアの間にある、対象範囲内の新しい入口。
  • 既存のIDプロバイダーを維持する判断を、サインイン経路に表示。
  • 運用チームへの質問を図から引き継ぎにリンク。
ワークスペースの例 — 架空の内容であり、製品画面や導入事例ではありません。エッジレスでは、オブジェクトをドラッグ、ハンドで移動、Ctrl/⌘ + スクロールでズームできます。描画ツールは表示例です。

作業からワークスペースへ

アーキテクチャからサポートまでのIT文書。

ソリューション概要を作り、実装メモを管理し、引き継ぎを準備し、サポート回答を再利用。

このページの4つの例に対応する作業と機能
作業ドキュメントエッジレステーブルチームエクスポート成果物
01 · ソリューションアーキテクトソフトウェア構成を文書化ドキュメントエッジレスソリューション概要
02 · デリバリー責任者実装文書を整理ドキュメントテーブルチーム実装ワークスペース
03 · コンサルタント技術引き継ぎを準備ドキュメントエッジレスエクスポート技術引き継ぎ
04 · サポートチームITナレッジベースを構築ドキュメントチームサポートナレッジメモ

01ソリューションアーキテクト

ソフトウェア構成を文書化

システムの構成要素と接続を描きます。図の隣のソリューション概要で、設計の選択、前提、未解決の質問を説明します。

作業
構成案を顧客に説明
AFFiNEで
エッジレスにシステムの関係を描き、各選択をページで説明
成果物
ソリューション概要

使用する機能

エッジレス架空の例

ソリューション概要

ソリューション概要 — キャンバスの例ノード:顧客の要望、システム図、選択肢、判断、保持要件は?。接続:顧客の要望 → システム図;システム図 → 選択肢;選択肢 → 判断 (選択);保持要件は? → 判断 (阻害)。
顧客の要望
システム図
選択肢
判断
保持要件は?
選択阻害
前提
既存のIDサービス
案
共有文書の入口
質問
保持要件を確認
架空の内容を使ったレイアウト例 — 製品画面ではありません。

02デリバリー責任者

実装文書を整理

プロジェクト範囲、設定メモ、納品チェックリストをまとめます。担当者と未解決事項はプロジェクトチームが更新するテーブルで管理。

作業
現在の議論を一か所にまとめて納品作業を開始
AFFiNEで
範囲を示すページと、チームが管理する簡単なテーブル
成果物
実装ワークスペース

使用する機能

ページ + テーブル架空の例

実装ワークスペース

項目担当者状態
文書移行の試験導入デリバリーチーム前提をレビュー
保持要件ソリューションアーキテクト未解決の質問
運用手順コンサルタント下書き中

手動管理のテーブル · チケット自動化なし

架空の内容を使ったレイアウト例 — 製品画面ではありません。

03コンサルタント

技術引き継ぎを準備

一つの引き継ぎページから、構成概要、運用手順、未解決問題をリンク。納品前に共有方法またはMarkdownエクスポートを確認します。

作業
顧客チームが迷わず使える引き継ぎ資料を残す
AFFiNEで
構成メモとキャンバスをリンクした引き継ぎページ。納品前にMarkdownエクスポートをテスト
成果物
技術引き継ぎ

使用する機能

ページ架空の例

技術引き継ぎ

システムの背景

アーキテクチャメモ

運用

既知の手順

未解決事項

次のチームへの質問

埋め込まれたエッジレスフレーム

Markdownエクスポート納品前に結果をテスト

Markdownエクスポート可能 · 先に共有方法をテスト

架空の内容を使ったレイアウト例 — 製品画面ではありません。

04サポートチーム

ITナレッジベースを構築

繰り返されるサポート質問を再利用できるページにします。設定、選定理由、実装メモへのリンクを含めます。

作業
繰り返される質問に、理由を添えて一度で回答
AFFiNEで
共有ワークスペース内の再利用可能なページを実装メモにリンク
成果物
サポートナレッジメモ

使用する機能

ページ架空の例

サポートナレッジメモ

なぜこの設定なのか?

設計の根拠を一度記録し、サポートメモからリンク。

関連実装メモ

架空の内容を使ったレイアウト例 — 製品画面ではありません。

例から評価へ

顧客向け文書のワークフローを相談。

構成メモ、プロジェクト引き継ぎ、チームのアクセス要件を話しましょう。

デモを予約

AFFiNEチームとの相談日時を選択。

つながるワークスペース

ページに書き、同じドキュメントをキャンバスに切り替える。

上記の例は同じ基本機能を使用しています。

  • 例示

    ドキュメント

    参照、画像、多彩なブロックを備えた読みやすいページ。

    Docsを見る
  • 例示

    エッジレスホワイトボード

    アイデアやシステムの関係を示すキャンバス。

    エッジレスを見る
  • 例示

    テーブルとチームワークスペース

    未解決事項を追跡し、共有スペースで共同編集。

    Teamhubを見る

ドキュメント、ホワイトボード、テーブルの例 — 製品画面や業種別の導入事例ではありません。

導入と評価

ワークスペースの運用方法を選択。

運用担当者とともに、業務、インフラ、AI設定を総合的に評価します。

ホスト型クラウドワークスペースの図

ホスト型ワークスペース

利用を広げる前に、使用が許可されたサンプル資料で一つの流れを試します。

  • AFFiNE Webアプリ
  • 一つのチームワークスペース
  • サーバー運用は不要
クラウド導入を相談
AFFiNEをセルフホスト

前提条件

1 / Docker

マシンにDockerとDocker Composeをインストール。

2 / 最新のComposeファイルをダウンロード

AFFiNEリポジトリからcompose.ymlをダウンロード。

3 / 環境設定ファイルを準備

導入環境の環境変数を確認。

セルフホスト

セルフホスト版AFFiNEでは、Docker Composeを使うデプロイ方法が文書化されています。ワークスペースのデータとアップロードには、ご自身で構成したインフラとストレージが使われます。

  • Docker Compose
  • PostgreSQL
  • ファイルまたはS3ストレージ
  • OIDCサインイン
  • 自社のIDプロバイダーでサインインセルフホスト版AFFiNEはOIDCに対応しています。ワークスペースの役割と文書アクセスを自社要件に照らして確認してください。
  • AIは任意セルフホスト版のAIにはプロバイダーの設定が必要で、無効にできます。独自キーの利用は実験的機能とされています。
  • 制限ネットワーク向けライセンスインストール可能なライセンスはAFFiNEのライセンスサーバーに接続せず有効化できます。ただし、すべての機能がオフラインで動くことを意味しません。
  • バックアップと復元復元テストを含め手順が文書化されています。自社環境で実行してください。
  1. 顧客資料と社内知識を同じワークスペースに置きますか?
  2. 各引き継ぎをどう共有・エクスポートしますか?
  3. 試験導入で使うIDプロバイダーは?

このページはSAML、SCIM、業界認証、特定業務への使用承認を表明するものではありません。

製品の参考資料:AFFiNE Enterpriseと、Docker Compose、OIDCサインイン、AI設定に関する英語のドキュメント。

さらに見る · 汎用テンプレート

既存のSOPテンプレート

繰り返し実施する運用作業を記録する汎用手順テンプレート。

開始前に

チームの疑問に答えます。

サービスチームはAFFiNEをIT文書ソフトウェアとしてどう使えますか?

設定メモや運用手順はドキュメントに、構成図はホワイトボードに、担当者や質問はテーブルに。この例は文書化が対象です。資産検出、パスワード保管、RMM、チケット自動化は専用ツールで行います。

ソフトウェア構成文書には何を含めますか?

システムの目的、利用者、構成要素、インターフェース、デプロイ環境を記録し、設計判断と未解決の質問を説明します。元の作成者がいなくても別のチームが読めるよう、図の要素と接続にラベルを付けましょう。AFFiNEでは図とその前提、出典、判断のメモを並べて保持できます。

図解の参考資料(英語):ソフトウェアアーキテクチャのC4モデル。

顧客ごとに情報を分けられますか?

顧客資料を使う前に、ワークスペースのメンバー、文書アクセス、共有設定が要件に合うか確認してください。この例はテナント分離を保証するものではありません。

セルフホストを評価できますか?

はい。Docker Composeを使う方法が文書化されており、OIDCを介した自社IDプロバイダーでのサインインに対応します。インフラチームとEnterprise文書を確認し、本格展開前に代表的なワークフローを一つ試してください。

このワークスペースにAIは必須ですか?

いいえ。これらのワークフローではページ、キャンバス、テーブルを使用し、AIは必須ではありません。セルフホスト版AFFiNEでAIを使うにはプロバイダーの設定が必要で、無効にすることもできます。有効化する前にプロバイダーとデータの流れを確認してください。

チームは何から始めればよいですか?

現在の文書作成作業を一つと、使用が許可された少量のサンプル資料を選びます。チームが仕事を見つけ、理解し、引き継げるかを評価してから利用を広げてください。

チームについて話す

顧客への納品業務でAFFiNEを評価。

構成メモ、プロジェクト引き継ぎ、チームのアクセス要件を話しましょう。

30分間のGoogle Meet · 空き時間を選択

メールをご希望ですか? 営業に問い合わせ