Home / つなぎ方
Integration
旧いシステムにも、
新しいシステムにも。
業務ロジックの書き換えは不要。ただし、何も変えずにつながるわけではありません。業務システムに「ブリッジ」を足し、残りはフレームワークが用意します。
足すのは「ブリッジ」
- 業務データを読む口と、AI の提案を受ける口
- manifest（システムの自己紹介）
- 本人の SNS 連携（システム自身のログインで）
- 受信者を業務システムが決める規則
- 状態変化を同じトランザクションで event に
- 承認の規則・定時報告（件数だけ）
載せ方は 3 通り
- Node.js：既存のサーバに server-kit を載せ、hooks を既存の表と関数につなぐ
- 同じ働きの API がある：/bridge/v1 を既存のルートに別名で載せる
- Node.js 以外：OpenAPI 3.1 をその言語で実装し、適合性テストで確かめる
生まれたときから、AI 社員と働く
- server-kit の上で作れば、Bridge の部分は部品が持つ
- 書くのは業務・hooks・manifest・画面だけ
- 見本の業務システムで、構成と書き方を確かめられる
bridge.manifest.yaml # self-description src/auth.mjs # authenticate · isSessionLive src/domain.mjs # business rules · tx + emitEvent src/hooks.mjs # employees · recipientsFor · approvals src/routes.mjs # /api/* · readToolPolicy manual/NN-*.md # one screen = one section test/conformance.test.mjs web/ bff/ # web-kit · gateway
コードを変えずに、外にブリッジを置く
- ログインを外から確かめられる（OIDC / SAML）
- 本人として呼べる API がある
- commit 後の変化の知らせ（webhook / CDC）がある
- 承認と書込みの API がある
A4 つともある → 全機能
BAPI はあるが本人として呼べない → 知らせと報告まで
C画面しか無い → API を足すか、新規で
Checklist
業務システムに足すもの（13 項目）
承認と定時報告は、業務で使わなくても最小の形で持ちます（適合性テストを skip なしで通すため）。
| # | 足すもの | 区分 |
|---|---|---|
| 1 | 業務データを読む口と、AI の提案を受ける口 | 必須 |
| 2 | manifest（--strict で警告なし） | 必須 |
| 3 | 本人の SNS 連携の画面（システム自身のログインで） | 必須 |
| 4 | 受信者を業務システムが決める規則（Web の認可と同じ判定） | 必須 |
| 5 | 状態変化を同じトランザクションで event に | 必須 |
| 6 | 職員と役割（有効・無効を含む） | 必須 |
| 7 | 承認の規則を 1 か所の関数に | 必須 |
| 8 | Web のセッションの確認 | 必須 |
| 9 | 職員向けのマニュアル（1 画面 = 1 節） | 推奨 |
| 10 | 名簿に基づく個人情報の検査 | 推奨 |
| 11 | AI 社員のプロフィールの編集 | 推奨 |
| 12 | 定時報告（件数だけ） | 必須 |
| 13 | 外部連携（接続先・操作・規則） | 任意 |
Seven steps
7 ステップと、完了の条件
1manifest を書いて検証
2hooks を実装（または別名）
3トランザクションで event
4適合性テスト 52 / 52
5AI 面の profile に登録
6業務 Web に画面と BFF
7自動タスクを有効化
# 1 manifest bridge-validate manifest bridge.manifest.yaml --strict exit 0 # 2 conformance (TEST environment) node --test conformance/http.test.mjs 52 passed · 0 skipped # 3 your own tests node --test test/*.test.mjs all pass # 5–6 product profile · outbound settings closed node profile/scripts/check.mjs cordis.patch.yml exit 0 # 8 business web tsc --noEmit no errors
🎯
ひとつの業務から
請求の承認・期限の超過など 1 つから始め、既存の画面と並行して確かめてから広げる。
📐
最初に見積もる
読取 API とログインは作りの根本。足す量はシステムによって大きく違う。
🧩
AI エージェントと進める
導入 skill が、診断 → 計画 → 実装 → 検証を AI コーディングエージェントに案内する。