87f97a2f9b
build / build (push) Successful in 1m7s
详情使用共享主表字典,稀疏修改所选字段并保留原始问答及旧复核审计。 月周统计提供文本和下拉双入口;每租户每周一份持久草稿,按技能六节双语模板真实预填。 加入幂等自动保存、冲突保留、未知响应重试、切周及离开保护和schema58非破坏降级保护。 验证:完整make verify、隔离PostgreSQL全mirror竞态回归、真实恢复库浏览器验收通过。 浏览器实测字段精确读回、月周双输入、模板预填、MD/CSV、自动保存、冲突、失败重试与API重启恢复。 未连接或改写DobotAI生产源库,未运行付费模型;提交时尚未部署。
64 lines
2.6 KiB
TypeScript
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),
|
|
}
|