feat: 添加 points_audit_ledger 及 JSON 字段 Pydantic Schema 约束

backend/src/models/register_bonus_claims.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+import uuid
+
+from sqlalchemy import ForeignKey, String, Text, UniqueConstraint
+from sqlalchemy.dialects.postgresql import UUID
+from sqlalchemy.orm import Mapped, mapped_column
+
+from core.db.base import Base, TimestampMixin
+
+
+class RegisterBonusClaims(TimestampMixin, Base):
+    __tablename__ = "register_bonus_claims"
+    __table_args__ = (
+        UniqueConstraint("email_hash", name="uq_register_bonus_claims_email_hash"),
+        UniqueConstraint(
+            "grant_event_id", name="uq_register_bonus_claims_grant_event_id"
+        ),
+    )
+
+    id: Mapped[uuid.UUID] = mapped_column(
+        UUID(as_uuid=True),
+        primary_key=True,
+        default=uuid.uuid4,
+    )
+    email_hash: Mapped[str] = mapped_column(String(64), nullable=False)
+    user_email_snapshot: Mapped[str] = mapped_column(Text, nullable=False)
+    first_user_id: Mapped[uuid.UUID | None] = mapped_column(
+        UUID(as_uuid=True),
+        ForeignKey("auth.users.id", ondelete="SET NULL"),
+        nullable=True,
+    )
+    grant_event_id: Mapped[str] = mapped_column(String(64), nullable=False)