SES 提案管理指南
在單一管理員介面中審閱 GIIP 收集的 SES 提案,查看每份提案的 FDE 評分與建議,然後向目標聯絡人寄送提案郵件。
📋 概觀
SES 提案管理頁面以表格形式列出 GIIP 收集的 SES(自由工程師採購)提案。你可以查看每份提案的狀態、FDE 評分/建議及完整內文,然後向已登錄的目標聯絡人寄送提案郵件(排入佇列)。資料來自 SES 提案庫;此介面是營運者審閱並派送提案的控制台。
⚠️ 這是僅限管理員的介面。 存取需要管理員層級
uLevel >= 70。低於該層級的使用者會被重新導向到首頁。
🔍 介面配置
1. 頂部標題列
- 頁面標題:「SES 提案管理」(已在地化)。
- 重新整理按鈕:從伺服器重新載入提案清單。
2. 狀態篩選
頂部下拉選單依處理狀態篩選清單:
| 篩選值 | 意義 |
|---|---|
| (全部) | 顯示所有提案,不論狀態 |
| pending | 已收集,尚未分析 |
| analyzing | FDE 分析進行中 |
| sent | 提案郵件已寄送 |
| failed | 寄送或處理失敗 |
3. 提案表格
每一列代表一份提案:
| 欄位 | 說明 |
|---|---|
| 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 參考
本頁面透過兩個派發命令(透過 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.zh-TW.md