Epic 3: Economy & Billing Engine (Pénzügyi Motor)

backend/app/models/audit.py

@@ -1,9 +1,12 @@
 # /opt/docker/dev/service_finder/backend/app/models/audit.py
+import enum
+import uuid
 from datetime import datetime
 from typing import Any, Optional
 from sqlalchemy import String, DateTime, JSON, ForeignKey, text, Numeric, Boolean, BigInteger, Integer
 from sqlalchemy.orm import Mapped, mapped_column, relationship
 from sqlalchemy.sql import func
+from sqlalchemy.dialects.postgresql import UUID as PG_UUID, ENUM as PG_ENUM
 from app.database import Base
 
 class SecurityAuditLog(Base):
@@ -48,6 +51,19 @@ class ProcessLog(Base):
     details: Mapped[Any] = mapped_column(JSON, server_default=text("'{}'::jsonb"))
     created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now())
 
+
+class LedgerEntryType(str, enum.Enum):
+    DEBIT = "DEBIT"
+    CREDIT = "CREDIT"
+
+
+class WalletType(str, enum.Enum):
+    EARNED = "EARNED"
+    PURCHASED = "PURCHASED"
+    SERVICE_COINS = "SERVICE_COINS"
+    VOUCHER = "VOUCHER"
+
+
 class FinancialLedger(Base):
     """ Minden pénz- és kreditmozgás központi naplója. Billing Engine alapja. """
     __tablename__ = "financial_ledger"
@@ -56,8 +72,21 @@ class FinancialLedger(Base):
     user_id: Mapped[Optional[int]] = mapped_column(Integer, ForeignKey("identity.users.id"))
     person_id: Mapped[Optional[int]] = mapped_column(BigInteger, ForeignKey("identity.persons.id"))
     amount: Mapped[float] = mapped_column(Numeric(18, 4), nullable=False)
-    currency: Mapped[Optional[str]] = mapped_column(String(10)) 
-    transaction_type: Mapped[Optional[str]] = mapped_column(String(50)) 
+    currency: Mapped[Optional[str]] = mapped_column(String(10))
+    transaction_type: Mapped[Optional[str]] = mapped_column(String(50))
     related_agent_id: Mapped[Optional[int]] = mapped_column(Integer, ForeignKey("identity.users.id"))
     details: Mapped[Any] = mapped_column(JSON, server_default=text("'{}'::jsonb"))
-    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now()) 
+    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now())
+    
+    # Új mezők double‑entry és okos levonáshoz
+    entry_type: Mapped[LedgerEntryType] = mapped_column(
+        PG_ENUM(LedgerEntryType, name="ledger_entry_type", schema="audit"),
+        nullable=False
+    )
+    balance_after: Mapped[Optional[float]] = mapped_column(Numeric(18, 4))
+    wallet_type: Mapped[Optional[WalletType]] = mapped_column(
+        PG_ENUM(WalletType, name="wallet_type", schema="audit")
+    )
+    transaction_id: Mapped[uuid.UUID] = mapped_column(
+        PG_UUID(as_uuid=True), default=uuid.uuid4, nullable=False, index=True
+    )