# FDEポートフォリオ READMEテンプレート

- **用途:** FDEを目指す人が、制作物を「顧客課題から設計・実装・運用・評価・再利用まで」のケーススタディとして整理するためのテンプレートです。
- **使い方:** 下のテンプレートをコピーし、角括弧の中を自分が確認できる事実へ置き換えてください。実在利用者へ確認していない内容は「想定」「仮説」「未検証」、測っていない結果は「未計測」と明記します。
- **非保証:** 本テンプレートは、書類通過、面接通過、内定、転職、年収上昇を保証するものではありません。応募先の最新求人と提出条件、勤務先・顧客との契約、秘密保持義務を必ず確認してください。
- **更新日:** 2026-07-26
- **提供:** あなたのFDEキャリア（運営：NEXT INNOVAITION株式会社）

---

# [プロジェクト名]

## 1. 30秒で分かる概要

- 利用者: [誰が、どの場面で使うか]
- 課題: [導入前に起きていた具体的な問題]
- 解決策: [作った仕組みを1〜2文で]
- 私の担当: [調査／設計／実装／評価／運用のうち本人が担当した範囲]
- 確認できた結果: [事実のみ。未計測なら「未計測」と記載]

## 2. 現状業務と課題

- 導入前フロー: [入力→判断→処理→出力]
- 利用者への確認方法: [ヒアリング／観察／公開資料／想定]
- 基準値: [時間、件数、品質、手戻り等。分からなければ不明]
- 放置した場合の影響: [確認できた範囲]

## 3. 対象範囲と成功指標

- 今回解くこと: [対象]
- 今回解かないこと: [対象外]
- 制約: [期間、データ、権限、予算、環境、法務]
- 成功指標: [指標／測り方／目標または比較対象]
- 主要な仮説: [未検証であることを明記]

## 4. 設計と実装

- システム構成図: [画像またはMermaid等へのリンク]
- データフロー: [取得元→処理→保存→出力]
- 技術選定: [選択肢／採用理由／採用しなかった理由]
- 自分が書いた部分: [repositoryのpathやPR]
- 第三者・AIが担った部分: [library、API、生成codeとreview方法]

## 5. 本番品質と運用

- 認証・権限: [誰が何へアクセスできるか]
- テスト: [unit／integration／end-to-end]
- ログ・監視: [何を記録し、どの状態で通知するか]
- 障害時: [timeout、retry、manual fallback、rollback]
- セキュリティ: [個人情報、secret、入力攻撃、監査]
- コスト・性能: [1件あたり費用、応答時間、上限]

## 6. 評価と結果

- 評価データ: [件数、作り方、実利用との差]
- 指標: [task success、正確性、安全性、latency等]
- 結果: [数値と測定日]
- 失敗例: [代表例と原因]
- 人による確認: [誰が、何を、どの基準で確認したか]
- 利用者から変えた点: [変更前→変更後]

## 7. 学び・残課題・再利用

- 判断を変えた点: [根拠]
- 残るリスク: [未解決事項]
- 再利用できるもの: [component、test、playbook]
- 次に試すこと: [優先順位付き]
- 長期保守者: [個人開発なら自分／終了予定も明記]

## 実行方法

[必要環境、setup、test、demo data、停止方法]

## 公開範囲

[匿名化、dummy data、license、秘密情報を含まない旨]

---

READMEから詳しい資料へ移動できるように、必要に応じて設計判断を `docs/decisions/`、評価データの作り方を `docs/evaluation/`、運用手順を `docs/runbook/` へ分けてください。