fix(dashboard): 修复普通用户落地页与待办角色过滤

- 新增 router/access.ts 统一准入与落地页（工作台→业务数据→回款），
  守卫/登录回跳/菜单/面包屑复用；普通用户不再被无限重定向
- 待办按角色映射在途审批节点（财务/领导/admin），admin 不代办但可查全部
- 预警排除已终止业务；WarningBlock.total 为全量命中数；回款趋势改日期范围
- 工作台加载请求序号防竞态；KPI 口径说明补经理分成/调整单
- 新增 role_home_flow e2e，更新 system_management 普通用户断言

Co-Authored-By: Claude Code <noreply@anthropic.com>

backend/app/repositories/dashboard_repository.py

@@ -7,7 +7,7 @@
 
 from datetime import date, datetime
 
-from sqlalchemy import exists, func, select
+from sqlalchemy import exists, func, or_, select
 from sqlalchemy.orm import Session
 
 from app.models import (
@@ -66,12 +66,18 @@ def performance_trend(session: Session, months: list[str]) -> dict[str, object]:
     return dict(rows)
 
 
-def receipt_trend(session: Session, months: list[str]) -> dict[str, object]:
-    """近 N 个月回款合计（按到账月，含未核算回款——与台账口径不同，页面注明）。"""
+def receipt_trend(
+    session: Session, *, start_date: date, end_date: date
+) -> dict[str, object]:
+    """近 N 个月回款合计（按到账月，含未核算回款——与台账口径不同，页面注明）。
+
+    过滤走 ``receipt_date`` 原始列范围（可用索引）；``DATE_FORMAT`` 只用于
+    分组，不参与 WHERE，避免函数列导致全表扫描。
+    """
     month_expr = func.date_format(Receipt.receipt_date, "%Y-%m")
     rows = session.execute(
         select(month_expr, func.coalesce(func.sum(Receipt.amount), 0))
-        .where(month_expr.in_(months))
+        .where(Receipt.receipt_date >= start_date, Receipt.receipt_date < end_date)
         .group_by(month_expr)
     ).all()
     return dict(rows)
@@ -101,24 +107,33 @@ def get_month_settlement(session: Session, month: str) -> MonthlySettlement | No
 
 # ==== 待办事项 ====
 
-def list_pending_approvals(session: Session, *, limit: int) -> list[ApprovalOrder]:
-    """待处理审批单（按提交时间升序——最久的排前面）。"""
+def list_pending_approvals(
+    session: Session, *, statuses: tuple[int, ...], limit: int
+) -> list[ApprovalOrder]:
+    """待处理审批单（按提交时间升序——最久的排前面）。
+
+    ``statuses`` 由调用方按当前用户角色解析（待我审批），空元组返回空列表。
+    """
+    if not statuses:
+        return []
     return list(
         session.execute(
             select(ApprovalOrder)
-            .where(ApprovalOrder.status.in_(_PENDING_STATUSES))
+            .where(ApprovalOrder.status.in_(statuses))
             .order_by(ApprovalOrder.create_time.asc(), ApprovalOrder.id.asc())
             .limit(limit)
         ).scalars()
     )
 
 
-def count_pending_approvals(session: Session) -> int:
+def count_pending_approvals(session: Session, *, statuses: tuple[int, ...]) -> int:
+    if not statuses:
+        return 0
     return int(
         session.execute(
             select(func.count())
             .select_from(ApprovalOrder)
-            .where(ApprovalOrder.status.in_(_PENDING_STATUSES))
+            .where(ApprovalOrder.status.in_(statuses))
         ).scalar_one()
     )
 
@@ -152,7 +167,11 @@ def count_unassigned_receipts(session: Session) -> int:
 # ==== 风险预警 ====
 
 def list_overdue_shipments(session: Session, *, cutoff: date, limit: int) -> list:
-    """发货后超过阈值且该批次无任何回款的发货单（回款逾期规则）。"""
+    """发货后超过阈值且该批次无任何回款的发货单（回款逾期规则）。
+
+    已终止业务（status=3）不再催收，排除在预警之外；业务行缺失时仍保留，
+    避免历史脏数据让发货单从预警中静默消失。
+    """
     has_receipt = exists().where(Receipt.shipment_id == Shipment.id)
     return list(
         session.execute(
@@ -161,7 +180,11 @@ def list_overdue_shipments(session: Session, *, cutoff: date, limit: int) -> lis
                 Business.business_no.label("business_no"),
             )
             .outerjoin(Business, Business.id == Shipment.business_id)
-            .where(Shipment.ship_date <= cutoff, ~has_receipt)
+            .where(
+                Shipment.ship_date <= cutoff,
+                ~has_receipt,
+                or_(Business.status.is_(None), Business.status != 3),
+            )
             .order_by(Shipment.ship_date.asc())
             .limit(limit)
         ).all()
@@ -174,7 +197,12 @@ def count_overdue_shipments(session: Session, *, cutoff: date) -> int:
         session.execute(
             select(func.count())
             .select_from(Shipment)
-            .where(Shipment.ship_date <= cutoff, ~has_receipt)
+            .outerjoin(Business, Business.id == Shipment.business_id)
+            .where(
+                Shipment.ship_date <= cutoff,
+                ~has_receipt,
+                or_(Business.status.is_(None), Business.status != 3),
+            )
         ).scalar_one()
     )