Files
knowledge-governance/web/src/qaInlineFields.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

74 lines
3.2 KiB
TypeScript

import { fetchQARecord, getPayload, qaCellValue } from './qaOps'
import type { QARecord } from './qaOps'
export const editableFieldKeys = ['coverage', 'is_correct', 'product_category', 'problem_type', 'root_cause'] as const
export type EditableField = (typeof editableFieldKeys)[number]
export type FieldOptions = Record<EditableField, string[]>
export function parseFieldOptions(raw: unknown): FieldOptions {
if (!raw || typeof raw !== 'object' || Array.isArray(raw)) throw Error('主表选项读取失败')
const v = raw as Record<string, unknown>
if (v.version !== 'qa-master-options-v1' || !v.fields || typeof v.fields !== 'object' || Array.isArray(v.fields))
throw Error('主表选项版本无效')
const fields = v.fields as Record<string, unknown>
if (Object.keys(fields).length !== editableFieldKeys.length) throw Error('主表选项不完整')
const result = {} as FieldOptions
for (const key of editableFieldKeys) {
const values = fields[key]
if (
!Array.isArray(values) ||
!values.length ||
values.some((v) => typeof v !== 'string' || !v.trim()) ||
new Set(values).size !== values.length
)
throw Error('主表选项不完整')
result[key] = values as string[]
}
return result
}
export async function fetchFieldOptions(signal?: AbortSignal) {
return parseFieldOptions(await getPayload('/api/v1/qa-ops/master/field-options', signal))
}
export function editableFieldValue(record: QARecord, field: EditableField): string {
if (field === 'root_cause' && qaCellValue(record, 'is_correct') === '是') return ''
const value = qaCellValue(record, field) ?? ''
return field === 'coverage' && value === '不计入' ? '否但不计入' : value
}
export async function saveInlineField(
record: QARecord,
field: EditableField,
value: string,
nonce: string,
signal?: AbortSignal
): Promise<QARecord> {
if (!record.record_origin || !record.quality) throw Error('此记录暂不可修改,请重新读取')
const q = record.quality
const raw = await getPayload(`/api/v1/qa-ops/master/records/${encodeURIComponent(record.id)}/fields`, signal, {
method: 'POST',
headers: { 'Content-Type': 'application/json', 'X-Governance-Action': 'qa-master-fields' },
body: JSON.stringify({
input_hash: q.input_hash,
input_epoch: q.input_epoch,
base_revision: record.field_edit_revision ?? 0,
base_review_revision: q.revision,
nonce,
fields: { [field]: value },
}),
})
if (!raw || typeof raw !== 'object' || Array.isArray(raw)) throw Error('字段保存回执无效,请重试读取')
const receipt = raw as Record<string, unknown>
if (
!Number.isSafeInteger(receipt.saved_revision) ||
Number(receipt.saved_revision) < 1 ||
typeof receipt.replayed !== 'boolean'
)
throw Error('字段保存回执无效,请重试读取')
const fresh = await fetchQARecord(record.id, signal, 'master')
if (
fresh.field_edit_revision !== receipt.saved_revision ||
fresh.quality?.input_hash !== q.input_hash ||
fresh.quality.revision !== q.revision ||
editableFieldValue(fresh, field) !== value
)
throw Error('保存后字段再次变化,未将旧结果标为成功,请重新读取核对')
return fresh
}