Skip to content

docs(admin): 回填司機評價可見性+修正 README 過期的「規劃中」段 - #23

Merged
thothawei merged 1 commit into
mainfrom
claude/rating-docs
Jul 27, 2026
Merged

docs(admin): 回填司機評價可見性+修正 README 過期的「規劃中」段#23
thothawei merged 1 commit into
mainfrom
claude/rating-docs

Conversation

@thothawei

Copy link
Copy Markdown
Owner

純文件,無程式碼改動。

回填

docs/TODO.md 新增「⭐ 司機評價可見性(B5 下游)」,記錄幾個容易被改掉的設計理由:

  • 排序特例:沒評分的一律排最後——0 則不代表差,不該混進低分名單(反向確認拿掉會 FAIL)。
  • 「尚無評分」而非 0.0:渲染成 0.0 顆星看起來像被評成 0 分。
  • RATING_COLOR 門檻純呈現用,不參與任何計算或派單邏輯。
  • 訂單詳情的 Ratedisabled——admin 不能改乘客給的分數。

README 端點表標明多帶的欄位;「已完成」補上車輛審核(O5)、N/O/P 下游 UI、司機評價;
測試數 107 → 123

🐛 修正 README 的過期資訊

「規劃中(尚未實作)」寫 2026-07-16 的 N/O/P 需求「都還沒實作」,
但它們已於 2026-07-22 補完(PR #21)——docs/TODO.md 的「五之二」標題本身就寫著「2026-07-22 補完」,
README 卻沒同步。

新增待辦

評分的營運動作:目前只做到「看得到」評價,還沒有低分司機的處理流程(通知/停權/申訴)。
等實際累積評分、營運說得出要做什麼再開——做在前面只會做出沒人用的流程。

🤖 Generated with Claude Code

- docs/TODO.md 新增「⭐ 司機評價可見性(B5 下游)」:評價欄的排序特例
  (沒評分排最後,0 則不代表差)、「尚無評分」而非 0.0 的理由、
  RATING_COLOR 門檻純呈現用不參與計算、訂單詳情唯讀 Rate,含真瀏覽器驗收數字。
- README 端點表標明 /admin/drivers 帶 rating_avg/rating_count、
  /admin/rides/:id 帶乘客評分;已完成清單補車輛審核、N/O/P 下游 UI、司機評價;
  測試數 107 → 123。
- **修正 README「規劃中(尚未實作)」的過期資訊**:2026-07-16 的 N/O/P 需求
  已於 2026-07-22 補完(PR #21),該段卻仍寫「都還沒實作」。
- 新增待辦:評分的營運動作(低分司機的通知/停權/申訴流程)——
  等實際累積評分、營運說得出要做什麼再開,做在前面只會做出沒人用的流程。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@thothawei
thothawei merged commit bd02a3c into main Jul 27, 2026
1 check passed
@thothawei
thothawei deleted the claude/rating-docs branch July 27, 2026 14:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant