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)