Appearance
PowerShell スクリプト集 (PowerShell Scripts Reference)
本プロジェクトのリポジトリルートにある主要な PowerShell スクリプトの機能と使い方をまとめています。
主要スクリプト一覧
| スクリプト名 | 役割・概要 | 実行例 |
|---|---|---|
scripts/ag-health-check.ps1 | 依存関係・API互換性・ビルド整合性の統合診断（エージェント推奨） | powershell -ExecutionPolicy Bypass -File ./scripts/ag-health-check.ps1 |
scripts/build-demo-artifacts.ps1 | すべてのアプリ（API, Management, Kiosk, Facility, Guardian/Staff PWA）のオフライン・デモ・デバッグ成果物一括ビルド。APKはFacility/Kioskのみ生成 | powershell -ExecutionPolicy Bypass -File ./scripts/build-demo-artifacts.ps1 -Version 0.1.0 |
scripts/build-release-artifacts.ps1 | 本番設定・本番署名を必須にした非デモRelease成果物の生成、成果物検証、SHA-256マニフェスト作成 | powershell -ExecutionPolicy Bypass -File ./scripts/build-release-artifacts.ps1 -Target kiosk-windows,kiosk-linux -Version 0.1.0 |
scripts/verify-release-artifacts.ps1 | 指定した本番成果物の構造・版数・署名・manifest/hashを検証（-Target 省略時は全成果物） | powershell -ExecutionPolicy Bypass -File ./scripts/verify-release-artifacts.ps1 -VersionName 0.1.0 -VersionCode 1 -Target management,kiosk-windows,kiosk-linux -RequireManifest |
scripts/build-all-suites.ps1 | 旧手順互換の一括ビルドラッパー（上記の標準デモビルドへ委譲） | powershell -ExecutionPolicy Bypass -File ./scripts/build-all-suites.ps1 -Version 0.1.0 |
scripts/check-api-compatibility.ps1 | API定義とManagement（C#）アプリのインターフェース互換性診断 | powershell -ExecutionPolicy Bypass -File ./scripts/check-api-compatibility.ps1 |
scripts/verify-local-stack.ps1 | 起動中のAPI、4つのフロント、CORS、未認証時の主要APIルートを機械的にスモーク検証 | pwsh -ExecutionPolicy Bypass -File ./scripts/verify-local-stack.ps1 |
scripts/run-dependency-check.ps1 | npm audit などを利用した依存パッケージのセキュリティ脆弱性検査 | powershell -ExecutionPolicy Bypass -File ./scripts/run-dependency-check.ps1 |
scripts/SeedDemoData.ps1 | デモ用のダミーデータの初期シード（ハッシュプレフィックス対応） | powershell -ExecutionPolicy Bypass -File ./scripts/SeedDemoData.ps1 |
scripts/start-local-stack.ps1 | API と Provider/Guardian/Facility/Staff のローカル開発サーバーをポート指定で一括起動（-SkipApiでAPI別起動にも対応） | powershell -ExecutionPolicy Bypass -File ./scripts/start-local-stack.ps1 -Demo |
app/api/scripts/verify-audit-log-chain.ts | D1から出力した監査ログJSONの施設単位ハッシュチェーンを検証（改ざん、欠損、リンク不一致を検出） | cd app/api; npx tsx scripts/verify-audit-log-chain.ts --file audit-logs.json |
build-demo-artifacts.ps1 はデモ成果物の作成開始時に release/release-manifest-*.json とSHA-256 sidecarを削除します。本番manifestは本番候補専用の build-release-artifacts.ps1 で生成し、デモ成果物と同じ配布単位に混在させないでください。
GuardianとStaffはPWA専用です。これらのターゲットはViteビルドとPWA ZIPだけを生成し、Android/Capacitor/APKの処理は行いません。
実行時の注意点
Windows 環境で実行ポリシー制限によりスクリプトが実行できない場合は、-ExecutionPolicy Bypass オプションを付与して呼び出してください。
詳細な配置やリリース構成の規約については、同サイトの ディレクトリ構成ルール を参照してください。
ローカル統合スモーク
start-local-stack.ps1 -Demo で起動したAPIとProvider/Guardian/Facility/Staffに対して、次を確認できます。
powershell
pwsh -ExecutionPolicy Bypass -File ./scripts/verify-local-stack.ps1検証内容は、APIのヘルスとD1接続、4画面の/login、Guardian/Facility/StaffのCORS preflight、未認証時のauth/me、Facilityのdashboard/SSEルートです。未ログインのauth/meが401になるのは正常であり、404や5xxとは分けて扱います。ログイン成功や画面操作そのものは、各アプリの手動テスト手順も併用してください。
APIだけを検証する場合は-SkipFrontend、CORSまたは認証ルートを個別に除外する場合は-SkipCors / -SkipAuthContractを指定します。