Files
knowledge-governance/web/src/qaWeeklyDraftAPI.ts
T
姚章浩 87f97a2f9b
build / build (push) Successful in 1m7s
feat(qaops): 完成详情下拉与每周自动保存草稿
详情使用共享主表字典,稀疏修改所选字段并保留原始问答及旧复核审计。
月周统计提供文本和下拉双入口;每租户每周一份持久草稿,按技能六节双语模板真实预填。
加入幂等自动保存、冲突保留、未知响应重试、切周及离开保护和schema58非破坏降级保护。

验证:完整make verify、隔离PostgreSQL全mirror竞态回归、真实恢复库浏览器验收通过。
浏览器实测字段精确读回、月周双输入、模板预填、MD/CSV、自动保存、冲突、失败重试与API重启恢复。
未连接或改写DobotAI生产源库,未运行付费模型;提交时尚未部署。
2026-10-20 05:44:02 +08:00

64 lines
2.6 KiB
TypeScript

import type { WeeklyDocument, WeeklyTransport } from './qaWeeklyDrafts'
import { validPeriodInput } from './qaPeriodInput'
import { getPayload, QARequestError } from './qaOps'
import type { WeeklyWriteRequest, WeeklyPrefillRequest } from './qaWeeklyDrafts'
const invalid = (): never => {
throw Error('草稿响应无效,未展示或标记为已保存')
}
export function parseWeeklyDocument(value: unknown, week: string): WeeklyDocument {
if (!value || typeof value !== 'object' || Array.isArray(value)) return invalid()
const v = value as Record<string, unknown>
if (
v.week !== week ||
!validPeriodInput('week', week) ||
typeof v.revision !== 'number' ||
!Number.isSafeInteger(v.revision) ||
v.revision < 0 ||
typeof v.markdown !== 'string' ||
new TextEncoder().encode(v.markdown).length > 256 * 1024 ||
!v.seed ||
typeof v.seed !== 'object' ||
Array.isArray(v.seed)
)
return invalid()
if (v.revision === 0) {
if (v.markdown !== '' || v.updated_at !== null || Object.keys(v.seed).length) return invalid()
} else if (typeof v.updated_at !== 'string' || !Number.isFinite(Date.parse(v.updated_at))) return invalid()
return {
week,
revision: v.revision,
markdown: v.markdown,
seed: v.seed as Record<string, unknown>,
updated_at: v.updated_at as string | null,
}
}
const endpoint = (week: string) => `/api/v1/qa-ops/master/weekly-drafts/${encodeURIComponent(week)}`
async function read(week: string) {
return parseWeeklyDocument(await getPayload(endpoint(week)), week)
}
async function save(week: string, q: WeeklyWriteRequest | WeeklyPrefillRequest, prefill: boolean) {
const raw = await getPayload(endpoint(week) + (prefill ? '/prefill' : ''), undefined, {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'X-Governance-Action': 'qa-weekly-draft' },
body: JSON.stringify(q),
})
if (!raw || typeof raw !== 'object' || Array.isArray(raw)) return invalid()
const receipt = raw as Record<string, unknown>,
draft = parseWeeklyDocument(receipt.draft, week)
if (
typeof receipt.replayed !== 'boolean' ||
draft.revision !== q.base_revision + 1 ||
(!prefill && draft.markdown !== (q as WeeklyWriteRequest).markdown)
)
return invalid()
const current = await read(week)
if (current.revision !== draft.revision || current.markdown !== draft.markdown)
throw new QARequestError('本周草稿在保存后又发生变化;你的文字仍保留,请核对服务器版本', 409)
return current
}
export const weeklyTransport: WeeklyTransport = {
read,
write: (week, q) => save(week, q, false),
prefill: (week, q) => save(week, q, true),
}