# オブジェクトモデルを実際に確認するコマンド
git cat-file -t HEAD        # オブジェクトの型を表示
# commit
 
git cat-file -p HEAD        # オブジェクトの中身を表示
# tree d8329fc...
# parent a0b1c2d...
# author Alice <alice@example.com> 1704067200 +0900
# committer Alice <alice@example.com> 1704067200 +0900
#
# Add user authentication feature
 
git cat-file -p HEAD^{tree}  # ルートtreeの中身
# 100644 blob af5626b... README.md
# 040000 tree 7a8b9c0... src
 
git cat-file -p af5626b      # blobの中身
# （ファイルの内容が表示される）
 
# オブジェクトの格納場所
ls .git/objects/
# af/  7a/  d8/  ...
# 最初の2文字がディレクトリ名、残りがファイル名

# ステージングの実践的な使い方
 
# ファイル全体をステージング
git add file.py
 
# ハンク（変更の塊）単位で対話的にステージング
git add -p file.py
# y: このハンクをステージング
# n: このハンクをスキップ
# s: ハンクをさらに分割
# e: ハンクを手動編集
 
# ステージング内容の確認
git diff --staged     # ステージングされた変更
git diff              # ステージングされていない変更
git diff HEAD         # 全ての変更（ステージング + 未ステージング）
 
# ステージングの取り消し
git restore --staged file.py  # ファイルをアンステージ（変更は保持）
git restore file.py           # ファイルの変更自体を取り消し（注意!）

# --- GitHub Flow のワークフロー ---
 
# 1. mainブランチから新しいブランチを作成
git switch main
git pull origin main
git switch -c feature/add-user-auth
 
# 2. 開発とコミット
# ... コードを編集 ...
git add src/auth.py tests/test_auth.py
git commit -m "feat: ログイン認証機能を実装"
 
git add src/middleware.py
git commit -m "feat: 認証ミドルウェアを追加"
 
git add tests/test_middleware.py
git commit -m "test: 認証ミドルウェアのテストを追加"
 
# 3. リモートにプッシュ
git push -u origin feature/add-user-auth
 
# 4. Pull Request を作成
gh pr create --title "feat: ユーザー認証機能を追加" --body "
## 概要
ログイン認証とミドルウェアを実装しました。
 
## 変更内容
- JWT ベースの認証
- 認証ミドルウェア
- テスト
 
## テスト方法
\`\`\`bash
pytest tests/test_auth.py tests/test_middleware.py
\`\`\`
"
 
# 5. レビュー後にマージ
# （GitHub UI または CLI で実行）
gh pr merge --squash
 
# 6. ローカルの片付け
git switch main
git pull origin main
git branch -d feature/add-user-auth

# --- Trunk-Based Development のワークフロー ---
 
# 1. 短命ブランチを作成（1日以内にマージ予定）
git switch main
git pull origin main
git switch -c short-lived/add-button
 
# 2. 小さな変更をコミット
git add src/components/Button.tsx
git commit -m "feat: 新しいボタンコンポーネントを追加（フラグ付き）"
 
# 3. フィーチャーフラグで未完成機能を隠蔽
# config/features.py
# FEATURE_FLAGS = {
#     "new_button": False,  # 本番ではオフ
# }
 
# 4. すぐにマージ
git push -u origin short-lived/add-button
gh pr create --title "feat: ボタンコンポーネント追加" --body "フラグ: new_button"
gh pr merge --squash
 
# 5. mainを最新にして次の作業へ
git switch main
git pull origin main
 
# フィーチャーフラグの段階的ロールアウト:
# 1. 開発環境: フラグON → テスト
# 2. ステージング: フラグON → QA
# 3. 本番: カナリアリリース（1%のユーザーにON）
# 4. 段階的にONの割合を増加（10% → 50% → 100%）
# 5. 全ユーザーにON → フラグのコードを削除

# --- 良いコミットメッセージの例 ---
 
# ✅ 短い1行のメッセージ（シンプルな変更向け）
git commit -m "fix: ユーザー登録時のメールバリデーションエラーを修正"
 
# ✅ 本文付きのメッセージ（複雑な変更向け）
git commit -m "$(cat <<'EOF'
feat(auth): JWT ベースの認証機能を実装
 
パスワード認証に加え、JWTトークンによる認証を追加した。
トークンの有効期限は24時間で、リフレッシュトークンによる
自動更新をサポートする。
 
- アクセストークンの発行と検証
- リフレッシュトークンによるローテーション
- トークン無効化のためのブラックリスト
 
Closes #123
EOF
)"
 
# --- 悪いコミットメッセージの例 ---
# ❌ 何をしたか分からない
git commit -m "fix"
git commit -m "update"
git commit -m "作業中"
git commit -m "WIP"
git commit -m "misc changes"
 
# ❌ 大きすぎるコミット
git commit -m "認証機能追加、バグ修正、UIリファクタリング、テスト追加"
# → 複数のコミットに分割すべき
 
# ❌ 実装詳細だけで意図が分からない
git commit -m "if文を追加"
git commit -m "変数名をxからuserIdに変更"

# --- 対話的リベース（コミット履歴の整理） ---
 
# 最新5コミットを整理
git rebase -i HEAD~5
 
# エディタが開く:
# pick a1b2c3d feat: ユーザーモデルを追加
# pick d4e5f6g feat: ユーザーAPIを実装
# pick 7a8b9c0 fix: typo修正
# pick 1d2e3f4 feat: バリデーション追加
# pick 5a6b7c8 fix: バリデーションのバグ修正
 
# 以下のように編集:
# pick a1b2c3d feat: ユーザーモデルを追加
# pick d4e5f6g feat: ユーザーAPIを実装
# fixup 7a8b9c0 fix: typo修正                 ← 上のコミットに統合
# pick 1d2e3f4 feat: バリデーション追加
# fixup 5a6b7c8 fix: バリデーションのバグ修正   ← 上のコミットに統合
 
# リベースコマンド:
# pick   = そのまま使う
# reword = コミットメッセージを変更
# edit   = コミットの内容を編集
# squash = 上のコミットに統合（メッセージも統合）
# fixup  = 上のコミットに統合（メッセージは捨てる）
# drop   = コミットを削除
 
# コミットの順序を入れ替えることも可能（行を移動するだけ）

# --- コンフリクト解決の手順 ---
 
# 1. マージ（またはリベース）を実行
git merge feature
# Auto-merging src/user.py
# CONFLICT (content): Merge conflict in src/user.py
# Automatic merge failed; fix conflicts and then commit the result.
 
# 2. コンフリクトの状態を確認
git status
# Unmerged paths:
#   both modified:   src/user.py
 
# 3. コンフリクトマーカーを確認
# ファイル内のコンフリクト表示:
# <<<<<<< HEAD
# name = "Hello, World!"
# =======
# name = "Hi there!"
# >>>>>>> feature
 
# 4. 手動で解決
# マーカーを削除し、正しい内容に編集:
# name = "Hello, World!"
 
# 5. 解決をステージング
git add src/user.py
 
# 6. マージコミットを作成
git commit  # マージの場合はメッセージが自動生成される
 
# --- リベース中のコンフリクト解決 ---
git rebase main
# CONFLICT in src/user.py
 
# 解決後:
git add src/user.py
git rebase --continue  # 次のコミットの適用に進む
 
# リベースを中断して元に戻す:
git rebase --abort

# --- 基本操作 ---
git status                  # 状態確認
git add -p                  # 対話的にステージング
git commit -m "msg"         # コミット
git push origin branch      # プッシュ
git pull --rebase           # プル（リベースマージ）
 
# --- ブランチ操作 ---
git switch -c feature       # ブランチ作成+切替
git switch main             # mainに切替
git branch -d feature       # マージ済みブランチを削除
git branch -D feature       # 未マージブランチを強制削除
 
# --- 履歴の確認 ---
git log --oneline --graph   # グラフ表示
git log --oneline -20       # 直近20件
git log --since="2024-01-01" --until="2024-01-31"  # 期間指定
git log --author="Alice"    # 作者で絞り込み
git log -p -- path/to/file  # ファイルの変更履歴を差分付きで
git blame file.py           # 各行の最終変更者
 
# --- 差分の確認 ---
git diff                    # ワーキングツリーの変更
git diff --staged           # ステージングされた変更
git diff main..feature      # ブランチ間の差分
git diff HEAD~3..HEAD       # 直近3コミットの差分
git diff --stat             # 変更の統計情報

# --- stash（一時退避）---
git stash                   # 変更を退避
git stash push -m "WIP: ログイン機能"  # メッセージ付き退避
git stash list              # 退避リスト
git stash pop               # 最新の退避を復元して削除
git stash apply stash@{1}   # 特定の退避を復元（削除しない）
git stash drop stash@{0}    # 特定の退避を削除
 
# --- cherry-pick（特定のコミットを適用）---
git cherry-pick abc1234     # 特定のコミットを現在のブランチに適用
git cherry-pick abc1234..def5678  # 範囲指定
git cherry-pick --no-commit abc1234  # コミットせずに変更だけ適用
 
# --- 特定のファイルを別ブランチから取得 ---
git checkout main -- path/to/file.py  # mainのファイルを取得
git restore --source main -- path/to/file.py  # 同上（新しい書式）
 
# --- コミットの修正 ---
git commit --amend          # 直前のコミットを修正（メッセージ変更）
git commit --amend --no-edit  # メッセージを変えずにファイルを追加
 
# --- タグ ---
git tag v1.0.0              # 軽量タグ
git tag -a v1.0.0 -m "Release 1.0.0"  # 注釈付きタグ
git push origin v1.0.0      # タグをプッシュ
git push origin --tags       # 全タグをプッシュ

# --- reflog（HEADの移動履歴）---
git reflog
# abc1234 HEAD@{0}: commit: feat: 新機能追加
# def5678 HEAD@{1}: rebase finished: ...
# 7a8b9c0 HEAD@{2}: rebase: starting
 
# reflog を使った復旧
git reset --hard HEAD@{2}   # 2操作前の状態に戻る
 
# --- bisect（バグ導入コミットの特定）---
git bisect start
git bisect bad              # 現在のコミットはバグあり
git bisect good v1.0.0      # v1.0.0にはバグなし
# → Gitが中間のコミットをcheckout
# テストして good/bad を判定
git bisect good  # or  git bisect bad
# → 二分探索で絞り込み
git bisect reset            # 完了、元のブランチに戻る
 
# 自動化（テストスクリプトで）
git bisect start HEAD v1.0.0
git bisect run python -m pytest tests/test_bug.py
 
# --- 間違ったコミットの取り消し ---
# 方法1: revert（新しいコミットで取り消し）= 安全
git revert abc1234
git revert HEAD~3..HEAD     # 直近3コミットを取り消し
 
# 方法2: reset（履歴を巻き戻し）= 注意が必要
git reset --soft HEAD~1     # コミットを取消（変更はステージに残る）
git reset --mixed HEAD~1    # コミットを取消（変更はワーキングツリーに残る）
git reset --hard HEAD~1     # コミットを取消（変更も全て削除!）
 
# --- 消してしまったブランチの復旧 ---
git reflog | grep "feature/important"
# abc1234 HEAD@{5}: checkout: moving from feature/important to main
git branch feature/important abc1234  # ブランチを復活
 
# --- 大きなファイルの誤コミットの修正 ---
# 履歴から完全に削除（注意: 履歴を書き換える）
git filter-branch --force --tree-filter \
  'rm -f path/to/large-file.zip' HEAD
 
# より新しいツール: git-filter-repo
pip install git-filter-repo
git filter-repo --path path/to/large-file.zip --invert-paths

# --- 便利なGitエイリアス ---
git config --global alias.st "status"
git config --global alias.co "checkout"
git config --global alias.sw "switch"
git config --global alias.br "branch"
git config --global alias.ci "commit"
git config --global alias.lg "log --oneline --graph --decorate --all"
git config --global alias.last "log -1 HEAD --format='%H %s'"
git config --global alias.unstage "restore --staged"
git config --global alias.undo "reset --soft HEAD~1"
git config --global alias.amend "commit --amend --no-edit"
git config --global alias.wip "commit -am 'WIP'"
git config --global alias.branches "branch -a -v"
git config --global alias.tags "tag -l -n1"
git config --global alias.stashes "stash list"
git config --global alias.cleanup "!git branch --merged | grep -v '\\*\\|main\\|master\\|develop' | xargs -n 1 git branch -d"
 
# 使用例
git st           # git status
git lg           # きれいなグラフ表示
git undo         # 直前のコミットを取り消し
git cleanup      # マージ済みブランチを一括削除

#!/bin/bash
# .git/hooks/pre-commit（または husky で管理）
 
# --- Lintチェック ---
echo "Running lint..."
npm run lint
if [ $? -ne 0 ]; then
    echo "❌ Lint errors found. Please fix before committing."
    exit 1
fi
 
# --- テスト実行 ---
echo "Running tests..."
npm run test -- --bail
if [ $? -ne 0 ]; then
    echo "❌ Tests failed. Please fix before committing."
    exit 1
fi
 
# --- 機密情報の検出 ---
echo "Checking for secrets..."
PATTERNS="(password|secret|api_key|token)\s*=\s*['\"][^'\"]+['\"]"
if git diff --cached --name-only | xargs grep -lE "$PATTERNS" 2>/dev/null; then
    echo "❌ Potential secrets detected. Please review."
    exit 1
fi
 
# --- 大きなファイルの検出 ---
MAX_SIZE=5242880  # 5MB
for file in $(git diff --cached --name-only); do
    if [ -f "$file" ]; then
        size=$(wc -c < "$file")
        if [ "$size" -gt "$MAX_SIZE" ]; then
            echo "❌ File $file exceeds 5MB. Use Git LFS instead."
            exit 1
        fi
    fi
done
 
echo "✅ All checks passed."
exit 0

#!/bin/bash
# .git/hooks/commit-msg
# Conventional Commits のフォーマットを強制
 
commit_msg=$(cat "$1")
pattern="^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?(!)?: .{1,72}"
 
if ! echo "$commit_msg" | head -1 | grep -qE "$pattern"; then
    echo "❌ Invalid commit message format."
    echo ""
    echo "Expected format: <type>(<scope>): <description>"
    echo "  type: feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert"
    echo "  scope: optional, e.g., (auth), (api)"
    echo "  description: max 72 characters"
    echo ""
    echo "Example: feat(auth): ログイン認証を実装"
    exit 1
fi
 
exit 0

// package.json
{
  "scripts": {
    "prepare": "husky install"
  },
  "lint-staged": {
    "*.{ts,tsx}": [
      "eslint --fix",
      "prettier --write"
    ],
    "*.{css,scss}": [
      "stylelint --fix",
      "prettier --write"
    ],
    "*.{json,md}": [
      "prettier --write"
    ]
  }
}

# husky のセットアップ
npm install --save-dev husky lint-staged
npx husky install
 
# pre-commit フック
npx husky add .husky/pre-commit "npx lint-staged"
 
# commit-msg フック（Conventional Commits チェック）
npm install --save-dev @commitlint/cli @commitlint/config-conventional
npx husky add .husky/commit-msg 'npx commitlint --edit "$1"'

// commitlint.config.js
module.exports = {
  extends: ['@commitlint/config-conventional'],
  rules: {
    'type-enum': [
      2, 'always',
      ['feat', 'fix', 'docs', 'style', 'refactor', 'perf',
       'test', 'build', 'ci', 'chore', 'revert']
    ],
    'subject-max-length': [2, 'always', 72],
    'body-max-line-length': [2, 'always', 100],
  },
};

# .github/workflows/ci.yml
name: CI
 
on:
  push:
    branches: [main]
  pull_request:
    branches: [main]
 
jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run lint
 
  test:
    runs-on: ubuntu-latest
    needs: lint
    strategy:
      matrix:
        node-version: [18, 20, 22]
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: 'npm'
      - run: npm ci
      - run: npm run test -- --coverage
      - uses: actions/upload-artifact@v4
        with:
          name: coverage-${{ matrix.node-version }}
          path: coverage/
 
  build:
    runs-on: ubuntu-latest
    needs: test
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'
      - run: npm ci
      - run: npm run build
      - uses: actions/upload-artifact@v4
        with:
          name: build
          path: dist/
 
  deploy:
    runs-on: ubuntu-latest
    needs: build
    if: github.ref == 'refs/heads/main'
    environment: production
    steps:
      - uses: actions/download-artifact@v4
        with:
          name: build
          path: dist/
      - run: echo "Deploying to production..."
      # 実際のデプロイコマンド

# .github/workflows/pr-checks.yml
name: PR Checks
 
on:
  pull_request:
    types: [opened, synchronize, reopened]
 
jobs:
  # PR のサイズチェック
  pr-size:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Check PR size
        run: |
          LINES_CHANGED=$(git diff --stat origin/${{ github.base_ref }}...HEAD | tail -1 | awk '{print $4+$6}')
          echo "Lines changed: $LINES_CHANGED"
          if [ "$LINES_CHANGED" -gt 1000 ]; then
            echo "::warning::PR is too large ($LINES_CHANGED lines). Consider splitting."
          fi
 
  # 自動レビューアサイン
  auto-assign:
    runs-on: ubuntu-latest
    steps:
      - uses: kentaro-m/auto-assign-action@v2
        with:
          configuration-path: '.github/auto-assign.yml'
 
  # ラベル自動付与
  labeler:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/labeler@v5
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}

# semantic-release による自動リリース
# Conventional Commits からバージョンを自動決定
 
# インストール
npm install --save-dev semantic-release @semantic-release/git @semantic-release/changelog
 
# .releaserc.json
# {
#   "branches": ["main"],
#   "plugins": [
#     "@semantic-release/commit-analyzer",
#     "@semantic-release/release-notes-generator",
#     "@semantic-release/changelog",
#     "@semantic-release/npm",
#     "@semantic-release/github",
#     ["@semantic-release/git", {
#       "assets": ["CHANGELOG.md", "package.json"],
#       "message": "chore(release): ${nextRelease.version}"
#     }]
#   ]
# }

# --- Git LFS（Large File Storage）---
 
# インストール
git lfs install
 
# 追跡するファイルパターンを指定
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "*.mp4"
git lfs track "assets/images/*.png"
 
# .gitattributes が自動生成される
# *.psd filter=lfs diff=lfs merge=lfs -text
# *.zip filter=lfs diff=lfs merge=lfs -text
 
# 通常通りadd/commit/push
git add .gitattributes
git add large-file.psd
git commit -m "feat: デザインファイルを追加"
git push origin main
 
# LFS の状態確認
git lfs ls-files     # LFS管理ファイル一覧
git lfs status       # LFS の状態

# --- .gitignore の推奨設定 ---
 
# --- OS ---
.DS_Store
Thumbs.db
*.swp
*~
 
# --- エディタ/IDE ---
.vscode/settings.json
.idea/
*.sublime-workspace
*.code-workspace
 
# --- 言語/フレームワーク ---
# Node.js
node_modules/
npm-debug.log*
yarn-error.log*
.pnpm-debug.log*
 
# Python
__pycache__/
*.py[cod]
*.pyo
.venv/
venv/
*.egg-info/
dist/
build/
 
# Java
*.class
target/
*.jar
*.war
 
# Go
/vendor/
 
# --- ビルド成果物 ---
dist/
build/
out/
.next/
.nuxt/
 
# --- 環境変数・機密情報 ---
.env
.env.local
.env.production
*.pem
*.key
credentials.json
 
# --- テスト/カバレッジ ---
coverage/
.nyc_output/
*.lcov
htmlcov/
 
# --- ログ ---
*.log
logs/
 
# --- データベース ---
*.sqlite3
*.db
 
# グローバル .gitignore（全リポジトリ共通）
git config --global core.excludesfile ~/.gitignore_global

# git-secrets のインストールと設定
brew install git-secrets  # macOS
 
# リポジトリに設定
cd my-project
git secrets --install
git secrets --register-aws  # AWSキーパターンを登録
 
# カスタムパターンの追加
git secrets --add 'password\s*=\s*["\047][^"\047]+["\047]'
git secrets --add 'PRIVATE[_-]?KEY'
 
# コミット前に自動チェック（pre-commit hook に追加される）
git secrets --scan         # リポジトリ全体をスキャン
git secrets --scan-history # 全履歴をスキャン

# --- コミット署名（GPG）---
 
# GPGキーの生成
gpg --full-generate-key
 
# キーIDの確認
gpg --list-secret-keys --keyid-format=long
# sec   rsa4096/ABC1234567890DEF 2024-01-01 [SC]
 
# Gitに設定
git config --global user.signingkey ABC1234567890DEF
git config --global commit.gpgsign true  # 全コミットに署名
 
# 署名付きコミット
git commit -S -m "feat: 署名付きコミット"
 
# 署名の検証
git log --show-signature
# gpg: Good signature from "Alice <alice@example.com>"
 
# GitHubに公開鍵を登録
gpg --armor --export ABC1234567890DEF
# → GitHubの Settings → SSH and GPG keys に追加

# --- git worktree ---
# 1つのリポジトリで複数のブランチを同時にチェックアウト
 
# 新しいworktreeを作成
git worktree add ../project-hotfix hotfix/critical-bug
git worktree add ../project-review feature/new-ui
 
# worktreeの一覧
git worktree list
# /path/to/project          abc1234 [main]
# /path/to/project-hotfix   def5678 [hotfix/critical-bug]
# /path/to/project-review   7a8b9c0 [feature/new-ui]
 
# worktreeの削除
git worktree remove ../project-hotfix
 
# ユースケース:
# - 長時間のビルドを別ディレクトリで実行しつつ開発を続ける
# - コードレビュー用に別ブランチをチェックアウト
# - 緊急のhotfixを本作業を中断せずに対応

# --- git submodule ---
# 外部リポジトリをサブディレクトリとして含める
 
# サブモジュールの追加
git submodule add https://github.com/example/library.git libs/library
git commit -m "feat: libraryをサブモジュールとして追加"
 
# サブモジュール付きリポジトリのクローン
git clone --recurse-submodules https://github.com/example/project.git
# または
git clone https://github.com/example/project.git
cd project
git submodule init
git submodule update
 
# サブモジュールの更新
git submodule update --remote  # リモートの最新を取得
cd libs/library
git checkout v2.0.0            # 特定のバージョンに固定
cd ../..
git add libs/library
git commit -m "chore: libraryをv2.0.0に更新"
 
# サブモジュールの注意点:
# - 複雑さが増す（クローン時に --recurse-submodules が必要）
# - CIの設定が複雑になる
# - 代替手段: npm/pip等のパッケージマネージャーを検討

# --- 大規模リポジトリのパフォーマンス改善 ---
 
# シャロークローン（履歴を制限）
git clone --depth 1 https://github.com/large/repo.git
git clone --depth 100 https://github.com/large/repo.git
git clone --shallow-since="2024-01-01" https://github.com/large/repo.git
 
# 部分クローン（blobを遅延取得）
git clone --filter=blob:none https://github.com/large/repo.git
 
# スパースチェックアウト（特定のディレクトリのみ）
git clone --no-checkout https://github.com/large/repo.git
cd repo
git sparse-checkout init --cone
git sparse-checkout set packages/web packages/shared
git checkout main
# → packages/web と packages/shared のみがチェックアウトされる
 
# fsmonitor（ファイル監視デーモン）で高速化
git config core.fsmonitor true
git config core.untrackedcache true
 
# gc（ガベージコレクション）
git gc --aggressive  # リポジトリの最適化
git prune            # 不要オブジェクトの削除
 
# パフォーマンス確認
git count-objects -vH  # オブジェクト数とサイズ

# --- .github/CODEOWNERS ---
# ファイル/ディレクトリごとにレビューアを自動アサイン
 
# デフォルトのオーナー
* @team-lead
 
# フロントエンド
/src/components/ @frontend-team
/src/pages/ @frontend-team
*.tsx @frontend-team
*.css @frontend-team
 
# バックエンド
/src/api/ @backend-team
/src/models/ @backend-team
/src/services/ @backend-team
 
# インフラ
/terraform/ @infra-team
/docker/ @infra-team
/.github/workflows/ @infra-team
Dockerfile @infra-team
 
# ドキュメント
/docs/ @tech-writers
*.md @tech-writers
 
# セキュリティ関連
/src/auth/ @security-team
/src/middleware/auth* @security-team

<!-- .github/pull_request_template.md -->
 
## 概要
<!-- この PR で何を変更しましたか？ -->
 
## 変更の種類
- [ ] 新機能（feat）
- [ ] バグ修正（fix）
- [ ] リファクタリング（refactor）
- [ ] ドキュメント（docs）
- [ ] テスト（test）
- [ ] その他
 
## 変更内容
<!-- 変更の詳細を記載 -->
 
## テスト方法
<!-- テスト手順を記載 -->
 
## スクリーンショット
<!-- UI変更がある場合はスクリーンショットを添付 -->
 
## チェックリスト
- [ ] テストを追加/更新した
- [ ] ドキュメントを更新した
- [ ] 破壊的変更はない
- [ ] パフォーマンスへの影響を確認した
- [ ] セキュリティへの影響を確認した
 
## 関連Issue
Closes #

# 演習1: 基本実装のテンプレート
class Exercise1:
    """基本的な実装パターンの演習"""
 
    def __init__(self):
        self.data = []
 
    def validate_input(self, value):
        """入力値の検証"""
        if value is None:
            raise ValueError("入力値がNoneです")
        return True
 
    def process(self, value):
        """データ処理のメインロジック"""
        self.validate_input(value)
        self.data.append(value)
        return self.data
 
    def get_results(self):
        """処理結果の取得"""
        return {
            'count': len(self.data),
            'data': self.data
        }
 
# テスト
def test_exercise1():
    ex = Exercise1()
    assert ex.process(1) == [1]
    assert ex.process(2) == [1, 2]
    assert ex.get_results()['count'] == 2
 
    try:
        ex.process(None)
        assert False, "例外が発生するべき"
    except ValueError:
        pass
 
    print("全テスト合格!")
 
test_exercise1()

# 演習2: 応用パターン
from typing import List, Dict, Optional
from datetime import datetime
 
class AdvancedExercise:
    """応用パターンの演習"""
 
    def __init__(self, max_size: int = 100):
        self._items: List[Dict] = []
        self._max_size = max_size
        self._created_at = datetime.now()
 
    def add(self, key: str, value: any) -> bool:
        """アイテムの追加（サイズ制限付き）"""
        if len(self._items) >= self._max_size:
            return False
        self._items.append({
            'key': key,
            'value': value,
            'timestamp': datetime.now().isoformat()
        })
        return True
 
    def find(self, key: str) -> Optional[Dict]:
        """キーによる検索"""
        for item in reversed(self._items):
            if item['key'] == key:
                return item
        return None
 
    def remove(self, key: str) -> bool:
        """キーによる削除"""
        for i, item in enumerate(self._items):
            if item['key'] == key:
                self._items.pop(i)
                return True
        return False
 
    def stats(self) -> Dict:
        """統計情報"""
        return {
            'total_items': len(self._items),
            'max_size': self._max_size,
            'usage_percent': len(self._items) / self._max_size * 100,
            'uptime': str(datetime.now() - self._created_at)
        }
 
# テスト
def test_advanced():
    ex = AdvancedExercise(max_size=3)
    assert ex.add("a", 1) == True
    assert ex.add("b", 2) == True
    assert ex.add("c", 3) == True
    assert ex.add("d", 4) == False  # サイズ制限
    assert ex.find("b")['value'] == 2
    assert ex.remove("b") == True
    assert ex.find("b") is None
    stats = ex.stats()
    assert stats['total_items'] == 2
    print("応用テスト全合格!")
 
test_advanced()

# 演習3: パフォーマンス最適化
import time
from functools import lru_cache
 
# 最適化前（O(n^2)）
def slow_search(data: list, target: int) -> int:
    """非効率な検索"""
    for i in range(len(data)):
        for j in range(i + 1, len(data)):
            if data[i] + data[j] == target:
                return (i, j)
    return (-1, -1)
 
# 最適化後（O(n)）
def fast_search(data: list, target: int) -> tuple:
    """ハッシュマップを使った効率的な検索"""
    seen = {}
    for i, num in enumerate(data):
        complement = target - num
        if complement in seen:
            return (seen[complement], i)
        seen[num] = i
    return (-1, -1)
 
# ベンチマーク
def benchmark():
    import random
    data = list(range(5000))
    random.shuffle(data)
    target = data[100] + data[4000]
 
    start = time.time()
    result1 = slow_search(data, target)
    slow_time = time.time() - start
 
    start = time.time()
    result2 = fast_search(data, target)
    fast_time = time.time() - start
 
    print(f"非効率版: {slow_time:.4f}秒")
    print(f"効率版:   {fast_time:.6f}秒")
    print(f"高速化率: {slow_time/fast_time:.0f}倍")
 
benchmark()

# デバッグ用ユーティリティ
import logging
import traceback
from functools import wraps
 
# ロガーの設定
logging.basicConfig(
    level=logging.DEBUG,
    format='%(asctime)s [%(levelname)s] %(name)s: %(message)s'
)
logger = logging.getLogger(__name__)
 
def debug_decorator(func):
    """関数の入出力をログ出力するデコレータ"""
    @wraps(func)
    def wrapper(*args, **kwargs):
        logger.debug(f"呼び出し: {func.__name__}(args={args}, kwargs={kwargs})")
        try:
            result = func(*args, **kwargs)
            logger.debug(f"戻り値: {func.__name__} -> {result}")
            return result
        except Exception as e:
            logger.error(f"例外発生: {func.__name__}: {e}")
            logger.error(traceback.format_exc())
            raise
    return wrapper
 
@debug_decorator
def process_data(items):
    """データ処理（デバッグ対象）"""
    if not items:
        raise ValueError("空のデータ")
    return [item * 2 for item in items]