関係人口 担当者自動算出ロジック

1. 要求 (Why)

関係者・ステークホルダー

• IT 管理: 実装・一括算出 endpoint 実行
• 代表理事・事務局: スコア入力 + 保存時の担当者確認
• 理事・リーダー級: 担当割当の影響を受ける

2. 要件 (What — 受け入れ基準)

2.1 スコア体系

• 各スタッフは支持者 1 名に対して S / A / B / C / Z の 5 段階で評価
• スコア配点: S=4 / A=3 / B=2 / C=1 / Z=0
• 「A 以上」= 関係値が高い（HIGH 閾値）
• 既存 calcLocalScore（平均ベースの関係値算出）はそのまま維持。本仕様はそれと別軸で「担当者」を算出する

2.2 担当者カテゴリ

カテゴリ	該当者	定義
CORE （基本担当 3 名）	小澤 / 藤原 / 佐々生	担当者候補の中心グループ
PRESIDENT （負担軽減対象 1 名）	鈴木	鈴木しか候補がない場合に表示
OTHER_DIR （他理事・5 名）	渡部 / 畠中 / 中村 / 吉田 / 正樹	CORE で候補が出ない時の次候補

※ 瀬川は 2026-05-30 元理事化のため算出対象外（既に削除済）

2.3 算出アルゴリズム

Step 1: 既に担当者がある場合はそれを優先する
Step 2: 9 名のスタッフ評価を読む
Step 3: Z と空欄は候補外にする
Step 4: S > A > B > C の順で最上位を採用する
Step 5: 同点なら候補を / 区切りで複数表示する
Step 6: 1 人も候補がいなければ「未定」

2.4 補足

• このロジックは「誰に期待が高いか」を見せるためのものなので、負荷分散の最適化はしない
• 負荷分散を入れると説明可能性が落ちるため、公開仕様では採用しない
• 担当者 は表示名で、旧 正担当 は互換用の内部名としてのみ残している

2.5 算出タイミング

方式	説明	対象
A (保存時即時算出)	members.html の保存ボタン押下時、サーバー側で算出 → 画面に「担当者」を返す	個別保存時
B (一括算出 endpoint)	既存 472 件に対して 1 回限り GET /admin/recalc-primary-owners（IT 管理者のみ）で全件再算出 → Notion 一括 PATCH	全件再算出時

※ 定期バッチは導入しない（件数変動は保存時に再算出で十分）

2.6 保存先

• 内部互換用の「正担当」select 列（将来削除予定）
• 画面上は「担当者」に統一（公開文言は担当者のみ）
• 過去の手動メモ用途のデータを毀損しない
• D1 members_update_log に変更履歴記録（既存 Tier 2.23 audit log の仕組みを利用）

2.7 既存バグ修正

• PATCH /members/{id} でスタッフ別評価 10 列（鈴木評価 / 渡部評価 / ... / 佐々生評価）の保存処理を追加
• POST /members でも同様

2.8 UI 変更

• members.html 編集モーダル
  • 「担当者」表示欄を新設（読込のみ・保存時にサーバーから返却された値を表示）
  • 内部互換の「正担当」は画面上では使わない

2.9 一括算出仕様

• IT 管理者のみ実行可能: GET /api/ikizama/admin/recalc-primary-owners?dry_run=1|0
• dry_run=1 → 算出結果を JSON 返却のみ、Notion 書込なし
• dry_run=0 → Notion 全件 PATCH 実行
• 算出順序による件数偏りを避けるため: 2 パス処理
  • パス 1: 全件の担当者候補を仮算出
  • パス 2: 件数を整える調整（簡易ロジック: 件数多い人を減らす方向で再配分は試みない・初期実装は単純パス 1 結果を採用）
• レスポンスに { ok, total, by_owner: {小澤: N, 藤原: N, ...}, undetermined: N }

---

3. 実装 (How)

3.1 関連ファイル

• _worker.js L362-461: POST/PATCH /members に staff scores 保存追加 + 担当者算出追加
• lib/notion.js: 担当者算出ロジック（純粋関数）を追加
• members.html: 担当者表示欄追加 + フォーム送信時に staff scores を含める
• docs/requirements/primary-owner-logic.md: 本ドキュメントの正本

3.2 API エンドポイント

• POST /api/ikizama/members — 新規登録時に担当者自動算出
• PATCH /api/ikizama/members/{id} — 更新時に担当者再算出
• GET /api/ikizama/admin/recalc-primary-owners?dry_run=1|0（新規・IT 管理者のみ）— 一括再算出

3.3 Notion スキーマ変更

新規列（手動 or /admin/ensure-primary-owner-column で確保）:

• 名前: 担当者（内部互換用に 正担当 を残す場合あり）
• タイプ: select
• options: 鈴木 / 渡部 / 畠中 / 中村 / 吉田 / 小澤 / 正樹 / 藤原 / 佐々生 / 未定

3.4 外部依存

• Notion API（DB スキーマ変更・properties 更新）

3.5 既知の制限・残課題

1. 件数情報のクライアント取得: 保存時の件数把握はサーバー側で実施（クライアントへの fetch なし）
2. OTHER_DIR 同点 tie-breaker: 初期実装は配列順（渡部 → 畠中 → 中村 → 吉田 → 正樹）。運用後に固定優先順位を再決定する場合は要件追記
3. 算出順序による偏り: 初期実装は単純 1 パス。集計結果に偏りが大きければパス 2 リバランスを後追加

---

4. 変更履歴

• 2026-05-30 (続): 対象 DB を NOTION_SUPPORT_DB → NOTION_MEMBER_DB に切替。当初要件で対象を「members」と書いていたが、実装で誤って supporters DB を対象にしていた。dry_run 結果で全件 UNDETERMINED となり判明（supporters には評価がほぼ未入力だったため）。members DB は既に POST/PATCH で staff scores 保存処理あり・既存「担当1/2/3」（members.html topStaff）でクライアント側評価表示もあり、本来の対象だった。
• 2026-05-30: 初版作成（議論内容を集約）

---