init

src/inventory/schemas/finance_schemas.py

@@ -0,0 +1,152 @@
+from pydantic import BaseModel, Field
+from typing import Optional, List, Literal
+from datetime import datetime
+from decimal import Decimal
+
+
+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: Decimal = Field(gt=0)
+
+
+class FinanceTransactionCreate(BaseModel):
+    amount: Decimal = 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: Decimal
+
+    class Config:
+        from_attributes = True
+
+
+class FinanceTransactionResponse(BaseModel):
+    id: int
+    txn_no: str
+    txn_type: TxnType
+    partner_type: PartnerType
+    partner_id: int
+    amount: Decimal
+    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: Decimal
+    payable_total: Decimal
+    monthly_receipt_total: Decimal
+    monthly_payment_total: Decimal
+    selected_year: int
+    selected_quarter: Optional[int] = None
+    period_label: str
+    period_receipt_total: Decimal = Decimal("0")
+    period_payment_total: Decimal = Decimal("0")
+    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: Decimal
+    received_amount: Decimal
+    receivable_amount: Decimal
+    status: str
+
+
+class PayableItemResponse(BaseModel):
+    order_id: int
+    order_no: str
+    supplier_id: int
+    supplier_name: str
+    order_date: datetime
+    total_amount: Decimal
+    paid_amount: Decimal
+    payable_amount: Decimal
+    status: str
+
+
+class PartnerStatementItemResponse(BaseModel):
+    partner_id: int
+    partner_name: str
+    order_count: int
+    transaction_count: int
+    order_total: Decimal
+    settled_total: Decimal
+    transaction_total: Decimal
+    outstanding_total: Decimal
+    period_year: int
+    period_quarter: Optional[int] = None
+
+
+class FinancePartnerStatementResponse(BaseModel):
+    partner_type: PartnerType
+    year: int
+    quarter: Optional[int] = None
+    period_label: str
+    order_total: Decimal
+    settled_total: Decimal
+    transaction_total: Decimal
+    outstanding_total: Decimal
+    items: List[PartnerStatementItemResponse] = []
+
+
+class PartnerProductStatementItemResponse(BaseModel):
+    partner_id: int
+    partner_name: str
+    product_id: int
+    product_sku: Optional[str] = None
+    product_name: str
+    order_count: int
+    order_quantity: Decimal
+    order_amount: Decimal
+    settled_amount: Decimal
+    outstanding_amount: Decimal
+    period_year: int
+    period_quarter: Optional[int] = None
+
+
+class FinancePartnerProductStatementResponse(BaseModel):
+    partner_type: PartnerType
+    year: int
+    quarter: Optional[int] = None
+    period_label: str
+    partner_id: Optional[int] = None
+    order_amount_total: Decimal
+    settled_amount_total: Decimal
+    outstanding_amount_total: Decimal
+    items: List[PartnerProductStatementItemResponse] = []