settlement.py 3.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485
  1. # app/schemas/settlement.py
  2. from datetime import datetime
  3. from typing import Optional, List, Dict, Any
  4. from pydantic import BaseModel, Field
  5. class SettlementPreviewRequest(BaseModel):
  6. start_date: datetime = Field(..., description="统计账期起始时间")
  7. end_date: datetime = Field(..., description="统计账期结束时间")
  8. partner_a_id: str = Field(..., description="合伙人甲方用户ID (必须指定系统真实用户)")
  9. partner_b_id: str = Field(..., description="合伙人乙方用户ID (必须指定系统真实用户)")
  10. default_developer_id: Optional[str] = Field(None, description="已废弃:技术分成按订单商品绑定的插件开发管理者自动归属")
  11. class SettlementConfirmRequest(SettlementPreviewRequest):
  12. period_id: str = Field(..., description="账期ID,如 2026-10")
  13. period_name: str = Field(..., description="账期显示名称,如 2026年10月月结")
  14. notes: Optional[str] = Field(None, description="结算备注")
  15. class SettlementPayoutItem(BaseModel):
  16. user_id: str
  17. user_name: Optional[str] = None # 真实姓名/昵称
  18. role_description: str # 如: 合伙人分红 / 社交直客提成 / 中介渠道提成 / 技术版权费
  19. gross_amount: int # 应得分润(分)
  20. fault_penalty: int # 过错赔偿冲销扣减(分)
  21. net_payout: int # 实际最终应支付转账金额(分)
  22. currency: str = "CNY" # 币种代码 (CNY, EUR, USD等)
  23. class SettlementOrderDetailOut(BaseModel):
  24. order_id: str
  25. channel_type: str
  26. agency_id: Optional[str] = None
  27. handler_id: Optional[str] = None
  28. handler_name: Optional[str] = None
  29. developer_id: Optional[str] = None
  30. developer_name: Optional[str] = None
  31. order_amount: int
  32. currency: str = "CNY" # 订单流水实际币种 (CNY, EUR, USD等)
  33. gross_amount: Optional[int] = None # 用户实付流水总额(分)
  34. fee_amount: int = 0 # 扣除的通道手续费(分)
  35. original_amount: Optional[int] = None
  36. original_currency: Optional[str] = None
  37. avg_cost: int
  38. net_profit: int
  39. tech_fee: int
  40. sales_fee: int
  41. pool_fee: int
  42. partner_a_amount: int
  43. partner_b_amount: int
  44. class SettlementPeriodOut(BaseModel):
  45. id: str
  46. name: str
  47. start_date: datetime
  48. end_date: datetime
  49. total_orders: int
  50. total_revenue: int
  51. total_cost: int
  52. avg_cost: int
  53. net_profit: int
  54. status: str
  55. summary_data: Optional[Dict[str, Any]]
  56. confirmed_by: Optional[str]
  57. confirmed_at: Optional[datetime]
  58. paid_at: Optional[datetime]
  59. created_at: datetime
  60. model_config = {"from_attributes": True}
  61. class SettlementPreviewResponse(BaseModel):
  62. period_range: str
  63. total_orders: int
  64. total_revenue: int
  65. total_cost: int
  66. avg_cost: int
  67. net_profit: int
  68. revenue_by_currency: Optional[Dict[str, int]] = None
  69. profit_by_currency: Optional[Dict[str, int]] = None
  70. payout_summary: List[SettlementPayoutItem]
  71. cost_breakdown: Dict[str, int]
  72. details: List[SettlementOrderDetailOut]