增加财务模块

src/api/inventory/schemas/__init__.py

@@ -14,6 +14,17 @@ from .sales_order_schemas import (
     SalesOrderResponse, 
     SalesOrderItemCreate
 )
+from .finance_schemas import (
+    FinanceAllocationCreate,
+    FinanceTransactionCreate,
+    ReceiptCreate,
+    PaymentCreate,
+    FinanceAllocationResponse,
+    FinanceTransactionResponse,
+    FinanceSummaryResponse,
+    ReceivableItemResponse,
+    PayableItemResponse
+)
 
 __all__ = [
     "ProductCreate", "ProductResponse",
@@ -24,4 +35,8 @@ __all__ = [
     "StockMovementCreate", "StockMovementResponse",
     "PurchaseOrderCreate", "PurchaseOrderResponse", "PurchaseOrderItemCreate",
     "SalesOrderCreate", "SalesOrderResponse", "SalesOrderItemCreate",
+    "FinanceAllocationCreate", "FinanceTransactionCreate",
+    "ReceiptCreate", "PaymentCreate",
+    "FinanceAllocationResponse", "FinanceTransactionResponse",
+    "FinanceSummaryResponse", "ReceivableItemResponse", "PayableItemResponse",
 ]

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