72077908f1
Ship fleet, availability, pricing, dispatch, routing, tracking, and settlement on delivery-service 0.10.8.0 with migrations and phase tests green. Co-authored-by: Cursor <cursoragent@cursor.com>
79 lines
2.8 KiB
Python
79 lines
2.8 KiB
Python
"""Settlement aggregates — Phase 10.8.
|
|
|
|
Uses AccountingProvider protocol refs only — NO journal entries in delivery_db.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import uuid
|
|
from decimal import Decimal
|
|
|
|
from sqlalchemy import Index, Numeric, String, Text, UniqueConstraint
|
|
from sqlalchemy.orm import Mapped, mapped_column
|
|
from sqlalchemy.types import JSON
|
|
|
|
from app.core.database import Base
|
|
from app.models.base import (
|
|
ActorAuditMixin,
|
|
OptimisticLockMixin,
|
|
SoftDeleteMixin,
|
|
TenantMixin,
|
|
TimestampMixin,
|
|
UUIDPrimaryKeyMixin,
|
|
)
|
|
from app.models.types import GUID, SettlementIntentStatus, SettlementLineKind
|
|
|
|
|
|
class SettlementIntent(
|
|
Base,
|
|
UUIDPrimaryKeyMixin,
|
|
TenantMixin,
|
|
TimestampMixin,
|
|
SoftDeleteMixin,
|
|
ActorAuditMixin,
|
|
OptimisticLockMixin,
|
|
):
|
|
__tablename__ = "settlement_intents"
|
|
|
|
organization_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
|
|
code: Mapped[str] = mapped_column(String(50), nullable=False)
|
|
status: Mapped[SettlementIntentStatus] = mapped_column(
|
|
default=SettlementIntentStatus.DRAFT, nullable=False
|
|
)
|
|
driver_id: Mapped[uuid.UUID | None] = mapped_column(GUID(), nullable=True)
|
|
dispatch_job_id: Mapped[uuid.UUID | None] = mapped_column(GUID(), nullable=True)
|
|
external_settlement_ref: Mapped[str | None] = mapped_column(
|
|
String(255), nullable=True
|
|
)
|
|
total_amount: Mapped[Decimal] = mapped_column(Numeric(18, 4), nullable=False)
|
|
currency_code: Mapped[str] = mapped_column(String(3), nullable=False, default="IRR")
|
|
notes: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
metadata_json: Mapped[dict | None] = mapped_column(JSON, nullable=True)
|
|
|
|
__table_args__ = (
|
|
UniqueConstraint("tenant_id", "code", name="uq_settlement_intents_tenant_code"),
|
|
Index("ix_settlement_intents_tenant_status", "tenant_id", "status"),
|
|
Index("ix_settlement_intents_tenant_deleted", "tenant_id", "is_deleted"),
|
|
)
|
|
|
|
|
|
class SettlementLine(
|
|
Base,
|
|
UUIDPrimaryKeyMixin,
|
|
TenantMixin,
|
|
TimestampMixin,
|
|
SoftDeleteMixin,
|
|
ActorAuditMixin,
|
|
):
|
|
__tablename__ = "settlement_lines"
|
|
|
|
settlement_intent_id: Mapped[uuid.UUID] = mapped_column(GUID(), nullable=False)
|
|
kind: Mapped[SettlementLineKind] = mapped_column(nullable=False)
|
|
description: Mapped[str | None] = mapped_column(String(255), nullable=True)
|
|
amount: Mapped[Decimal] = mapped_column(Numeric(18, 4), nullable=False)
|
|
currency_code: Mapped[str] = mapped_column(String(3), nullable=False, default="IRR")
|
|
metadata_json: Mapped[dict | None] = mapped_column(JSON, nullable=True)
|
|
|
|
__table_args__ = (
|
|
Index("ix_settlement_lines_intent", "tenant_id", "settlement_intent_id"),
|
|
)
|