GoのWebプロダクトに途中参加するときのキャッチアップ #layerxgo / How to catch up Go web product

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

© LayerX Inc. 3 GoのWebプロダクトに途中参加したときのキャッチアップ - まったくゼロからサービス開発するフェーズはなかなかない - 転職・異動などでプロダクトコードがすでにあるチームにアサインされること大半 - GoはデファクトなWebフレームワーク、技術スタックがない - 既存プロダクトコードがどのように構成されているかをキャッチアップする必要がある今日のトピック今日のトピック

Slide 4

Slide 4 text

© LayerX Inc. 4 コードを見る前にやったほうがよいキャッチアップ - コードを触る前に行ったほうがよいキャッチアップは省略します - ドメイン知識（業務知識、業界標準、関連法制度 etc）のキャッチアップ - 開発環境でプロダクトを動かしてみる - プロダクトのサポートページを読む - システムアーキテクチャを把握する（RDBMS, 本番実行環境 etc） - DBスキーマやER図を確認する前提（今日話さないこと）今日のトピック

Slide 5

Slide 5 text

サービスを動かす前に

Slide 6

Slide 6 text

© LayerX Inc. 6 初期設定をする README, Makefile, .env サービスを動かす前に - READMEに環境変数の情報などがないか確認 - .env.localなどを用意する必要があるならば準備 - make initのようなコマンドがあるならばそれを実行 - バクラクの場合 - Rancher Desktopなどをインストール、認証を設定する - lx.sh bootstrap コマンドを実行すると全プロダクトの初期構築が完了する - https://tech.layerx.co.jp/entry/2022/12/12/131507

Slide 7

Slide 7 text

Slide 8

Slide 8 text

Slide 9

Slide 9 text

© LayerX Inc. 9 依存ライブラリからプロダクトが取り扱う要素技術を確認する依存関係の確認サービスを動かす前に - プロトコル - GraphQL, gRPC, OpenAPI, REST API - 自動生成 - gqlgen, protoc, buf, go-swagger, xo, gomock… - ORM - GORM, sqlx, bun, ent - バクラクの場合 - GraphQL, gRPC, OpenAPI, - xo + GORM

Slide 10

Slide 10 text

ローカルで動かしてみる

Slide 11

Slide 11 text

Slide 12

Slide 12 text

Slide 13

Slide 13 text

Slide 14

Slide 14 text

コードを読んでみる

Slide 15

Slide 15 text

© LayerX Inc. 15 リポジトリの歩き方を覚えるディレクトリ構成を理解するコードを読んでみる - GoはデファクトのWebフレームワークがないので各社それぞれのディレクトリ構成となる - エンドポイントを探すならば、認証ロジックを探すならば、どのディレクトリからたどるとよいか - よくみかけるディレクトリ名 - handler, api - middleware, interceptor - usecase, service - domain - repository, gateway - infrastructure

Slide 16

Slide 16 text

Slide 17

Slide 17 text

© LayerX Inc. 17 GitHub Copilot Chatに聞いてみるソースコードを読むコードを読んでみる - VSCodeやJetbrains IDEなどから利用可能 - ファイルを開いて「100行目は何をしているの」とか聞いてみる - （ご利用は所属元の許可状況を確認の上！） - バクラクの場合 - LayerXではGitHub Copilot, ChatGPT Teamが使えます