fc / apps /automation /api /preservation_quote_api.py
jun2024's picture
Upload 2241 files
b4f2238 verified
Raw History Blame Contribute Delete
7.69 kB
"""
财产保全询价 API
提供财产保全担保费询价的 RESTful API 接口:
- POST /preservation-quotes - 创建询价任务
- GET /preservation-quotes - 列表查询
- GET /preservation-quotes/{id} - 获取详情
- POST /preservation-quotes/{id}/execute - 执行任务
"""
import logging
# Exceptions are handled by global exception handlers
import math
from typing import Any
from django.http import HttpRequest
from django.utils.translation import gettext_lazy as _
from ninja import Router
from ninja_jwt.authentication import JWTAuth
from apps.automation.schemas import (
PreservationQuoteCreateSchema,
PreservationQuoteSchema,
QuoteExecuteResponseSchema,
QuoteListItemSchema,
QuoteListSchema,
)
logger = logging.getLogger("apps.automation")
# 创建路由器,使用 JWT 认证
router = Router(tags=["财产保全询价"], auth=JWTAuth())
def _get_preservation_quote_service() -> Any:
from apps.core.dependencies import build_preservation_quote_service
return build_preservation_quote_service()
@router.post("/preservation-quotes", response=PreservationQuoteSchema)
def create_preservation_quote(request: HttpRequest, data: PreservationQuoteCreateSchema) -> PreservationQuoteSchema:
"""
创建询价任务
创建一个新的财产保全担保费询价任务。任务创建后状态为 PENDING,
需要调用执行接口来实际执行询价。
**请求参数:**
- preserve_amount: 保全金额(必须为正数)
- corp_id: 企业/法院ID
- category_id: 分类ID (cPid)
- credential_id: 账号凭证ID
**响应:**
返回创建的询价任务详情
**错误码:**
- VALIDATION_ERROR: 数据验证失败
"""
# 创建 Service 实例(使用工厂函数)
service = _get_preservation_quote_service()
# 调用 Service 方法
quote = service.create_quote( # type: ignore[attr-defined]
preserve_amount=data.preserve_amount,
corp_id=data.corp_id,
category_id=data.category_id,
credential_id=data.credential_id,
)
# 返回响应
return PreservationQuoteSchema.from_model(quote)
@router.get("/preservation-quotes", response=QuoteListSchema)
def list_preservation_quotes(
request: HttpRequest, page: int = 1, page_size: int | None = None, status: str | None = None
) -> QuoteListSchema:
"""
列表查询询价任务
分页查询询价任务列表,支持按状态筛选。
**查询参数:**
- page: 页码(从 1 开始,默认 1)
- page_size: 每页数量(默认 20,最大 100)
- status: 状态筛选(可选)
- pending: 等待中
- running: 执行中
- success: 成功
- partial_success: 部分成功
- failed: 失败
**响应:**
返回分页的任务列表,包含总数、页码等信息
"""
# 创建 Service 实例(使用工厂函数)
service = _get_preservation_quote_service()
actual_page_size = page_size or 20
# 调用 Service 方法(参数验证在 Service 层)
result = service.list_quotes( # type: ignore[attr-defined]
page=page,
page_size=actual_page_size,
status=status,
)
# adapter 返回 dict,兼容直接返回 (quotes, total) 元组的实现
if isinstance(result, dict):
quotes = result.get("quotes", [])
total = result.get("total", 0)
else:
quotes, total = result
# 计算总页数
total_pages = math.ceil(total / actual_page_size) if total > 0 else 0
# 转换为 Schema
items = [QuoteListItemSchema.from_model(quote) for quote in quotes]
# 返回响应
return QuoteListSchema(
total=total,
page=page,
page_size=actual_page_size,
total_pages=total_pages,
items=items,
)
@router.get("/preservation-quotes/{quote_id}", response=PreservationQuoteSchema)
def get_preservation_quote(request: HttpRequest, quote_id: int) -> PreservationQuoteSchema:
"""
获取询价任务详情
获取指定询价任务的详细信息,包括所有保险公司的报价记录。
**路径参数:**
- quote_id: 询价任务ID
**响应:**
返回询价任务详情,包含所有保险公司报价列表
**错误码:**
- NOT_FOUND: 任务不存在
"""
# 创建 Service 实例(使用工厂函数)
service = _get_preservation_quote_service()
# 调用 Service 方法
quote = service.get_quote(quote_id) # type: ignore[attr-defined]
# 返回响应
return PreservationQuoteSchema.from_model(quote)
@router.post("/preservation-quotes/{quote_id}/execute", response=QuoteExecuteResponseSchema)
async def execute_preservation_quote(request: HttpRequest, quote_id: int) -> QuoteExecuteResponseSchema:
"""
执行询价任务
执行指定的询价任务,系统会:
1. 检查 Token 是否有效
2. 获取保险公司列表
3. 并发查询所有保险公司报价
4. 保存报价结果
**注意:**
- 如果 Token 不存在或已过期,会返回错误提示,需要先到 /admin/automation/testcourt/ 获取 Token
- 执行过程是异步的,可能需要几秒到几十秒
- 单个保险公司查询失败不会影响其他查询
**路径参数:**
- quote_id: 询价任务ID
**响应:**
返回执行结果,包含成功/失败统计
**错误码:**
- NOT_FOUND: 任务不存在
- TOKEN_ERROR: Token 相关错误
- FETCH_COMPANIES_FAILED: 获取保险公司列表失败
"""
# 创建 Service 实例(使用工厂函数)
service = _get_preservation_quote_service()
# 执行询价(异步)
result = await service.execute_quote(quote_id) # type: ignore[attr-defined]
# 获取更新后的任务详情
quote = service.get_quote(quote_id) # type: ignore[attr-defined]
# 返回响应
return QuoteExecuteResponseSchema(
success=True,
message=_("询价任务执行完成,成功 %(success)d 个,失败 %(failed)d 个")
% {"success": result["success_count"], "failed": result["failed_count"]},
data=PreservationQuoteSchema.from_model(quote),
)
@router.post("/preservation-quotes/{quote_id}/retry", response=QuoteExecuteResponseSchema)
async def retry_preservation_quote(request: HttpRequest, quote_id: int) -> QuoteExecuteResponseSchema:
"""
重试询价任务
重新执行失败或部分成功的询价任务。系统会:
1. 检查任务状态是否允许重试
2. 重置任务状态
3. 重新执行完整的询价流程
**注意:**
- 只有失败或部分成功的任务可以重试
- 重试会使用最新的Token和账号策略
- 之前的报价记录会被保留
**路径参数:**
- quote_id: 询价任务ID
**响应:**
返回重试执行结果
**错误码:**
- NOT_FOUND: 任务不存在
- VALIDATION_ERROR: 任务状态不允许重试
- TOKEN_ERROR: Token 相关错误
"""
# 创建 Service 实例(使用工厂函数)
service = _get_preservation_quote_service()
# 重试询价(异步)
result = await service.retry_quote(quote_id) # type: ignore[attr-defined]
# 获取更新后的任务详情
quote = service.get_quote(quote_id) # type: ignore[attr-defined]
# 返回响应
return QuoteExecuteResponseSchema(
success=True,
message=_("重试询价任务完成,成功 %(success)d 个,失败 %(failed)d 个")
% {"success": result["success_count"], "failed": result["failed_count"]},
data=PreservationQuoteSchema.from_model(quote),
)