📄
概念 📚 fullstack-curriculum 考える

カリキュラム参照マップ（概念・領域・ステップ別）

Week 番号ではなく、概念・領域・ステップごとに「どの教材を読み、参照リポジトリのどこを見るか」を安定パスで結び直すマップ

このカリキュラムは、次の 3 つを行き来しながら進めます。

  1. 教材: このサイト上の b00〜b24 / c01〜c05
  2. 参照実装: subaru-hello/fullstack_typescript_curriculum の main
  3. 完成条件: checklist.yml

従来は週次ブランチを中心に参照していましたが、現在は 週番号よりも「今どの概念・領域・ステップを見ているか」 を軸にした方が追いやすい状態です。本ページでは、main 上の安定したファイルパスを主参照として整理し直します。

このマップで何を変えたか

観点従来このページ
参照軸旧来の週番号ベース概念・領域・ステップ
主参照先旧週次ブランチmain の安定パス（web/ api/ docs/phase*.md checklist.yml）
使い方今週どのブランチを見るか今学んでいる概念に対応する実ファイルをどこで見るか
ブランチ理解週次ブランチ前提README / docs/phase*.md / 実装ファイル前提

方針:

  • まずは main の実ファイルを読む
  • 実装の流れは docs/phase1.md〜docs/phase4.md で掴む
  • 完成条件は checklist.yml で確認する
  • 旧週次ブランチは存在する場合のみ補助的に見る

参照の優先順位

  1. 実ファイル
    web/src/* api/src/* Dockerfile.api など。最も安定していて、いま何があるかが分かる。
  2. フェーズ資料
    docs/phase1.md〜docs/phase4.md。実装順と狙いを掴む。
  3. 完成条件
    checklist.yml。何を満たせば終わりかを確認する。
  4. 旧週次ブランチ
    存在する場合のみ差分確認に使う。主参照にはしない。

ステップ別参照マップ

ステップ何を掴む段階か先に読む教材参照実装でまず見る場所補助資料対応する完成条件
1. 開発基盤リポジトリ構成、ローカル起動、作業ルールb00-env-setup b01 b02 b03 b04 b21README.md / package.json / docker-compose.yml / CLAUDE.md / AGENTS.mddocs/phase1.mdN8 N9 の土台
2. 全体像と UISPA の構造、ページ、コンポーネント、ルーティングb05 b08 b09 b10 b11 b12 b14web/src/main.tsx / web/src/App.tsx / web/src/pages/ / web/src/components/ / web/src/lib/api.tsdocs/phase2.mdM1 M2 M3 M9 N2
3. 要求から設計へ要求整理、画面、ER 図、API 契約の叩き台b05-requirements-elicitation b05b-wireframing b07-er-diagram b07b-api-spec c02 c03docs/client-app-intake.md / README.md のディレクトリ構成 / api/src/db/schema.ts / api/src/routes/docs/curriculum.mdMonth 2 の設計成果物
4. API と認証Hono の入口、ルート分割、JWT、ミドルウェアb06 b07 b13 b14-error-handlingapi/src/index.ts / api/src/routes/auth.ts / api/src/routes/posts.ts / api/src/middleware/auth.ts / api/src/lib/auth.tsdocs/phase3.mdM1〜M3 M9 M10 M11
5. DB とマイグレーションスキーマ、DB 接続、Drizzle の責務b15 b16api/src/db/schema.ts / api/src/db/index.ts / api/drizzle.config.tsdocs/phase3.md / checklist.ymlM1〜M8
6. AWS へ載せる本番構成、Docker、EC2 / RDS / CloudFrontb00-target-infrastructure b17 b17-budget-alert b18-bastion b18-env-vars b19 b19-ecr-push b20-cloudfront-s3-albDockerfile.api / docker-compose.prod.yml / docker-compose.yml / README.md の技術スタックdocs/phase4.mdM12 M13
7. 品質・運用・AI 協働テスト、レビュー、週次運用、AI 活用記録b20 b21-pr-review b22 b22-playwright b23-code-review-debug b23-trivy b23-cloudwatch-logs b24 c04 c05checklist.yml / docs/evaluation-rubric.md / docs/weekly-template.md / CLAUDE.md / AGENTS.mddocs/ddd.mdN7 N8 N9

領域別の安定参照先

1. フロントエンド

見たい概念まず見る場所対応する教材
エントリーポイントとルーティングweb/src/main.tsx / web/src/App.tsxb11 b14
画面の切り方web/src/pages/b11 b14 c02
UI 部品web/src/components/PostCard.tsx / web/src/components/PostForm.tsxb08 b11 b12 b12b
API 呼び出し口web/src/lib/api.tsb05 b06 b13

2. バックエンド

見たい概念まず見る場所対応する教材
Hono の入口api/src/index.tsb13
投稿 APIapi/src/routes/posts.tsb06 b13 b14
認証 APIapi/src/routes/auth.tsb07 b13
リアクション / フォローapi/src/routes/reactions.ts / api/src/routes/follows.tsb13 b15
認証ミドルウェアapi/src/middleware/auth.ts / api/src/lib/auth.tsb07 b14-error-handling

3. DB / モデル

見たい概念まず見る場所対応する教材
テーブル設計api/src/db/schema.tsb07-er-diagram b15 c03
DB 接続api/src/db/index.tsb15
Drizzle 設定api/drizzle.config.tsb16

4. インフラ / デプロイ

見たい概念まず見る場所対応する教材
本番 API イメージDockerfile.apib17 b19
本番 composedocker-compose.prod.ymlb17 b19
ローカル Postgresdocker-compose.ymlb16 b17
AWS 全体の組み立て順docs/phase4.mdb00-target-infrastructure b18 b19 b20-cloudfront-s3-alb

5. 運用 / 評価 / AI

見たい概念まず見る場所対応する教材
完成条件一覧checklist.ymlb05-requirements-elicitation c05 b21-pr-review
PR レビュー基準docs/evaluation-rubric.mdb21-pr-review b23-code-review-debug
週次の進め方docs/weekly-template.mdc04-issue-based-development
AI への作業ルールCLAUDE.md / AGENTS.mdb21 b22 b23

最初に読む順番

パターン A: 参照実装の全体像を 15 分で掴みたい

  1. README.md
  2. docs/phase1.md
  3. docs/phase2.md
  4. docs/phase3.md
  5. docs/phase4.md

パターン B: いまフロント実装中

  1. b11 b12 b14
  2. web/src/App.tsx
  3. web/src/pages/
  4. web/src/components/

パターン C: いま API / 認証で詰まっている

  1. b06 b07 b13
  2. api/src/index.ts
  3. api/src/routes/auth.ts
  4. api/src/middleware/auth.ts

パターン D: いま DB / スキーマで詰まっている

  1. b07-er-diagram b15 b16
  2. api/src/db/schema.ts
  3. api/drizzle.config.ts
  4. checklist.yml の M1〜M8

パターン E: いま AWS / デプロイで詰まっている

  1. b00-target-infrastructure b17 b18 b19 b20-cloudfront-s3-alb
  2. docs/phase4.md
  3. Dockerfile.api
  4. docker-compose.prod.yml

旧週次ブランチとの関係

旧週次ブランチが存在する場合は、次のように使うとよいです。

  • 主参照: このページの安定パス
  • 補助参照: 旧週次ブランチとの差分

つまり、先に「どの概念のどの実ファイルを見るか」を決め、そのあと必要なら旧週次ブランチとの差分を見る、という順番にします。

関連資料