taiyi
9b32afdbb4
覆盖所有模块： - api 层：17 个路由文件，每个接口标注用途、参数、返回值、权限 - services 层：18 个服务文件，每个方法标注作用、参数、返回值、调用方 - repositories 层：13 个仓储文件，每个方法标注查询逻辑和被调用方 - schemas 层：11 个请求/响应体文件，每个字段标注业务含义 - core 层：config、security、exceptions、responses、error_codes - models 层：19 个 ORM 模型类，每个表标注业务含义和关联关系 - scripts：bootstrap_data、smoke_check - migrations：env.py 和版本迁移文件 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
94 lines
3.9 KiB
Python
94 lines
3.9 KiB
Python
"""销售流程相关API路由。
|
||
|
||
提供销售流程概览接口，汇总展示订单列表、待审核项、物流轨迹、
|
||
AI识别记录及统计数据，供前端流程看板使用。
|
||
"""
|
||
|
||
from fastapi import APIRouter, Depends
|
||
from sqlalchemy.orm import Session
|
||
|
||
from backend.app.api.deps import require_permissions, require_roles
|
||
from backend.app.db import get_db_session
|
||
from backend.app.schemas.common import success_payload
|
||
from backend.app.services.order_service import OrderService
|
||
|
||
router = APIRouter(prefix='/api/orders', tags=['sales-flow']) # 订单模块路由，挂载在 /api/orders 路径下
|
||
|
||
|
||
@router.get('/flow-overview')
|
||
def flow_overview(
|
||
order_service: OrderService = Depends(),
|
||
session: Session = Depends(get_db_session),
|
||
current_user: dict = Depends(require_roles('salesman', 'manager', 'admin')),
|
||
_permission_user: dict = Depends(require_permissions('order:list')),
|
||
) -> dict:
|
||
"""销售流程概览接口。
|
||
|
||
汇总返回订单概览数据，包括：
|
||
- orders: 最近10条订单摘要列表
|
||
- review_items: 待审核/已审核订单项
|
||
- traces: 物流轨迹节点
|
||
- ai_items: AI识别附件记录
|
||
- notices: 通知公告（预留）
|
||
- stats: 各状态订单统计数据（草稿/待审核/履约中）
|
||
|
||
Args:
|
||
order_service: 订单服务实例，通过依赖注入获取。
|
||
session: 数据库会话，通过依赖注入获取。
|
||
current_user: 当前登录用户信息，要求为 salesman/manager/admin 角色。
|
||
_permission_user: 权限校验，要求拥有 order:list 权限。
|
||
|
||
Returns:
|
||
dict: 包含 orders、review_items、traces、ai_items、notices、stats 的统一响应体。
|
||
"""
|
||
orders = order_service.list_orders(session, order_service.normalize_list_filters({}, current_user))
|
||
detail_orders = [order_service.get_order(item['order_id'], session, current_user) for item in orders[:5]]
|
||
detail_orders = [item for item in detail_orders if item]
|
||
review_items = []
|
||
traces = []
|
||
ai_items = []
|
||
notices = []
|
||
for item in detail_orders:
|
||
if item.get('order_status') in {'pending_approve', 'approved'}:
|
||
review_items.append({
|
||
'orderNo': item.get('order_no'),
|
||
'customerName': item.get('customer_name'),
|
||
'amount': f"{item.get('sale_price_total', 0):.2f}",
|
||
})
|
||
trace_list = item.get('logistics_info', {}).get('trace_list', [])
|
||
for trace in trace_list[:2]:
|
||
traces.append({
|
||
'title': f"订单 {item.get('order_no')} 物流节点",
|
||
'detail': trace.get('node_desc') or trace.get('remark') or '物流节点更新',
|
||
'time': trace.get('node_time') or '',
|
||
})
|
||
for attach in item.get('attachments', [])[:1]:
|
||
ai_items.append({
|
||
'name': attach.get('file_name') or '识别附件',
|
||
'raw': item.get('customer_name', ''),
|
||
'corrected': item.get('customer_name', ''),
|
||
})
|
||
pending_count = sum(1 for item in orders if item.get('order_status') == 'pending_approve')
|
||
draft_count = sum(1 for item in orders if item.get('order_status') == 'draft')
|
||
fulfillment_count = sum(1 for item in orders if item.get('order_status') in {'approved', 'pending_factory', 'pending_delivery', 'delivering'})
|
||
return success_payload({
|
||
'orders': [
|
||
{
|
||
'order_no': item.get('order_no'),
|
||
'customer_name': item.get('customer_name'),
|
||
'order_status': item.get('order_status'),
|
||
'sale_price_total': item.get('sale_price_total', 0),
|
||
}
|
||
for item in orders[:10]
|
||
],
|
||
'review_items': review_items,
|
||
'traces': traces,
|
||
'ai_items': ai_items,
|
||
'notices': notices,
|
||
'stats': {
|
||
'draft': draft_count,
|
||
'pending': pending_count,
|
||
'fulfillment': fulfillment_count,
|
||
},
|
||
})
|