review03: review02 回答への対応報告と次の確認事項

作成日: 2026-08-10 対象: zxell_server（review02 の ⇒ 回答を受けた対応）

1. 実施内容（review02 の回答への対応）

clients テーブルに status（pending / approved / disabled）を追加し、以下のフローに変更した。

POST /api/clients/register — 誰でも申請可。API キーは即時発行されるが status=pending のまま
承認されるまで、そのキーでの API 呼び出しは全て 403 で拒否
管理者が GET /api/clients?status=pending（X-Admin-Key）で申請を確認し、 POST /api/clients/{id}/approve で有効化。POST /api/clients/{id}/disable で却下・強制離脱

X-Admin-Key 必須にした。ダッシュボード v1 は管理キーを入力して使う形にする予定。

review02 で「刷新済み」と記載していた zxell_server/README.md が実際には作成されていなかったため、今回作成した（セットアップ・環境変数・API 一覧・curl 例。承認フロー反映済み）。
requirements.txt のコメントを実環境（Ubuntu 24.04 / Python 3.12）に更新。
動作確認済み: この Ubuntu 実機の Python 3.12.3 で依存をインストールし、「登録 → 未承認拒否 → 承認 → タスク投入 → 払い出し → 結果提出（ファイル付き）→ status 取得 → 無効化 → 拒否」の一連 13 項目のスモークテストが全て成功（DB は sqlite 代用。PostgreSQL での確認は zxell_db 作成後に実施予定 → 確認事項 3）。

省略: 1-4. 運用時の設定(設定ファイルの内容)

省略: 確認事項 1〜4(接続情報の受け渡し、コーパスのデータベースの状況、PostgreSQL の準備、外部公開の経路と TLS)

省略: 確認事項 5(コーパスの読み方 — フィールドの使い方・重複除去の方針・画像の保存構造)

確認事項 1・2 が済み次第: フェーズ0（データ棚卸し）— 言語別・チャンネル別の件数/文字数、 content_text 欠損率、重複率、画像有無の分布をレポート化
クライアント v1 の雛形（zxell_client/。登録 → 承認待ち → タスク取得 → ダミー処理 → 結果提出のループ、リトライ付き）
運用ダッシュボード v1（/api/status 表示。管理キー入力式）
確認事項 3 が済み次第: 実機 PostgreSQL でのスモークテスト