SES Proposals Admin Guide
Review the SES proposals collected in GIIP, check each one's FDE score and advice, and send the proposal email to the target contact — all from a single admin screen.
📋 Overview
The SES Proposals admin page lists the SES (freelance engineer staffing) proposals gathered in GIIP as a table. For each proposal you can review its status, FDE score / advice, and full content, then queue the proposal email to the registered target contact. The underlying data comes from the SES proposal store; this screen is the operator's cockpit for reviewing and dispatching them.
⚠️ This is an admin-only screen. Access requires administrator level
uLevel >= 70. Users below that level are redirected to the home page.
🔍 Screen layout
1. Top header
- Page title: "SES Proposals" (localized).
- Refresh button: reloads the proposal list from the server.
2. Status filter
A dropdown at the top filters the list by processing status:
| Filter value | Meaning |
|---|---|
| (All) | Show every proposal regardless of status |
| pending | Collected, not yet analyzed |
| analyzing | FDE analysis in progress |
| sent | Proposal email has been sent |
| failed | Sending or processing failed |
3. Proposal table
Each row shows one proposal:
| Column | Description |
|---|---|
| spSn | Proposal serial number (internal ID) |
| SES name | Name of the SES / engineer |
| Title | Proposal title — click to open the detail modal |
| Status | Colored badge (pending / analyzing / sent / failed) |
| FDE score | Automated fit score, shown as NN/100 (or - if not scored) |
| Registered | Registration date/time (shown in your local time) |
| Actions | Detail and, when applicable, Send mail |
4. Detail modal
Clicking a title (or Detail) opens a modal with the full proposal: spSn, SES name, title, target email, status, FDE score, FDE advice, full proposal content, email-sent timestamp, and registration date. From here you can also send the mail directly.
🛠️ How to send a proposal email
- Find the proposal in the list (use the status filter to narrow down, e.g.
pending). - Click Detail to review the content, target email, and FDE advice.
- Click Send mail. A confirmation dialog appears — confirm to proceed.
- The request is queued (
SESMailQueuePut). On success you'll see a success message and the list refreshes; the status moves toward sent. - The Send mail action is available only for proposals in
pending,analyzing, orfailedstatus. Proposals alreadysentdo not show the button.
💡 Notes
- FDE score / advice is generated by the automated FDE analysis pipeline. A
-score means the proposal hasn't been analyzed yet. - Sending is asynchronous: "Send mail" enqueues the email; the actual delivery is handled by the mail-queue worker, so the status may update on a later refresh.
- Because access is guarded by DB mode (
mcMinLevel), the exact required level is read from menu configuration but is capped at 70 to prevent admin lockout.
API 참조
This page talks to the backend through two dispatch commands (via fetchAzureCommand). There is no separate API guide, so the essentials are described here.
| Command | Purpose | Key parameters |
|---|---|---|
SESProposalList | Fetch the proposal list | procStatus (optional filter), limit (e.g. 100) |
SESMailQueuePut | Queue the proposal email for one proposal | spSn (proposal serial number) |
- Both commands return a result set plus an
RstValstatus field.RstVal = 200means success;RstVal = 403means the session expired or you lack permission (log in again). - The list SP returns the data table and the
RstValtable as separate result sets; the client reads the first (data) table.
Troubleshooting
| Symptom | Cause | Resolution |
|---|---|---|
| Redirected to home immediately | Your uLevel is below 70 | Sign in with an administrator account (level 70+). |
| "Session expired" / 403 error | Auth token expired or missing | Log in again, then press Refresh. |
| List is empty | No proposals match the current filter | Switch the status filter to (All) or register/collect proposals first. |
FDE score shows - | Proposal not analyzed yet | Wait for the FDE pipeline to run, then Refresh. |
| Send mail button missing | Proposal is already sent | Sent proposals cannot be re-queued from this screen. |
| Top guide button (📖) not visible | Guide mapping missing (older deploy) | It appears once this guide is deployed and indexed. |
Version: 1.0
Last updated: 2026-08-02
Source file: giipv3/public/help/ses-proposals.en.md