説明を書く
文書でPayment Serviceを説明します。同じWorkspaceのもう一人のメンバーに、一緒に編集してもらいます。
日常のオーサリング
使い慣れた作業面が土台です。 妥協ではありません。
人がそのまま読める文書とダイアグラムで、書く、描く、レビューする、検索する、移動する、インポートする、エクスポートする。形式的な構造は、再利用やガバナンスを改善する場所にだけ現れます。
- 01技術文書
- 02構造化ダイアグラム
- 03リアルタイム共同編集
- 04セマンティック変更レビュー
- 05権限対応検索
- 06履歴と復元
- 07文書インポート
- 08不変の公開とエクスポート
実際に確かめる手順
ひとつのServiceを、執筆からエクスポートまで追う。
Serviceは、決済処理などシステムの一部分です。六つの確認には同じServiceを使い、評価で実際に使えたことを記録します。
- 01
試すこと 確認することエディターのキャプチャには、保存済みの文章と別の編集者が写っています。後のすべての手順を証明するものではありません。
製品キャプチャを見る - 02
試すこと Serviceにひとつのアイデンティティを与える
Serviceを再利用可能なオブジェクトとして確認します。これは文書やダイアグラムから参照できる共有レコードです。
確認することオブジェクトのキャプチャには所有者とバージョン履歴があります。この切り抜きにはUsed inの一覧がないため、再利用は別途試す必要があります。
製品キャプチャを見る - 03
試すこと 二つの文書と一つのダイアグラムで再利用する
同じオブジェクトへの参照を挿入します。必要に応じて、復旧手順であるRunbookと、信頼性の目標であるSLOを追加します。
確認すること各参照を開いてオブジェクトIDを比較します。同じ名前だけでは不十分です。最新バージョンに追従する参照と、固定バージョンにピン留めする参照を試します。
デモで試す - 04
試すこと ひとつの変更をレビューする
所有者または依存関係を変更します。保存済みバージョンを比較して、semantic changeと呼ばれる意味の変更を確認します。
確認することダイアグラム比較のキャプチャには、変更された参照と追加された項目が見えます。自分の所有者変更と、誰が承認できるかを試してください。
製品キャプチャを見る - 05
試すこと 作業の準備ができたら公開する
組み込みのService Overview Contractを試します。このルールセットは、統制された公開の前にService名と所有Teamを確認します。
確認すること未完成の下書きも保存できなければなりません。有効なレビュー規則と、公開対象として選ばれる保存済みバージョンを確認します。
デモで試す - 06
試すこと Topoloomの外でエクスポートを開く
選択した内容をエクスポートし、読めるファイル、共有レコード、省略または変更された情報のレポートを開きます。
確認することキャプチャはエクスポートの完了を示します。実際のアーカイブを検査して内容を確かめ、プロバイダーが利用できない状態でも繰り返します。
製品キャプチャを見る
これらの正規のキャプチャは2026年9月に提供され、それぞれ別の製品状態を示しています。ひとつの評価を完了するまでの録画ではありません。デモでバージョンと有効な機能を確認してください。
プロダクトの証拠
Mapで文書の関係を説明する。
現在の文書モードはContentとMapです。ここでSTORES_INは、Payment ServiceがPayment PostgreSQLにデータを保存することを示します。
共有レコードを確認
参照の先にあるオブジェクトを開く。
挿入した参照とID、所有者、バージョンを比較します。参照を最新オブジェクトバージョンに追従させるか、ひとつのバージョンに固定するかを選びます。
Used inには、閲覧を許可された固定済みの文書またはダイアグラムのバージョン内の参照が出ます。これらのバージョンは不変で、内容は変わりません。ライブドラフトは含まれません。この切り抜きには一覧が写っていません。
機能の境界
各ステップが担う範囲を知る。
自分の環境で確かめる。
上のワークフローには六つの確認項目があります。何を検査するか、何が別のままか、利用可能な環境がどこで関わるかを、これらの境界で確かめます。
どの版がオブジェクトを使うかを確認する。
Used inには、公開済みかどうかを問わず、閲覧を許可された不変の成果物バージョン内の参照が出ます。編集中のドラフトは含まれません。
宣言済みエッジと視覚線を分ける。
型付きノードと宣言済みエッジには来歴があります。視覚表現のみのコネクターが同じ関係を主張することはありません。
編集と併せて意味を検査する。
安定したアイデンティティで、所有者、依存関係、目標、Decisionの変更を確認し、Workspaceで有効なレビュー規則を確かめます。
組み込みContractを試す。
Service Overviewは通常の下書き保存を止めずに、統制された公開を確認します。独自Contractの作成は後の機能です。
必要なプロバイダーを確認する。
設定済みプロバイダーのコンテキストは、帰属を保ち、人が作成した知識とは別に扱われます。参照ワークフローは模擬プロバイダーを使うため、実際のコネクターは別途確認してください。
パッケージとレポートを開く。
読める内容、ID、版、関係、来歴、レビュー、権限マッピング、省略を検査します。ソース参照付きDiagramのエクスポートにはtopoloom.package/4を使います。
AIに依存しないAI-ready
機械にも役立つ。 それでも人が制御する。
RAGやGraphRAGを含む検索・取得パイプラインやエージェントは、設定されていればこのナレッジを利用できます。Topoloomは構造化され、版が付き、権限を考慮した入力を提供しますが、AIは権限、レビュー承認、公開の判断には入れません。現行リリースでKnowledge Reviewを支える提案エンジンは、決定的なオフラインのルールセットです。モデルはループに入りません。
安定したアイデンティティ
取得は、文書、ダイアグラム、版、エクスポートをまたいで同じオブジェクトを参照できます。
権限コンテキスト
検索、参照、イベント、エクスポート、生成ビューは、何かを表示する前に権限をもう一度確認します。
来歴とライフサイクル
来歴は記述の由来を示し、ライフサイクルはどの版が現行かを示します。読み手は宣言と提案、公開版と置き換えられた版、さらにそれらと外部コンテキストを区別できます。
プロバイダーからの独立
AIやコンテキストプロバイダーが停止しても、執筆、共同編集、レビュー、履歴、ローカルエクスポートは続きます。Knowledge Reviewの提案も続きます。現在の分析に必要なのはモデルでもネットワーク呼び出しでもありません。
焦点を絞ったプロダクトウォークスルー
チームが毎日 説明しているワークフローを持ち込む。
同じServiceが、文章、システムダイアグラム、Runbook、SLO、セマンティックレビューを通る様子をご覧ください。