修改过时文档，优化文档内容

pages/mall/delivery/doc/old(弃用)/earnings.md

@@ -0,0 +1,92 @@
+# earnings.uvue — 收入明细
+
+## 概要
+按 `order_no` 聚合展示配送员收入明细（配送费、用户打赏、商家打赏），支持分页加载与按时间区间统计。
+
+## 数据结构
+- `EarningItem`
+  - `id: string`
+  - `order_no: string`
+  - `date: string`
+  - `amount: number`
+  - `source: 'delivery_fee' | 'user_tip' | 'merchant_tip' | string`
+  - `distance?: number`
+
+- `OrderEarning`
+  - `order_no: string`
+  - `date: string`
+  - `distance?: number`
+  - `totalAmount: number`
+  - `details: EarningItem[]`
+
+## 关键方法
+- `loadAllEarnings()`
+  - 从后端或本地数据源取原始 `EarningItem[]`，按 `order_no` 聚合成 `OrderEarning[]`。
+  - 对每个 `OrderEarning.details` 补齐三类来源占位项（amount=0），以保证前端渲染顺序稳定。
+
+- `calculateTotalStats()`
+  - 计算 `totalEarnings`, `totalUserTips`, `totalMerchantTips`。
+
+- `loadPage()` / `loadMore()`
+  - 基于 `pageSize` 控制分页渲染，避免一次性载入全部历史记录。
+
+## 聚合示例（核心）
+```
+const orderMap = new Map()
+raw.forEach(item => {
+  let order = orderMap.get(item.order_no)
+  if (!order) {
+    order = { order_no: item.order_no, date: item.date, distance: item.distance, totalAmount: 0, details: [] }
+    orderMap.set(item.order_no, order)
+  }
+  order.totalAmount += Number(item.amount || 0)
+  order.details.push(item)
+})
+// 补齐三类来源
+orderMap.forEach(order => {
+  const has = type => order.details.some(d => d.source === type)
+  ;['delivery_fee','merchant_tip','user_tip'].forEach(t => { if (!has(t)) order.details.push({ id: `${order.order_no}_${t}`, order_no: order.order_no, amount: 0, source: t }) })
+})
+const result = Array.from(orderMap.values())
+```
+
+## 接口 / DB 建议
+- 推荐后端提供按订单聚合的接口：
+  - GET `/api/driver/{id}/earnings?start=&end=&page=&size=`
+  - 返回 `OrderEarning[]` 已聚合的数据以减轻前端压力
+
+## 数据源更新：包含已接订单（Accepted）
+- 需求说明：为了与“历史订单”页面保持一致，收入统计应包含配送员已接取（accepted/assigned）的订单，不仅限于已完成订单。也就是说，只要 `ml_delivery_tasks` 中 `driver_id` = 当前司机且 `status >= 2`（已接取或进行中），其对应的订单都应计入收入统计范围。
+
+- 需求说明（已采纳）：收入统计以 `ml_delivery_tasks` 为数据源之一：只要任务记录显示 `driver_id` = 当前司机且 `status >= 2`（已接取或进行中），其对应订单即应计入统计范围。注意：部分 `ml_delivery_tasks` 可能没有可匹配的 `ml_orders`（`order_id` 为空或在 `ml_orders` 中找不到），页面/后端应对缺失 `order_no` 做回退显示并记录供核查。
+
+- 推荐 Supabase 查询示例（后端或前端按需实现）：
+
+```
+-- 查询分配给当前司机且已接取的任务对应的订单ID
+SELECT DISTINCT order_id FROM ml_delivery_tasks WHERE driver_id = :driverId AND status >= 2;
+
+-- 基于 order_id 查询订单及收入项（示例：ml_orders + ml_delivery_tips）
+SELECT o.id,o.order_no,o.created_at,o.distance,o.delivery_fee, t.amount as tip_amount, 'user_tip' as tip_source
+FROM ml_orders o
+LEFT JOIN ml_delivery_tips t ON t.order_id = o.id
+WHERE o.id IN (<order_id_list>)
+ORDER BY o.created_at DESC
+LIMIT :size OFFSET :offset;
+```
+
+- 若在前端直接使用 `supabase-js`：
+
+```js
+const taskRes = await supa.from('ml_delivery_tasks').select('order_id').eq('driver_id', uid).gte('status', 2).execute()
+const orderIds = taskRes.data.map(r => r.order_id)
+// 对于 order_id 为空或找不到的情况，server 端应记录这些 id 以便排查
+const ordersRes = await supa.from('ml_orders').select('*,ml_delivery_tips(*)').in('id', orderIds).order('created_at',{ascending:false}).limit(size).execute()
+```
+
+注意：若订单很多，务必在后端做分页/聚合以减轻客户端开销。
+
+## 注意事项
+- 在金额计算中使用整数 cents 或 BigInt 或固定小数处理，避免浮点误差。
+- 大量数据应后端分页/聚合并支持过滤（按时间、按来源）。
+