# 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: Optional[str] = Field("partner_a", description="合伙人甲方用户ID") partner_b_id: Optional[str] = Field("partner_b", 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 role_description: str # 如: 合伙人分红 / 社交直客提成 / 中介渠道提成 / 技术版权费 gross_amount: int # 应得分润(分) fault_penalty: int # 过错赔偿冲销扣减(分) net_payout: int # 实际最终应支付转账金额(分) class SettlementOrderDetailOut(BaseModel): order_id: str channel_type: str agency_id: Optional[str] handler_id: Optional[str] developer_id: Optional[str] order_amount: int 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 payout_summary: List[SettlementPayoutItem] cost_breakdown: Dict[str, int] details: List[SettlementOrderDetailOut]