エンジニアのポートフォリオは何を作る?題材選びと自分の工夫の加え方

ITエンジニアの選考・ポートフォリオ

エンジニアへの転職を目指して勉強しているものの「ポートフォリオに何を作ればいいか分からない」と迷っていませんか。教材どおりにToDoアプリを作ってみたけれど、それだけでは弱いのではと不安になる人もいるでしょう。

ポートフォリオで大切なのは、機能をたくさん追加することよりも「誰のどんな困りごとを解決する作品か」「なぜその設計にしたか」「自分で何を確認したか」を説明できることです。 志望職種に関係する機能を小さく完成させ、動作と制作過程を第三者が確かめられるようにしましょう。

この記事では未経験〜初級のITエンジニアを想定し、題材選びから実装範囲の絞り方、GitHubでの見せ方までを順に解説します。作品を1件完成させるための具体例も紹介します。

ポートフォリオは「誰の何を解決するか」から決める

最初に技術やアプリ名を決めるのではなく、使う人が困っている場面を一文にしてみましょう。

考える順番は「誰が」「どんな場面で」「何に困っているか」の3つです。

  • 誰が:小さな店舗のスタッフ、アルバイトのシフト管理者、勉強時間を記録したい学習者など
  • どんな場面で:在庫を確認するとき、希望シフトを集めるとき、毎日の学習結果を振り返るときなど
  • 何に困っているか:確認漏れがある、同じ内容を何度も入力する、情報が散らばっているなど

たとえば「小規模店舗の担当者が、商品ごとの在庫数を見ながら補充が必要なものをすぐ確認したい」という課題なら、在庫確認ツールを考えられます。これは題材を決めるための架空の例です。実際の店舗で取材や検証をしたという意味ではありません。

この例では、商品名と在庫数を登録し、在庫が設定した基準以下になった商品を一覧で表示できれば目的に近づきます。最初から売上分析や発注メール送信まで作る必要はありません。

ToDoアプリも同じです。「タスクを追加・削除できる」だけで終えず、使う人の状況に合わせて必要な機能を考えれば題材になり得ます。たとえば複数の締切がある学習者向けに、期限切れのタスクを見つけやすくする工夫が考えられるでしょう。

ただし「ToDoアプリだから評価されない」「独創的な題材なら採用される」と一律に判断することはできません。企業が何を確認したいかは求人や選考方法によって変わります。

志望職種に合わせて見せる技術と題材を選ぶ

同じ在庫確認ツールでも、どこに力を入れるかは志望職種によって違います。求人票に書かれた仕事内容や使用技術を読み、作品で示すポイントを絞りましょう。

志望職種 作品の方向性 見せたい工夫と確認内容
フロントエンド 入力・一覧・検索などの画面があるWebアプリ 迷わず操作できる画面設計、入力エラーの案内、スマホやキーボードでの操作
バックエンド 在庫の登録・更新APIや予約管理API データ設計、入力値の検証、権限の扱い、異常時の応答、APIテスト
インフラ・クラウド 小さなアプリの実行環境と運用手順 環境構築の再現性、デプロイ、ログ、監視、障害時の対応手順
データ分析・データエンジニア 公開データを加工して傾向を確認するツール 前処理、欠損値の扱い、集計手順の再現性、分析結果の限界

これは題材の一例であり、職種ごとの必須課題ではありません。バックエンドを志望していても画面が全く不要とは限らず、フロントエンド志望でもAPIの理解が役立つ場面があります。

求人票にJavaScriptやPython、SQLなどが書かれている場合は、その技術で何を実現する仕事なのかも確認します。単に流行しているフレームワークを増やすより、応募先の業務と自分が説明できる実装がつながっていることを優先しましょう。

応募先から課題の仕様や提出方法が指定されているなら、その要項が最優先です。自主制作の作品とは分けて考えてください。

最初の1作品は必要最小限の機能で完成させる

題材が決まったらMVP(Minimum Viable Product)を考えます。ここでは、使う人が主な目的を達成できる最小限の作品という意味で使います。

先ほどの在庫確認ツールなら、最初に作る機能は次の3つで十分かもしれません。

  1. 商品名・在庫数・補充の目安となる数を登録できる
  2. 在庫数を更新できる
  3. 補充の目安以下になった商品を一覧で確認できる

担当者が「在庫を確認する→数量を更新する→補充対象を見る」という一連の操作を完了できれば、作品の中心部分を説明できます。

一方、会員登録、外部サービスとの連携、自動通知、詳細な分析画面は後回しにできます。追加するなら「この機能がないと誰が何に困るのか」を説明できるものに絞りましょう。

作る前に決めておきたいこと

要件を数行で書くだけでも、制作途中で目的がぶれるのを防げます。

決める項目 在庫確認ツールの例
利用者 小規模店舗の在庫担当者
達成したいこと 補充が必要な商品をすぐ見つける
入力 商品名・在庫数・補充基準
出力 在庫一覧と補充対象の表示
考えるべき例外 空欄、負の在庫数、同じ商品の重複登録
今回は作らない機能 発注メール、決済、複数店舗の管理

使う技術も、主要機能を実装・修正できる範囲で選びます。初めて使う技術を採用すること自体が悪いわけではありません。ただし環境構築に時間を使いすぎて作品が完成しなければ、動作確認や説明資料まで手が回りません。

まず一通り動く状態を作り、その後で必要な改善を加える順番がおすすめです。

教材どおりの作品から「自分の工夫」をどう加える?

チュートリアルを参考に作った作品でも、学んだ内容を使って新しい要件に対応すれば制作過程を説明できます。

ただし色やタイトルを変えただけで、すべて自分で設計したと説明するのは避けましょう。教材のどこを参考にし、何を変更したかを分けて記録します。

在庫確認ツールを例にすると、次のような変更が考えられます。

元の実装 自分で考えた変更例 示せる判断
商品を一覧表示するだけ 補充基準以下の商品を絞り込む 利用者が必要な情報を探しやすくした理由
どんな数字でも保存できる 負の数や空欄を受け付けない データの整合性を守るための入力ルール
保存に失敗しても案内がない 失敗時に理由と再操作の方法を表示する 例外処理と使いやすさへの配慮
画面だけで動作を確かめる 境界値や不正入力のテストを追加する 正しく動くことを確認した方法

大きな新機能を付けなくても、入力ミスが起きたときの振る舞いを考えることは設計上の判断です。

その判断を説明するには「変更前の問題→選んだ対応→変更後の確認結果」を一組で残します。GitHubのIssueやコミット履歴、設計メモ、画面の画像があれば、後から説明しやすくなります。

教材や他の人のコードを参考にした場合は、元の資料やライセンスの条件も確認してください。参考にした部分を隠して全部自作だと説明する必要はありません。

README・GitHub・デモで作品を見てもらえる状態にする

作品が完成しても、採用担当者が何をするアプリなのか分からなければ中身を確認しにくくなります。コードの公開だけで終わらず、最初に読むREADMEと動作の確認方法を用意しましょう。

GitHub公式ドキュメントでもREADMEは、プロジェクトの役割や使い方を利用者に伝えるための資料と説明されています。

出典:GitHub Docs「リポジトリのREADMEファイルについて」

READMEには「何を作ったか」と「どう試すか」を書く

最低限、次の項目があると作品の目的と実装内容をたどりやすくなります。

  • 作品の概要:誰のどんな困りごとに向けたものか
  • 主要な機能:何を登録・更新・確認できるか
  • 画面とデモ:スクリーンショット、公開URL、試せる操作
  • 使用技術:言語、フレームワーク、データベース、主なライブラリ
  • 起動方法:必要なバージョン、インストール、環境変数、起動手順
  • 確認方法:テストの実行手順と、確認した結果
  • 設計上の判断:採用した方法と、採用しなかった方法の理由
  • 残る課題:既知の不具合、未実装機能、今後の改善案

起動手順には、自分の環境で実際に動作確認したコマンドを記載します。架空のコマンドや現在使えないデモURLを載せないようにしましょう。

環境変数が必要なら値を空欄にした設定例を用意し、本物のAPIキーやパスワードは含めません。新しいフォルダーに取得したコードを置き、READMEだけを見て起動できるか確認すると手順の抜けに気づけます。

GitHubの公開範囲は応募先の指定に合わせる

GitHubのリポジトリは公開(Public)か非公開(Private)かによって閲覧できる人が変わります。公開リポジトリはインターネット上の誰でも見られます。非公開にする場合は、確認する担当者に必要なアクセス権があるか確かめましょう。

公開範囲を変更する際は、コードだけでなくコミット履歴や関連する情報の公開範囲にも注意が必要です。GitHub Docs「リポジトリの公開範囲の設定」でも公開・非公開変更の影響を説明しています。

企業のコーディング課題を提出する場合は、応募先が指定したリポジトリや提出方法を優先してください。提出直前の確認事項はこちらの記事で整理しています。

コーディング課題をGitHubで提出するときの確認事項|公開範囲・README・動作確認
コーディング課題をGitHubで提出する前に、公開範囲・README・動作確認・秘密情報・未実装部分を点検。応募先の指定を優先する確認表とREADME構成例、提出メッセージ例を紹介します。

デモは採用担当者が主要機能を試せる形にする

Webアプリなら公開デモがあると動作を伝えやすくなります。ただし全作品でデモ公開が必須というわけではありません。デプロイが難しいツールやインフラ構成なら、操作動画や実行結果、再現手順が適している場合もあります。

デモを用意するなら「画面を開く→サンプル商品を選ぶ→在庫数を変える→補充一覧が更新される」のように、確認してほしい操作を短く案内します。デモ用データは架空のものにしましょう。

認証が主要機能と関係しないなら、ログインなしで試せる画面も選択肢です。ログインが必要な場合は専用のテストアカウントやゲスト用の操作方法を検討します。削除・外部メール送信などは不用意に実行できないよう、サーバー側を含めた権限制御を確認してください。

ゲストログインの要否や安全なデモの作り方は、次の記事で詳しく解説しています。

ポートフォリオにゲストログインは必要?採用担当が試せるデモの作り方
ポートフォリオにゲストログインは必要?ログイン不要の公開画面・テストアカウント・ゲストログインを比較。デモ用データ、操作範囲、削除やメール送信、初期化の方法と、採用担当が試せる公開前確認を整理します。

テストと改善記録で「動く」だけではない部分を見せる

正常な操作で動くことは出発点です。想定外の入力や操作でも説明できる状態にしておくと、設計の意図を伝えやすくなります。

在庫数の入力を例にすると、次の確認が考えられます。

確認するケース 期待する動作の例
在庫数が10、補充基準が5 補充対象に表示されない
在庫数が5、補充基準が5 境界値として補充対象に表示される
在庫数が空欄またはマイナス 保存せず理由を表示する
同じ商品を二度登録 設計した重複時の扱いに沿って動く
保存処理が失敗 失敗を知らせ、誤って成功と表示しない

これらはテスト設計の例であり、実際にテストを実施した結果ではありません。READMEには自分が実行したテストと結果を区別して記録します。

Webアプリの場合は画面の入力制限だけでなく、サーバー側でも受け付ける値を検証します。OWASPは入力データの形式・範囲・意味を確認すること、画面上のチェックだけに頼らないことを推奨しています。

出典:OWASP「Input Validation Cheat Sheet」

見た目だけでなく操作のしやすさも確認する

入力欄に分かりやすいラベルがあるか、エラーが文字で伝わるか、キーボードだけで操作できるかを確認しましょう。スマートフォンで表示が崩れないかも重要です。

W3CのWeb Accessibility Initiativeは、入力欄などのフォーム部品には役割の分かるラベルを付けるよう案内しています。W3C WAI「Labeling Controls」を参考にできます。

実際に試してもらえたら、改善の前後を残す

自分以外の人に試してもらえるなら、最初の説明をせず操作してもらい、どこで迷ったか記録します。その際も本物の個人情報は入力してもらわず、架空のテストデータを使います。

たとえば次のような改善の記録が考えられます。

段階 記録例
気づいた問題 「在庫を更新する場所が分かりにくい」という指摘を受けた
行った変更 更新ボタンの表記と位置を変更した
確認方法 変更後に同じ操作をもう一度試してもらった
残る課題 スマートフォンでの表示は追加確認が必要

これは改善記録の書き方を示す架空の例です。実際に利用者2人へ確認したなどと事実でない実績を作る必要はありません。試用を依頼できない場合は「自分で行った操作確認」として記録を残しましょう。

秘密情報と実在のデータは公開しない

GitHubへ公開する前に、APIキー、パスワード、秘密鍵、実際の顧客情報が入っていないか確認します。スクリーンショットやテストデータも対象です。

注意したいのは、最新のコードから秘密情報を消しても過去のコミット履歴に残ることがある点です。万一公開した場合は、ファイルを消すだけでなく該当する認証情報の無効化・再発行などを優先します。GitHub公式ドキュメントは履歴からの削除には追加対応が必要なことも説明しています。

出典:GitHub Docs「Removing sensitive data from a repository」

面接では「何を自分で判断したか」を説明する

作品を説明するときは使用技術の一覧から始めるより、課題と実装した理由をつなげると伝わりやすくなります。

例えば在庫確認ツールなら、次の順番で説明を組み立てられます。

  1. 目的:補充が必要な商品を一覧で確認するために作った
  2. 実装:商品・在庫数・補充基準を保存し、条件に一致するものを表示した
  3. 判断:発注機能は後回しにし、まず在庫確認の操作を完成させた
  4. 検証:境界値や不正入力を想定したテストを実施した
  5. 今後:利用者の操作確認など、次に確かめたい内容を挙げる

この説明は構成例です。自分が実際に作成・検証した内容に置き換えましょう。実装していない機能や未実施のテストを説明に含めないことが大切です。

AIを利用した部分と自分の作業は分けて話す

AIにコードの提案やエラーの解説を頼んだ場合も、利用した事実だけで作品の価値が決まるわけではありません。ただし、企業の選考課題にはAI利用を制限・申告するルールが設けられていることがあります。指定がある場合は必ず従ってください。

面接で説明するために、次の内容を整理しておきましょう。

  • AIに依頼した内容と、出力された部分
  • 自分が決めた要件・設計・採用理由
  • 生成されたコードを修正した箇所と理由
  • 自分で実行したテストと確認結果
  • まだ理解が不十分な部分や未確認事項

「AIがこの方法を勧めたから」だけで終わらず、別の方法と比べて何を重視したのか説明できるようにします。コードを読み返し、主要な処理の入力・出力・エラー時の動きを自分の言葉で話せる状態にしておきましょう。

AI利用を含む制作過程の整理方法は、こちらの記事を参考にしてください。

AIで作ったポートフォリオは面接でどう説明する?自分の判断・修正・検証の整理方法
AIで作ったポートフォリオを面接で説明する準備を紹介。AIに任せた作業、自分が決めた仕様、修正、検証、未理解の部分をワークシートで整理し、制作記録から説明を組み立てます。質問別に見直す記録と説明の型も掲載。

まとめ|完成・再現・説明ができる1作品を作ろう

エンジニアのポートフォリオは、珍しい題材や大量の機能だけで評価が決まるものではありません。応募する仕事に関係する課題を選び、主要な機能を完成させて、自分が考えたことと確認したことを示しましょう。

完成前に確認したいのは次の5点です。

  1. 誰のどんな不便を解決する作品か、一文で説明できる
  2. 中心となる操作を最初から最後まで実行できる
  3. 設計・変更・テストのうち自分が行った作業を示せる
  4. READMEとデモから第三者が安全に内容を確認できる
  5. 参考教材やAIの利用範囲、残る課題を正しく説明できる

まずは小さくても完成した作品を1つ作ることから始めてください。 その作品に必要な改善を積み重ねれば、なぜその機能を付けたのか、どのように問題を解決したのかを具体的に話せるようになります。

採用時の評価基準は企業や職種によって異なります。機能数や使用技術だけで合格を保証することはできませんが、完成した成果物と再現できる制作記録は自分の取り組みを伝える材料になります。

参考にした公式情報

※2026年11月5日時点の公開資料をもとに作成しています。GitHubの設定・機能や応募先の提出条件は変更されることがあるため、公開・提出時の案内を確認してください。