はじめに：ワークフローを制する者が業務改善を制す

業務システム開発において、「ワークフロー」の自動化・最適化は今や業務改善の中核的テーマとなっています。社内申請、承認フロー、通知処理といった反復的な業務は、人的リソースを圧迫するだけでなく、属人化によるリスクやトレーサビリティの欠如といった課題を内包しています。 従来、Excelやメール、チャットなどをベースに進められていたこれらの業務フローは、APIによる連携と自動化により一元化・可視化が可能になりました。特に、SaaSサービスとの統合、ノーコードUIによる現場での設定、再実行や分岐制御に強い非同期処理の仕組みが加わることで、開発の幅が大きく広がっています。 本記事では、業務フローの統制と柔軟性を両立する「APIドリブンワークフロー構築」の受託開発実践例を、設計思想・技術選定・運用設計にわたって解説します。

プロジェクト背景：属人化した社内フローの再構築ニーズ

ある中堅企業でのプロジェクトにおいて、以下のような課題が顕在化していました：

• 部署ごとに異なる申請書式と承認手順の存在
• 申請チャネルがメール・フォーム・Slackなどで分散している
• 担当者不在時にフローが停滞し、緊急時対応が困難
• 履歴や進捗の一元管理が不十分で、後追い確認が煩雑

クライアントはこれを機に、Google WorkspaceやSlackといった既存のIT資産を活かしながら、業務フローを統一された定義に基づいて制御・可視化できるようにしたいと考えていました。その相談を受け、APIベースで業務を自動制御する提案がスタートしました。

要件定義：抽象化・可視化・自動制御の三軸設計

要件定義においては、以下の三軸を中心に検討を進めました：

• 1. 業務フローの抽象化：複数の申請フローをYAMLでテンプレート化し、汎用構造として設計
  2. 可視化：進捗状況や承認履歴をリアルタイムで表示できるUI設計
  3. 自動制御：Webhookやステータスに応じた処理分岐、再実行対応を含む非同期設計

具体的な要件は以下のとおりです：

• Google Workspace（Gmail、Sheets、Drive）とのAPI連携
• Slackでの通知と承認処理（Webhook受信による状態管理）
• YAMLベースの業務フロー定義とノーコードUIの併用管理
• 複数ステップ・条件分岐・複数承認経路に対応した設計
• Celeryによる非同期タスク制御と再実行可能なジョブ基盤

技術設計：柔軟性と保守性を両立する構成

フローエンジンと非同期制御

• FastAPIを用いたWebフックおよびAPIエンドポイント設計
• Celery + Redis による非同期タスクキュー制御
• 各ステップのタイムアウト、再実行ポリシー、ログ保存仕様を明確化

フロントエンドとノーコード管理

• React + TypeScript によるSPA構成、フォーム定義をUIスキーマで実装
• Firebase Authentication によるユーザー識別とロールベース表示
• YAMLテンプレートをWeb UI上から編集・バージョン管理可能に

外部サービスとの連携

• Google Sheets 起票によるワークフローのトリガー起動（Webhook）
• Slackボタンによる承認／差戻し、ステータス更新の自動反映
• Google Drive による添付ファイル格納、Gmail送信による通知処理

導入と効果検証：段階導入による安定展開

導入は以下のようなステップで実施しました：

1. 業務フローのマッピングとユースケース整理（2週間）
2. プロトタイプ開発（UI・YAMLテンプレート）（3週間）
3. 各種SaaS連携・CI実装と検証（6週間）
4. 現場教育と本番運用（2週間）

成果指標としては以下が確認されました：

• 申請から承認完了までの平均時間が4分の1に短縮
• Slack通知による即時レスポンスが90%以上を記録
• フローの属人性がほぼ解消、管理者による全体把握が可能に
• 問題発生時のログ確認や再実行が数クリックで可能に

開発者に求められる視点：構造設計と業務理解の両立

このプロジェクトでは以下の能力が開発側に求められました：

• API設計における認可制御・レート制限・ステート管理
• ワークフローの抽象化（冪等性、例外分岐、遅延処理）
• YAMLテンプレートによる定義とUIスキーマの一致管理
• 現場業務の可視化とテンプレート化（属人知の設計転換）

業務を「技術視点で記述する」だけでなく、「現場が理解・運用しやすい構造へ翻訳する」力こそが受託開発における強みとなります。

まとめ：ワークフロー統合は業務改善そのもの

本プロジェクトは、APIとノーコードUIの融合により、属人的業務を「再利用可能な仕組み」へと昇華した事例です。 今後も、システム開発会社に求められるのは「単なるAPI接続の技術力」ではなく、「業務そのものを再設計し、クライアントにとって持続可能な業務構造を提供する視点」です。 受託開発においても、APIドリブンなワークフローの構築力は、プロジェクトの品質を決定づける要素となるでしょう。