fix(txn+security): 仓储改 flush + 启动校验/兜底 + job.error 脱敏 + SSE 异常硬化
P0-1 SqlCredentialStore/save_draft 由自提交改 flush,端点/服务统一 commit (新增 CredentialStore.commit() 统一提交点;token 刷新落库显式提交); 补多凭据一请求中途失败整体回滚集成测试。 P0-2 启动校验 _fernet(enc_key) 快速失败 + catch-all Exception → ErrorEnvelope; credential_enc_key 改 SecretStr。 P0-3 run_job 异常分类:AppError 存 code+message,其余存通用文案不泄 str(exc)。 P0-4 评审/正文 SSE 失败先发 error 事件,尾部 commit 包 try/except。 P1-4 max_version 加 FOR UPDATE 行锁消除 TOCTOU。 P1-5 scan_overdue 谓词下推 + 批量 UPDATE RETURNING。 P1-10 移除 OAuth user_code 日志。 P2 provider_deps 改调网关 build_adapter;accept_service Committable Protocol; CORS 白名单收窄;request_id 安全字符集白名单;stdlib 日志接管;读端点 404 校验; httpx timeout;测试用合法 Fernet key;类型化响应模型(JobResponse/DimensionEntry/ ReviewConflictView/selling_points)+路由 ErrorEnvelope responses(供 codegen)。
This commit is contained in:
27
apps/api/ww_api/schemas/jobs.py
Normal file
27
apps/api/ww_api/schemas/jobs.py
Normal file
@@ -0,0 +1,27 @@
|
||||
"""长任务轮询响应 schema(C3 / ARCH §7.4)。
|
||||
|
||||
snake_case;前端经 OpenAPI→TS 客户端消费——改字段须 `pnpm gen:api` 重生成。
|
||||
此前 `GET /jobs/{id}` 返回裸 `dict`,TS 端拿到弱类型;改为具体 Pydantic 模型提升类型。
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from typing import Any
|
||||
|
||||
from pydantic import BaseModel
|
||||
|
||||
|
||||
class JobResponse(BaseModel):
|
||||
"""长任务状态(`GET /jobs/{id}`):状态 + 进度 + 结果/错误。
|
||||
|
||||
`result` 是任务成功后的非密摘要(如 `{"connected": true, ...}`);`error` 是失败后的
|
||||
面向用户文案(已脱敏,绝不含 `str(exc)`,见 `services/job_runner._classify_job_error`)。
|
||||
"""
|
||||
|
||||
id: uuid.UUID
|
||||
kind: str
|
||||
status: str
|
||||
progress: int = 0
|
||||
result: dict[str, Any] | None = None
|
||||
error: str | None = None
|
||||
@@ -19,7 +19,7 @@ class ProjectCreateRequest(BaseModel):
|
||||
logline: str | None = None
|
||||
premise: str | None = None
|
||||
theme: str | None = None
|
||||
selling_points: list[Any] = Field(default_factory=list)
|
||||
selling_points: list[str] = Field(default_factory=list)
|
||||
structure: str | None = None
|
||||
|
||||
|
||||
@@ -32,7 +32,7 @@ class ProjectResponse(BaseModel):
|
||||
logline: str | None = None
|
||||
premise: str | None = None
|
||||
theme: str | None = None
|
||||
selling_points: list[Any] = Field(default_factory=list)
|
||||
selling_points: list[str] = Field(default_factory=list)
|
||||
structure: str | None = None
|
||||
|
||||
|
||||
@@ -97,6 +97,18 @@ class ReviewRequest(BaseModel):
|
||||
draft: str | None = None
|
||||
|
||||
|
||||
class ReviewConflictView(BaseModel):
|
||||
"""单条一致性冲突(chapter_reviews.conflicts JSONB 子项;形对齐 SSE `conflict` 事件)。
|
||||
|
||||
强类型化此前的裸 `dict[str, Any]`,给 TS 客户端真实字段类型。容忍历史/缺省(默认值)。
|
||||
"""
|
||||
|
||||
type: str = ""
|
||||
where: str = ""
|
||||
refs: list[str] = Field(default_factory=list)
|
||||
suggestion: str = ""
|
||||
|
||||
|
||||
class ReviewHistoryItem(BaseModel):
|
||||
"""单条审稿留痕(GET .../reviews 历史项;snake_case)。"""
|
||||
|
||||
@@ -104,7 +116,7 @@ class ReviewHistoryItem(BaseModel):
|
||||
project_id: uuid.UUID
|
||||
chapter_no: int
|
||||
chapter_version: int | None = None
|
||||
conflicts: list[dict[str, Any]] = Field(default_factory=list)
|
||||
conflicts: list[ReviewConflictView] = Field(default_factory=list)
|
||||
foreshadow_sug: list[dict[str, Any]] = Field(default_factory=list)
|
||||
style: dict[str, Any] | None = None
|
||||
pace: dict[str, Any] | None = None
|
||||
|
||||
@@ -7,7 +7,7 @@ snake_case(命名契约,见 memory/gotchas)。前端经 OpenAPI→TS 客
|
||||
from __future__ import annotations
|
||||
|
||||
import uuid
|
||||
from typing import Any, Literal
|
||||
from typing import Literal
|
||||
|
||||
from pydantic import BaseModel, Field
|
||||
|
||||
@@ -25,11 +25,22 @@ class StyleLearnResponse(BaseModel):
|
||||
job_id: uuid.UUID
|
||||
|
||||
|
||||
class StyleFingerprintResponse(BaseModel):
|
||||
"""最新文风指纹(`GET /style`):完整 16 维 + 证据 + 版本(对齐 UX §6.9)。"""
|
||||
class DimensionEntry(BaseModel):
|
||||
"""单个文风维度:名称 + 判定值 + 原文证据摘录(强类型,替代裸 dict[str, Any])。"""
|
||||
|
||||
dimensions: dict[str, Any] = Field(default_factory=dict)
|
||||
evidence: dict[str, Any] = Field(default_factory=dict)
|
||||
name: str
|
||||
value: str
|
||||
evidence: list[str] = Field(default_factory=list)
|
||||
|
||||
|
||||
class StyleFingerprintResponse(BaseModel):
|
||||
"""最新文风指纹(`GET /style`):完整 16 维(名称/值/证据)+ 版本(对齐 UX §6.9)。
|
||||
|
||||
DB 存两列并行 dict(`{name:value}` + `{name:[evidence]}`);响应合并为
|
||||
`list[DimensionEntry]`,给 TS 客户端强类型(替代弱类型 `dict[str, Any]`)。
|
||||
"""
|
||||
|
||||
dimensions: list[DimensionEntry] = Field(default_factory=list)
|
||||
version: int
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user