45 lines
1.7 KiB
Python
45 lines
1.7 KiB
Python
"""模板库端点的请求/响应 schema（F3 / 契约 §F3）。
|
||
|
||
snake_case；前端经 OpenAPI 生成 TS 类型消费。改字段 → 前端必须 `pnpm gen:api`。
|
||
单用户本地版：作者保存/复用提示词模板，可一键填入生成器的 brief/text。
|
||
`title`/`body` 非空（先 strip 再 `min_length=1`，纯空白 → 422）。`category`/`tool_key` 可选。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
import uuid
|
||
from typing import Annotated
|
||
|
||
from pydantic import BaseModel, Field, StringConstraints
|
||
|
||
# 长度上界（CR-H9：防超长入参 DoS/成本）。标题=标签级；正文=段落级。
|
||
_TITLE_MAX = 200
|
||
_BODY_MAX = 20_000
|
||
|
||
# 先去首尾空白再校验长度：纯空白（" "）strip 后为空 → min_length=1 不满足 → 422。
|
||
NonBlankTitle = Annotated[
|
||
str, StringConstraints(strip_whitespace=True, min_length=1, max_length=_TITLE_MAX)
|
||
]
|
||
NonBlankBody = Annotated[
|
||
str, StringConstraints(strip_whitespace=True, min_length=1, max_length=_BODY_MAX)
|
||
]
|
||
|
||
|
||
class TemplateCreateRequest(BaseModel):
|
||
"""POST /templates：新建一条提示词模板。"""
|
||
|
||
title: NonBlankTitle = Field(description="模板标题（非空，纯空白 → 422）")
|
||
body: NonBlankBody = Field(description="模板正文（非空，一键填入生成器的 brief/text）")
|
||
category: str | None = Field(default=None, description="可选分类")
|
||
tool_key: str | None = Field(default=None, description="可选关联生成器（NULL=通用）")
|
||
|
||
|
||
class TemplateResponse(BaseModel):
|
||
"""模板视图（列出/创建后回显；snake_case）。"""
|
||
|
||
id: uuid.UUID
|
||
title: str
|
||
body: str
|
||
category: str | None = None
|
||
tool_key: str | None = None
|