ERP連携付きの医薬品卸向け発注プラットフォーム
医薬品卸向けのB2B発注プラットフォーム。購買者向けミニプログラム、運営コンソール、Spring BootのAPIで構成されます。スケジュールジョブが販売元のERPから商品と在庫を取り込み、注文と顧客を再試行付きでERPに送り返します。
要点: 販売元のERPを正のシステムのまま、医薬品卸のセルフサービス発注を構築しました。スケジュールジョブがカタログと在庫を取り込み、注文と顧客を再試行付きで送り返し、商品が出荷され請求書が発行されるまで伝票の状態をポーリングします。
概要
薬局と診療所はミニプログラムから発注します。運営者はWebコンソールで商品、購買者の資格、注文、アフターサービスを管理します。商品、在庫、請求書は引き続きERPから来ており、プラットフォームが送るのは支払い済みで承認された注文とその顧客だけです。
課題
卸の購買者はセルフサービスで発注したいが、在庫、会計、請求はERPに残さなければなりませんでした。2つのシステムは、ERP側が公開したインタフェース仕様を通じて整合を保つ必要がありました。
制約
- 商品、在庫、伝票の状態、請求書についてはERPが正のシステム。
- 購入前に購買者の資格を確認する必要があり、アップロードされた許可証の文書認識も含む。
- 開発とテストは、本番の決済、物流、通知、ERPにアクセスせずに動くこと。
アーキテクチャ
| 部分 | 実装 |
|---|---|
| バックエンド | Java 17、Spring Boot 3.3、MySQL 8、Redis、S3互換オブジェクトストレージ、Flywayマイグレーション |
| クライアント | 購買者向けのメッセージングプラットフォームのミニプログラム。Vue 3の運営コンソール |
| ERPアダプタ | 注文を「計上済み」まで進め請求書を生成するインメモリのモックと、HTTP実装とを切り替え可能 |
| スケジュール | カタログの取り込みは30分ごと。在庫の取り込みは1分ごと。注文と顧客の再試行付き送信は1分ごと。伝票状態のポーリングは5分ごと |
| 運用 | 同期状態とログを表示するコンソールの連携ページ。同期、送信、ポーリングは手動でも起動できる |
主な判断
- 取り込みとポーリング、データベースは共有しない。 プラットフォームは公開されたインタフェースを通してしかERPにアクセスしないため、片側のスキーマが変わってももう片側は壊れません。
- モック優先のアダプタ。 決済、物流、通知、ERPにそれぞれモックがあり、請求書発行まで含めた注文のライフサイクル全体を、パートナーの認証情報なしでローカルで動かせます。
- シークレットはリポジトリに置かない。 CIはバックエンドの検証、コンソールのlint、型チェック、テスト、ビルド、シークレットスキャンを実行し、コミットするのは環境ファイルのサンプルだけです。
根拠
- バックエンドのテストクラス45、マイグレーションファイル56。
- 本番デプロイの文書は、リリース、ロールバック、シークレットのローテーション、バックアップと復元を扱っています。
限界
注文数、購買者数、稼働開始日、取引条件は公開していません。
よくあるご質問
在庫はどうやってERPと同期していますか?
商品は30分ごと、在庫は1分ごとに取り込みます。注文と顧客は再試行付きで送信します。伝票の状態は5分ごとにポーリングします。
本物のERPにアクセスできなくても開発できますか?
モックのERPアダプタが、請求書発行を含む伝票のライフサイクルを再現します。
ERPへの送信に失敗するとどうなりますか?
そのレコードはキューに残り、1分ごとの次の実行で再試行されます。運営者はコンソールで同期ログを確認し、再試行を手動で起動できます。