転職活動のポートフォリオとして、バイブコーディングでWebアプリを完成させました。
ただ、大部分のコードの動作原理を確認せずに進めてしまい、正直なところ何が起きているのか把握できていません。本来は実装しながら理解すべきだったと反省しています。
この状況からでも、面接で設計思想や処理の仕組みを説明できるようになりたいのですが、コードが7万行ほどあり、何から手をつければよいか分からず困っています。
どのようなアプローチでコードの理解に取り組めばよいか、アドバイスをいただけると幸いです。

Question

酒井潤 · Accepted Answer

正直、その状態は今かなり増えていると思います。

AIで開発スピードが上がった結果、「完成はしたけど全体を説明できない」という状況になる人は珍しくありません。

ただ、7万行を最初から全部読もうとするのはおすすめしません。おそらく途中で心が折れます。

自分だったら、まずコードではなく「システム全体」から理解します。

そのアプリにどんな機能があるのか、ユーザーは何ができるのか、どの画面があって、どのAPIが呼ばれて、どのDBに保存されるのか。この流れを図に書いて整理します。

面接官も実は7万行のコードの詳細を聞きたいわけではなく、「このシステムを理解しているか」を見ていることが多いです。

その次に、自分が重要だと思う機能を数個選びます。

例えばログイン機能でもいいですし、検索機能でもいいですし、そのアプリの一番価値がある部分でもいいです。

そして、その機能について、ユーザーの操作から始まり、APIが呼ばれ、どのビジネスロジックが動き、最終的にDBに保存されるのかという流れを追います。

そうすると、全体を少しずつ理解できるようになります。

あと、AIに「このプロジェクトのアーキテクチャを説明して」「認証フローを説明して」「データの流れを説明して」と聞くのも全然ありです。

ただし、その説明を鵜呑みにするのではなく、実際のコードを見ながら確認することが大事です。

個人的には、面接のためなら「7万行全部理解する」は目指さなくていいと思います。

むしろ、なぜこのアプリを作ったのか、どんな技術を使ったのか、システム全体はどう動いているのか、主要な機能はどう実装されているのか、このあたりを説明できる状態の方が重要です。

あと、今回の経験は決して無駄ではないと思います。

むしろAI時代は、「まず作る→あとから理解する」という流れも増えていくと思います。

ただ、その後の理解フェーズを飛ばしてしまうと成長しないので、今まさにその理解フェーズに入ろうとしているのは良いことだと思います。

まずはコードを読むことから始めるのではなく、「このシステムはどう動いているのか」という地図を作ることから始めると、かなり理解しやすくなると思います。