管理者用環境構築手順 (Admin Setup)

プロジェクト立ち上げ時に 一度だけ 実施する作業をまとめる．既に完了した項目もチェック付きで記録しておく．

1. GitHub リポジトリ作成（完了済み）

•  rintoHasegawa/SmTIAS-LightSim を Private で作成
•  main ブランチを作成・初期コミット
•  programming-template から初回同期（/sync-template）
•  MiniTIAS/ と MiniTias-Evaluation/ を .gitignore に追加（参照用ローカルコピーのため）

2. uv の動作確認（完了済み）

ローカル環境で uv をインストール済みであれば次へ．未導入であれば ENV_02_環境構築手順.md の手順 1 を実施．

3. プロジェクト初期化（実装フェーズで実行）

以下はフェーズ 7（実装開始）の最初に行う．

3.1 pyproject.toml の生成

uv init --package --no-readme --no-workspace

その後，pyproject.toml の依存関係を ENV_01_技術スタック.md の主要依存ライブラリ表に従って追記する．

例：

uv add mitsuba numpy trimesh pillow matplotlib pandas
uv add --dev pytest ruff

3.2 Python バージョン固定

uv python pin 3.12

.python-version ファイルが生成される．これをコミットする．

3.3 ロックファイルの初期生成とコミット

uv lock
git add pyproject.toml uv.lock .python-version
git commit -m "[add] uv によるプロジェクト初期化と Mitsuba 3 依存の追加"

4. リポジトリ運用設定

4.1 デフォルトブランチの確認

•  GitHub の Settings → Branches → Default branch が main になっていること

4.2 ブランチ保護（任意）

1 人運用のため必須ではないが，誤プッシュ防止に以下を推奨：

• Settings → Branches → Add rule
• Branch name pattern: main
• Require a pull request before merging（チェック）
• Require approvals は無効でよい（1 人運用のため）

未設定でも開発に支障はない．

5. 外部サービス（任意・将来）

現時点では外部サービス連携は不要．以下は将来検討事項として残しておく：

• CI / CD（GitHub Actions）: pytest と ruff の自動実行．運用が安定してから導入する
• GitHub Pages: シミュレーション結果のレポート公開用．現状は不要

これらは管理者がコンソール操作で設定する作業のため，AI からは実施しない．

6. メンバー追加時の手続き

1. 新規参加者を GitHub リポジトリの Collaborator に追加（管理者の手動操作）
2. 参加者は ENV_02_環境構築手順.md に従って自分の環境を構築