【保存版】Git/GitHub入門：バージョン管理・ブランチ戦略・レビュー・自動化を“実務の型”で最短習得

# ユーザー情報
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
# デフォルトブランチ名
git config --global init.defaultBranch main
# 改行コード（Windowsの混乱を減らす）
git config --global core.autocrlf input
# 差分を見やすく
git config --global color.ui auto

project/
  ├─ data/
  │   ├─ raw/          # 受領データ（非追跡にすることが多い）
  │   └─ warehouse/    # SQLiteなど（非追跡）
  ├─ notebooks/
  ├─ src/
  ├─ reports/          # 図/Excel/PDF（必要に応じ非追跡）
  ├─ tests/
  ├─ .gitignore
  ├─ requirements.txt
  └─ README.md

# Python
__pycache__/
*.pyc
.venv/
.env
# Data / Outputs
/data/*
!/data/README.md
/reports/*
!/reports/README.md
*.sqlite
# Jupyter
.ipynb_checkpoints/
# OS/editor
.DS_Store
Thumbs.db

cd project
git init
echo "# プロジェクト名" > README.md
git add .
git commit -m "feat: 初期雛形を追加 (構成/ignore/README)"

# GitHubで空のリポジトリ（project名）を作成後に接続
git remote add origin https://github.com/yourname/project.git
git branch -M main
git push -u origin main

git switch -c feat/monthly-report
# 変更→テスト→コミット
git add -p
git commit -m "feat: 月次集計のSQLとNotebookを追加"
git push -u origin feat/monthly-report  # GitHubでPR作成

git status
git diff
git add -p
git commit --amend             # 未push時のみ
git stash && git switch main   # 急用で退避
git log --oneline --graph --decorate --all

git switch feat/monthly-report
git fetch origin
git rebase origin/main
# コンフリクト解消→テスト
git push --force-with-lease

# .git/hooks/pre-commit（chmod +xで実行権限付与）
#!/usr/bin/env bash
find . -name "*.ipynb" -print0 | xargs -0 -I {} jupyter nbconvert --ClearOutputPreprocessor.enabled=True --inplace {}

## 目的
- 例：月次集計と図を追加し、Excel出力まで自動化

## 変更点（Before/After）

* SQL: WITH monthly を追加
* report.py: ExcelWriter で Summary タブ出力

## 動作確認

* `python src/report.py` で report.xlsx が生成される

## 影響範囲

* なし（新規追加のみ）

### 概要
### ゴール（受け入れ条件）
### 参考

git switch main && git pull
git tag -a v0.1.0 -m "初回リリース: 月次集計+Excel出力"
git push origin v0.1.0

name: ci
on:
  pull_request:
  push:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with: { python-version: '3.11' }
      - run: pip install -r requirements.txt || true
      - run: python -m pip install pytest
      - run: pytest -q || echo "tests not found; skipping"

# ブランチ
git switch -c feat/foo     # 作成+切替
git switch main            # 切替
# 差分/取り消し
git diff                    # 差分
git restore --staged file   # ステージ解除
git restore file            # 変更取り消し
# 追跡をやめる（ファイルは残す）
git rm --cached path/to/file

# プロジェクト名
目的：誰の、どの意思決定を支援するか（1文）
再現手順：
1) python -m venv .venv && source .venv/bin/activate
2) pip install -r requirements.txt
3) python src/report.py  # Excel/図を出力
データ：data/raw/ 以下に配置（入手方法を記載）