この記事について

SES案件に新しく参画する際、この記事は初日にスマホやPCで開いてカンペとして使うことを想定してまとめたもの。

想定読者は、Next.js + React / Node.js / AWS あたりの構成でWeb開発案件に参画するエンジニア。
ただし他の技術スタックでもほとんどの項目はそのまま使える。

あいさつテンプレ

初日の自己紹介はシンプルでいい。長々と話す必要はない。

本日からお世話になります、〇〇と申します。
前職（前案件）では△△のプロジェクトでReact / Node.js を使ったWeb開発を担当しておりました。
早くキャッチアップできるよう努めますので、よろしくお願いいたします。

ポイントは自分の得意領域をさらっと伝えること。相手がタスクを振りやすくなる。

リモート参画で初日からオンラインの場合も、Slackやチャットツールでの自己紹介文は同じ構成でよい。

→ アカウント発行は申請から時間がかかることが多い。午前中のうちにまとめて依頼して、待ち時間にドキュメントを読むのが効率的。

典型的なNext.js + Node.js + AWS構成の案件を例にすると、以下を確認・セットアップすることになる。

PC（支給 or BYOD）のスペックとOS。macOSかWindowsか、Windowsの場合はWSL2を使うかどうか
WSL2を使う場合、ディストリビューション（Ubuntu等）のバージョン指定があるか
Node.js のバージョン（.node-version や .nvmrc がリポジトリにあるか。nvm / volta / asdf のどれを使っているか）
パッケージマネージャの指定（npm / yarn / pnpm）。lockfileの種類を見ればわかる
Docker / docker-compose の利用有無とバージョン
DBのローカル環境（MySQL / PostgreSQL をDockerで立てるのか、ローカルインストールか）
環境変数の管理方法（.env.local のテンプレートはあるか。APIキーなど秘匿情報の受け渡し方法）
エディタ／IDEの指定やチーム推奨の拡張機能（VSCode + ESLint + Prettier が多い）

→ README.md にセットアップ手順が書いてある場合と、Confluenceや Notion など別の場所にある場合がある。
「ローカル環境の構築手順について、何か参考になるものはありますでしょうか？orどこにありますか？」と最初に聞くのが一番早い。

Microsoft Graph API や Google API など外部サービスと連携している案件では、以下も確認が必要。

→ これらは自分で勝手に発行できないことが多い。誰に依頼すればいいかを初日に確認しておく。

初日に環境構築が完了しないのはよくあることで、焦る必要はない。ただし以下は意識する。

初日にすべてを読み込む必要はないが、存在と場所を把握しておくことが重要。

システム構成図 — フロントエンド・バックエンド・DB・AWS各サービス・外部APIの全体像
API仕様書 — Swagger / OpenAPI / Postmanコレクションなどの場所。バックエンドのエンドポイント一覧
DB定義書（ER図） — テーブル構造とリレーションの把握。マイグレーションツール（Prisma / TypeORM / Knex など）を使っているかどうか
ブランチ戦略 — Git Flow / GitHub Flow / trunk-based のどれか
デプロイフロー — CI/CDの仕組み（GitHub Actions等）、ステージング環境と本番環境の関係。AWSのどのサービスにデプロイされるか
コーディング規約 — ESLint / Prettier の設定、命名規則、コンポーネントのディレクトリ構造ルール
デザインカンプ — Figma の共有URL。MUIのテーマカスタマイズの方針

→ これらの場所を一覧でメモしておくと、翌日以降の立ち上がりが格段に速くなる。

口頭で聞かないとドキュメント化されていないことが多い領域。初日〜数日以内に把握する。

在宅中心の案件では、以下も初日に把握しておく。