初始化提交

backend/app/api/v1/endpoints/world.py

@@ -0,0 +1,95 @@
+"""世界模型 API（河图枢运行时，api-spec §12）。"""
+
+from fastapi import APIRouter, Depends, Query
+
+from app.api.v1.deps import get_current_user
+from app.schemas.auth import CurrentUser
+from app.schemas.common import Page
+from app.schemas.world import (
+    WorldEntityCreateRequest,
+    WorldEntityResponse,
+    WorldGraphResponse,
+    WorldRelationCreateRequest,
+    WorldRelationResponse,
+)
+from app.services.world import (
+    create_entity,
+    create_relation,
+    delete_relation,
+    get_entity_by_id,
+    get_graph,
+    list_entities_page,
+    list_relations_page,
+)
+
+router = APIRouter(prefix="/world", tags=["world"])
+
+
+@router.get("/entities", response_model=Page[WorldEntityResponse])
+async def list_entities(
+    current_user: CurrentUser = Depends(get_current_user),
+    character_id: str | None = Query(default=None, description="所属人物；省略取当前激活。"),
+    type: str | None = Query(default=None, description="按实体类型过滤（契约字典 §11.1）。"),
+    page: int = Query(default=1, ge=1),
+    page_size: int = Query(default=20, ge=1, le=100),
+) -> Page[WorldEntityResponse]:
+    return await list_entities_page(
+        character_id,
+        entity_type=type,
+        page=page,
+        page_size=page_size,
+        owner_scope=current_user.owner_scope,
+    )
+
+
+@router.post("/entities", response_model=WorldEntityResponse)
+async def create_entity_api(
+    payload: WorldEntityCreateRequest,
+    current_user: CurrentUser = Depends(get_current_user),
+) -> WorldEntityResponse:
+    return await create_entity(payload, owner_scope=current_user.owner_scope)
+
+
+@router.get("/entities/{entity_id}", response_model=WorldEntityResponse)
+async def get_entity(
+    entity_id: str,
+    current_user: CurrentUser = Depends(get_current_user),
+) -> WorldEntityResponse:
+    return await get_entity_by_id(entity_id, owner_scope=current_user.owner_scope)
+
+
+@router.get("/relations", response_model=Page[WorldRelationResponse])
+async def list_relations(
+    current_user: CurrentUser = Depends(get_current_user),
+    character_id: str | None = Query(default=None, description="所属人物；省略取当前激活。"),
+    page: int = Query(default=1, ge=1),
+    page_size: int = Query(default=20, ge=1, le=100),
+) -> Page[WorldRelationResponse]:
+    return await list_relations_page(
+        character_id, page=page, page_size=page_size, owner_scope=current_user.owner_scope
+    )
+
+
+@router.post("/relations", response_model=WorldRelationResponse)
+async def create_relation_api(
+    payload: WorldRelationCreateRequest,
+    current_user: CurrentUser = Depends(get_current_user),
+) -> WorldRelationResponse:
+    return await create_relation(payload, owner_scope=current_user.owner_scope)
+
+
+@router.delete("/relations/{relation_id}", status_code=204)
+async def delete_relation_api(
+    relation_id: str,
+    current_user: CurrentUser = Depends(get_current_user),
+) -> None:
+    await delete_relation(relation_id, owner_scope=current_user.owner_scope)
+
+
+@router.get("/graph", response_model=WorldGraphResponse)
+async def world_graph(
+    current_user: CurrentUser = Depends(get_current_user),
+    character_id: str | None = Query(default=None, description="所属人物；省略取当前激活。"),
+) -> WorldGraphResponse:
+    """返回人物的完整世界图谱（无分页），供前端 D3/Force 图谱渲染。"""
+    return await get_graph(character_id, owner_scope=current_user.owner_scope)