Quote Bid - Submit Or Update Review
type: frontend_operation
status: observed
last_verified: 2026-05-14
environment: staging
source_page: Dashboard Projects Quote Detail
這個操作回答什麼
這份文件描述 consumer 在 quote bid 詳情聊天頁,如何提交或更新 provider 評價,以及前端實際打出的 API。
起始頁面
- 頁面:../頁面/dashboard__projects_quote_detail
- URL pattern:
https://staging.pro360.com.tw/dashboard/projects/quote/{quote_request_id}/{quote_bid_id}示範:
https://staging.pro360.com.tw/dashboard/projects/quote/21234/2147686109進入方式
首頁
-> 我的需求
-> https://staging.pro360.com.tw/dashboard/projects/quotelist/21235
-> 已聯繫的專家區塊
-> 點選一位專家
-> 進入案件聊天詳情頁
-> 點 provider 名稱右側「更多」
-> 點「評論專家」操作可見條件
評論專家 只會在 consumer 已確認雇用該 provider 後出現。
已知必要條件:
- consumer / requestor 已登入。
- quote bid 已聯繫 provider。
- consumer 已確認雇用此專家。
截圖
更多功能選單:
![[前端操作觀測/附件/screenshots/dashboard__projects_quote_detail/more_menu_review_2026-05-14.png]]
評價結果畫面:
![[前端操作觀測/附件/screenshots/dashboard__projects_quote_detail/review_result_2026-05-14.png]]
觸發方式
- 以 consumer 身份登入 staging。
- 進入案件聊天詳情頁。
- 確認該 bid 已聯繫 provider,且 consumer 已確認雇用該 provider。
- 點擊 provider 名稱右側的
更多。 - 在「更多功能」選單點擊
評論專家。 - 前端開啟評價流程或評價表單。
- 選擇星等,例如 5 顆星。
- 輸入評價文字,例如
非常好!!。 - 可選擇 tag,例如:
技術優良價格公道溝通良好專業度高
- 可上傳附件圖片。
- 送出。
API Sequence
| 順序 | Method | API | 觸發時機 | 成功 response | 備註 |
|---|---|---|---|---|---|
| 1 | POST | POST__quote_bids__change_status__reviews__quote_bid_id | 從「更多功能」->「評論專家」送出評價表單 | {"status":"Success"} | 若同一 actor 已評價過,後端更新既有 feedback |
Request 觀測摘要
POST https://api-staging.pro360.com.tw/quote_bids/change_status/reviews/2147686109.json主要 body:
| 欄位 | 範例 | 說明 |
|---|---|---|
is_satisfied | 5 | 星等 |
feedback | 非常好!! | 評價文字 |
FeedbackAttachment[0] | https://d3coohax1msd4e.cloudfront.net/...png | 評價附件 |
tag[0..n] | 技術優良 等 | 評價 tag |
成功畫面
- 聊天內出現或更新評價卡片。
- 卡片文案可能是:
您給好棒棒專業團隊的評價您更新好棒棒專業團隊的評價
- 右側服務評價列表可以看到最新評價。
失敗畫面
| 情況 | 後端 response | 前端預期 |
|---|---|---|
| 未聯繫 provider 就評價 | {"error":19,"status":"您必須先與專家聯繫後才能評價專家"} | 顯示錯誤 |
缺少 is_satisfied | {"status":"error"} | 顯示錯誤 |
| CORS / Network error | 無 response body | 通常顯示泛用錯誤 |
DB / Log 驗證範例
2026-05-14 實測:
quote_feedbacks.id = 2031quote_feedbacks.foreign_id = 2147686109quote_feedbacks.feedback = 非常好!!quote_feedbacks.tag = ["技術優良","價格公道","溝通良好","專業度高"]quote_feedback_attachments.id = 116event_queue_log_4.event_key = Update_Reviewevent_queue_log_4.status_id = 1
待確認
- 前端首次評價時是否一定顯示新增文案。
更多/評論專家的可見條件。- 多附件上傳的前端上限是否跟後端 3 張一致。