Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
個人開発アプリにスキーマ 駆動開発を取り入れた話
Search
虎の穴ラボ株式会社
November 30, 2023
Programming
0
210
個人開発アプリにスキーマ 駆動開発を取り入れた話
2023年11月30日に行われた「秋の終わりまでにチャレンジしたことLT会」にて発表した内容となります。
虎の穴ラボ株式会社
November 30, 2023
Tweet
Share
More Decks by 虎の穴ラボ株式会社
See All by 虎の穴ラボ株式会社
Tailwind CSSとAtomic Designで実現する効率的な Web 開発の事例
toranoana
1
430
Denoについて、同人誌記事を出しました+update
toranoana
0
120
【虎の穴ラボ Tech Talk #2】プロンプトエンジニアリング
toranoana
0
45
20241121_[TechTalk#2]虎の穴ラボでのLLMについて取り組み紹介
toranoana
0
65
社内チャットへRAG導入した話(Tech Talk #2)
toranoana
0
95
Deno Deploy で Web Cache API を 使えるようになったので試した知見
toranoana
1
400
【虎の穴ラボ Tech Talk】虎の穴ラボTech Talk説明資料
toranoana
0
270
虎の穴ラボ Tech Talk_CDKでFargate環境構築
toranoana
1
300
虎の穴ラボスキルアップ支援制度の利用例
toranoana
0
3.9k
Other Decks in Programming
See All in Programming
CSS Linter による Baseline サポートの仕組み
ryo_manba
1
160
機能が複雑化しても 頼りになる FactoryBotの話
tamikof
1
250
データベースのオペレーターであるCloudNativePGがStatefulSetを使わない理由に迫る
nnaka2992
0
250
読まないコードリーディング術
hisaju
0
120
Amazon Bedrockマルチエージェントコラボレーションを諦めてLangGraphに入門してみた
akihisaikeda
1
160
苦しいTiDBへの移行を乗り越えて快適な運用を目指す
leveragestech
0
1.2k
未経験でSRE、はじめました! 組織を支える役割と軌跡
curekoshimizu
1
200
Jasprが凄い話
hyshu
0
180
Duke on CRaC with Jakarta EE
ivargrimstad
0
180
仕様変更に耐えるための"今の"DRY原則を考える
mkmk884
9
3.3k
The Clean ArchitectureがWebフロントエンドでしっくりこないのは何故か / Why The Clean Architecture does not fit with Web Frontend
twada
PRO
55
18k
[JAWS DAYS 2025] 最近の DB の競合解決の仕組みが分かった気になってみた
maroon1st
0
170
Featured
See All Featured
Fontdeck: Realign not Redesign
paulrobertlloyd
83
5.4k
How to Create Impact in a Changing Tech Landscape [PerfNow 2023]
tammyeverts
49
2.3k
Adopting Sorbet at Scale
ufuk
75
9.2k
Practical Tips for Bootstrapping Information Extraction Pipelines
honnibal
PRO
13
1k
CSS Pre-Processors: Stylus, Less & Sass
bermonpainter
356
29k
The Cost Of JavaScript in 2023
addyosmani
47
7.5k
ピンチをチャンスに:未来をつくるプロダクトロードマップ #pmconf2020
aki_iinuma
115
51k
Building Your Own Lightsaber
phodgson
104
6.2k
Intergalactic Javascript Robots from Outer Space
tanoku
270
27k
The Invisible Side of Design
smashingmag
299
50k
Art, The Web, and Tiny UX
lynnandtonic
298
20k
Mobile First: as difficult as doing things right
swwweet
223
9.5k
Transcript
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. 個人開発アプリにスキーマ 駆動開発を取り入れた話
虎の穴ラボ株式会社 浜田拓実 (sheltie) 2022 秋の終わりまでにチャレンジしたことLT会 11/30
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. 自己紹介 浜田
拓実(ハマダ タクミ) • 2022/06 入社 • 虎の穴ラボ 通販コスト削減チーム エンジニア Goを使い始めた理由 • シンプルな構文でコードがガリガリ書ける(気がする) • エイリアスや省略した書き方が少ない(気がする) 今季の推しアニメ • SHY • 16bitセンセーション
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. ・スキーマ駆動開発とは ・スキーマ駆動開発を取り入れた理由
・実際にやってみる ・OpenAPIでAPI仕様書を作成 ・ツールを利用してGo言語のファイルを出力 ・プログラムの修正 ・まとめ アジェンダ
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. スキーマ駆動開発とは 2022
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. スキーマ駆動開発とは スキーマ駆動開発(Schema-Driven
Development)は、ソフトウェア開発のアプ ローチの一つです。通常、データの構造や形式が事前に定義されたスキーマ に基づいています。これにより、開発者はデータの構造や型を明示的に定義 し、それに基づいてコードを構築します。 By ChatGPT 先にAPIのパラメータやDBのテーブル構造を決めておき、その設 計に沿ってプログラムを作成する開発手法のこと
Copyright (C) 2021 Toranoana Inc. All Rights Reserved. スキーマ駆動開発を 取り入れた理由
6 2022
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. スキーマ駆動開発を取り入れた理由 ・設計と実装を一元管理したい
個人開発のため、思いついたらそのまま実装(設計書は書かない) ➡自分でどんなAPIを作ったのか思い出せない ➡APIのパラメータを忘れた ➡APIのメソッドも忘れた(POSTだっけ? PUTだっけ?) 設計書は必要だ!
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. スキーマ駆動開発を取り入れた理由 ・設計書の管理はどうするか?
スプレッドシート ➡設計と実装がずれる自信がある! GoDocに書く ➡出力されるフォーマットがAPI向きではない
Copyright (C) 2021 Toranoana Inc. All Rights Reserved. 実際にやってみる 9
2022
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. OpenAPIでAPI仕様書を作成 ・エディタを整備
VSCodeに以下2つの拡張機能を導入
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. OpenAPIでAPI仕様書を作成 ・エディタを整備
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. ツールを利用してGo言語のファイルを出力 ・作成したOpenAPI仕様書からGoのプログラムを出力
今回は「oapi-codegen」を利用します ➡変換後のファイルが1つなので、管理が楽そう ➡main関数はすでに作成済みなので、 ジェネレーターから出力されなくて良い
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. ツールを利用してGo言語のファイルを出力 ・oapi-codegenの利用方法
導入 go install github.com/deepmap/oapi-codegen/v2/cmd/oapi-codegen@latest 変換 oapi-codegen -package petstore petstore-expanded.yaml > petstore.gen.go
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. ツールを利用してGo言語のファイルを出力 ・oapi-codegenの利用方法(自分の場合)
oapi-codegen -package generated -generate types,server,spec ./openapi.yaml > ./openapi.go 以下のコードのみ出力 ・APIパラメータの構造体 ・サーバーサイドのAPI定義の利用(Echoのルーター定義など)
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. ツールを利用してGo言語のファイルを出力
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. プログラムの修正 ・生成されたコードに合わせて既存のプログラムを修正
➡独自に定義していた構造体を削除 この修正に合わせて、構造体利用箇所も修正 ➡生成されたハンドラーの実装(次で紹介) ➡Echoのルーティングを削除 生成されたコードのルーティングを利用するように修正(次で紹介)
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. プログラムの修正 ハンドラーの実装
ハンドラーの登録
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. 動作確認
Copyright (C) 2021 Toranoana Inc. All Rights Reserved. まとめ 19
2022
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. まとめ ・スキーマ駆動開発を取り入れて
➡APIの設計と実装が一元管理できるようになった! ➡APIの設計書が出来た! ・注意事項 APIを修正するときはyamlファイル修正、 その後ジェネレータでソース出力する 出力されたファイルを修正しないように注意!!!
Copyright (C) 2020 Toranoana Inc. All Rights Reserved. ご静聴ありがとうございました 2022