From 93aabc8a81d5e15c459844ef2e25bd87b79c7bdf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=A7=9A=E7=AB=A0=E6=B5=A9?= Date: Sun, 18 Oct 2026 20:00:38 +0800 Subject: [PATCH] =?UTF-8?q?feat(qa-ops):=20=E9=87=8D=E5=81=9A=E5=9B=9B?= =?UTF-8?q?=E9=A1=B5=E5=B8=83=E5=B1=80=E4=B8=8E=E5=91=A8=E6=8A=A5=E8=8D=89?= =?UTF-8?q?=E7=A8=BF=E5=AF=BC=E5=87=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CHANGELOG.md | 12 ++ web/src/QAAnswerMarkdown.test.tsx | 2 +- web/src/QAAnswerMarkdown.tsx | 2 +- web/src/QADashboard.test.tsx | 42 +++++ web/src/QADashboard.tsx | 223 +++++++++++++++++++++++++++ web/src/QAMirrorSync.test.tsx | 4 +- web/src/QAMirrorSync.tsx | 5 +- web/src/QAOperations.test.tsx | 15 +- web/src/QAOperations.tsx | 244 +++++++++++++----------------- web/src/QARegions.test.tsx | 2 +- web/src/QARegions.tsx | 9 +- web/src/QAWeekPicker.test.tsx | 3 +- web/src/QAWeekPicker.tsx | 1 - web/src/QAWeekly.tsx | 97 ++++++++++++ web/src/qaDashboard.css | 244 ++++++++++++++++++++++++++++++ web/src/qaDashboard.ts | 50 ++++++ web/src/qaWeekly.test.ts | 107 +++++++++++++ web/src/qaWeekly.ts | 132 ++++++++++++++++ 18 files changed, 1037 insertions(+), 157 deletions(-) create mode 100644 web/src/QADashboard.test.tsx create mode 100644 web/src/QADashboard.tsx create mode 100644 web/src/QAWeekly.tsx create mode 100644 web/src/qaDashboard.css create mode 100644 web/src/qaDashboard.ts create mode 100644 web/src/qaWeekly.test.ts create mode 100644 web/src/qaWeekly.ts diff --git a/CHANGELOG.md b/CHANGELOG.md index 2fff4e2..043e0a9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -76,6 +76,18 @@ > `0.1.12`),由 `scripts/version.py` 从 git **算出来**;开发交付的独立说明写入本文件“开发快照”章节,并打 `snapshot/vX.Y.Z` 注释标签 ⇒ 每次开发交付均可追溯, > 但"发布版本"仍然只能由人定(CI 不会自动升版本、不会打 tag)。 +## 开发快照 snapshot/v0.1.29 - 2026-10-18 + +### Added + +- 问答运营调整为“问题流水、问题统计看板、区域配置、周报生成”四页,流水与看板共用年份、自然周和查询条件;区域页不再显示问题查询框,完整字段及人工复核入口保留。 +- 重做统计看板:展示完整筛选范围的问题量、覆盖率、正确率、人工复核、北京时间每日趋势、质量分布、区域、问题类型和产品分类;个人月明细折叠保留,未知分类与零分母不虚构结论。 +- 周报页提供手动草稿、Markdown 预览及 MD/完整明细 CSV 下载。核对副本版本、完整数量、质量范围与覆盖分布后生成;CSV 保留完整十五列并防护公式注入,不发送、不归档、不作为正式持久化周报验收。 + +### Changed + +- 删除问答记录、同步栏和区域页中的冗余解释文字、读取时间与源连接提示,保留真实错误、未同步、权限阻断和安全告警。 + ## 开发快照 snapshot/v0.1.28 - 2026-10-18 ### Added diff --git a/web/src/QAAnswerMarkdown.test.tsx b/web/src/QAAnswerMarkdown.test.tsx index 9d8264b..befbdf8 100644 --- a/web/src/QAAnswerMarkdown.test.tsx +++ b/web/src/QAAnswerMarkdown.test.tsx @@ -25,6 +25,6 @@ describe('AI answer Markdown preview', () => { expect(html).toContain('查看图片') }) it('does not confuse an empty answer with a positive assessment', () => { - expect(renderToStaticMarkup()).toContain('尚无答案;不默认判覆盖或正确') + expect(renderToStaticMarkup()).toContain('暂无答案') }) }) diff --git a/web/src/QAAnswerMarkdown.tsx b/web/src/QAAnswerMarkdown.tsx index 4d4ef0c..f030c05 100644 --- a/web/src/QAAnswerMarkdown.tsx +++ b/web/src/QAAnswerMarkdown.tsx @@ -16,7 +16,7 @@ export function safeAnswerURL(value: string): string { export function QAAnswerMarkdown({ answer }: { answer: string }) { const [showImages, setShowImages] = useState(false) - if (!answer) return

尚无答案;不默认判覆盖或正确

+ if (!answer) return

暂无答案

return (
diff --git a/web/src/QADashboard.test.tsx b/web/src/QADashboard.test.tsx new file mode 100644 index 0000000..c7d5634 --- /dev/null +++ b/web/src/QADashboard.test.tsx @@ -0,0 +1,42 @@ +import { renderToStaticMarkup } from 'react-dom/server' +import { describe, it, expect, vi } from 'vitest' +import { qaDailySeries, qaCategorySeries } from './qaDashboard' +import { QADashboardView } from './QADashboard' +import type { QARecord, QAQuery } from './qaOps' +const query: QAQuery = { start: '2026-10-11T16:00:00Z', end: '2026-10-13T16:00:00Z', keyword: '', cursor: '' } +const records = [ + { id: 'a', asked_at: '2026-10-11T16:30:00Z', product_category: '', problem_type: '通信' }, + { id: 'b', asked_at: '2026-10-12T16:01:00Z' }, +] as QARecord[] +describe('question dashboard projections', () => { + it('groups by Beijing day and keeps zero days instead of using the browser timezone', () => { + expect(qaDailySeries(records, query)).toEqual([ + { label: '2026-10-12', count: 1 }, + { label: '2026-10-13', count: 1 }, + ]) + expect(qaDailySeries([], query).map((p) => p.count)).toEqual([0, 0]) + }) + it('keeps unclassified records distinct without inventing a category', () => { + expect(qaCategorySeries(records, 'problem_type')).toEqual([ + { label: '通信', count: 1 }, + { label: '未分类', count: 1 }, + ]) + }) + it('renders the real dashboard panels and escaped category text', () => { + const html = renderToStaticMarkup( + + ) + for (const title of ['问题总量', '每日提问趋势', '质量分布', '区域分布', '产品分类', '问题类型']) + expect(html).toContain(title) + expect(html).not.toContain(' void +} +const percent = (r: QualityRate | undefined) => (r?.percent == null ? '—' : `${r.percent.toFixed(1)}%`) +function Bars({ points }: { points: QACountPoint[] }) { + const max = Math.max(1, ...points.map((p) => p.count)) + return points.length ? ( +
+ {points.map((p) => ( +
+ {p.label} +
+ +
+ {p.count} +
+ ))} +
+ ) : ( +

暂无数据

+ ) +} +export function QADashboardView(p: QADashboardProps) { + const page = p.loading ? null : p.page, + items = page?.items || [], + q = page && p.quality?.summary.total === page.total ? p.quality : null + const b = q?.summary.rates.breakdown + const daily = page && p.query ? qaDailySeries(items, p.query) : [] + const max = Math.max(1, ...daily.map((d) => d.count)) + const outcomes = b + ? [ + ['已覆盖', b.covered], + ['未覆盖', b.uncovered], + ['部分覆盖', b.partial], + ['待确认', b.pending], + ['未评估', b.unassessed], + ['不计入', b.excluded], + ['待重新核对', b.stale], + ].map(([label, count]) => ({ label: String(label), count: Number(count) })) + : [] + return ( +
+ {p.error ? ( +
+ {p.error}{' '} + +
+ ) : null} + {p.loading ?

正在读取完整统计范围…

: null} +
+
+ 问题总量 + {page?.total ?? '—'} + 条 +
+
+ 知识覆盖率 + {percent(q?.summary.rates.coverage)} + + {q ? `${q.summary.rates.coverage.numerator} / ${q.summary.rates.coverage.denominator}` : '分子 / 分母'} + +
+
+ 回答正确率 + {percent(q?.summary.rates.correctness)} + + {q + ? `${q.summary.rates.correctness.numerator} / ${q.summary.rates.correctness.denominator}` + : '分子 / 分母'} + +
+
+ 已人工复核 + {q?.summary.reviewed ?? '—'} + {q ? `待复核 ${q.summary.unreviewed}` : '条'} +
+
+
+
+

每日提问趋势

+ {daily.length ? ( +
+ {daily.map((d) => ( +
+ {d.count} +
+ +
+ {d.label.slice(5)} +
+ ))} +
+ ) : ( +

暂无数据

+ )} +
+
+

质量分布

+ +
+
+

区域分布

+ r.questions > 0) + .map((r) => ({ label: usageLabels[r.key] || r.key, count: r.questions })) || [] + } + /> + {p.usage ? ( +
+ + + + + + + + + + {p.usage.rows + .filter((r) => r.questions > 0 || r.roster_people !== null) + .map((r) => ( + + + + + + ))} + +
区域提问量已关联使用人数
{usageLabels[r.key] || r.key}{r.questions}{r.users ?? '—'}
+
+ ) : null} +
+
+

问题类型

+ +
+
+

产品分类

+ +
+
+
+ ) +} +export function QADashboard({ + page, + query, + loading, + error, + revision, + onRetry, +}: { + page: QARecordPage | null + query: QAQuery | null + loading: boolean + error: string | null + revision: number + onRetry: () => void +}) { + const [quality, setQuality] = useState(null), + [usage, setUsage] = useState(null), + [failure, setFailure] = useState(''), + [monthly, setMonthly] = useState(false) + useEffect(() => { + setQuality(null) + setUsage(null) + setFailure('') + if (!query) return + const abort = new AbortController() + void fetchQADashboardQuality(query, abort.signal) + .then((v) => { + if (!abort.signal.aborted) setQuality(v) + }) + .catch((e) => { + if (!abort.signal.aborted) setFailure(e instanceof Error ? e.message : '质量统计读取失败') + }) + void fetchQAUsage(query, abort.signal) + .then((v) => { + if (!abort.signal.aborted) setUsage(v) + }) + .catch((e) => { + if (!abort.signal.aborted) setFailure(e instanceof Error ? e.message : '区域统计读取失败') + }) + return () => abort.abort() + }, [query, revision]) + const mismatch = !!page && !!quality && page.total !== quality.summary.total + return ( +
+ +
setMonthly(e.currentTarget.open)}> + 个人月明细 + {monthly ? : null} +
+
+ ) +} diff --git a/web/src/QAMirrorSync.test.tsx b/web/src/QAMirrorSync.test.tsx index 5bf3cbd..bc7a23b 100644 --- a/web/src/QAMirrorSync.test.tsx +++ b/web/src/QAMirrorSync.test.tsx @@ -22,7 +22,7 @@ describe('local Q&A synchronization strip', () => { expect(html).toContain('本地数据库') expect(html).toContain('首次同步尚未完成') expect(html).toContain('立即同步') - expect(html).toContain('每 5 分钟') + expect(html).not.toContain('每 5 分钟后台同步 · 查询不请求远端') }) it('keeps the last-good dataset visibly stale after a failed sync', () => { const status = { @@ -38,7 +38,7 @@ describe('local Q&A synchronization strip', () => { const html = renderToStaticMarkup() expect(html).toContain('639') expect(html).toContain('保留上次成功数据') - expect(html).toContain('最近成功同步') + expect(html).not.toContain('不承诺实时源快照') }) it('distinguishes authorization blocking from an ordinary network failure', () => { const html = renderToStaticMarkup( diff --git a/web/src/QAMirrorSync.tsx b/web/src/QAMirrorSync.tsx index 4bb8019..ddbc3d0 100644 --- a/web/src/QAMirrorSync.tsx +++ b/web/src/QAMirrorSync.tsx @@ -9,7 +9,6 @@ interface ViewProps { submitting: boolean onSync: () => void } -const stamp = (v: string) => new Date(v).toLocaleString('zh-CN', { hour12: false }) export function QAMirrorSyncView(p: ViewProps) { const s = p.status const active = mirrorSyncActive(s) @@ -17,7 +16,7 @@ export function QAMirrorSyncView(p: ViewProps) {
本地数据库 - 每 5 分钟后台同步 · 查询不请求远端 + {s?.ready ? 已同步 {s.records} 条 : null} + ))} + + ) +} interface ViewProps { onQualitySaved?: (record: QARecord) => void onReloadDetail?: () => void @@ -30,7 +49,6 @@ interface ViewProps { progress?: { loaded: number; total: number } onRetry: () => void } -const stateLabels = { disabled: '未配置', unavailable: '连接不可用', blocked: '接入被阻断', connected: '已连接' } const warningLabels: Record = { database_temp_enabled: '数据库仍允许临时对象:未视为完全只读验收通过', database_transport_unencrypted: '数据库连接未启用 TLS:上线前须完成传输安全审核', @@ -59,17 +77,8 @@ export function QAOperationsView(props: ViewProps) { ? `共 ${page.total} 条 · 已展示 ${page.items.length} 条` : '尚未读取问答'} - - DobotAI 2.0 / 钉钉 · 本地问答副本{props.status ? ` · ${stateLabels[props.status.state]}` : ''} -
- {page?.organization ? ( -

- {page.organization.state === 'ready' - ? `缺失组织信息按当前通讯录补全(${stamp(page.organization.synced_at!)}),不代表提问时归属。目录:${page.organization.directory_id};区域版本:${page.organization.revision_id || '未保存'}` - : '尚无完整通讯录,仅展示源端已有组织快照,不根据姓名推断。'} -

- ) : null} + {props.status?.warnings.map((warning) => (

{warningLabels[warning] ?? '数据源有待审核的安全告警'} @@ -138,12 +147,7 @@ export function QAOperationsView(props: ViewProps) { ) : page && !props.loading && !props.error ? (

没有符合条件的问答,请调整时间范围或关键词。

) : null} - {page ? ( -
- 本次读取:{stamp(page.as_of)} · 固定显示完整字段,左右滚动查看;— 表示暂无数据 - {page.items.length === page.total ? '已全部展示' : '全量读取尚未完成'} -
- ) : null} + {showDrawer ? ( <> - - - - {view === 'usage' ? ( - - ) : null} - {view === 'usage' && usageMode === 'monthly' ? ( - - ) : view === 'regions' ? ( - - ) : ( + + {queryView ? ( <> + { + if (detail || detailLoading) { + setMirrorChanged(true) + return + } + setQuery((q) => (q ? { ...q } : q)) + setRevision((v) => v + 1) + setQualityRevision((v) => v + 1) + }} + /> + {mirrorChanged ?

数据已更新,关闭详情后刷新。

: null}
- {view === 'records' ? ( - { - const current = initialDraft() - setDraft({ ...current, keyword: draft.keyword }) - setQuery({ - start: qaDateTimeToISO(current.start), - end: qaDateTimeToISO(current.end), - keyword: draft.keyword, - cursor: '', - }) - }} - onChange={(year, week) => { - setDraft((old) => { - if (week === null) return { ...old, year, week } - const { start, end } = qaWeekQueryRange(year, week) - return { ...old, year, week, start, end } - }) - }} - /> - ) : null} + { + const current = initialDraft() + setDraft({ ...current, keyword: draft.keyword }) + setQuery({ + start: qaDateTimeToISO(current.start), + end: qaDateTimeToISO(current.end), + keyword: draft.keyword, + cursor: '', + }) + }} + onChange={(year, week) => + setDraft((old) => + week === null ? { ...old, year, week } : { ...old, ...qaWeekQueryRange(year, week) } + ) + } + /> -

- 部门/区域保留源快照,缺失时按当前通讯录补全;使用统计不是绩效结论。外语翻译与AI评估仍暂缓,空值不默认填“否”。 -

- {view === 'records' ? : null} - {view === 'usage' ? ( - - ) : ( - { - if (detail) void select(detail.id) - }} - onQualitySaved={(fresh) => { - if (fresh.id !== detail?.id) return - setDetail(fresh) - setPage((old) => { - if (!old) return old - const all = new Set(old.columns) - const f = fresh.quality?.effective - if (f) { - if (f.coverage) all.add('coverage') - if (f.correctness) all.add('is_correct') - for (const key of ['product_category', 'problem_type', 'root_cause'] as const) - if (f[key]) all.add(key) - } - return { - ...old, - items: old.items.map((item) => (item.id === fresh.id ? fresh : item)), - columns: qaColumns.filter((c) => all.has(c.key)).map((c) => c.key), - } - }) - setQualityRevision((v) => v + 1) - }} - onSelect={(id) => void select(id)} - onCloseDetail={close} - progress={progress} - onRetry={() => setRevision((value) => value + 1)} - /> - )} + ) : null} + {view === 'regions' ? ( + + ) : view === 'weekly' ? ( + + ) : view === 'dashboard' ? ( + { + setRevision((v) => v + 1) + setQualityRevision((v) => v + 1) + }} + /> + ) : ( + { + if (detail) void select(detail.id) + }} + onQualitySaved={(fresh) => { + if (fresh.id !== detail?.id) return + setDetail(fresh) + setPage((old) => + old ? { ...old, items: old.items.map((item) => (item.id === fresh.id ? fresh : item)) } : old + ) + setQualityRevision((v) => v + 1) + }} + onSelect={(id) => void select(id)} + onCloseDetail={close} + progress={progress} + onRetry={() => setRevision((v) => v + 1)} + /> )} )} diff --git a/web/src/QARegions.test.tsx b/web/src/QARegions.test.tsx index 2923234..2884f31 100644 --- a/web/src/QARegions.test.tsx +++ b/web/src/QARegions.test.tsx @@ -87,7 +87,7 @@ describe('region mapping workbench', () => { const html = renderToStaticMarkup() expect(html).toContain('历史快照') expect(html).toContain('跨区域待核对:1') - expect(html).toContain('配置区域归属不等于纳入绩效考核') + expect(html).not.toContain('配置区域归属不等于纳入绩效考核') expect(html).not.toContain('') expect(html).not.toContain('达标率') expect(html).toMatch(/disabled=""[^>]*>保存归属/) diff --git a/web/src/QARegions.tsx b/web/src/QARegions.tsx index 07e94c3..1209d4f 100644 --- a/web/src/QARegions.tsx +++ b/web/src/QARegions.tsx @@ -85,9 +85,7 @@ export function RegionMappingView(p: Props) { {p.state.revision_id || '尚未保存'}

) : null} -

- 父部门包含子部门,子部门单独配置优先。配置区域归属不等于纳入绩效考核;跨区域多部门人员先待核对。 -

+ {p.error ? (

{p.error} @@ -97,7 +95,7 @@ export function RegionMappingView(p: Props) { {!p.state ? (

{p.busy ? '正在读取通讯录…' : '尚未读取通讯录'}

) : !available ? ( -

尚无完整通讯录快照。先接入已验证的全量同步结果,不能使用按需人员缓存或编造部门。

+

暂无通讯录,请先同步。

) : ( <>
@@ -185,9 +183,6 @@ export function RegionMappingView(p: Props) { {!departments.length ?

没有匹配的部门路径

: null}
-

- 此处仅预览通讯录归属人数;2.0 使用次数、考核名单与绩效统计尚未接入。不会将未知在职状态当作已确认在职人数。 -

)}
diff --git a/web/src/QAWeekPicker.test.tsx b/web/src/QAWeekPicker.test.tsx index 9a99a17..6bcd202 100644 --- a/web/src/QAWeekPicker.test.tsx +++ b/web/src/QAWeekPicker.test.tsx @@ -15,8 +15,7 @@ describe('QA week picker', () => { expect(html).toContain('value="40" selected=""') expect(html).toContain('第40周(09-28 到 10-04)') expect(html).toContain('第53周(2026-12-28 到 2027-01-03)') - expect(html).toContain('北京时间') - expect(html).toContain('周一至周日') + expect(html).not.toContain('北京时间 · 周一至周日 · 本周截至当前') }) it('preserves custom range mode and does not offer invalid week 53', () => { const html = renderToStaticMarkup() diff --git a/web/src/QAWeekPicker.tsx b/web/src/QAWeekPicker.tsx index 49d3579..f0f4b85 100644 --- a/web/src/QAWeekPicker.tsx +++ b/web/src/QAWeekPicker.tsx @@ -50,7 +50,6 @@ export function QAWeekPicker({ year, week, onChange, onCurrentWeek }: Props) { - 北京时间 · 周一至周日 · 本周截至当前
) } diff --git a/web/src/QAWeekly.tsx b/web/src/QAWeekly.tsx new file mode 100644 index 0000000..770fa40 --- /dev/null +++ b/web/src/QAWeekly.tsx @@ -0,0 +1,97 @@ +import { useEffect, useRef, useState } from 'react' +import type { QAQuery } from './qaOps' +import { fetchAllQARecords } from './qaOps' +import { fetchQADashboardQuality } from './qaDashboard' +import { fetchQAMirrorStatus } from './qaMirror' +import { buildQAWeeklyDraft, downloadQAWeekly } from './qaWeekly' +import type { QAWeeklyDraft } from './qaWeekly' +import { QAAnswerMarkdown } from './QAAnswerMarkdown' +export function QAWeekly({ query }: { query: QAQuery | null }) { + const [draft, setDraft] = useState(null), + [loading, setLoading] = useState(false), + [error, setError] = useState('') + const request = useRef(null) + useEffect(() => { + request.current?.abort() + setDraft(null) + setError('') + setLoading(false) + return () => request.current?.abort() + }, [query]) + const generate = async () => { + if (!query || loading) return + request.current?.abort() + const controller = new AbortController() + request.current = controller + setLoading(true) + setDraft(null) + setError('') + try { + const before = await fetchQAMirrorStatus(controller.signal) + if (!before.ready || before.blocked) throw Error('本地同步未就绪,暂不能生成周报') + const [page, quality] = await Promise.all([ + fetchAllQARecords(query, controller.signal), + fetchQADashboardQuality(query, controller.signal), + ]) + const after = await fetchQAMirrorStatus(controller.signal) + if (!after.ready || after.blocked || before.revision !== after.revision || page.local_revision !== after.revision) + throw Error('本地副本在生成期间已更新,请重新生成') + const result = buildQAWeeklyDraft(page, query, quality, new Date().toISOString()) + if (!controller.signal.aborted) setDraft(result) + } catch (e) { + if (!controller.signal.aborted) setError(e instanceof Error ? e.message : '周报生成失败') + } finally { + if (!controller.signal.aborted) setLoading(false) + } + } + const suffix = query ? new Date(Date.parse(query.start) + 8 * 60 * 60 * 1000).toISOString().slice(0, 10) : 'draft' + return ( +
+
+
+

周报生成

+ {query ? ( + + {new Date(query.start).toLocaleDateString('zh-CN', { timeZone: 'Asia/Shanghai' })} 至{' '} + {new Date(Date.parse(query.end) - 1).toLocaleDateString('zh-CN', { timeZone: 'Asia/Shanghai' })} + + ) : null} +
+ + {draft ? ( + <> + 草稿 · {draft.questions} 条 + + + + ) : null} +
+ {error ? ( +

+ {error} +

+ ) : null} + {draft ? ( +
+ +
+ ) : ( +
{loading ? '正在汇总本地问答…' : '尚未生成周报。'}
+ )} +
+ ) +} diff --git a/web/src/qaDashboard.css b/web/src/qaDashboard.css new file mode 100644 index 0000000..45106cb --- /dev/null +++ b/web/src/qaDashboard.css @@ -0,0 +1,244 @@ +.qa-dashboard-scroll { + min-height: 0; + overflow: auto; + flex: 1; + overscroll-behavior: contain; +} +.qa-dashboard { + min-width: 0; + display: flex; + flex-direction: column; + gap: 16px; +} +.qa-dashboard-metrics { + display: grid; + grid-template-columns: repeat(4, minmax(0, 1fr)); + border: 1px solid var(--border-base); + background: var(--bg-panel); +} +.qa-dashboard-metrics > div { + padding: 18px 22px; + display: flex; + flex-direction: column; + gap: 8px; + border-right: 1px solid var(--border-base); +} +.qa-dashboard-metrics > div:last-child { + border-right: 0; +} +.qa-dashboard-metrics span { + color: var(--ink-mute); + font-size: 12px; +} +.qa-dashboard-metrics strong { + color: var(--ink-strong); + font-size: 30px; + font-weight: 650; + font-variant-numeric: tabular-nums; + letter-spacing: -0.04em; +} +.qa-dashboard-metrics small { + font-size: 11px; + color: var(--ink-mute); +} +.qa-dashboard-grid { + display: grid; + grid-template-columns: minmax(0, 1.6fr) minmax(260px, 1fr); + gap: 14px; +} +.qa-chart { + min-width: 0; + padding: 18px 20px; + background: var(--bg-panel); + border: 1px solid var(--border-base); +} +.qa-chart-full { + grid-column: 1/-1; +} +.qa-chart h3 { + font-size: 14px; + font-weight: 600; + margin: 0 0 20px; + color: var(--ink-strong); +} +.qa-chart-bars { + display: grid; + gap: 13px; +} +.qa-chart-bar { + display: grid; + grid-template-columns: minmax(70px, 120px) minmax(0, 1fr) 40px; + gap: 12px; + align-items: center; + font-size: 12px; +} +.qa-chart-bar > span { + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; +} +.qa-chart-bar b { + text-align: right; + font-weight: 500; + font-variant-numeric: tabular-nums; +} +.qa-chart-track { + height: 7px; + background: var(--bg-canvas, #f1f5f9); + overflow: hidden; + border-radius: 2px; +} +.qa-chart-track i { + display: block; + height: 100%; + background: #377bc9; + border-radius: 2px; +} +.qa-chart-empty { + padding: 28px 0; + text-align: center; + color: var(--ink-mute); + font-size: 12px; +} +.qa-daily-chart { + display: flex; + gap: clamp(6px, 1.5vw, 22px); + height: 180px; + align-items: stretch; + overflow-x: auto; +} +.qa-daily-chart > div { + flex: 1; + min-width: 24px; + display: flex; + flex-direction: column; + align-items: center; + gap: 7px; + font-size: 11px; + color: var(--ink-mute); +} +.qa-daily-chart > div > div { + height: 125px; + width: 100%; + display: flex; + align-items: flex-end; + border-bottom: 1px solid var(--border-base); +} +.qa-daily-chart i { + display: block; + width: 100%; + background: #377bc9; + border-radius: 2px 2px 0 0; + min-height: 0; +} +.qa-daily-chart b { + font-size: 11px; + color: var(--ink-strong); + font-variant-numeric: tabular-nums; + font-weight: 500; +} +.qa-dashboard-region-table { + margin-top: 18px; + overflow-x: auto; +} +.qa-dashboard-region-table table { + width: 100%; + font-size: 12px; +} +.qa-dashboard-region-table th, +.qa-dashboard-region-table td { + padding: 8px 10px; + text-align: left; + white-space: normal; +} +.qa-monthly-disclosure { + margin-top: 14px; + border-top: 1px solid var(--border-base); + padding: 14px 0; +} +.qa-monthly-disclosure > summary { + font-size: 13px; + cursor: pointer; +} +.qa-monthly-disclosure .qa-monthly { + min-height: 400px; + max-height: 650px; + margin-top: 12px; + overflow: auto; +} +@media (max-width: 900px) { + .qa-dashboard-grid { + grid-template-columns: minmax(0, 1fr); + } + .qa-chart-full { + grid-column: auto; + } + .qa-dashboard-metrics > div { + padding: 14px; + } + .qa-dashboard-metrics strong { + font-size: 25px; + } +} +@media (max-width: 560px) { + .qa-dashboard-metrics { + grid-template-columns: repeat(2, minmax(0, 1fr)); + } + .qa-dashboard-metrics > div:nth-child(2) { + border-right: 0; + } + .qa-dashboard-metrics > div:nth-child(-n + 2) { + border-bottom: 1px solid var(--border-base); + } + .qa-chart { + padding: 16px 12px; + } + .qa-chart-bar { + grid-template-columns: minmax(65px, 100px) minmax(0, 1fr) 30px; + } +} + +.qa-weekly { + display: flex; + flex-direction: column; + gap: 14px; + min-height: 0; + flex: 1; + overflow: auto; +} +.qa-weekly-toolbar { + display: flex; + align-items: center; + gap: 10px; + flex-wrap: wrap; + padding: 16px; + background: var(--bg-panel); + border: 1px solid var(--border-base); +} +.qa-weekly-toolbar > div { + margin-right: auto; +} +.qa-weekly-toolbar h3 { + font-size: 15px; + margin: 0 0 6px; +} +.qa-weekly-toolbar span { + font-size: 12px; + color: var(--ink-mute); +} +.qa-weekly-badge { + padding: 4px 7px; + border: 1px solid var(--border-base); +} +.qa-weekly-preview { + padding: 20px; + background: var(--bg-panel); + border: 1px solid var(--border-base); + min-width: 0; +} +.qa-weekly-empty { + padding: 50px 20px; + text-align: center; + font-size: 13px; + color: var(--ink-mute); +} diff --git a/web/src/qaDashboard.ts b/web/src/qaDashboard.ts new file mode 100644 index 0000000..1c4878c --- /dev/null +++ b/web/src/qaDashboard.ts @@ -0,0 +1,50 @@ +import type { QARecord, QAQuery } from './qaOps' +import { getPayload } from './qaOps' +import { parseQualitySummary } from './qaQuality' +export type QACountPoint = { label: string; count: number } +const day = 24 * 60 * 60 * 1000, + offset = 8 * 60 * 60 * 1000 +export function qaDailySeries(items: QARecord[], query: QAQuery): QACountPoint[] { + const start = Date.parse(query.start), + end = Date.parse(query.end) + if (!Number.isFinite(start) || !Number.isFinite(end) || start >= end || end - start > 90 * day) + throw Error('统计时间范围无效') + const counts = new Map() + for (let t = Math.floor((start + offset) / day) * day; t <= Math.floor((end - 1 + offset) / day) * day; t += day) + counts.set(new Date(t).toISOString().slice(0, 10), 0) + for (const item of items) { + const stamp = Date.parse(item.asked_at) + if (stamp >= start && stamp < end) { + const key = new Date(stamp + offset).toISOString().slice(0, 10) + counts.set(key, (counts.get(key) || 0) + 1) + } + } + return [...counts].map(([label, count]) => ({ label, count })) +} +export function qaCategorySeries(items: QARecord[], key: 'product_category' | 'problem_type'): QACountPoint[] { + const counts = new Map() + for (const item of items) { + const label = + (item.quality?.state === 'stale' ? '' : item.quality?.effective[key] || item[key] || '').trim() || '未分类' + counts.set(label, (counts.get(label) || 0) + 1) + } + return [...counts] + .map(([label, count]) => ({ label, count })) + .sort((a, b) => b.count - a.count || a.label.localeCompare(b.label, 'zh-CN')) +} +export async function fetchQADashboardQuality(query: QAQuery, signal?: AbortSignal) { + const value = parseQualitySummary( + await getPayload('/api/v1/qa-ops/quality/query', signal, { + method: 'POST', + headers: { 'Content-Type': 'application/json', 'X-Governance-Action': 'qa-quality' }, + body: JSON.stringify({ start: query.start, end: query.end, keyword: query.keyword }), + }) + ) + if ( + Date.parse(value.start) !== Date.parse(query.start) || + Date.parse(value.end) !== Date.parse(query.end) || + value.keyword !== query.keyword + ) + throw Error('质量统计与当前查询范围不一致') + return value +} diff --git a/web/src/qaWeekly.test.ts b/web/src/qaWeekly.test.ts new file mode 100644 index 0000000..5559d35 --- /dev/null +++ b/web/src/qaWeekly.test.ts @@ -0,0 +1,107 @@ +import { describe, it, expect } from 'vitest' +import { renderToStaticMarkup } from 'react-dom/server' +import { createElement } from 'react' +import { QAAnswerMarkdown } from './QAAnswerMarkdown' +import { buildQAWeeklyDraft } from './qaWeekly' +import type { QARecordPage, QAQuery } from './qaOps' +import type { QualitySummary } from './qaQuality' +const query: QAQuery = { start: '2026-10-11T16:00:00Z', end: '2026-10-18T10:00:00Z', keyword: '', cursor: '' } +const page = { + items: [ + { + id: 'fixture', + status: 'succeeded', + time_source: 'request_message.created_at', + asker: 'fixture person', + trigger_person: '', + department: '', + region: '', + references: [], + media: [], + source_coverage: { verdict: '', reason_code: '', evaluator_version: '' }, + question: '=HYPERLINK("https://example.invalid")', + answer: '暂无已发布', + asked_at: '2026-10-14T00:00:00Z', + coverage: { + verdict: 'uncovered', + state: 'checked', + rule_version: 'governance-answer-substring-v1', + matched_text: '暂无已发布', + }, + feedback: { asker_value: '', up: 0, down: 0 }, + }, + ], + columns: [], + total: 1, + has_more: false, + next_cursor: '', + as_of: query.end, + local_revision: 1, +} as QARecordPage +const quality = { + start: query.start, + end: query.end, + keyword: '', + as_of: query.end, + scope: 'whole_filter', + ai_state: 'not_configured', + summary: { + total: 1, + reviewed: 0, + unreviewed: 1, + stale: 0, + pending_confirmation: 0, + rule_uncovered: 1, + rates: { + policy_version: 'quality-rates-human-first-v1', + coverage: { numerator: 0, denominator: 1, percent: 0 }, + correctness: { numerator: 0, denominator: 0, percent: null }, + breakdown: { + covered: 0, + uncovered: 1, + partial: 0, + pending: 0, + unassessed: 0, + excluded: 0, + stale: 0, + covered_correct: 0, + covered_incorrect: 0, + covered_pending: 0, + covered_unassessed: 0, + }, + }, + }, +} as QualitySummary +describe('weekly draft export', () => { + it('builds preview and downloadable evidence from the same complete query without invented correctness', () => { + const d = buildQAWeeklyDraft(page, query, quality, '2026-10-18T10:00:00Z') + expect(d.questions).toBe(1) + expect(d.revision).toBe(1) + expect(d.markdown).toContain('周报(草稿)') + expect(d.markdown).toContain('正确率:—') + expect(renderToStaticMarkup(createElement(QAAnswerMarkdown, { answer: d.markdown }))).toContain(' { + const input = { + ...page, + items: page.items.map((r) => ({ + ...r, + question: '中文 [链接](https://example.invalid) **危险**' + String.fromCharCode(10) + '第二行', + })), + } + const d = buildQAWeeklyDraft(input, query, quality, query.end) + const html = renderToStaticMarkup(createElement(QAAnswerMarkdown, { answer: d.markdown })) + expect(html).not.toContain('>链接') + expect(html).not.toContain('危险') + expect(d.markdown).not.toContain(String.fromCharCode(10) + '第二行') + }) + it('refuses incomplete ranges or statistics from another scope', () => { + expect(() => buildQAWeeklyDraft({ ...page, has_more: true }, query, quality, query.end)).toThrow() + expect(() => buildQAWeeklyDraft(page, query, { ...quality, keyword: 'other' }, query.end)).toThrow() + }) +}) diff --git a/web/src/qaWeekly.ts b/web/src/qaWeekly.ts new file mode 100644 index 0000000..eb30086 --- /dev/null +++ b/web/src/qaWeekly.ts @@ -0,0 +1,132 @@ +import type { QARecordPage, QAQuery } from './qaOps' +import { qaCellValue, qaColumns } from './qaOps' +import type { QualitySummary, QualityRate } from './qaQuality' +import { qaDailySeries, qaCategorySeries } from './qaDashboard' +export interface QAWeeklyDraft { + markdown: string + csv: string + questions: number + revision: number + generatedAt: string +} +const stamp = (v: string) => new Date(v).toLocaleString('zh-CN', { timeZone: 'Asia/Shanghai', hour12: false }) +const rate = (v: QualityRate) => + v.percent === null ? '—' : `${v.percent.toFixed(1)}%(${v.numerator} / ${v.denominator})` +const cell = (v: unknown) => + String(v ?? '') + .replace(/&/g, '&') + .replace(//g, '>') + .replace(/[\`*_[\]|]/g, '\\$&') + .replace(/[\r\n]+/g, ' ') +function csvCell(value: unknown) { + const v = String(value ?? '') + const safe = /^[\t\r\n]|^\s*[=+\-@]/.test(v) ? "'" + v : v + return '"' + safe.replace(/"/g, '""') + '"' +} +export function buildQAWeeklyDraft( + page: QARecordPage, + query: QAQuery, + quality: QualitySummary, + generatedAt: string +): QAWeeklyDraft { + if ( + page.has_more || + page.items.length !== page.total || + new Set(page.items.map((i) => i.id)).size !== page.total || + quality.summary.total !== page.total || + Date.parse(quality.start) !== Date.parse(query.start) || + Date.parse(quality.end) !== Date.parse(query.end) || + quality.keyword !== query.keyword || + !Number.isFinite(Date.parse(generatedAt)) + ) + throw Error('周报范围或完整性不一致,请重新生成') + const groups: Record = { + covered: 0, + uncovered: 0, + partial: 0, + pending: 0, + unassessed: 0, + excluded: 0, + stale: 0, + } + for (const r of page.items) { + const state = + r.quality?.state === 'stale' ? 'stale' : r.quality?.effective.coverage || r.coverage?.verdict || 'unassessed' + const key = state === 'unknown' ? 'unassessed' : state + if (!(key in groups)) throw Error('周报存在未知覆盖状态') + groups[key]++ + } + for (const [key, count] of Object.entries(groups)) + if (quality.summary.rates.breakdown[key as keyof typeof quality.summary.rates.breakdown] !== count) + throw Error('复核结果在生成期间发生变化,请重新生成') + const s = quality.summary + const daily = qaDailySeries(page.items, query) + .map((p) => `| ${p.label} | ${p.count} |`) + .join('\n') + const products = qaCategorySeries(page.items, 'product_category') + .map((p) => `| ${cell(p.label)} | ${p.count} |`) + .join('\n') + const gaps = page.items.filter( + (r) => (r.quality?.effective.coverage || r.coverage?.verdict) === 'uncovered' && r.quality?.state !== 'stale' + ) + const md = + [ + '# DobotAI 问答运营周报(草稿)', + `统计范围:${stamp(query.start)} 至 ${stamp(query.end)}(结束不含)`, + query.keyword ? `关键词:${cell(query.keyword)}` : '', + `生成:${stamp(generatedAt)}`, + `本地数据版本:${page.local_revision ?? '—'}`, + '## 问答概览', + `- 问题总量:${page.total}`, + `- 知识覆盖率:${rate(s.rates.coverage)}`, + `- 回答正确率:${rate(s.rates.correctness)}`, + `- 已人工复核:${s.reviewed}`, + `- 待重新核对:${s.stale}`, + `- 人工待确认:${s.pending_confirmation}`, + '## 质量分布', + '| 已覆盖 | 未覆盖 | 部分覆盖 | 待确认 | 未评估 | 不计入 | 待重新核对 |', + '| --- | --- | --- | --- | --- | --- | --- |', + `| ${groups.covered} | ${groups.uncovered} | ${groups.partial} | ${groups.pending} | ${groups.unassessed} | ${groups.excluded} | ${groups.stale} |`, + '## 每日提问', + '| 日期 | 问题量 |', + '| --- | ---: |', + daily, + '## 产品分类', + '| 分类 | 问题量 |', + '| --- | ---: |', + products, + '## 未覆盖问题', + gaps.length ? '| 提问时间 | 问题 | 产品分类 |' : '当前无有效未覆盖记录', + gaps.length ? '| --- | --- | --- |' : '', + ...gaps.map( + (r) => + `| ${stamp(r.asked_at)} | ${cell(qaCellValue(r, 'question_chinese') || r.question)} | ${cell(r.quality?.effective.product_category || r.product_category || '—')} |` + ), + ] + .filter(Boolean) + .join('\n\n') + '\n' + const csv = + '\ufeff' + + [ + qaColumns.map((c) => csvCell(c.label)).join(','), + ...page.items.map((row) => qaColumns.map((c) => csvCell(qaCellValue(row, c.key))).join(',')), + ].join('\r\n') + return { + markdown: md.replace(/\|\n\n\|/g, '|\n|'), + csv, + questions: page.total, + revision: page.local_revision ?? 0, + generatedAt, + } +} +export function downloadQAWeekly(content: string, filename: string, type: string) { + const url = URL.createObjectURL(new Blob([content], { type })) + const a = document.createElement('a') + a.href = url + a.download = filename + document.body.append(a) + a.click() + a.remove() + setTimeout(() => URL.revokeObjectURL(url), 1000) +}