Rails + RSpec + OpenAPI3 + Committeeでスキーマ駆動開発を運用するTips - Timee Product Team Blog

こんにちは、タイミーデリバリー開発チームの宮城です。 今回は弊社のOpenAPI3ベースのスキーマ駆動開発の運用方法を紹介します。 TL;DR 技術スタックは OpenAPI3, Swagger UI, Committee, ActiveModelSerializers Committeeを利用してOpenAPI準拠のRequest Specを行う OpenAPI3のrequiredキーワードに注意する 背景 タイミーデリバリーでは、RailsによるAPIサーバーと、Web管理画面としてVue.jsによるSPA、ユーザー向けiOSアプリとしてSwiftを採用しています。 1つのモノリスなRailsで利用者別にネームスペースを区切り、それぞれエンドポイントを提供しています。 サーバーサイドとクライアントサイドを分離し並行して開発を進めるためにスキーマ駆動開発を導入しました。スキーマ駆動開発の

[MH4GF]

書きましたー

[ota42y]

committee採用事例だ( ﾟ∀ﾟ)o彡 OpenAPIの仕様でデフォルト値がnullable:falseなのでわざわざ指定しない運用は正しいと思います。

[ohbarye]

テスト実行時のみcommitteeのrack middlewareを使うように設定すればより楽だと思いました(全てのrequestに対して自動的にvalidationが走る) “ちなみに assert_response_schema_confirm を全てのエンドポイントで記述するのは面倒”

[nmcli]

いいなあ開発ラクそうだ