81 lines
4.8 KiB
Python
81 lines
4.8 KiB
Python
from sqlalchemy import Float, ForeignKey, Index, Integer, String, text
|
|
from sqlalchemy.orm import Mapped, mapped_column
|
|
|
|
from app.models.base import Base, TimestampMixin
|
|
|
|
|
|
class CreditRecord(Base, TimestampMixin):
|
|
__tablename__ = "credit_records"
|
|
__table_args__ = (
|
|
# 正式计费幂等键：同一用户同一个业务流水只能写入一次。
|
|
# PostgreSQL/MySQL/SQLite 对 nullable unique 的处理都允许多条 NULL，兼容历史数据。
|
|
Index("uq_credit_records_user_biz_key", "user_id", "biz_key", unique=True),
|
|
Index("ix_credit_records_user_refund_for_biz_key", "user_id", "refund_for_biz_key"),
|
|
Index(
|
|
"uq_credit_records_user_refund_target",
|
|
"user_id",
|
|
"refund_for_biz_key",
|
|
unique=True,
|
|
postgresql_where=text("type = 'refund' AND refund_for_biz_key IS NOT NULL"),
|
|
),
|
|
Index("ix_credit_records_related_type", "related_id", "type"),
|
|
Index("ix_credit_records_owner", "owner_type", "owner_id"),
|
|
Index("ix_credit_records_subject_media", "credit_subject", "media_type"),
|
|
Index("ix_credit_records_source_module_scene", "source_module", "billing_scene"),
|
|
Index("ix_credit_records_user_kind_time", "user_type_snapshot", "frontend_user_kind_snapshot", "created_at"),
|
|
Index("ix_credit_records_team_time", "team_id_snapshot", "created_at"),
|
|
Index("ix_credit_records_user_kind_team_time", "user_type_snapshot", "frontend_user_kind_snapshot", "team_id_snapshot", "created_at"),
|
|
)
|
|
|
|
id: Mapped[str] = mapped_column(String(32), primary_key=True)
|
|
user_id: Mapped[str] = mapped_column(
|
|
String(32), ForeignKey("users.id", ondelete="CASCADE"), index=True
|
|
)
|
|
type: Mapped[str] = mapped_column(String(16), index=True)
|
|
amount: Mapped[float] = mapped_column(Float)
|
|
balance_after: Mapped[float] = mapped_column(Float)
|
|
description: Mapped[str] = mapped_column(String(256))
|
|
related_id: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
|
|
|
# 当前积分流水自己的业务幂等键。
|
|
# 例如：generation_record:{record_id}:attempt:1:media:charge
|
|
biz_key: Mapped[str | None] = mapped_column(String(160), nullable=True, index=True)
|
|
|
|
# 如果当前流水是退款，记录它退的是哪一次扣费。
|
|
# 例如：generation_record:{record_id}:attempt:1:media:charge
|
|
refund_for_biz_key: Mapped[str | None] = mapped_column(String(160), nullable=True, index=True)
|
|
|
|
# 账务快照字段：保证业务步骤/资源软删后，流水仍可独立展示。
|
|
owner_type: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
|
owner_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
|
attempt_no: Mapped[int | None] = mapped_column(Integer, nullable=True)
|
|
|
|
charge_kind: Mapped[str | None] = mapped_column(String(32), nullable=True, index=True)
|
|
charge_action: Mapped[str | None] = mapped_column(String(16), nullable=True)
|
|
credit_subject: Mapped[str | None] = mapped_column(String(32), nullable=True, index=True)
|
|
media_type: Mapped[str | None] = mapped_column(String(16), nullable=True, index=True)
|
|
billing_scene: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
|
|
|
source_module: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
|
source_project_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
|
source_step_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
|
source_step_code: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True)
|
|
|
|
token_usage_id: Mapped[str | None] = mapped_column(String(32), nullable=True, index=True)
|
|
input_tokens: Mapped[int | None] = mapped_column(Integer, nullable=True)
|
|
output_tokens: Mapped[int | None] = mapped_column(Integer, nullable=True)
|
|
total_tokens: Mapped[int | None] = mapped_column(Integer, nullable=True)
|
|
|
|
|
|
engine_type: Mapped[str | None] = mapped_column(String(16), nullable=True)
|
|
engine_id: Mapped[str | None] = mapped_column(String(32), nullable=True, index=True)
|
|
engine_name: Mapped[str | None] = mapped_column(String(128), nullable=True)
|
|
engine_provider: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
|
engine_model_name: Mapped[str | None] = mapped_column(String(128), nullable=True)
|
|
|
|
user_type_snapshot: Mapped[str | None] = mapped_column(String(16), nullable=True, index=True)
|
|
frontend_user_kind_snapshot: Mapped[str | None] = mapped_column(String(16), nullable=True, index=True)
|
|
# 交易流水发生时的团队归属冷备快照；用户后续改团队不影响历史流水展示与筛选。
|
|
team_id_snapshot: Mapped[str | None] = mapped_column(String(32), nullable=True, index=True)
|
|
team_name_snapshot: Mapped[str | None] = mapped_column(String(128), nullable=True)
|