主な概念

このページでは、Hane Platform の主な概念を短い定義で並べ、互いの関係と、詳しい説明のページを示します。言葉の細かな使い分けは 用語集 を参照してください。

全体の地図

組織
 ├─ メンバー・グループ（ロールを持つ）
 └─ プロジェクト
     └─ 環境（dev・stage・prod）
         ├─ サービスアカウント・API キー
         ├─ 有効なバージョン（ReleaseBundle） ← マニフェスト（定義）
         │     型・計算の規則・Workflow・スケジュール・割り当ての規則・DeciderPolicy・Agent …
         └─ 業務の状態
               レコード・関係 ─ 案件 ─ Task
               AgentRun ─ ActionRequest（承認を待つ操作）
               文書・会話
               イベント ─▶ 購読（webhook）
                  └─▶ 監査の記録

組織とアクセス

概念	意味	詳しく
組織	Hane を契約する単位。データと権限はここで分かれる	組織・プロジェクト・環境
プロジェクト	組織の中で、定義とデータを分ける単位。業務アプリや用途ごとに作る	同上
環境	同じプロジェクトの開発・検証・本番（dev・stage・prod）。データと資格情報は環境ごとに分かれる	同上
メンバーとロール	組織に属する利用者。owner・admin・developer・operator・viewer のロールで、できる操作（スコープ）が決まる	同上
サービスアカウントと API キー	人でない呼出し元（業務アプリのサーバーや CI）と、その資格情報。1 つのプロジェクトの 1 つの環境に結び付く	同上
緊急停止	組織のすべての API と実行を止める操作。解除は owner だけができる	同上

定義

概念	意味	詳しく
マニフェスト	Git に置く定義の YAML。apiVersion・kind・metadata・spec の形を持つ	定義をコードで管理する
定義	まとめて有効にするもの（型・計算の規則・Workflow・Agent など）。ReleaseBundle に束ねる	同上
設定	束ねずに、apply するとすぐ効くもの（EnvironmentBinding・RoleBinding など）	同上
draft	apply したが、まだ有効でない定義	同上
ReleaseBundle	定義のバージョンの組。中身は変えない	同上
有効なバージョン	いまその環境で動いている ReleaseBundle（active_release）	同上

業務データ

概念	意味	詳しく
型と項目	レコードの種類（車両・契約など）と、型が持つ値の名前。Schema と Ontology のマニフェストで定義する	業務データ
レコード	型に従う業務データの 1 件	同上
値の状態と出典	値をどこまで確かめたか（確定・推定・要照会・不明）と、値がどこから来たか	同上
関係	レコードとレコードのつながり。有効期間を持てる	同上

業務の進行

概念	意味	詳しく
Workflow	案件の進め方の定義。ステップをたどって進む	Workflow と案件
案件	Workflow で進める 1 件の仕事。対象のレコードと、始めたときの ReleaseBundle を持つ	同上
待機	Task の完了、イベント、承認の結果などを待っている状態	同上
スケジュール	毎日の決まった時刻に、案件を始めるか、Agent を 1 回動かすか、外部の接続先からの取り込みを 1 回始める定義	同上
Task	人が決める・作業する 1 件。担当のグループか人に割り当て、決めた結果のどれかで閉じる	承認と Task
承認	外へ影響する操作の中身（承認の対象）に対して、決定者が承認か却下を決めること	同上
DeciderPolicy	操作の種類と条件（金額・宛先）ごとに、誰が決めるかと承認の段を決める定義	同上

Agent

概念	意味	詳しく
Agent	目標・入力と出力の型・使えるツール・上限を定義した AI エージェント	Agent
AgentRun	Agent の 1 回の実行。ツールの呼出しと結果、使用量を記録する	同上
ActionRequest	Agent が提案した、外へ影響する操作。承認を通ってから実行され、結果は実行台帳に残る	同上
会話	利用者がチャットの Agent に自然文で頼むやり取り	組み込みチャット

文書・イベント・監査

概念	意味	詳しく
文書	原本のファイルと、そのバージョン。全文検索や、項目の値の抽出に使う	文書
抽出の候補	文書から抜き出した値で、人がまだ確かめていないもの。確かめると業務データの確定の値になる	同上
イベント	サービスで起きた変化の記録（案件の完了、Task の作成、レコードの更新など）	Webhook
購読	イベントを顧客のシステムへ webhook で届ける宛先と種類の登録	同上
監査の記録	誰が・何を・どの権限で行ったかの記録。前の記録のハッシュとつないで残す	監査と使用量

次に読む

組織・プロジェクト・環境メンバー、ロール、API キー、招待

定義をコードで管理するマニフェストから有効化まで

用語集言葉の意味と使い分け