スキーマ駆動開発

はじめに こんにちは！ 技術本部 Bill One Engineering Unit の市川です。 私の所属するチームでは Bill One の新規マイクロサービス開発に Go 言語と Connect を採用してスキーマ駆動開発を実践しています。 今回は Connect を導入して実感した良いところを、バックエンドの話を中心に実例を交えながらご紹介していきます。 なお、本記事は【Bill One 開発 Unit ブログリレー】という連載記事のひとつです。

この記事は techtekt アドベントカレンダー2022 の15日目の記事です🔥 その他にも記事が掲載されていますので、興味がある方は#techtekt Advent Calendar 2022で検索してみてください！ はじめに はじめまして。パーソルキャリア株式会社のサービス開発部でエンジニアをしている西澤と申します。 HR forecasterという採用支援サービスのフロントエンドエンジニアを担当しています。今回はそのプロジェクト内で新たに組み上げた開発体制で導入したスキーマ駆動開発の流れについて紹介したいと思います🙋‍♂️ 目次 開発環境 導入背景 スキーマ駆動開発って何？ OASのデ…

初めに 本記事では 『最近の学びを簡単にご紹介』 ということで2年目なりたて Java エンジニアの自分がここ2ヶ月で学んだことを簡単に紹介したいなと思います。 お願い 2年目成り立てエンジニアが思う事です！ 優しい目で見てね！ あくまで、 個人の意見です！ あえて断定的な物言いにしてるとこもあります！ 議論のネタにでもなったら嬉しいです！ 初めに お願い 1. SOLID 1-1. 単一責任原則：単位あたりにもたす目的は「一個のみ」 1-2. 開放閉鎖原則：仕様変更時に既存のコードを変えるな 1-3. リスコフの置換原則：親で出来ることは子でも出来なかん 1-4. インターフェイス分離原…

初めに 前編ではスキーマ駆動開発において必要な前提知識や周辺ツールの記述を行いました。 以下の様なものたちです（抜粋）。 ❐ スキーマとは ❐ OpenAPI Specification ❐ OAI：OpenAPI Initiative ❐ OpenAPI (Swagger) Editor ❐ OpenAPI Generator (Gradle Plugin) ❐ ドキュメントの自動生成 ❐ スキーマから Spring コードの自動生成を行う ❐ Gradle タスクの依存関係設定 ❐ API記述言語 ❐ スキーマ駆動開発とは（詳細） ❐ スキーマ活用シーン ❐ API 設計 『設計はなぜ重要…

こんにちは、Progate の平川です。本記事は Progate Advent Calendar ４日目の記事になります。日頃業務ではフロントエンドの実装を担当させて頂いています。前回書かせて頂いた記事は少々辛い話だったので、今回はちょっとした DX 改善で幸せになった話について書きたいと思います。 tech.prog-8.com はじめに 弊社ではここ１年くらいで新しく作られた API の仕様を OpenAPI で管理するようになりました。これまでは API の仕様についてまとめられたものはなく、レスポンスの型などはすべて API のソースコードを読みに行く必要がありましたが、OpenAPI…

こんにちは！Gaudiyのエンジニアの永井（@sho0910K）です。 Gaudiyでは昨年からGraphQLを導入し、スキーマ駆動開発に取り組んできました。導入からまもなく1年を迎えようとしていますが、良かったところや、改めて浮き彫りになった課題や気づきがあったので、今回はGraphQLの取り組みについてまとめてみたいと思います。 GraphQLの導入を検討しているチームや、実際に活用しているチームのご参考になれば嬉しいです。 1. GraphQL導入の背景 2. GraphQLをプロダクトでどのように活用しているのか 3. GraphQLを実践する上での工夫 3-1. クライアントもサーバ…

目次 はじめに スキーマ駆動開発とは 導入背景 課題 実現したい状態 スキーマ定義 ドキュメントの閲覧 バックエンド APIのテストに利用 フロントエンド モックサーバとしての利用 導入してどのように変わったか？ おわりに はじめに スタメンでエンジニアをしている田中です。今回は新規プロジェクトにて導入したスキーマ駆動開発について、その背景や実際にどのように開発に組み込んでいるかをご紹介いたします。 ※ 前提: スタメンではバックエンドにRuby on Rails, フロントエンドにTypeScript, Reactを利用しています。 スキーマ駆動開発とは スキーマ駆動開発とは、「APIのスキ…

* 本記事は STORES Advent Calendar 2023 15日目の記事です こんにちは。STORES ネットショップ のエンジニアをしております、takeuchiです。 STORES ネットショップ では2021年10月から開発者向けAPIを提供開始しました。 officialmag.stores.jp この記事では、APIリリースに至るまでに行われた検討事項について紹介します。 背景 APIで提供する項目 バージョンの管理方法 バージョンの指定方法 バージョンアップのポリシー バージョンアップの対象 APIドキュメントの公開 最後に 背景 2021年頃、以下の理由から開発者向け…

こんにちは、GMOあおぞらネット銀行 CTOオフィスグループのmonty（モンティ）です。そろそろ福袋の季節ですね。毎年いくつか手にしていますが、事前エントリーや先着順など様々で、うかうかしていると福も袋も届きません。 12月5日〜6日に『GMO Developers Day 2023』開催！ 『GMO Developers Day 2023』開催概要 APIや金融に関するセッションに当社パートナーが登壇！ テクノロジーバンクが取り組む、クラウドネイティブなAPI基盤設計 UX・クリエイティブで切り開く、金融業界の未来 セッションの一部をご紹介！ ホワイトハッカーが集まる「エンジニアの楽園」 …

最近はマイクロサービスを検討することが多いです。 マイクロサービスにおいて、よく問題となるのはサービス同士のやりとりをどのように行うかです。オーソドックスな選択肢としてはAPIを作成してHTTP通信で呼び出すという方法が候補に上がりますが、リクエスト数・量が増えてくれば、通信のオーバーヘッド、データ効率といった点で苦しくなってきます。 次に選択肢に上がるのはRPC、近年だとHTTP2を使用するgRPCでしょうか。 HTTP通信と比べると通信のオーバーヘッドも少なく、データ効率が良いため頻繁にやりとりが必要となるマイクロサービスとの相性が良いとされています。ただ、RubyでgRPCを使う...と…

iOSDC Japan 2023 参加レポート はじめに こんにちは、ヤプリでiOSエンジニアをしている菅（@Nao_RandD）です この度は、iOSDC Japan 2023に初めてオフラインで参加しました。今回はその経験と学びをシェアしたいと思います。 iOSDC Japanは日本最大級のiOS開発者向けのカンファレンスで、多くのセッションやスポンサーブースが出されます 当日の名札・ネームプレート。来年はスピーカーにしたい🔈 概要 開催場所: 早稲田大学 理工学部 開催期間: 9/1（金）〜9/3（日） 設備・運営に関するメモ ドリンクは飲み放題 水はボトルで好きなだけ（節度をもって）も…

みなさん、こんにちは。 ニカチョーのバックエンドエンジニア武じい(@pouhiroshi) です。 ニカチョーというのは、開発部二課の課長のことです。弊社の開発部（プロダクトチーム）はマルチプロダクトを推進すべく、最近３チームに分かれるという変化がありました。 そのうちのDev2チームのリーダーをやることになりました。部は課からできてますよね。だからDev2は二課かな。そのリーダーなので課長かな？つまりニカチョー？ これまで役職がついたことがないので、ニカチョー頑張っていきたい所存です。（特に何か変わるわけではないのですが、気分的なアレです）さて、今回はPythonのライブラリPydantic…

nota.connpass.com こちらのイベントに参加してきたので、会の様子と感想を書いていこうと思います。 会の概要 会の様子 スクラム導入と透明性のための実践プラクティス〜CTOとして1年間スクラムと向き合った結果〜 by suzukiさん スクラムしない組織のアジャイル論 パネルディスカッション 会全体を通した感想 会の概要 以下、イベントページから引用です。 プロダクトの革新を支えたの開発組織づくりについて、現クリエイティブサーベイCTO鈴木康寛とHelpfeelCTO秋山博紀がLT, パネルディスカッションの形でぶっちゃけトーク！ マネジメントを行う上での苦労や取り組みについてお…

こんにちは、バクラク事業部 バクラクビジネスカード開発チームでEMとTechLeadを担当している高江 @shnjtk です。 今回は、openapi-generator を使ってOpenAPI定義ファイル(OpenAPI Specification)からGoのコードを生成する方法と、運用時のTipsについてご紹介します。 背景 バクラク事業部では、スキーマ駆動開発によりDBやGraphQLのスキーマ定義、OpenAPI定義ファイルなどから自動生成されたコードを積極的に利用する開発スタイルが採用されています。 OpenAPIについては、これまでは go-swagger を利用していましたが、対…

Software Design (ソフトウェアデザイン) 2023年7月号 [雑誌]技術評論社Amazon 第1特集 gRPCで始めるWebAPI開発 RPCとは Remote Procedure Call（遠隔手続呼び出し） クライアントがサーバ側の処理の呼び出し方だけを知っていて、実装の詳細は知らなくても使うことができる マイクロサービス間・バックエンドとモバイルアプリの通信 gRPC → Google が開発した、RPC サービス RPC メソッドの集合 リクエスト、レスポンスの形式を指定する gRPC は HTTP/2 プロトコルで通信を行う HTTP/2 通信だと何が嬉しいのか 従来…

Software Design 2023年7月号を読んで、ちょこっとずつ感想を書いてます。 gihyo.jp いつも参加しているSoftware Design輪読会に向けての予習でもあります。 softwaredesign.connpass.com 特に気になったこと ハピネスチームビルディング モブプロされてる方います？ うちは人数が少なすぎて>< Miro チームビルディング、どうされてますか？ ドラッカー風エクササイズ、使ったことがある方がいたら、感想とか聞きたいです。 やる気UPエクササイズ 瞑想、やったことあります？ （輪読会で自分の体験を話したいが…続くかどうか…） 社会に役立つ …

Bill Oneエンジニアの上司陽平です。当記事では4~5月に実施していたBill One開発Unitブログリレーで立てた目標に対する結果や良かったことを記載します。またブログ圧Bot🤖による執筆者の募集活動など連載の企画者としてやったことについても紹介します！！

こんにちは、2023年4月にYOUTRUSTにジョインした寺井(YOUTRUST / Twitter)です。 今日から6/2(金)までの5日間、YOUTRUSTのエンジニアチーム全員で毎日ブログ記事を投稿していく予定です！ YOUTRUSTは2023年5月29日現在、正社員エンジニア6人 + 業務委託の方数名で開発を進めています。 今日は私がYOUTRUSTに入社して2ヶ月間一緒に働いて感じた、YOUTRUSTの正社員エンジニアのみなさんの紹介記事を書きたいと思います。 1人目 アプリエンジニア 朝日さん 1人目は、アプリエンジニアの朝日さん(YOUTRUST / Twitter)です！ 朝日…