86 lines
3.6 KiB
Python
86 lines
3.6 KiB
Python
|
"""客户申报投顾方案 + 投顾受理审批 的 HTTP 入口（`docs/05` 未登记的 AD 段新端点）。
|
|||
|
|
|
|||
|
|
| 段 | 端点 | 权限码 | 摘要 |
|
|||
|
|
|---|---|---|---|
|
|||
|
|
| 客户 | `POST /api/v1/users/me/advisor-requests` | `advisor-request:write:self` | 提交申报 |
|
|||
|
|
| 客户 | `GET /api/v1/users/me/advisor-requests` | `advisor-request:read:self` | 我的申报（含状态） |
|
|||
|
|
| 投顾 | `GET /api/v1/advisor/service-requests` | `advisor-request:read` | 名下客户的申报队列 |
|
|||
|
|
| 投顾 | `POST /api/v1/advisor/service-requests/{request_no}/reviews` | `advisor-request:review` | 受理 / 驳回 |
|
|||
|
|
|
|||
|
|
客户侧刻意**不挂投顾灰度闸门**（`enforce_advisor_rollout`）—— 那是投顾业务的灰度，
|
|||
|
|
客户提交自己的服务申请不该被它拦下；投顾侧照旧挂上。
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
from __future__ import annotations
|
|||
|
|
|
|||
|
|
from fastapi import APIRouter, Depends, Header, Path
|
|||
|
|
|
|||
|
|
from app.api.dependencies.auth import build_request_context
|
|||
|
|
from app.api.dependencies.rate_limit import enforce_rate_limit
|
|||
|
|
from app.core.contracts import RequestContext
|
|||
|
|
from app.core.errors import ValidationAgentError
|
|||
|
|
from app.service.advisor_rollout_service import enforce_advisor_rollout
|
|||
|
|
from app.service.advisor_service_request_service import (
|
|||
|
|
AdvisorServiceRequestCreate,
|
|||
|
|
AdvisorServiceRequestService,
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
client_router = APIRouter(
|
|||
|
|
prefix="/api/v1/users/me",
|
|||
|
|
tags=["advisor-service-requests"],
|
|||
|
|
dependencies=[Depends(enforce_rate_limit)],
|
|||
|
|
)
|
|||
|
|
advisor_router = APIRouter(
|
|||
|
|
prefix="/api/v1/advisor",
|
|||
|
|
tags=["advisor-service-requests"],
|
|||
|
|
dependencies=[Depends(enforce_rate_limit), Depends(enforce_advisor_rollout)],
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
|
|||
|
|
@client_router.post("/advisor-requests")
|
|||
|
|
async def create_advisor_request(
|
|||
|
|
payload: AdvisorServiceRequestCreate,
|
|||
|
|
context: RequestContext = Depends(build_request_context), # noqa: B008
|
|||
|
|
key: str | None = Header(default=None, alias="Idempotency-Key"),
|
|||
|
|
) -> dict[str, object]:
|
|||
|
|
"""客户主动申报投顾方案（需已完成且未过期的风险测评）。"""
|
|||
|
|
return await AdvisorServiceRequestService().create(payload, context, key)
|
|||
|
|
|
|||
|
|
|
|||
|
|
@client_router.get("/advisor-requests")
|
|||
|
|
async def my_advisor_requests(
|
|||
|
|
context: RequestContext = Depends(build_request_context), # noqa: B008
|
|||
|
|
) -> dict[str, object]:
|
|||
|
|
"""我的申报单（待受理 / 已受理 / 已发送 / 已驳回）。"""
|
|||
|
|
return await AdvisorServiceRequestService().list_mine(context)
|
|||
|
|
|
|||
|
|
|
|||
|
|
@advisor_router.get("/service-requests")
|
|||
|
|
async def advisor_service_request_queue(
|
|||
|
|
context: RequestContext = Depends(build_request_context), # noqa: B008
|
|||
|
|
) -> dict[str, object]:
|
|||
|
|
"""名下客户提交的申报队列（待受理排前面）。"""
|
|||
|
|
return await AdvisorServiceRequestService().queue(context)
|
|||
|
|
|
|||
|
|
|
|||
|
|
@advisor_router.post("/service-requests/{request_no}/reviews")
|
|||
|
|
async def review_advisor_service_request(
|
|||
|
|
payload: dict[str, object],
|
|||
|
|
request_no: str = Path(min_length=8, max_length=32),
|
|||
|
|
context: RequestContext = Depends(build_request_context), # noqa: B008
|
|||
|
|
key: str | None = Header(default=None, alias="Idempotency-Key"),
|
|||
|
|
) -> dict[str, object]:
|
|||
|
|
"""受理（**自动生成方案草稿**）或驳回客户的申报。
|
|||
|
|
|
|||
|
|
受理后投顾仍需走既有的「审核通过 → 发送给客户」，方案才会到客户手里。
|
|||
|
|
"""
|
|||
|
|
decision = payload.get("decision")
|
|||
|
|
if decision not in {"accepted", "rejected"}:
|
|||
|
|
raise ValidationAgentError("decision 必须为 accepted 或 rejected")
|
|||
|
|
comment = payload.get("comment", "")
|
|||
|
|
if not isinstance(comment, str):
|
|||
|
|
raise ValidationAgentError("comment 必须是字符串")
|
|||
|
|
return await AdvisorServiceRequestService().review(
|
|||
|
|
request_no, str(decision), comment, context, key
|
|||
|
|
)
|