Fork: 0
hasegawa / TIASShot
Transfer to URL with SHA Find file
Newer
Older
TIASShot / docs / 02_ENV / ENV_03_管理者用環境構築手順.md
@rintoHasegawa rintoHasegawa on 28 Aug 4 KB [add] Dependabot を設定（脆弱性検出の有効化と依存更新 PR の定期実行）
Raw Blame History

管理者用環境構築手順 (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 はリポジトリに含めず，各開発マシンへ個別に導入する．入手元とライセンスの管理は管理者が把握しておく．

SDK用途入手・配置
IC Imaging Control SDKImagingSource 製カメラ（DFK33UX178 / DFK23UX249）The Imaging Source から各自インストール（setup.ps1 が未導入時にダウンロードページを開く）
Lumenera SDKLumenera 製カメラ（Lw110）lumenera.api.dll をリポジトリに同梱済み．追加インストールは不要

実行時参照ファイルの配布 (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 を追加した時点で自動的に追従される．
  • Dependabot の PR は /deps-update で処理する（ゲートを満たすものだけマージし，メジャー更新・CI 赤は分析付きで報告される）．本プロジェクトは CI が無いためゲートはローカル検証（x64 ビルド＋テスト）で判定される点に注意する．