"""数据模型。商用切 MySQL/PG 只需改 DATABASE_URL,表结构不变。""" import datetime as dt from sqlalchemy import (String, Boolean, Integer, Text, DateTime, ForeignKey, JSON, UniqueConstraint, Index) from sqlalchemy.orm import Mapped, mapped_column, relationship from ..db.session import Base def now(): return dt.datetime.utcnow() class User(Base): __tablename__ = "users" id: Mapped[int] = mapped_column(primary_key=True) username: Mapped[str] = mapped_column(String(64), unique=True) password_hash: Mapped[str] = mapped_column(String(128)) # 用户密码盐,用于派生加密密钥(明文盐可存,派生密钥不存) kdf_salt: Mapped[str] = mapped_column(String(64)) is_admin: Mapped[bool] = mapped_column(Boolean, default=False) is_active: Mapped[bool] = mapped_column(Boolean, default=True) created_at: Mapped[dt.datetime] = mapped_column(DateTime, default=now) deleted_at: Mapped[dt.datetime | None] = mapped_column(DateTime, nullable=True) class SiteSetting(Base): """管理员权限开关,key-value。键值见 api/routers/admin.py""" __tablename__ = "site_settings" key: Mapped[str] = mapped_column(String(64), primary_key=True) value: Mapped[str] = mapped_column(String(256)) class Channel(Base): """AI 渠道。管理员全局渠道 or 用户 BYOK 私有渠道(owner_id 非空)。""" __tablename__ = "channels" id: Mapped[int] = mapped_column(primary_key=True) name: Mapped[str] = mapped_column(String(128)) base_url: Mapped[str] = mapped_column(String(256)) api_key_enc: Mapped[str] = mapped_column(Text) # 加密存储 # 槽位模型映射: narrative / extract / tts / image models: Mapped[dict] = mapped_column(JSON, default=dict) owner_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), nullable=True) visibility: Mapped[str] = mapped_column(String(16), default="admin") # public/granted/admin created_at: Mapped[dt.datetime] = mapped_column(DateTime, default=now) class ChannelGrant(Base): __tablename__ = "channel_grants" id: Mapped[int] = mapped_column(primary_key=True) channel_id: Mapped[int] = mapped_column(ForeignKey("channels.id")) user_id: Mapped[int] = mapped_column(ForeignKey("users.id")) class Character(Base): __tablename__ = "characters" id: Mapped[int] = mapped_column(primary_key=True) user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), index=True) name: Mapped[str] = mapped_column(String(128)) persona: Mapped[str] = mapped_column(Text, default="") # 人设 greeting: Mapped[str] = mapped_column(Text, default="") # 开场白 voice: Mapped[str] = mapped_column(String(64), default="tongtong") # 音色 avatar_url: Mapped[str] = mapped_column(Text, default="") source: Mapped[str] = mapped_column(String(16), default="manual") # manual / novel_auto / imported novel_id: Mapped[int | None] = mapped_column(nullable=True) # 广场/分享 is_public: Mapped[bool] = mapped_column(Boolean, default=False) share_code: Mapped[str | None] = mapped_column(String(32), unique=True, nullable=True) tags: Mapped[str] = mapped_column(String(256), default="") # 逗号分隔标签 usage_count: Mapped[int] = mapped_column(Integer, default=0) # 公开卡片展示用的明文字段(发布时由作者密钥解密写入) public_persona: Mapped[str] = mapped_column(Text, default="") public_greeting: Mapped[str] = mapped_column(Text, default="") created_at: Mapped[dt.datetime] = mapped_column(DateTime, default=now) class Memory(Base): """角色记忆,双轨: fact(设定类) / event(事件类)。全部可查可改。""" __tablename__ = "memories" __table_args__ = (Index("ix_mem_user_char", "user_id", "character_id"),) id: Mapped[int] = mapped_column(primary_key=True) character_id: Mapped[int] = mapped_column(ForeignKey("characters.id"), index=True) user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), index=True) kind: Mapped[str] = mapped_column(String(16), default="fact") content_enc: Mapped[str] = mapped_column(Text) created_at: Mapped[dt.datetime] = mapped_column(DateTime, default=now) class WorldbookEntry(Base): __tablename__ = "worldbook_entries" id: Mapped[int] = mapped_column(primary_key=True) user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), index=True) scope: Mapped[str] = mapped_column(String(32), default="character") # character/novel scope_id: Mapped[int] = mapped_column(Integer, default=0) keywords: Mapped[str] = mapped_column(String(512), default="") # 逗号分隔 content_enc: Mapped[str] = mapped_column(Text) constant: Mapped[bool] = mapped_column(Boolean, default=False) # 常驻 enabled: Mapped[bool] = mapped_column(Boolean, default=True) class ChatSession(Base): """mode: roleplay(单角色) / novel(动态小说) / group(群聊) / call(语音通话)""" __tablename__ = "chat_sessions" __table_args__ = (Index("ix_sess_user_pin", "user_id", "pinned", "id"),) id: Mapped[int] = mapped_column(primary_key=True) user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), index=True) mode: Mapped[str] = mapped_column(String(16), default="roleplay") title: Mapped[str] = mapped_column(String(256), default="新会话") character_id: Mapped[int | None] = mapped_column(nullable=True) novel_setting_enc: Mapped[str | None] = mapped_column(Text, nullable=True) channel_id: Mapped[int | None] = mapped_column(nullable=True) # 扩展 group_member_ids: Mapped[str] = mapped_column(String(512), default="") # 逗号分隔角色id prompt_suffix: Mapped[str] = mapped_column(Text, default="") # 用户自定义指令模板 bg_url: Mapped[str] = mapped_column(Text, default="") # 聊天背景 pinned: Mapped[bool] = mapped_column(Boolean, default=False) # 置顶 archived: Mapped[bool] = mapped_column(Boolean, default=False) created_at: Mapped[dt.datetime] = mapped_column(DateTime, default=now) class Message(Base): __tablename__ = "messages" __table_args__ = ( Index("ix_msg_sess_user_time", "session_id", "user_id", "id"), Index("ix_msg_user_time", "user_id", "id"), ) id: Mapped[int] = mapped_column(primary_key=True) session_id: Mapped[int] = mapped_column(ForeignKey("chat_sessions.id"), index=True) user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), index=True) role: Mapped[str] = mapped_column(String(16)) # user / assistant / system / narrator content_enc: Mapped[str] = mapped_column(Text) speaker: Mapped[str | None] = mapped_column(String(128), nullable=True) # 小说模式中的说话角色 # swipe 多版本:JSON 数组存备选回复,active 为当前选中下标 swipes_enc: Mapped[str | None] = mapped_column(Text, nullable=True) # JSON [str] active_swipe: Mapped[int] = mapped_column(Integer, default=0) reply_to_id: Mapped[int | None] = mapped_column(nullable=True) # 引用回复 starred: Mapped[bool] = mapped_column(Boolean, default=False) # 收藏 created_at: Mapped[dt.datetime] = mapped_column(DateTime, default=now) class Moment(Base): """角色朋友圈""" __tablename__ = "moments" __table_args__ = (Index("ix_moment_user_time", "user_id", "id"),) id: Mapped[int] = mapped_column(primary_key=True) user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), index=True) character_id: Mapped[int] = mapped_column(ForeignKey("characters.id"), index=True) content_enc: Mapped[str] = mapped_column(Text) image_url: Mapped[str] = mapped_column(Text, default="") liked_by_me: Mapped[bool] = mapped_column(Boolean, default=False) created_at: Mapped[dt.datetime] = mapped_column(DateTime, default=now) class MomentComment(Base): __tablename__ = "moment_comments" id: Mapped[int] = mapped_column(primary_key=True) moment_id: Mapped[int] = mapped_column(ForeignKey("moments.id"), index=True) user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), index=True) author: Mapped[str] = mapped_column(String(128)) # "me" 或角色名 content_enc: Mapped[str] = mapped_column(Text) created_at: Mapped[dt.datetime] = mapped_column(DateTime, default=now) class UserPrefs(Base): """用户偏好:主题/字号/气泡样式等""" __tablename__ = "user_prefs" user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), primary_key=True) data: Mapped[str] = mapped_column(Text, default="{}") # JSON class ApiKey(Base): """商业化预留:第三方 API 密钥。scope: chat / characters / full""" __tablename__ = "api_keys" id: Mapped[int] = mapped_column(primary_key=True) user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), index=True) key_hash: Mapped[str] = mapped_column(String(64), unique=True) # sha256,不存明文 name: Mapped[str] = mapped_column(String(128), default="default") scope: Mapped[str] = mapped_column(String(32), default="chat") # chat / full rate_limit: Mapped[int] = mapped_column(Integer, default=60) # req/min revoked: Mapped[bool] = mapped_column(Boolean, default=False) created_at: Mapped[dt.datetime] = mapped_column(DateTime, default=now) last_used_at: Mapped[dt.datetime | None] = mapped_column(DateTime, nullable=True) class UsageLog(Base): """商业化预留:API 用量账本(计费/配额的数据底座)""" __tablename__ = "usage_logs" __table_args__ = (Index("ix_usage_user_time", "user_id", "id"),) id: Mapped[int] = mapped_column(primary_key=True) user_id: Mapped[int] = mapped_column(ForeignKey("users.id"), index=True) api_key_id: Mapped[int | None] = mapped_column(nullable=True) endpoint: Mapped[str] = mapped_column(String(128)) cost_units: Mapped[int] = mapped_column(Integer, default=1) # 计费单位(暂为次数)