settlement.py 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  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: Optional[str] = Field("partner_a", description="合伙人甲方用户ID")
  9. partner_b_id: Optional[str] = Field("partner_b", 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. role_description: str # 如: 合伙人分红 / 社交直客提成 / 中介渠道提成 / 技术版权费
  18. gross_amount: int # 应得分润(分)
  19. fault_penalty: int # 过错赔偿冲销扣减(分)
  20. net_payout: int # 实际最终应支付转账金额(分)
  21. class SettlementOrderDetailOut(BaseModel):
  22. order_id: str
  23. channel_type: str
  24. agency_id: Optional[str]
  25. handler_id: Optional[str]
  26. developer_id: Optional[str]
  27. order_amount: int
  28. avg_cost: int
  29. net_profit: int
  30. tech_fee: int
  31. sales_fee: int
  32. pool_fee: int
  33. partner_a_amount: int
  34. partner_b_amount: int
  35. class SettlementPeriodOut(BaseModel):
  36. id: str
  37. name: str
  38. start_date: datetime
  39. end_date: datetime
  40. total_orders: int
  41. total_revenue: int
  42. total_cost: int
  43. avg_cost: int
  44. net_profit: int
  45. status: str
  46. summary_data: Optional[Dict[str, Any]]
  47. confirmed_by: Optional[str]
  48. confirmed_at: Optional[datetime]
  49. paid_at: Optional[datetime]
  50. created_at: datetime
  51. model_config = {"from_attributes": True}
  52. class SettlementPreviewResponse(BaseModel):
  53. period_range: str
  54. total_orders: int
  55. total_revenue: int
  56. total_cost: int
  57. avg_cost: int
  58. net_profit: int
  59. payout_summary: List[SettlementPayoutItem]
  60. cost_breakdown: Dict[str, int]
  61. details: List[SettlementOrderDetailOut]