merge: integrate ZSY customer service and profile capabilities

app/api/controllers/admin.py

@@ -22,6 +22,8 @@ from app.core.contracts import RequestContext
 from app.core.profile_governance_contracts import ProfileDriftReviewRequest
 from app.service.admin_service import AdminService
 from app.service.allocation_backtest_service import AllocationBacktestService
+from app.service.customer_profile_candidate_service import CustomerProfileCandidateService
+from app.service.customer_service_handover_admin_service import CustomerServiceHandoverAdminService
 from app.service.profile_governance_service import ProfileGovernanceService
 
 router = APIRouter(
@@ -204,3 +206,45 @@ async def audit_records(
 ) -> dict[str, Any]:
     """审计查询（文档 §9.6 支持游标过滤）。游标非法时返回 `400 INVALID_CURSOR`。"""
     return await AdminService().query("audit-records", context, limit=limit, cursor=cursor)
+
+
+@router.get("/customer-service/handover-tickets")
+async def list_customer_service_handover_tickets(
+    limit: int = Query(default=20, ge=1, le=100),
+    cursor: str | None = Query(default=None),
+    context: RequestContext = Depends(build_request_context),  # noqa: B008
+) -> dict[str, Any]:
+    """只读查看客服待转人工队列；不暴露原始会话或处理动作。"""
+    return await CustomerServiceHandoverAdminService().list_tickets(
+        context, limit=limit, cursor=cursor
+    )
+
+
+@router.get("/customer-service/handover-tickets/{ticket_no}")
+async def get_customer_service_handover_ticket(
+    ticket_no: str,
+    context: RequestContext = Depends(build_request_context),  # noqa: B008
+) -> dict[str, Any]:
+    """只读查看单个工单的脱敏转接摘要。"""
+    return await CustomerServiceHandoverAdminService().get_ticket(ticket_no, context)
+
+
+@router.get("/customer-profile-candidates")
+async def list_customer_profile_candidates(
+    limit: int = Query(default=20, ge=1, le=100),
+    context: RequestContext = Depends(build_request_context),  # noqa: B008
+) -> dict[str, Any]:
+    """管理员查看待确认或待审核的画像候选。"""
+    return await CustomerProfileCandidateService().list_for_admin(context, limit=limit)
+
+
+@router.post("/customer-profile-candidates/{candidate_id}/reviews", status_code=200)
+async def review_customer_profile_candidate(
+    candidate_id: int,
+    payload: ReviewPayload,
+    context: RequestContext = Depends(build_request_context),  # noqa: B008
+) -> dict[str, Any]:
+    """管理员批准或驳回候选；批准会处理同键旧正式记忆。"""
+    return await CustomerProfileCandidateService().review_by_admin(
+        candidate_id, payload.decision, context, comment=payload.comment
+    )