ワークフロー共通基盤
申請・承認・期限管理・通知・監査ログを共通機能として提供するワークフロー基盤の参考実装です。
3つの設定ファイルを置くだけで業務を追加できます。
コードを変えずに業務を追加
フロー・フォーム・設定の3ファイルを置いてアプリを再起動するだけで、申請メニューに業務が追加されます。
共通機能の改善が全業務に反映
承認UI・通知・監査ログは基盤に一か所あるため、改善すると全業務が一度に恩恵を受けます。
AI ツールと相性がよい
ガイドドキュメントを渡すだけで、AI コーディングツールに定義ファイルを作ってもらえます。
デモを見る デモ環境は、パスワード付きです。ご利用希望の方は、作者までご連絡ください。

仕組み

基盤(公開コード)と業務定義(利用者が足すもの)を分けて管理します。 業務定義フォルダはリポジトリ外に置くことができ、環境変数で場所を切り替えられます。

業務定義(利用者が足すもの — リポジトリ外でも可) process.bpmn20.xml 承認・分岐の流れ form.json 申請フォームの項目 meta.json 表示・権限・期限 DEFINITIONS_DIR で場所を指定 基盤(公開コード) 画面 React + Ant Design 申請・タスク・履歴 通知・監査ログ サーバー Node.js + Express SLA・ACL・BPMN 自動デプロイ エンジン Flowable OSS BPMN 実行・タスク管理 履歴・変数管理

利用手順(利用部門の方へ)

デモを見る デモ環境は、パスワード付きです。ご利用希望の方は、作者までご連絡ください。
デモ環境は、パスワード付きで運用しています。ご利用希望の方は、作者までご連絡ください。
1
利用申請
基盤の管理者に利用を申請し、共通環境か専用環境かを相談します。業務の重要度・機密性・可用性・監査要件を整理しておくと話が早くなります。
2
手順書と定義フォルダのひな型を受け取る
担当者から docs/definition-guide.md(定義の書き方ガイド)と定義フォルダのひな型を受け取ります。
3
定義を作る
Claude Code などの AI コーディングツールに definition-guide.md を渡し、「○○という業務を定義して」と依頼すると、フロー・フォーム・設定の 3 ファイルを生成してもらえます。
4
レビュー
フロー(誰が何をするか)・権限(誰が申請・承認できるか)・期限(SLA)の設定内容を、担当者とともに確認します。
5
リリースされ、申請カタログに出る
リリース担当者が定義フォルダを所定の場所に配置してアプリを再起動します。申請カタログに業務が追加され、指定したグループのユーザーが申請できるようになります。

運用の考え方

以下は設計方針です。本サンプルには実装していません。実際の運用ルールは、導入する組織が別途定めてください。
動かす場所
同じ基盤を 2 通りで動かします。
共通環境は軽めの業務を載せ、基盤の改善が全業務に一斉に届きます。
専用環境は決裁など基幹系の業務を別に立てます。止まったときの影響・機密性・可用性・監査要件が違うためです。
判断基準: 重要度 / 機密性 / 可用性 / 監査要件。
リリース
定義はコードと同じく Git で管理し、定期リリース枠の中で配置します。再起動は「リリースの一部」として扱います。
動いている申請は旧版のまま進み、新しい申請から新版が適用されます(Flowable の仕様)。
緊急時の臨時リリース経路だけ事前に決めておきます。
品質
2 段階で確認します。
機械的な検査(CI): 形式・必須項目・命名・BPMN 構文を自動確認し、通らないものはレビューに回しません。
人によるレビュー: 業務の中身・承認者設定・他部門への影響を確認します。
レビュアーとチェックリストは運用開始時に組織内で決めます。
互換性
定義の形式にバージョンを付け、基盤が対応する形式を明示します。変更履歴を残し、古い形式は一定期間動かしてから廃止します。
同梱の 4 業務サンプルを、基盤を修正したときの回帰テストとして使います。

よくある質問

このシステムで何ができますか?
申請・承認・審査業務を素早く立ち上げるための共通基盤のデモです。 承認の流れ(複数段階・条件分岐・並行審査)・期限管理(SLA)・アプリ内通知・操作履歴(監査ログ)・権限制御を共通機能として提供しています。 業務を追加するために基盤のコードを変える必要はありません。
業務を追加するにはどうすればよいですか?
3 つのファイルを用意するだけです。
process.bpmn20.xml(承認・分岐の流れ)、form.json(申請フォームの入力項目)、meta.json(業務名・権限・期限などの設定)を definitions/<業務ID>/ フォルダに置いてアプリを再起動すると、申請カタログに業務が追加されます。 詳しい書き方は docs/definition-guide.md を参照してください。
データはどこに保存されますか?
このデモは Flowable の組み込み H2 データベースを使用しています。 コンテナを削除するとデータは消えます。 本番環境で使う場合は、外部のデータベース(PostgreSQL 等)への切り替えが別途必要です。 通知データは /data/notifications.json にファイルとして保存されます。
「参考実装」とは何が違いますか? 製品として使えますか?
本サンプルは仕組みを学ぶ・試す・自社向けに作り直す出発点として公開しています。 認証基盤(Entra ID 等との連携)・メール通知・データの永続化・高可用性構成・サポート体制などは含まれていません。 本番環境で使う場合は、これらを別途整備する必要があります。 無保証(AS IS)の提供であり、Issue・PR は受け付けていません。
基盤に機能が足りない場合はどうすればよいですか?
このリポジトリをフォークして、自社の要件に合わせて基盤側(server.js・フロントエンド)を直接変更できます。 変更は全業務に即座に反映されます。 基盤のコードは Apache-2.0 ライセンスで公開しているため、自由に改変・再配布できます。
ライセンスはどうなっていますか?
Apache License 2.0 で公開しています。商用利用・改変・再配布が可能です。 依存するオープンソースライブラリのライセンスは docs/third-party-licenses.md を参照してください。 本ソフトウェアは無保証(AS IS)で提供します。
デモ環境はありますか?
デモ環境は、パスワード付きで運用しています。ご利用希望の方は、作者までご連絡ください。 手元で動かす場合は、このリポジトリを複製して docker compose up -d で起動できます(起動まで約 4 分)。