SES提案書管理ガイド
GIIPに収集されたSES提案書を確認し、各提案書のFDEスコアとアドバイスをチェックしたうえで、対象担当者へ提案メールを送信する作業を、ひとつの管理者画面で行います。
📋 概要
SES提案書管理ページは、GIIPに収集されたSES(フリーランスエンジニアのソーシング)提案書を表形式で表示します。各提案書のステータス、FDEスコア/アドバイス、本文全体を確認し、登録された対象担当者へ**提案メールを送信(キュー投入)**できます。データはSES提案書ストアから取得され、この画面は運用者が提案書を確認・送信するための管制画面です。
⚠️ この画面は管理者専用です。 アクセスには管理者レベル
uLevel >= 70が必要です。それ未満のユーザーはホームへリダイレクトされます。
🔍 画面構成
1. 上部ヘッダー
- ページタイトル: 「SES提案書管理」(ローカライズ済み)。
- 更新ボタン: サーバーから提案書一覧を再読み込みします。
2. ステータスフィルター
上部のドロップダウンで処理ステータス別に一覧を絞り込みます。
| フィルター値 | 意味 |
|---|---|
| (すべて) | ステータスに関わらず全提案書を表示 |
| pending | 収集済み、未分析 |
| analyzing | FDE分析中 |
| sent | 提案メール送信済み |
| failed | 送信または処理に失敗 |
3. 提案書テーブル
各行が1件の提案書を表します。
| 列 | 説明 |
|---|---|
| spSn | 提案書シリアル番号(内部ID) |
| SES名 | SES/エンジニアの名前 |
| タイトル | 提案書タイトル — クリックで詳細モーダルを開く |
| ステータス | 色付きバッジ(pending / analyzing / sent / failed) |
| FDEスコア | 自動適合度スコア、NN/100 形式(未採点は -) |
| 登録日 | 登録日時(ユーザーのローカル時刻で表示) |
| 操作 | 詳細、条件を満たす場合は メール送信 |
4. 詳細モーダル
タイトル(または 詳細)をクリックすると、提案書全体を表示するモーダルが開きます: spSn、SES名、タイトル、対象メール、ステータス、FDEスコア、FDEアドバイス、提案書本文、メール送信時刻、登録日。このモーダルから直接メールを送信することもできます。
🛠️ 提案メールの送信方法
- 一覧で提案書を探します(ステータスフィルターで絞り込み、例:
pending)。 - 詳細を押して本文、対象メール、FDEアドバイスを確認します。
- メール送信をクリックします。確認ダイアログが表示されるので、確認して進めます。
- リクエストがキューに投入されます(
SESMailQueuePut)。成功すると成功メッセージが表示され一覧が更新され、ステータスが sent へ移行します。 - メール送信操作は
pending、analyzing、failedステータスの提案書でのみ利用できます。すでにsentの提案書にはボタンが表示されません。
💡 補足
- FDEスコア/アドバイスは自動FDE分析パイプラインが生成します。スコアが
-の場合はまだ分析されていない提案書です。 - 送信は非同期です:「メール送信」はメールをキューに入れるだけで、実際の配信はメールキューワーカーが処理するため、ステータスは後の更新時に反映されることがあります。
- アクセスがDBモード(
mcMinLevel)で保護されるため、必要レベルはメニュー設定から読み取られますが、管理者ロックアウトを防ぐため70で上限が適用されます。
API 参照
このページは2つのディスパッチコマンド(fetchAzureCommand 経由)でバックエンドと通信します。専用のAPIガイドがないため、要点をここに記載します。
| コマンド | 用途 | 主なパラメータ |
|---|---|---|
SESProposalList | 提案書一覧の取得 | procStatus(任意フィルター)、limit(例: 100) |
SESMailQueuePut | 特定提案書の提案メールをキューに投入 | spSn(提案書シリアル番号) |
- 両コマンドとも結果セットに加えて
RstValステータスフィールドを返します。RstVal = 200は成功、RstVal = 403はセッション失効または権限なし(再ログインが必要)を意味します。 - 一覧SPはデータテーブルと
RstValテーブルを別々の結果セットで返し、クライアントは最初の(データ)テーブルを読み取ります。
トラブルシューティング
| 症状 | 原因 | 解決 |
|---|---|---|
| アクセス直後にホームへ戻される | uLevel が70未満 | 管理者アカウント(レベル70+)でログインしてください。 |
| 「セッション失効」/ 403 エラー | 認証トークンの失効または欠落 | 再ログイン後、更新を押してください。 |
| 一覧が空 | 現在のフィルターに一致する提案書がない | ステータスフィルターを(すべて)に変えるか、先に提案書を収集/登録してください。 |
FDEスコアが - | まだ分析されていない | FDEパイプラインの実行を待ってから更新してください。 |
| メール送信ボタンがない | すでに sent ステータス | 送信済みの提案書はこの画面から再送信できません。 |
| 上部のガイドボタン(📖)が見えない | ガイドマッピング欠落(旧バージョン配備) | このガイドが配備・インデックス化されると表示されます。 |
バージョン: 1.0
最終更新: 2026-08-02
ソースファイル: giipv3/public/help/ses-proposals.ja.md