增加财务模块

src/api/inventory/schemas/finance_schemas.py

@@ -0,0 +1,94 @@
+from pydantic import BaseModel, Field
+from typing import Optional, List, Literal
+from datetime import datetime
+
+
+TxnType = Literal["receipt", "payment"]
+PartnerType = Literal["customer", "supplier"]
+OrderType = Literal["sales", "purchase"]
+TxnStatus = Literal["confirmed", "voided"]
+
+
+class FinanceAllocationCreate(BaseModel):
+    order_type: OrderType
+    order_id: int
+    allocated_amount: float = Field(gt=0)
+
+
+class FinanceTransactionCreate(BaseModel):
+    amount: float = Field(gt=0)
+    txn_date: Optional[datetime] = None
+    method: str = "bank"
+    account_name: Optional[str] = None
+    remark: Optional[str] = None
+    allocations: List[FinanceAllocationCreate]
+
+
+class ReceiptCreate(FinanceTransactionCreate):
+    customer_id: int
+
+
+class PaymentCreate(FinanceTransactionCreate):
+    supplier_id: int
+
+
+class FinanceAllocationResponse(BaseModel):
+    id: int
+    order_type: str
+    order_id: int
+    allocated_amount: float
+
+    class Config:
+        from_attributes = True
+
+
+class FinanceTransactionResponse(BaseModel):
+    id: int
+    txn_no: str
+    txn_type: TxnType
+    partner_type: PartnerType
+    partner_id: int
+    amount: float
+    txn_date: datetime
+    method: str
+    account_name: Optional[str]
+    status: TxnStatus
+    remark: Optional[str]
+    created_at: datetime
+    allocations: List[FinanceAllocationResponse] = []
+
+    class Config:
+        from_attributes = True
+
+
+class FinanceSummaryResponse(BaseModel):
+    receivable_total: float
+    payable_total: float
+    monthly_receipt_total: float
+    monthly_payment_total: float
+    overdue_receivable_count: int = 0
+    overdue_payable_count: int = 0
+
+
+class ReceivableItemResponse(BaseModel):
+    order_id: int
+    order_no: str
+    customer_id: int
+    customer_name: str
+    order_date: datetime
+    total_amount: float
+    received_amount: float
+    receivable_amount: float
+    status: str
+
+
+class PayableItemResponse(BaseModel):
+    order_id: int
+    order_no: str
+    supplier_id: int
+    supplier_name: str
+    order_date: datetime
+    total_amount: float
+    paid_amount: float
+    payable_amount: float
+    status: str