309a051038
数据库与模型：新增多版迁移（章节证据快照、对话血缘、记忆事实/时间线 lineage 等），把「成稿 ↔ 对话/记忆」的溯源信息落到表结构里。 业务链路：会话与 WS、回忆录/故事流水线、记忆写入与 enrichment 等跟着接上线索与快照；新增章节证据快照与评测侧 EvalTraceService 等模块，方便组评审用的证据包。 内部评测：自动化 run 与手工 memoir 评审共用可追溯证据；rubric/ judge 相关脚本与文档有配套调整。 app-eval-web：Memoir/实验详情里能展开看证据摘要与 evidence_trace（含对话轮次 id）；Vite 代理与 development.sh 注入的 API 端口与当前默认内部评测端口一致，避免改端口后页面连错服务。 工程杂项：GitHub Actions / 仓库说明有更新；各适配器与支付/配额/plan 等多处为小改动或跟随主改动的收尾；新增/扩充了?
301 lines
11 KiB
Python
301 lines
11 KiB
Python
from sqlalchemy import (
|
||
JSON,
|
||
Boolean,
|
||
Column,
|
||
DateTime,
|
||
Float,
|
||
ForeignKey,
|
||
Integer,
|
||
String,
|
||
Text,
|
||
)
|
||
from sqlalchemy.orm import relationship
|
||
|
||
from app.core.db import Base, utc_now
|
||
|
||
|
||
class Chapter(Base):
|
||
"""章节：阅读与导出视图，canonical_markdown 为正文真源。"""
|
||
|
||
__tablename__ = "chapters"
|
||
|
||
id = Column(String, primary_key=True)
|
||
user_id = Column(String, ForeignKey("users.id"), nullable=False)
|
||
book_id = Column(String, ForeignKey("books.id", ondelete="SET NULL"), nullable=True)
|
||
title = Column(String, nullable=False)
|
||
category = Column(String, nullable=True)
|
||
order_index = Column(Integer, nullable=False)
|
||
summary = Column(Text, nullable=True)
|
||
canonical_markdown = Column(Text, nullable=True) # 当前生效正文（markdown-first）
|
||
status = Column(String, default="draft") # active / draft / archived
|
||
cover_asset_id = Column(String, nullable=True)
|
||
current_version_id = Column(String, nullable=True) # FK 在 migration 中分步添加
|
||
created_at = Column(DateTime(timezone=True), default=utc_now)
|
||
updated_at = Column(DateTime(timezone=True), default=utc_now, onupdate=utc_now)
|
||
is_new = Column(Boolean, default=True)
|
||
is_active = Column(Boolean, default=True)
|
||
source_segments = Column(JSON, nullable=True)
|
||
# 物化当前 canonical 对应的证据闭包（segment / story / memory ids），供评测与审计；见 memoir/chapter_evidence_snapshot
|
||
evidence_bundle_json = Column(JSON, nullable=True)
|
||
# Phase C：指向当前生效的 chapter_evidence_snapshots 行（版本链可审计）
|
||
current_evidence_snapshot_id = Column(
|
||
String,
|
||
ForeignKey("chapter_evidence_snapshots.id", ondelete="SET NULL"),
|
||
nullable=True,
|
||
)
|
||
# story-backed 章节：story 变更后标 True，由 Celery 重组 canonical_markdown
|
||
markdown_compose_dirty = Column(Boolean, default=False, nullable=False)
|
||
markdown_composed_at = Column(DateTime(timezone=True), nullable=True)
|
||
# 与 canonical 同一生成时机物化；无签名 URL，读时 hydrate
|
||
reading_segments_json = Column(JSON, nullable=True)
|
||
source_lineage_json = Column(JSON, nullable=True)
|
||
|
||
user = relationship("User", back_populates="chapters")
|
||
book = relationship("Book", back_populates="chapters")
|
||
images = relationship(
|
||
"MemoirImage",
|
||
back_populates="chapter",
|
||
foreign_keys="MemoirImage.chapter_id",
|
||
cascade="all, delete-orphan",
|
||
)
|
||
versions = relationship(
|
||
"ChapterVersion",
|
||
back_populates="chapter",
|
||
foreign_keys="ChapterVersion.chapter_id",
|
||
cascade="all, delete-orphan",
|
||
)
|
||
current_version = relationship(
|
||
"ChapterVersion",
|
||
primaryjoin="Chapter.current_version_id == ChapterVersion.id",
|
||
foreign_keys="ChapterVersion.id",
|
||
)
|
||
story_links = relationship(
|
||
"ChapterStoryLink",
|
||
back_populates="chapter",
|
||
cascade="all, delete-orphan",
|
||
)
|
||
cover_intents = relationship(
|
||
"ChapterCoverIntent",
|
||
back_populates="chapter",
|
||
cascade="all, delete-orphan",
|
||
)
|
||
evidence_snapshots = relationship(
|
||
"ChapterEvidenceSnapshot",
|
||
back_populates="chapter",
|
||
foreign_keys="ChapterEvidenceSnapshot.chapter_id",
|
||
cascade="all, delete-orphan",
|
||
)
|
||
evidence_links = relationship(
|
||
"ChapterEvidenceLink",
|
||
back_populates="chapter",
|
||
cascade="all, delete-orphan",
|
||
)
|
||
current_evidence_snapshot = relationship(
|
||
"ChapterEvidenceSnapshot",
|
||
foreign_keys=[current_evidence_snapshot_id],
|
||
post_update=True,
|
||
)
|
||
|
||
|
||
class MemoirImage(Base):
|
||
__tablename__ = "memoir_images"
|
||
|
||
id = Column(String, primary_key=True)
|
||
chapter_id = Column(
|
||
String, ForeignKey("chapters.id", ondelete="CASCADE"), nullable=False
|
||
)
|
||
order_index = Column(Integer, nullable=False, default=0)
|
||
placeholder = Column(Text, nullable=True)
|
||
description = Column(Text, nullable=True)
|
||
status = Column(String, nullable=False, default="pending")
|
||
prompt = Column(Text, nullable=True)
|
||
url = Column(Text, nullable=True)
|
||
storage_key = Column(Text, nullable=True)
|
||
provider = Column(String, nullable=True)
|
||
style = Column(String, nullable=True)
|
||
size = Column(String, nullable=True)
|
||
error = Column(Text, nullable=True)
|
||
retryable = Column(Boolean, nullable=True)
|
||
created_at = Column(DateTime(timezone=True), nullable=True)
|
||
updated_at = Column(DateTime(timezone=True), default=utc_now, onupdate=utc_now)
|
||
|
||
chapter = relationship("Chapter", back_populates="images")
|
||
|
||
|
||
class ChapterVersion(Base):
|
||
"""Chapter 版本快照，记录正文变更与来源。"""
|
||
|
||
__tablename__ = "chapter_versions"
|
||
|
||
id = Column(String, primary_key=True)
|
||
chapter_id = Column(
|
||
String,
|
||
ForeignKey("chapters.id", ondelete="CASCADE"),
|
||
nullable=False,
|
||
index=True,
|
||
)
|
||
version_no = Column(Integer, nullable=False)
|
||
markdown_snapshot = Column(Text, nullable=False)
|
||
change_summary = Column(Text, nullable=True)
|
||
actor_type = Column(String, nullable=True) # ai / user / editor / system
|
||
source_type = Column(
|
||
String, nullable=True
|
||
) # generate / rewrite / merge / manual / migration
|
||
parent_version_id = Column(
|
||
String, ForeignKey("chapter_versions.id", ondelete="SET NULL"), nullable=True
|
||
)
|
||
prompt_meta = Column(JSON, nullable=True)
|
||
created_at = Column(DateTime(timezone=True), default=utc_now)
|
||
|
||
chapter = relationship(
|
||
"Chapter", back_populates="versions", foreign_keys=[chapter_id]
|
||
)
|
||
parent_version = relationship(
|
||
"ChapterVersion",
|
||
remote_side="ChapterVersion.id",
|
||
foreign_keys=[parent_version_id],
|
||
)
|
||
|
||
|
||
class ChapterCoverIntent(Base):
|
||
"""Chapter 封面意图（结构化）。"""
|
||
|
||
__tablename__ = "chapter_cover_intents"
|
||
|
||
id = Column(String, primary_key=True)
|
||
chapter_id = Column(
|
||
String,
|
||
ForeignKey("chapters.id", ondelete="CASCADE"),
|
||
nullable=False,
|
||
index=True,
|
||
)
|
||
chapter_version_id = Column(
|
||
String,
|
||
ForeignKey("chapter_versions.id", ondelete="SET NULL"),
|
||
nullable=True,
|
||
)
|
||
story_ids = Column(JSON, nullable=True)
|
||
prompt_brief = Column(Text, nullable=True)
|
||
status = Column(String, nullable=False)
|
||
claim_token = Column(String, nullable=True)
|
||
claimed_at = Column(DateTime(timezone=True), nullable=True)
|
||
attempt_count = Column(Integer, nullable=False, default=0)
|
||
asset_id = Column(String, nullable=True)
|
||
error = Column(Text, nullable=True)
|
||
created_at = Column(DateTime(timezone=True), default=utc_now)
|
||
updated_at = Column(DateTime(timezone=True), default=utc_now, onupdate=utc_now)
|
||
|
||
chapter = relationship("Chapter", back_populates="cover_intents")
|
||
|
||
|
||
class ChapterStoryLink(Base):
|
||
"""Chapter 与 Story 的编排关联。"""
|
||
|
||
__tablename__ = "chapter_story_links"
|
||
|
||
id = Column(String, primary_key=True)
|
||
chapter_id = Column(
|
||
String,
|
||
ForeignKey("chapters.id", ondelete="CASCADE"),
|
||
nullable=False,
|
||
index=True,
|
||
)
|
||
story_id = Column(
|
||
String, ForeignKey("stories.id", ondelete="CASCADE"), nullable=False, index=True
|
||
)
|
||
order_index = Column(Integer, nullable=False)
|
||
role = Column(String, nullable=True) # core / bridge / appendix
|
||
created_at = Column(DateTime(timezone=True), default=utc_now)
|
||
|
||
chapter = relationship("Chapter", back_populates="story_links")
|
||
story = relationship("Story", back_populates="chapter_links")
|
||
|
||
|
||
class ChapterEvidenceSnapshot(Base):
|
||
"""章节证据闭包版本快照（一行 = 一次物化；current 指针在 Chapter 上）。"""
|
||
|
||
__tablename__ = "chapter_evidence_snapshots"
|
||
|
||
id = Column(String, primary_key=True)
|
||
chapter_id = Column(
|
||
String,
|
||
ForeignKey("chapters.id", ondelete="CASCADE"),
|
||
nullable=False,
|
||
index=True,
|
||
)
|
||
user_id = Column(String, ForeignKey("users.id"), nullable=False, index=True)
|
||
version_no = Column(Integer, nullable=False)
|
||
schema_version = Column(Integer, nullable=False, default=1)
|
||
segment_ids = Column(JSON, nullable=True)
|
||
conversation_ids = Column(JSON, nullable=True)
|
||
story_ids = Column(JSON, nullable=True)
|
||
memory_chunk_ids = Column(JSON, nullable=True)
|
||
memory_fact_ids = Column(JSON, nullable=True)
|
||
timeline_event_ids = Column(JSON, nullable=True)
|
||
summary_ids = Column(JSON, nullable=True)
|
||
notes = Column(JSON, nullable=True)
|
||
message_lineage_json = Column(JSON, nullable=True)
|
||
captured_at = Column(DateTime(timezone=True), default=utc_now)
|
||
|
||
chapter = relationship(
|
||
"Chapter",
|
||
back_populates="evidence_snapshots",
|
||
foreign_keys=[chapter_id],
|
||
)
|
||
|
||
|
||
class ChapterEvidenceLink(Base):
|
||
"""与 StoryEvidenceLink 对称：章节当前态绑定的结构化记忆 id（按快照刷新时整批替换）。"""
|
||
|
||
__tablename__ = "chapter_evidence_links"
|
||
|
||
id = Column(String, primary_key=True)
|
||
chapter_id = Column(
|
||
String,
|
||
ForeignKey("chapters.id", ondelete="CASCADE"),
|
||
nullable=False,
|
||
index=True,
|
||
)
|
||
evidence_type = Column(String, nullable=False)
|
||
evidence_id = Column(String, nullable=False)
|
||
role = Column(String, nullable=True)
|
||
weight = Column(Float, nullable=True)
|
||
created_at = Column(DateTime(timezone=True), default=utc_now)
|
||
|
||
chapter = relationship("Chapter", back_populates="evidence_links")
|
||
|
||
|
||
class Book(Base):
|
||
__tablename__ = "books"
|
||
|
||
id = Column(String, primary_key=True)
|
||
user_id = Column(String, ForeignKey("users.id"), nullable=False)
|
||
title = Column(String, nullable=False)
|
||
total_pages = Column(Integer, default=0)
|
||
total_words = Column(Integer, default=0)
|
||
cover_image_url = Column(String, nullable=True)
|
||
updated_at = Column(DateTime(timezone=True), default=utc_now, onupdate=utc_now)
|
||
has_update = Column(Boolean, default=False)
|
||
last_update_chapter_id = Column(String, nullable=True)
|
||
|
||
user = relationship("User", back_populates="books")
|
||
chapters = relationship(
|
||
"Chapter",
|
||
back_populates="book",
|
||
foreign_keys="Chapter.book_id",
|
||
)
|
||
|
||
|
||
class MemoirState(Base):
|
||
__tablename__ = "memoir_states"
|
||
|
||
id = Column(String, primary_key=True)
|
||
user_id = Column(String, ForeignKey("users.id"), unique=True, nullable=False)
|
||
stage_order = Column(JSON, default=list)
|
||
current_stage = Column(String, default="childhood")
|
||
covered_stages = Column(JSON, default=list)
|
||
slots = Column(JSON, nullable=False)
|
||
updated_at = Column(DateTime(timezone=True), default=utc_now, onupdate=utc_now)
|
||
|
||
user = relationship("User", back_populates="memoir_state")
|