#434

docs/counts-exports.md

@@ -105,3 +105,23 @@ CSV の物理行と JSON の pivot_cell には集計レコードを含むため
 追加は許可後の新規 add_index migration として行い、既存 migration は変更しない。
 実DBでのインデックス容量・作成時ロック・実行計画・時間は未確認。
 索引追加なしでの最大データ量に対する応答時間は保証しない。
+
+
+## GET 応答開始の確認（静的実装・未実測）
+
+進捗画面は ready 後に owner/job に紐づく download_attempt を登録し、同じ attempt を
+native iframe の実 GET に渡す。サーバーは署名・所有者・権限 revision・期限・ファイルを
+再検証し、64KiB の最初のチャンクを Rack 出力側へ渡した後に started を記録する。
+HEAD や受付 POST では started にしない。確認には30秒の独立した期限がある。
+サーバーの出力開始はブラウザー受信・保存完了を保証しない。途中の切断もあり得る。
+開始確認前の失敗はダイアログに残る。再実行はダイアログを閉じてエクスポートをやり直す。
+
+Web と worker は同じ COUNTS_EXPORT_DIRECTORY、Rails secret、DB、実行ユーザーで
+共有 POSIX filesystem を使うこと。別ホストではローカル tmp を共有できない。
+systemd の EnvironmentFile と Web の環境を照合し、directory の owner と0700相当の
+アクセス制限、容量、期限切れ削除、worker heartbeat と restart を公開前に確認する。
+この作業では systemctl・worker 起動・本番環境への適用を行っていない。
+
+リリース保留：非公開グループと複数値・変更項目軸の交差集計、生成ファイルへの秘匿値の
+非混入、実 GET の middleware/proxy 経由の開始通知は、回帰テストと実環境の確認が必要。
+テスト・型チェック・build は未実行。