業種別 AFFiNE

技術チームのナレッジ管理

AFFiNEは、ドキュメント、ホワイトボード、テーブルを一か所にまとめた、技術ナレッジのための共同作業ワークスペースです。手順を説明し、図とその根拠を結び付け、出典、担当者、未解決の質問とともに判断を引き継げます。6つの業種のワークフロー例をご覧ください。

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

ワークスペースの例:ドキュメント、テーブル、エッジレス

ワークスペース表示
プロジェクトチェックリストコンポーネント図配置図

ドキュメントとテーブル

プロジェクトチェックリスト

カテゴリタスク1:計画と準備タスク2:要件と分析タスク3:UI/UXデザイン
プロジェクト計画プロジェクト範囲を定義関係者を特定スケジュールを設定
要件分析機能要件を収集非機能要件を収集ユーザーストーリーを記録
UI/UXデザインワイヤーフレームを作成プロトタイプを開発デザインシステムを定義
アーキテクチャと技術スタックプログラミング言語を選定フレームワークを選定データベーススキーマを設計
開発環境の準備開発環境を構成CI/CDパイプラインを構築開発サーバーを構築
バックエンド開発中核ロジックを開発APIエンドポイントを実装データベースクエリを最適化
フロントエンド開発UIコンポーネントを開発レスポンシブ表示を確認API連携を実装
テストとQAユニットテストを作成結合テストを実施システムテストを実施
デプロイと監視本番サーバーを構成負荷分散を設定監視ツールを導入
保守とサポート定期更新を計画リリース後の問題を修正パフォーマンスを監視
コンポーネント図 · エッジレス
コンポーネント図 — キャンバスの例ノード:ユーザーインターフェース、認証サービス、商品カタログ、ショッピングカートサービス、注文処理、決済ゲートウェイ、データベースサービス、通知サービス。接続:ユーザーインターフェース → 認証サービス (IAuthService);ユーザーインターフェース → 商品カタログ;認証サービス → ショッピングカートサービス;商品カタログ → ショッピングカートサービス (IProductService);商品カタログ → 注文処理;ショッピングカートサービス → 決済ゲートウェイ;注文処理 → 決済ゲートウェイ (IPaymentService);注文処理 → データベースサービス;決済ゲートウェイ → 通知サービス;データベースサービス → 通知サービス (IDataStorage)。
ユーザーインターフェース
認証サービス
商品カタログ
ショッピングカートサービス
注文処理
決済ゲートウェイ
データベースサービス
通知サービス
IAuthService
IProductService
IPaymentService
IDataStorage
配置図 · エッジレス
配置図クライアントPCはWebサービスに接続。Webサービスはアプリケーションサーバーの明細と送金に接続。明細はデータストレージの口座情報に、送金は顧客情報に接続。顧客情報は口座情報に接続。
クライアントPC
Webサービス
明細
送金
口座情報
顧客情報
アプリケーションサーバーデータストレージ
ワークスペースの例 — 架空の内容であり、製品画面や導入事例ではありません。エッジレスでは、オブジェクトをドラッグ、ハンドで移動、Ctrl/⌘ + スクロールでズームできます。描画ツールは表示例です。

業種別ソリューション

業種に合った技術文書を。

6業種それぞれに4つのワークフロー例。架空の例による活用提案であり、導入事例ではありません。

  1. 工程・品質・技術チーム

    製造業

    準備手順と例外を、それらを説明する図とともに記録。

    作業
    ビジュアル作業手順書 · 根本原因分析
    成果物
    SOP、工程図、改善メモ
    製造業のワークフローを見る
  2. ソリューション・デリバリー・サポートチーム

    ITサービス

    設定の詳細と設計判断を、納品からサポートへ引き継ぎます。

    作業
    IT文書 · ソフトウェアアーキテクチャ
    成果物
    アーキテクチャメモ、納品チェックリスト、ITナレッジベース
    ITサービスのワークフローを見る
  3. 調査アナリストと責任者

    投資調査

    仮説の出典をたどり、見解を変えうる条件を記録します。

    作業
    投資メモ · 投資仮説のレビュー
    成果物
    調査メモ、出典、企業関連図
    投資調査のワークフローを見る
  4. 技術・文書作成チーム

    防衛

    インターフェースの前提、代替案、担当に関する疑問をレビュー担当者に共有。

    作業
    技術文書 · 設計レビュー
    成果物
    インターフェースメモ、レビュー記録、判断の根拠
    防衛分野の技術ワークフローを見る
  5. セキュリティ調査・コンサルティングチーム

    サイバーセキュリティ

    観測した挙動を、前提と不足する証拠に結び付けます。

    作業
    脅威モデル図 · インシデントレビュー
    成果物
    セキュリティ所見、信頼境界、フォローアップメモ
    サイバーセキュリティのワークフローを見る
  6. 探索段階 · 技術チーム

    航空宇宙

    例示ワークスペースで代替案を比較し、不足する証拠を記録。

    作業
    技術設計レビュー · トレードスタディメモ
    成果物
    構想図、案の比較、試験観察
    航空宇宙のワークフローを見る

例から評価へ

チームに合う出発点を見つけましょう。

文書作成の流れ、導入要件、次のステップを相談。

デモを予約

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

つながるワークスペース

ドキュメント、ホワイトボード、テーブルを一つに。

どの業種のワークフローも、同じ基本機能で構成できます。

  • 例示

    技術文書をドキュメントで

    見出し、画像、参照を使って手順書や調査メモを作成。

    Docsを見る
  • 例示

    ホワイトボードで工程図とシステム図を

    文書で説明する手順、構成要素、関係を図にします。

    エッジレスを見る
  • 例示

    テーブルで担当者と対応事項を管理

    未解決の質問を記録し、担当者を割り当て、チームで状態を更新。

    Teamhubを見る
  • ドキュメントをページモードとキャンバスモードで切り替える図

    ページとキャンバス、同じドキュメント

    ドキュメントをページとエッジレスの間で切り替え。

    使い方を見る
  • 共同編集

    リアルタイムで共同編集できるチーム共有ワークスペース。

    チームワークスペースを見る

作業別に見る

文書作成のワークフローを見つけましょう。

複数の業種にまたがる場合は、最も近い例を参考にしてください。

一般的な技術作業、チームの成果物、使用するAFFiNE機能
作業一般的な成果物AFFiNEの活用方法例を見る
工程を文書化手順、画像、例外メモを含むSOPを書き、流れを図示。順序図を添えた手順ページ画像ブロック付きドキュメント、流れを示すエッジレス、例外を記録するテーブル
システム構成を文書化コンポーネントとインターフェースを描き、設計判断を説明。判断メモを添えた構成図やインターフェース図選択の理由を説明するページと、その隣のエッジレスキャンバス
調査と証拠をレビュー出典や反論を仮説、所見、設計案に結び付ける。未解決の質問を含む仮説、脅威モデル、トレードオフの記録参照とPDFプレビューを含むドキュメント、関係図、手動更新の状態テーブル
引き継ぎを準備運用手順、図、未解決の質問を受け手のチーム向けにまとめる。背景、判断、未解決事項にリンクした引き継ぎページチーム共有ワークスペース、リアルタイム共同編集、Markdownエクスポート

一つのワークフローを最初から最後まで

メモ、図、判断から設計レビューを組み立てる。

同じ設計レビューをページ、ホワイトボード、テーブルで保持。チームが4つのステップで作り上げます。

ワークフローの例 · 架空の内容

ページ

データインターフェース — 設計レビュー

目的
2つのシステム間で測定値を交換する方法に合意
マーカー1:現時点の判断
v1では現在のメッセージ形式を維持
マーカー2:次のステップ
引き継ぎ前にリトライの担当を確認

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

データインターフェース — 設計レビュー — キャンバスの例ノード:送信元システム、インターフェース、利用側、形式v1、リトライの担当は?。接続:送信元システム → インターフェース (送信);インターフェース → 利用側 (読み取り);形式v1 → インターフェース (定義);リトライの担当は? → 形式v1。
送信元システム
インターフェース
利用側
形式v1
リトライの担当は?
送信読み取り定義12

テーブル · チームが管理

設計レビュー例の未解決事項
項目状態担当者
フィールドの対応付けレビュー済み連携
マーカー2:リトライ担当未解決要確認
マーカー3:引き継ぎメモ下書き中デリバリー
  1. ページに記した判断が、キャンバス上の形式に対応します。
  2. キャンバスの未解決の質問は、チームが手動で追跡する行に対応します。
  3. 引き継ぎメモがページ、図、未解決事項をまとめます。

番号付きマーカーは表示間の参照箇所を示します。リンクはチームが手動で作成し、自動同期や自動承認は行われません。

  1. 背景を記録

    目的、前提、判断をレビュー用ページに記録。

    入力:メモと仕様書 成果物:レビュー概要

  2. 関係を図示

    ホワイトボードにシステムを描き、前提と質問を記入。

    入力:概要 成果物:関係図

  3. 未解決の質問を追跡

    チームが手動で更新するテーブルにまとめます。

    入力:キャンバスの質問 成果物:未解決質問のテーブル

  4. 引き継ぐ

    概要、図、テーブルを1ページにリンク。共同編集し、Markdownでエクスポート。

    入力:概要、図、テーブル 成果物:引き継ぎ資料

導入と評価

自分たちに合う運用を。

利用を広げる前に、AFFiNEの運用方法を決めましょう。

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

ホスト型ワークスペース

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

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

前提条件

1 / Docker

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

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

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

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

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

セルフホスト

自社で運用するインフラ上でAFFiNEを動かす公式サポート方法はDocker Composeです。

  • Docker Compose
  • PostgreSQL
  • ファイルまたはS3ストレージ
  • OIDCサインイン

試験導入前に4点を確認

  1. 誰が執筆・レビュー・閲覧するか
  2. 誰がインフラとバックアップを運用するか
  3. AIを無効にするか、どのプロバイダーを使うか
  4. 必要なプラン機能

ローカルファースト編集でも、すべてのチーム機能がオフラインで動くわけではありません。制限ネットワーク用のインストール可能なライセンスがあっても、製品全体がエアギャップ対応になるわけではありません。セルフホストでデータの保存先を管理できますが、それだけで法令遵守が成立するものではありません。

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

リソース

テンプレートから始める。

上記の作業に合うAFFiNEの既存テンプレートとガイド。

一部の関連リソースは英語で提供されています。

よくある質問

チームから寄せられる質問。

技術チームの社内ナレッジベースには何を含めるべきですか?

社内ナレッジベースでは、手順、システムの背景情報、判断、出典を結び付け、各ページに担当者とレビュー日を明記します。チームが答えを必要とする質問に沿って整理しましょう。AFFiNEでは、文章による説明、図、フォローアップ用のテーブルをリンクすることで、新しいメンバーが作業を見つけて引き継げます。

ドキュメントとホワイトボードはどう連携しますか?

ページには目的、前提、判断、出典を詳しく記します。エッジレスキャンバスにはシステム、手順、論点などの関係を描きます。図を説明の隣に配置し相互にリンクすれば、同じワークスペースで理由と構造を確認できます。

AFFiNEは既存の技術・業務ツールと併用できますか?

はい。AFFiNEは仕事を説明し結び付ける場所であり、生産、チケット管理、セキュリティ監視、市場データなどの記録元システムを置き換えるものではありません。通常はそれらにリンクし、レビューや引き継ぎに必要な点を要約します。利用予定の連携機能は、計画前に個別に確認してください。

AFFiNEはセルフホストできますか?

はい。公式にサポートされる方法はDocker Composeで、OIDCを通じて自社のIDプロバイダーでサインインできます。AI機能は任意で、無効にできます。運用担当者とEnterpriseページおよびドキュメントを確認し、自社環境でバックアップと復元を検証してください。

機密性の高い技術知識に対するAFFiNEの適合性はどう評価しますか?

まず業務要件を確認します。保存可能な資料、保存場所、アクセス権限、AI利用可否を決め、その要件でホスト型とセルフホストを比較してください。保存場所だけでは業務への使用承認は成立しません。セキュリティとコンプライアンスの担当者に早期に参加してもらいましょう。

試験導入はどこから始めればよいですか?

設計レビューや引き継ぎなど実際のワークフローを一つ選び、使用が許可された少量の資料を用意します。維持管理するメンバーとページ、キャンバス、未解決質問のテーブルを作ります。次の担当者が仕事を見つけ、理解し、引き継げるかで評価してください。

チームについて話す

チームでAFFiNEを評価。

文書作成の流れ、導入要件、次のステップを相談。

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

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