Excel 导入改造期 3:网格交互、自助修复、按期累积——每月的报表可以累积成一份跨月的表,漂移了点修复按钮就能接着导入,网格上框一块就能写进配方,版本页可以回滚、移除一期、清除原件

按期累积(新 recipe_accumulate;table_versions 扩展)
- 按统计期出的交叉表报表首次导入时默认「按期累积」,由人确认;一期一个构建,两期及以上物化成一份新的 SQLite 快照,不用视图
- 统计期完全相同要勾「替换该期」,部分重叠拒收,中间有空缺要确认;物化前逐期核对库哈希和行号,并集上另加行数守恒、主键唯一、日期落在所属统计期三条核对
- 配方演进分三档:新增列(早期各期为空值)、退役的列和表保留旧值(只在这次才退役时要勾)、不兼容变化只能显式「重新开始累积」
- 快照 id 在累积时含目标配方和模式;同样的输入物化两次库哈希相同,同一文件换名再传直接复用
- 说明按期合并,任何一期没核对过就不写「已核对」;各期维度取值不同、退役列、合计表都有提示,经过数字检查

修复按钮(新 recipe_fixes;执行器给问题带结构化参数)
- 加入标签、移除标签、声明为合计行、分段标题改名、编辑恒等式成员、按锚点忽略行/列/区域外文字、声明占位符、声明隐藏行处理、工作表改名
- 服务端算补丁,先预览新旧配方对照、再应用,可以撤销;补丁封闭,不引入正则、自由文本常量和写死坐标;修复进确认清单
- 只改分段标题、新标题仍含原来选的词时沿用已确认的常量,不算破坏性变更;修复后只查改动过的段的认领,没改的关系交给试运行核对

框选转锚点(新 recipe_select)
- 网格上框选(鼠标、键盘、区域输入),按八种用途换算成按文字认的锚点,立刻干跑比对;配方里不存坐标,泛化不了时列出原因
- 整张表挪位后同一配方照样认得;框进合计行、夹着小计、表下说明都有明确的处理

确认与对照(recipe_confirm、recipe_diff、新 recipe_compare)
- 改配方后确认清单只列有变化的项(同时按本期数据比较),不用每修一次重勾十来项;新旧配方对照界面;按规则重新起草并把名字对齐到现行配方
- 改配方后已体现在配方里的回答保留,矛盾的列出来请人重答
- 「排除的行」写进回执和导入清单:隐藏行、跳过的空行、按配方忽略的行、停止后的文字行、只核对不另存的合计行

版本页(新 source_versions、api/source_versions;前端 VersionsDialog)
- 快照与导入记录列表、启用旧版本(可写理由)、查看清单、移除一期、作废接受、清除原件;写操作带界面看到的当前版本,并发改动回 409,不静默丢期
- 除当前版本和被运行引用的版本外,再保留最近 3 个版本供回滚;遮罩列丢失要明确确认

期 1、期 2 遗留
- 重传撞上被改过的构建文件:能用本次上传恢复就隔离旧文件再恢复,否则回 409,不再是 500
- 跳过空行的列表不再把表下隔一行的说明读成数据;不像说明的单格行要人确认;受影响的配方构建换 id
- 版本存储加进程级文件锁:第二个进程拿不到锁时不清理、不回收,写操作回 503(部署本来就是单进程)
This commit is contained in:
ThearchyHelios
2026-10-02 07:38:44 +08:00
parent 2d5e50fa88
commit 2cdbf9a733
79 changed files with 28889 additions and 794 deletions
+45 -2
View File
@@ -4,10 +4,11 @@ import { createRoot } from 'react-dom/client'
import { BrowserRouter } from 'react-router-dom'
import { Database, Inbox, Plus, Trash2, RefreshCw } from 'lucide-react'
import {
DeleteButton, EmptyState, ErrorState, Field, HealthPill, IconButton, Kbd, Modal, OfflineBanner, PageHeader,
DeleteButton, EmptyState, ErrorState, Field, HealthPill, IconButton, Kbd, Modal, Notice, OfflineBanner, PageHeader,
SectionBar, Skeleton, StatusBadge, StatusPill, Tabs, TabPanel, ToastHost, confirmDialog, deferDelete,
promptDialog, toast, useRadioGroup, withoutDeferred,
} from '../components/ui'
import { ReceiptSummary } from '../pages/import/ReceiptBlocks'
import { ApiError, api, streamCopilot } from '../api/client'
import { useCatalog, useDatasources, useOnReconnect } from '../store/catalog'
import { STATUS } from '../lib/status'
@@ -32,7 +33,7 @@ import evidenceVerdict from '../run/__tests__/evidence-verdict.json'
import { EvidenceGuessView } from '../run/EvidenceGuess'
import { IssuanceBanner } from '../run/AssistantStream'
import mdPinned from '../run/__tests__/markdown-pinned.json'
import type { EvidenceDocData, EvidenceGraph } from '../types'
import type { EvidenceDocData, EvidenceGraph, TrialReceipt } from '../types'
import '../index.css'
/**
@@ -225,6 +226,44 @@ function longDoc(doc: EvidenceDocData, times: number): EvidenceDocData {
}
const EV_LONG = longDoc(EV_DOC, 16)
/** 回执块的样例(合成的假数据):三种排除原因里有一种是界面不认识的,要写「其他原因」,不露枚举值 */
const DEMO_RECEIPT: TrialReceipt = {
ledger: [{ sheet: '客流汇总', nonempty_scan: 771, nonempty_read: 771, roles: { value: 771 }, unclaimed: 0 }],
tables: [{ name: '日客流', sheet: '客流汇总', kind: 'data', columns: [], grain: ['日期'], rows: 30 }],
placeholders: { '·': 30 },
canonicalized_total: 17,
outside_text: [{ sheet: '客流汇总', cell: '客流汇总!B3', text: '客流汇总表', kind: 'text' }],
rows_excluded: [
{ sheet: '客流汇总', reason: 'ignored_rows', rows: [[32, 32]], cells: 3, anchor: '补录(人次)', block: '交叉表' },
{ sheet: '客流汇总', reason: 'total_not_kept', rows: [[28, 30]], cells: 93, block: '交叉表' },
{ sheet: '客流汇总', reason: 'mystery_reason', rows: [[40, 41]], cells: 2 },
],
}
/** 期 3 的共用件:提示条 Notice(从导入向导挪进 ui.tsx)、回执块(向导回执和版本页清单视图共用) */
function NoticeKitDemo() {
const [focused, setFocused] = useState('')
return (
<div className="flex flex-col gap-3">
<div className="flex flex-col gap-2" id="notice-demo">
<Notice tone="info" attr={{ 'data-demo-notice': 'info' }}>已应用修复,请重新试运行</Notice>
<Notice tone="warn" attr={{ 'data-demo-notice': 'warn' }}>服务端的同版本数据文件曾被改动,已用本次上传的文件恢复</Notice>
<Notice tone="err" attr={{ 'data-demo-notice': 'err' }} className="mt-1">
导入失败:当前版本未受影响
<div className="text-2xs text-dim" id="notice-detail">细节写在第二行</div>
</Notice>
</div>
<div className="border-t pt-3" id="receipt-demo">
<ReceiptSummary receipt={DEMO_RECEIPT} onFocus={setFocused} />
<div className="mt-1 text-2xs text-faint">定位到:<span id="receipt-focus" className="mono">{focused}</span></div>
</div>
<div className="border-t pt-3" id="receipt-unrecorded">
<ReceiptSummary receipt={{ tables: DEMO_RECEIPT.tables }} />
</div>
</div>
)
}
/**
* 可点击证据的演示:宽栏(侧边面板 / 窄屏时底部抽屉)、360px 窄栏(栏内展开)、旧契约的
* 按位置标记。文档是后端 compose_doc 真跑出来的夹具(evidence-doc.json,只用通用名);
@@ -650,6 +689,10 @@ function Harness() {
<ManageKitDemo />
</Block>
<Block title="提示条 Notice · 回执块">
<NoticeKitDemo />
</Block>
<Block title="可点击证据 EvidenceDoc(单独看:?evidence=1)">
<EvidenceDemo />
</Block>