# app/schemas/settlement.py from datetime import datetime from typing import Optional, List, Dict, Any from pydantic import BaseModel, Field class SettlementPreviewRequest(BaseModel): start_date: datetime = Field(..., description="统计账期起始时间") end_date: datetime = Field(..., description="统计账期结束时间") partner_a_id: str = Field(..., description="合伙人甲方用户ID (必须指定系统真实用户)") partner_b_id: str = Field(..., description="合伙人乙方用户ID (必须指定系统真实用户)") default_developer_id: Optional[str] = Field(None, description="已废弃:技术分成按订单商品绑定的插件开发管理者自动归属") class SettlementConfirmRequest(SettlementPreviewRequest): period_id: str = Field(..., description="账期ID,如 2026-10") period_name: str = Field(..., description="账期显示名称,如 2026年10月月结") notes: Optional[str] = Field(None, description="结算备注") class SettlementPayoutItem(BaseModel): user_id: str user_name: Optional[str] = None # 真实姓名/昵称 role_description: str # 如: 合伙人分红 / 社交直客提成 / 中介渠道提成 / 技术版权费 gross_amount: int # 应得分润(分) fault_penalty: int # 过错赔偿冲销扣减(分) net_payout: int # 实际最终应支付转账金额(分) currency: str = "CNY" # 币种代码 (CNY, EUR, USD等) class SettlementOrderDetailOut(BaseModel): order_id: str channel_type: str agency_id: Optional[str] = None handler_id: Optional[str] = None handler_name: Optional[str] = None developer_id: Optional[str] = None developer_name: Optional[str] = None order_amount: int currency: str = "CNY" # 订单流水实际币种 (CNY, EUR, USD等) gross_amount: Optional[int] = None # 用户实付流水总额(分) fee_amount: int = 0 # 扣除的通道手续费(分) original_amount: Optional[int] = None original_currency: Optional[str] = None avg_cost: int net_profit: int tech_fee: int sales_fee: int pool_fee: int partner_a_amount: int partner_b_amount: int class SettlementPeriodOut(BaseModel): id: str name: str start_date: datetime end_date: datetime total_orders: int total_revenue: int total_cost: int avg_cost: int net_profit: int status: str summary_data: Optional[Dict[str, Any]] confirmed_by: Optional[str] confirmed_at: Optional[datetime] paid_at: Optional[datetime] created_at: datetime model_config = {"from_attributes": True} class SettlementPreviewResponse(BaseModel): period_range: str total_orders: int total_revenue: int total_cost: int avg_cost: int net_profit: int revenue_by_currency: Optional[Dict[str, int]] = None profit_by_currency: Optional[Dict[str, int]] = None payout_summary: List[SettlementPayoutItem] cost_breakdown: Dict[str, int] details: List[SettlementOrderDetailOut]