| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485 |
- # 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]
|