59 lines
3.0 KiB
Python
59 lines
3.0 KiB
Python
"""河图枢世界模型运行时（api-spec §12；design/world-model-design §3/§4）。
|
||
|
||
与治理视图 ``governance.WorldEntity``（全局、人工维护、无 character_id）区分：
|
||
本模块是**按人物隔离的运行时**世界状态，所有写入绑定 ``character_id``。
|
||
自动抽取（世界引擎）属 v1 半自动留后项，本表先承载手动 CRUD 与未来抽取结果。
|
||
"""
|
||
|
||
from datetime import datetime
|
||
|
||
from sqlalchemy import DateTime, Float, ForeignKey, String, Text
|
||
from sqlalchemy.orm import Mapped, mapped_column
|
||
|
||
from app.core.ids import new_world_entity_id, new_world_relation_id
|
||
from app.core.time import utc_now
|
||
from app.db.base import Base
|
||
|
||
|
||
class CharacterWorldEntity(Base):
|
||
"""人物视角下的世界实体（契约字典 §11.1 type / §11.2 state_type）。"""
|
||
|
||
__tablename__ = "character_world_entities"
|
||
|
||
id: Mapped[str] = mapped_column(String(80), primary_key=True, default=new_world_entity_id)
|
||
character_id: Mapped[str] = mapped_column(String(80), ForeignKey("characters.id"), index=True)
|
||
type: Mapped[str] = mapped_column(String(40), nullable=False, default="concept", index=True)
|
||
name: Mapped[str] = mapped_column(String(200), nullable=False)
|
||
attributes_json: Mapped[str] = mapped_column(Text, nullable=False, default="{}")
|
||
state_type: Mapped[str] = mapped_column(String(40), nullable=False, default="inference")
|
||
status: Mapped[str] = mapped_column(String(40), nullable=False, default="confirmed", index=True)
|
||
confidence: Mapped[float] = mapped_column(Float, nullable=False, default=0.5)
|
||
evidence_ids_json: Mapped[str] = mapped_column(Text, nullable=False, default="[]")
|
||
sources_json: Mapped[str] = mapped_column(Text, nullable=False, default="[]")
|
||
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=utc_now)
|
||
updated_at: Mapped[datetime] = mapped_column(
|
||
DateTime(timezone=True), default=utc_now, onupdate=utc_now
|
||
)
|
||
|
||
|
||
class WorldRelation(Base):
|
||
"""实体间关系（design §4；predicate 为自由字符串谓词，非枚举）。"""
|
||
|
||
__tablename__ = "world_relations"
|
||
|
||
id: Mapped[str] = mapped_column(String(80), primary_key=True, default=new_world_relation_id)
|
||
character_id: Mapped[str] = mapped_column(String(80), ForeignKey("characters.id"), index=True)
|
||
subject_id: Mapped[str] = mapped_column(
|
||
String(80), ForeignKey("character_world_entities.id"), index=True
|
||
)
|
||
predicate: Mapped[str] = mapped_column(String(120), nullable=False)
|
||
object_id: Mapped[str] = mapped_column(
|
||
String(80), ForeignKey("character_world_entities.id"), index=True
|
||
)
|
||
confidence: Mapped[float] = mapped_column(Float, nullable=False, default=0.5)
|
||
evidence_ids_json: Mapped[str] = mapped_column(Text, nullable=False, default="[]")
|
||
created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=utc_now)
|
||
updated_at: Mapped[datetime] = mapped_column(
|
||
DateTime(timezone=True), default=utc_now, onupdate=utc_now
|
||
)
|