ヘキサゴナルアーキテクチャをFastAPIで考える

Transcript

1. ヘ キ サ ゴ ナ ル ア ー キ テ ク チ ャ を F a s t A P I で 考 え る ゴロゴロシステムズ　
2. 趣味 自 己 紹 介 　 　 　 　 た つ の ぶ ( @ 5 6 5 6 s y s t e m s ) 職業 介護福祉領域の事業承継支援会社の技術役員（CTO） ゴロゴロシステムズ（個人事業主：エンジニア） 水門の遠隔操作システム開発者・生体認証基盤保守開発者←NEW お米会社のIT顧問 / 心理相談室のHP改善担当 社会保険労務士事務所の社内SE / M&Aプラットフォーム開発者 「人事・労務・業務・メンタルヘルス課題のDX」を通じてこころの労働負荷を削減する 　担当実績 　モットー ボカロ鑑賞・カフェ巡り・技術探求・ゴロゴロすること 2027年の 社会保険労務士試験 合格したいゾ 💪 ...etc
3. Hexagonal Architectureは 2005年頃にAlistair Cockburn（アリスター・コバーン）氏 によって提唱された アーキテクチャパターン
4. ビジネスロジックを外部技術から独立 させること 最 大 の 目 的
5. フ ォ ル ダ ー 構 成 例
6. ① D o m a i n 層 （ E n t i t y ） 業務ルールを持つ、システムのコアです。ピュアなPythonコードで記述 し、PydanticやSQLAlchemyなどのライブラリには依存させません。
7. ② P o r t 定 義 （ I n t e r f a c e ） Repositoryの「仕様」だけを定義する抽象クラスです。
8. ③ A p p l i c a t i o n 層 （ U s e C a s e ） Portを利用して業務ロジックを組み立てます。
9. ④ I n f r a s t r u c t u r e 層 （ A d a p t e r の 実 装 ） SQLAlchemy等のORMを利用して、Port（仕様） を満たす具象処理を実装します。
10. ⑤ P r e s e n t a t i o n 層 （ F a s t A P I R o u t e r ） FastAPIのRouterは、HTTPリクエストをアプリケーションが理解できる形に変換 してUseCaseに渡す「入力アダプター」です。FastAPIの強力な機能である Depends を使って、UseCaseへAdapterを注入します。
11. ま と め Hexagonal Architectureの本質は 「業務ロジックを外部技術から守る」こと！！ FastAPIとしてはRouter部分のみを担当し Domain UseCase Port を中心に設計することで 保守性・テスト容易性・拡張性の高いシステムを構築できる 💪
12. ありがとうございました