Files
deerflow-code/offline-backend-20260512/backend/app/gateway/routers/goview_templates.py
T

230 lines
9.1 KiB
Python

"""Personal templates and the builtin template market."""
from __future__ import annotations
from fastapi import APIRouter, Query, Request
from pydantic import BaseModel, ConfigDict
from app.gateway import goview_http
from app.gateway.goview_builtin_templates import ensure_builtin_templates
from app.gateway.goview_demo_projects import COVER_URL
from deerflow.persistence.goview import GoviewRejected
from deerflow.persistence.goview.template_store import MARKET, PERSONAL
router = APIRouter(prefix="/api/goview/templates", tags=["goview-templates"])
class FromProjectBody(BaseModel):
model_config = ConfigDict(extra="ignore")
projectId: str
name: str | None = None
description: str | None = None
coverImage: str | None = None
class TemplateEditBody(BaseModel):
model_config = ConfigDict(extra="ignore")
name: str | None = None
description: str | None = None
coverImage: str | None = None
class CreateProjectBody(BaseModel):
model_config = ConfigDict(extra="ignore")
projectName: str | None = None
remarks: str | None = None
def _templates(request: Request):
return getattr(request.app.state, "goview_template_store", None)
def _projects(request: Request):
return getattr(request.app.state, "goview_project_store", None)
def _invalid(exc: ValueError):
return goview_http.fail(422, str(exc) or "请求无效")
def _can_read(record: dict, owner: str) -> bool:
if record["scope"] == MARKET:
return True
return record.get("owner_id") == owner and record["scope"] == PERSONAL
@router.get("/mine")
async def list_my_templates(request: Request, page: int = Query(default=1), limit: int = Query(default=12)):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
safe_page, safe_limit = goview_http.page_window(page, limit)
rows, total = await store.list_personal(owner, page=safe_page, limit=safe_limit)
return goview_http.ok([goview_http.template_view(row) for row in rows], msg="获取成功", count=total)
@router.get("/market")
async def list_market_templates(request: Request, page: int = Query(default=1), limit: int = Query(default=12)):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
await goview_http.load_user(request)
safe_page, safe_limit = goview_http.page_window(page, limit)
rows, total = await store.list_market(page=safe_page, limit=safe_limit)
return goview_http.ok([goview_http.template_view(row) for row in rows], msg="获取成功", count=total)
@router.post("/from-project")
async def create_template_from_project(body: FromProjectBody, request: Request):
templates = _templates(request)
projects = _projects(request)
if templates is None or projects is None:
return goview_http.fail(503, "模板存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
project = await projects.get_owned(body.projectId, owner, with_content=True)
if project is None:
return goview_http.fail(404, "项目不存在")
try:
name = goview_http.clean_text(body.name or project["project_name"], label="模板名称", limit=255)
description = goview_http.clean_optional_text(body.description if body.description is not None else project.get("remarks"), limit=512)
cover = goview_http.clean_image_ref(body.coverImage if body.coverImage is not None else project.get("index_image"))
content = goview_http.retitle_canvas(project.get("content") or "{}", name)
except ValueError as exc:
return _invalid(exc)
try:
created = await templates.create_personal(
name=name,
description=description,
cover_image=cover,
content=content,
owner_id=owner,
)
except GoviewRejected as exc:
return _invalid(exc)
return goview_http.ok(goview_http.template_view(created), msg="创建成功")
@router.post("/admin/seed")
async def seed_builtin_templates(request: Request):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
user = await goview_http.load_user(request)
if not goview_http.user_is_admin(user):
return goview_http.fail(403, "仅管理员可维护市场模板")
inserted = await ensure_builtin_templates(store)
return goview_http.ok({"inserted": inserted}, msg="操作成功")
@router.get("/{template_id}")
async def get_template(template_id: str, request: Request):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
record = await store.get(template_id)
if record is None or not _can_read(record, owner):
return goview_http.fail(404, "模板不存在")
return goview_http.ok(goview_http.template_view(record, include_content=True), msg="获取成功")
@router.put("/{template_id}")
async def edit_template(template_id: str, body: TemplateEditBody, request: Request):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
user = await goview_http.load_user(request)
owner = goview_http.owner_id_of(user)
record = await store.get(template_id)
if record is None:
return goview_http.fail(404, "模板不存在")
if record["scope"] == MARKET:
if not goview_http.user_is_admin(user):
return goview_http.fail(403, "市场模板不能直接编辑")
elif record.get("owner_id") != owner:
return goview_http.fail(404, "模板不存在")
fields: set[str] = set()
name = None
description = None
cover = None
try:
if "name" in body.model_fields_set:
name = goview_http.clean_text(body.name or "", label="模板名称", limit=255)
fields.add("name")
if "description" in body.model_fields_set:
description = goview_http.clean_optional_text(body.description, limit=512)
fields.add("description")
if "coverImage" in body.model_fields_set:
cover = goview_http.clean_image_ref(body.coverImage)
fields.add("cover_image")
except ValueError as exc:
return _invalid(exc)
updated = await store.update_meta(
template_id,
name=name,
description=description,
cover_image=cover,
fields=fields,
)
if updated is None:
return goview_http.fail(404, "模板不存在")
return goview_http.ok(goview_http.template_view(updated), msg="保存成功")
@router.delete("/{template_id}")
async def delete_template(template_id: str, request: Request):
store = _templates(request)
if store is None:
return goview_http.fail(503, "模板存储未初始化")
user = await goview_http.load_user(request)
owner = goview_http.owner_id_of(user)
record = await store.get(template_id)
if record is None:
return goview_http.fail(404, "模板不存在")
if record.get("is_builtin"):
return goview_http.fail(403, "内置模板不可删除")
if record["scope"] == MARKET:
if not goview_http.user_is_admin(user):
return goview_http.fail(403, "市场模板不能直接编辑")
elif record.get("owner_id") != owner:
return goview_http.fail(404, "模板不存在")
await store.delete(template_id)
return goview_http.ok({"id": template_id}, msg="删除成功")
@router.post("/{template_id}/create-project")
async def create_project_from_template(template_id: str, request: Request, body: CreateProjectBody | None = None):
templates = _templates(request)
projects = _projects(request)
if templates is None or projects is None:
return goview_http.fail(503, "模板存储未初始化")
owner = goview_http.owner_id_of(await goview_http.load_user(request))
record = await templates.get(template_id)
if record is None or not _can_read(record, owner):
return goview_http.fail(404, "模板不存在")
requested = body.projectName if body is not None and body.projectName else record["name"]
remarks = body.remarks if body is not None else record.get("description")
try:
name = goview_http.clean_text(requested, label="项目名称", limit=255)
remarks = goview_http.clean_optional_text(remarks, limit=512)
content = goview_http.retitle_canvas(record.get("content") or "{}", name)
except ValueError as exc:
return _invalid(exc)
try:
created = await projects.create_project(
project_name=name,
remarks=remarks,
# Let the project gallery show the template's real dashboard
# preview before the first canvas save generates its own thumbnail.
index_image=record.get("cover_image") or COVER_URL,
owner_id=owner,
content=content,
)
except GoviewRejected as exc:
return _invalid(exc)
return goview_http.ok({"id": created["id"]}, msg="创建成功")