From 48fa3bc73f138e50209be3c16dd7aa592437599b Mon Sep 17 00:00:00 2001
From: kkfluous <kkfluous@kdemacbook-air.local>
Date: Thu, 16 Apr 2026 21:23:35 +0800
Subject: [PATCH] refactor(scheduling): rewrite terminology to match core
 business logic
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Core story: 里程高的车换下来，里程少的车换上去。

- Summary cards: "里程高·需换下" / "里程低·需换走" / "替换建议"
- List tags: "换下" (amber) / "换走" (blue) with matching color bars
- Detail modal title: "里程高·换下此车" / "里程低·换走此车"
- Candidate section: explains WHY these vehicles are recommended
  - 换下: "以下车辆里程缺口大，换到该高里程客户处可加速达标"
  - 换走: "以下车辆里程已充足，可调给当前客户，将此车换走给高里程客户冲刺"
- Reason text: states current situation + clear action recommendation
  with specific numbers (已跑, 缺口, 日均, 完成率)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 src/modules/scheduling/SchedulingModule.tsx | 12 ++++++------
 src/modules/scheduling/SuggestionDetail.tsx | 18 +++++++++++++-----
 src/modules/scheduling/SuggestionList.tsx   |  6 +++---
 src/server/routes/scheduling/algorithm.ts   | 13 +++++++++++--
 4 files changed, 33 insertions(+), 16 deletions(-)

diff --git a/src/modules/scheduling/SchedulingModule.tsx b/src/modules/scheduling/SchedulingModule.tsx
index df8ecee..55cc995 100644
--- a/src/modules/scheduling/SchedulingModule.tsx
+++ b/src/modules/scheduling/SchedulingModule.tsx
@@ -183,12 +183,12 @@ export default function SchedulingModule() {
                 : 'bg-amber-50 border border-amber-100'
             }`}
           >
-            <div className="text-[10px] font-bold text-amber-700 mb-1">已达标车辆</div>
+            <div className="text-[10px] font-bold text-amber-700 mb-1">里程高·需换下</div>
             <div className="text-2xl font-black text-amber-800">
               {loading && !data ? '-' : summary?.qualifiedCount ?? 0}
               <span className="text-xs font-normal text-amber-600 ml-1">台</span>
             </div>
-            <div className="text-[9px] text-amber-600 mt-1">本年完成率 ≥ 120%</div>
+            <div className="text-[9px] text-amber-600 mt-1">已达标，换上里程少的车</div>
           </button>
 
           <button
@@ -199,12 +199,12 @@ export default function SchedulingModule() {
                 : 'bg-blue-50 border border-blue-100'
             }`}
           >
-            <div className="text-[10px] font-bold text-blue-700 mb-1">无望达标</div>
+            <div className="text-[10px] font-bold text-blue-700 mb-1">里程低·需换走</div>
             <div className="text-2xl font-black text-blue-800">
               {loading && !data ? '-' : summary?.hopelessCount ?? 0}
               <span className="text-xs font-normal text-blue-600 ml-1">台</span>
             </div>
-            <div className="text-[9px] text-blue-600 mt-1">本年完成率 &lt; 60%</div>
+            <div className="text-[9px] text-blue-600 mt-1">无法达标，调给高里程客户</div>
           </button>
 
           <button
@@ -215,13 +215,13 @@ export default function SchedulingModule() {
                 : 'bg-emerald-50 border border-emerald-100'
             }`}
           >
-            <div className="text-[10px] font-bold text-emerald-700 mb-1">可干预建议</div>
+            <div className="text-[10px] font-bold text-emerald-700 mb-1">替换建议</div>
             <div className="text-2xl font-black text-emerald-800">
               {loading && !data ? '-' : summary?.suggestionCount ?? 0}
               <span className="text-xs font-normal text-emerald-600 ml-1">条</span>
             </div>
             <div className="text-[9px] text-emerald-600 mt-1">
-              预计 +{summary?.estimatedGain ?? 0} 台可达标
+              预计 +{summary?.estimatedGain ?? 0} 台可新增达标
             </div>
           </button>
         </div>
diff --git a/src/modules/scheduling/SuggestionDetail.tsx b/src/modules/scheduling/SuggestionDetail.tsx
index 7cbd35f..1eb8e09 100644
--- a/src/modules/scheduling/SuggestionDetail.tsx
+++ b/src/modules/scheduling/SuggestionDetail.tsx
@@ -63,11 +63,11 @@ export default function SuggestionDetail({ suggestion: s, onClose, onNotifySucce
         <div className="bg-slate-800 px-4 py-3 flex items-center justify-between flex-shrink-0">
           <div className="flex items-center gap-2">
             {isRescue
-              ? <ArrowDown size={14} className="text-rose-400" />
-              : <ArrowUp size={14} className="text-emerald-400" />
+              ? <ArrowDown size={14} className="text-blue-300" />
+              : <ArrowUp size={14} className="text-amber-300" />
             }
             <span className="text-white font-bold text-sm">
-              {isRescue ? '抢救低里程' : '释放已达标'}
+              {isRescue ? '里程低·换走此车' : '里程高·换下此车'}
             </span>
           </div>
           <button onClick={onClose} className="text-slate-400 hover:text-white transition-colors p-1 cursor-pointer">
@@ -113,10 +113,18 @@ export default function SuggestionDetail({ suggestion: s, onClose, onNotifySucce
 
           {/* Candidates */}
           <div className="px-4 py-3">
-            <div className="flex items-center justify-between mb-2.5">
-              <span className="text-xs font-bold text-slate-700">推荐替换</span>
+            <div className="flex items-center justify-between mb-1">
+              <span className="text-xs font-bold text-slate-700">
+                {isRescue ? '从库存调入替换' : '换上以下里程少的车'}
+              </span>
               <span className="text-[10px] text-slate-400">{s.candidates.length} 辆可选</span>
             </div>
+            <div className="text-[10px] text-slate-400 mb-2.5">
+              {isRescue
+                ? '以下车辆里程已充足，可调给当前客户，将此车换走给高里程客户冲刺'
+                : '以下车辆里程缺口大，换到该高里程客户处可加速达标'
+              }
+            </div>
 
             <div className="space-y-2">
               {s.candidates.map(c => {
diff --git a/src/modules/scheduling/SuggestionList.tsx b/src/modules/scheduling/SuggestionList.tsx
index e3b1136..591c04d 100644
--- a/src/modules/scheduling/SuggestionList.tsx
+++ b/src/modules/scheduling/SuggestionList.tsx
@@ -38,7 +38,7 @@ export default function SuggestionList({ suggestions, onSelect }: Props) {
             onClick={() => onSelect(s)}
           >
             {/* Color bar */}
-            <div className={`w-1 h-10 rounded-full flex-shrink-0 ${isRescue ? 'bg-rose-400' : 'bg-emerald-400'}`} />
+            <div className={`w-1 h-10 rounded-full flex-shrink-0 ${isRescue ? 'bg-blue-400' : 'bg-amber-400'}`} />
 
             {/* Info */}
             <div className="flex-1 min-w-0">
@@ -47,9 +47,9 @@ export default function SuggestionList({ suggestions, onSelect }: Props) {
                   <Blur>{v.plateNumber}</Blur>
                 </span>
                 <span className={`text-[9px] px-1.5 py-px rounded font-bold ${
-                  isRescue ? 'bg-rose-50 text-rose-500' : 'bg-emerald-50 text-emerald-500'
+                  isRescue ? 'bg-blue-50 text-blue-600' : 'bg-amber-50 text-amber-600'
                 }`}>
-                  {isRescue ? '无望' : '达标'}
+                  {isRescue ? '里程低·换走' : '里程高·换下'}
                 </span>
                 <span className="text-[9px] text-slate-400">{v.vehicleType}</span>
                 <span className="text-[9px] text-slate-300">·</span>
diff --git a/src/server/routes/scheduling/algorithm.ts b/src/server/routes/scheduling/algorithm.ts
index b7d981f..b23c460 100644
--- a/src/server/routes/scheduling/algorithm.ts
+++ b/src/server/routes/scheduling/algorithm.ts
@@ -3,6 +3,11 @@ import type {
   CandidateVehicle, VehicleClassification, SchedulingSummary,
 } from './types.js';
 
+function fmtKmSimple(v: number): string {
+  if (v >= 10000) return (v / 10000).toFixed(1) + '万';
+  return Math.round(v).toLocaleString();
+}
+
 // ---------------------------------------------------------------------------
 // 1. Vehicle type compatibility
 // ---------------------------------------------------------------------------
@@ -105,7 +110,10 @@ export function generateSuggestions(
       })
       .slice(0, 5);
 
-    const reason = `${vehicle.customer}日均里程仅 ${Math.round(vehicle.customerAvgDaily)} KM，该车达标概率 ${Math.round((vehicle.predictedYearEnd / vehicle.yearTarget) * 100)}%，建议替换为已达标车辆，将此车调配给高里程客户。`;
+    const yearRate = vehicle.yearTarget > 0 ? Math.round((vehicle.currentYearMileage / vehicle.yearTarget) * 100) : 0;
+    const gap = Math.max(0, vehicle.yearTarget - vehicle.currentYearMileage);
+    const reason = `该车在客户「${vehicle.customer}」处日均仅 ${Math.round(vehicle.customerAvgDaily)} km，本年完成率 ${yearRate}%，还差 ${fmtKmSimple(gap)} km 达标，按当前速度年底无法完成。`
+      + `\n建议：将此车调配给高里程客户冲刺达标，同时从库存调一辆已达标的车给当前客户。`;
 
     suggestions.push({
       id: `hopeless-${vehicle.plateNumber}`,
@@ -156,7 +164,8 @@ export function generateSuggestions(
       .slice(0, 5);
 
     const yearRate = vehicle.yearTarget > 0 ? Math.round((vehicle.currentYearMileage / vehicle.yearTarget) * 100) : 0;
-    const reason = `${vehicle.customer}日均里程 ${Math.round(vehicle.customerAvgDaily)} KM（高里程），该车本年完成率 ${yearRate}%，建议换上里程缺口大的车辆以加速达标。`;
+    const reason = `该车在客户「${vehicle.customer}」处已达标（完成率 ${yearRate}%），客户日均 ${Math.round(vehicle.customerAvgDaily)} km，属于高里程客户。`
+      + `\n建议：将此车换下，换上一辆里程少的车，利用该客户的高日均里程帮助新车快速达标。`;
 
     suggestions.push({
       id: `qualified-${vehicle.plateNumber}`,