A R R R Associates
169 lines
12 KiB
Python
169 lines
12 KiB
Python
from __future__ import annotations
|
|
|
|
from datetime import date, datetime, timezone
|
|
from decimal import Decimal
|
|
|
|
from sqlalchemy import Boolean, Date, DateTime, ForeignKey, Integer, Numeric, String, Text, UniqueConstraint
|
|
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
|
|
|
from app.core.db.common import CommonBase
|
|
|
|
|
|
class PlatformPlan(CommonBase):
|
|
__tablename__ = "platform_plans"
|
|
__table_args__ = (UniqueConstraint("code", name="uq_platform_plans_code"),)
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
code: Mapped[str] = mapped_column(String(80), nullable=False, index=True)
|
|
name: Mapped[str] = mapped_column(String(200), nullable=False)
|
|
target_account_type: Mapped[str] = mapped_column(String(30), nullable=False, default="AUDIT_FIRM", index=True)
|
|
billing_cycle: Mapped[str] = mapped_column(String(20), nullable=False, default="Monthly", index=True)
|
|
base_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
gst_rate: Mapped[Decimal] = mapped_column(Numeric(5, 2), nullable=False, default=Decimal("18.00"))
|
|
description: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
is_active: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True, index=True)
|
|
created_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), nullable=False)
|
|
updated_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), onupdate=lambda: datetime.now(timezone.utc), nullable=False)
|
|
|
|
features = relationship("PlatformPlanFeature", back_populates="plan", cascade="all, delete-orphan", order_by="PlatformPlanFeature.sort_order.asc()")
|
|
subscriptions = relationship("PlatformSubscription", back_populates="plan")
|
|
|
|
|
|
class PlatformPlanFeature(CommonBase):
|
|
__tablename__ = "platform_plan_features"
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
plan_id: Mapped[int] = mapped_column(ForeignKey("platform_plans.id", ondelete="CASCADE"), nullable=False, index=True)
|
|
feature_code: Mapped[str] = mapped_column(String(100), nullable=False, index=True)
|
|
feature_name: Mapped[str] = mapped_column(String(200), nullable=False)
|
|
limit_value: Mapped[str | None] = mapped_column(String(100), nullable=True)
|
|
is_enabled: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True)
|
|
sort_order: Mapped[int] = mapped_column(Integer, nullable=False, default=1)
|
|
|
|
plan = relationship("PlatformPlan", back_populates="features")
|
|
|
|
|
|
class PlatformBillingAccount(CommonBase):
|
|
__tablename__ = "platform_billing_accounts"
|
|
__table_args__ = (UniqueConstraint("account_type", "account_code", name="uq_platform_billing_accounts_type_code"),)
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
account_type: Mapped[str] = mapped_column(String(30), nullable=False, index=True) # AUDIT_FIRM|CLIENT|CONSULTANT|MARKETPLACE_CUSTOMER
|
|
account_code: Mapped[str] = mapped_column(String(80), nullable=False, index=True)
|
|
display_name: Mapped[str] = mapped_column(String(220), nullable=False, index=True)
|
|
|
|
tenant_id: Mapped[int | None] = mapped_column(ForeignKey("tenants.id", ondelete="SET NULL"), nullable=True, index=True)
|
|
client_id: Mapped[int | None] = mapped_column(ForeignKey("clients.id", ondelete="SET NULL"), nullable=True, index=True)
|
|
consultant_id: Mapped[int | None] = mapped_column(ForeignKey("consultant_profiles.id", ondelete="SET NULL"), nullable=True, index=True)
|
|
|
|
email: Mapped[str | None] = mapped_column(String(255), nullable=True)
|
|
mobile: Mapped[str | None] = mapped_column(String(20), nullable=True)
|
|
gstin: Mapped[str | None] = mapped_column(String(20), nullable=True)
|
|
pan: Mapped[str | None] = mapped_column(String(20), nullable=True)
|
|
billing_address: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
state: Mapped[str | None] = mapped_column(String(100), nullable=True)
|
|
status: Mapped[str] = mapped_column(String(20), nullable=False, default="ACTIVE", index=True)
|
|
notes: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
|
|
created_by_user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), nullable=True)
|
|
updated_by_user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), nullable=True)
|
|
created_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), nullable=False)
|
|
updated_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), onupdate=lambda: datetime.now(timezone.utc), nullable=False)
|
|
|
|
subscriptions = relationship("PlatformSubscription", back_populates="account")
|
|
invoices = relationship("PlatformInvoice", back_populates="account")
|
|
|
|
|
|
class PlatformSubscription(CommonBase):
|
|
__tablename__ = "platform_subscriptions"
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
account_id: Mapped[int] = mapped_column(ForeignKey("platform_billing_accounts.id", ondelete="CASCADE"), nullable=False, index=True)
|
|
plan_id: Mapped[int] = mapped_column(ForeignKey("platform_plans.id", ondelete="RESTRICT"), nullable=False, index=True)
|
|
subscription_code: Mapped[str] = mapped_column(String(100), nullable=False, index=True)
|
|
start_date: Mapped[date] = mapped_column(Date, nullable=False, default=date.today)
|
|
end_date: Mapped[date | None] = mapped_column(Date, nullable=True)
|
|
billing_cycle: Mapped[str] = mapped_column(String(20), nullable=False, default="Monthly", index=True)
|
|
amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
gst_rate: Mapped[Decimal] = mapped_column(Numeric(5, 2), nullable=False, default=Decimal("18.00"))
|
|
status: Mapped[str] = mapped_column(String(20), nullable=False, default="ACTIVE", index=True)
|
|
auto_generate_invoice: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True)
|
|
notes: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
created_by_user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), nullable=True)
|
|
created_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), nullable=False)
|
|
updated_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), onupdate=lambda: datetime.now(timezone.utc), nullable=False)
|
|
|
|
account = relationship("PlatformBillingAccount", back_populates="subscriptions")
|
|
plan = relationship("PlatformPlan", back_populates="subscriptions")
|
|
|
|
|
|
class PlatformInvoice(CommonBase):
|
|
__tablename__ = "platform_invoices"
|
|
__table_args__ = (UniqueConstraint("invoice_no", name="uq_platform_invoices_invoice_no"),)
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
account_id: Mapped[int] = mapped_column(ForeignKey("platform_billing_accounts.id", ondelete="RESTRICT"), nullable=False, index=True)
|
|
subscription_id: Mapped[int | None] = mapped_column(ForeignKey("platform_subscriptions.id", ondelete="SET NULL"), nullable=True, index=True)
|
|
invoice_no: Mapped[str] = mapped_column(String(80), nullable=False, index=True)
|
|
invoice_date: Mapped[date] = mapped_column(Date, nullable=False, default=date.today, index=True)
|
|
due_date: Mapped[date | None] = mapped_column(Date, nullable=True, index=True)
|
|
billing_period_from: Mapped[date | None] = mapped_column(Date, nullable=True)
|
|
billing_period_to: Mapped[date | None] = mapped_column(Date, nullable=True)
|
|
tax_type: Mapped[str] = mapped_column(String(20), nullable=False, default="CGST_SGST")
|
|
subtotal: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
discount_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
taxable_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
cgst_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
sgst_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
igst_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
total_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
status: Mapped[str] = mapped_column(String(20), nullable=False, default="DRAFT", index=True)
|
|
notes: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
created_by_user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), nullable=True)
|
|
posted_by_user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), nullable=True)
|
|
posted_at_utc: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
|
|
created_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), nullable=False)
|
|
updated_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), onupdate=lambda: datetime.now(timezone.utc), nullable=False)
|
|
|
|
account = relationship("PlatformBillingAccount", back_populates="invoices")
|
|
subscription = relationship("PlatformSubscription")
|
|
lines = relationship("PlatformInvoiceLine", back_populates="invoice", cascade="all, delete-orphan", order_by="PlatformInvoiceLine.sort_order.asc()")
|
|
|
|
|
|
class PlatformInvoiceLine(CommonBase):
|
|
__tablename__ = "platform_invoice_lines"
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
invoice_id: Mapped[int] = mapped_column(ForeignKey("platform_invoices.id", ondelete="CASCADE"), nullable=False, index=True)
|
|
charge_type: Mapped[str] = mapped_column(String(40), nullable=False, default="SUBSCRIPTION", index=True)
|
|
description: Mapped[str] = mapped_column(String(500), nullable=False)
|
|
reference_type: Mapped[str | None] = mapped_column(String(60), nullable=True)
|
|
reference_id: Mapped[int | None] = mapped_column(Integer, nullable=True)
|
|
quantity: Mapped[Decimal] = mapped_column(Numeric(12, 2), nullable=False, default=Decimal("1.00"))
|
|
rate: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
discount_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
taxable_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
gst_rate: Mapped[Decimal] = mapped_column(Numeric(5, 2), nullable=False, default=Decimal("18.00"))
|
|
cgst_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
sgst_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
igst_amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
line_total: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False, default=Decimal("0.00"))
|
|
sort_order: Mapped[int] = mapped_column(Integer, nullable=False, default=1)
|
|
|
|
invoice = relationship("PlatformInvoice", back_populates="lines")
|
|
|
|
|
|
class PlatformPayment(CommonBase):
|
|
__tablename__ = "platform_payments"
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
invoice_id: Mapped[int] = mapped_column(ForeignKey("platform_invoices.id", ondelete="CASCADE"), nullable=False, index=True)
|
|
account_id: Mapped[int] = mapped_column(ForeignKey("platform_billing_accounts.id", ondelete="RESTRICT"), nullable=False, index=True)
|
|
payment_date: Mapped[date] = mapped_column(Date, nullable=False, default=date.today, index=True)
|
|
amount: Mapped[Decimal] = mapped_column(Numeric(14, 2), nullable=False)
|
|
mode: Mapped[str] = mapped_column(String(30), nullable=False, default="Bank")
|
|
reference_no: Mapped[str | None] = mapped_column(String(100), nullable=True)
|
|
notes: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
created_by_user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), nullable=True)
|
|
created_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), nullable=False)
|