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

プロジェクト作成時に一度だけ行う初期設定をまとめる．各開発者が繰り返し行う構築手順は ENV_02_環境構築手順 を参照する．

本プロジェクトは個人開発（solo）のデスクトップアプリのため，管理者作業は最小限である．チーム開発へ移行する場合の管理者初期設定は .claude/rules/／GUIDE_01 の team 運用に従って別途整備する．

リポジトリ (Repository)

• ホスティング: GitHub の Private リポジトリ．具体的なオーナー・リポジトリ名・URL は管理者が別途把握する（本ドキュメントには記載しない）．
• 既定ブランチ: main．main への直接 push は行わず，作業ブランチ → PR 経由でマージする（.claude/rules/git-conventions.md）．
• 新しい開発マシンでは git clone 後に ENV_02_環境構築手順 に従う．

GitHub リポジトリのセキュリティ設定 (Repository Security Settings)

Dependabot alerts（既知脆弱性の検出）と Dependabot security updates（脆弱性を直す PR の自動作成）はリポジトリごとに既定で OFF のため，リポジトリ作成後に有効化する．2026-08-28 に有効化済み（冪等なので再実行してよい）．

gh api -X PUT repos/{owner}/{repo}/vulnerability-alerts        # Dependabot alerts（依存グラフも同時に有効化される）
gh api -X PUT repos/{owner}/{repo}/automated-security-fixes    # Dependabot security updates

検証は次のとおり（vulnerability-alerts は 204 で有効・404 で無効，automated-security-fixes は {"enabled":true} で有効）．

gh api repos/{owner}/{repo}/vulnerability-alerts -i
gh api repos/{owner}/{repo}/automated-security-fixes

• 実行にはリポジトリの admin 権限が必要（無いと 403）．手順の詳細・トラブル対応は .claude/skills/setup/reference.md「GitHub リポジトリのセキュリティ設定」を参照する．
• 依存パッケージの定期更新 PR は .github/dependabot.yml で設定しており，本設定とは独立に動く（後述の「CI・自動化」）．

外部 SDK・ライセンス (External SDKs & Licenses)

カメラ制御 SDK はリポジトリに含めず，各開発マシンへ個別に導入する．入手元とライセンスの管理は管理者が把握しておく．

実行時参照ファイルの配布 (Runtime Reference Files)

アプリは実行ファイルと同じディレクトリに以下を必要とする．これらは環境・機材に依存するためリポジトリでは管理せず，管理者が正となるファイルを保持し，新しい開発者・現場へ配布する．

• config.xml — 実行時設定（仕様は SPEC_02_設定ファイル仕様）
• DFK33UX178.xml / DFK23UX249.xml — ImagingSource カメラ設定
• tcc_srgb.csv / tcc_xyz.csv — TCC 色変換の参照値

データ保存フォルダ (Data Folder)

• 既定の保存先は C:\TIAS_Data（config.xml の <SaveFolder> で変更可能）．
• setup.ps1 実行時に未作成なら自動生成される．
• 現場マシンでは，このフォルダへの書き込み権限を管理者が確認する．

CI・自動化 (CI & Automation)

• 現時点で CI（GitHub Actions 等）は構築していない．ビルド・テストはローカルで行う（ENV_04_開発コマンド）．
• 将来 CI を導入する場合は，x64・packages.config・ネイティブ DLL（OpenCvSharp）依存を満たすランナー構成が必要になる点に注意する．
• .github/dependabot.yml で依存パッケージの定期更新 PR を設定している（NuGet: TIASshot／TIASshot.Tests の各 packages.config，週 1 回，マイナー／パッチは 1 PR にまとめる．メジャー更新も個別 PR で作成する）．GitHub Actions の更新も対象に含めてあるため，CI を追加した時点で自動的に追従される．
• OpenCvSharp4 系（5 パッケージ）は opencvsharp 専用グループに分離してある．OpenCvSharp は OpenCV 本体に追随するバージョニングで semver 契約を持たず，マイナー扱いの bump でも破壊的変更が入るため（4.10→4.13 で ArUco API が変更され，マイナー扱いのグループ PR がビルド不能になった実績がある）．マネージドとネイティブ（runtime.win）を常に同一バージョンで揃える必要があるので，規模を問わず 1 PR に束ねる．security update 経路にも同じ束ね方を効かせるため applies-to: "security-updates" のミラーグループを併置している．このグループは自動マージ禁止で，fixture 回帰または実機確認を経て人間がマージする（/deps-update 側のガードは .claude/deps-update-skip.md）．
• Dependabot の PR は /deps-update で処理する（ゲートを満たすものだけマージし，メジャー更新・CI 赤は分析付きで報告される）．本プロジェクトは CI が無いためゲートはローカル検証（x64 ビルド＋テスト）で判定される点に注意する．