初始化提交

backend/app/models/world.py

@@ -0,0 +1,58 @@
+"""河图枢世界模型运行时（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
+    )