111

docs/ARCHITECTURE.md

@@ -12,6 +12,7 @@
 | src/core/money.ts | 整数分、金额上限、人民币大写、金额格 |
 | src/core/date.ts | 日期与 Excel 日期制 |
 | src/core/templates.ts | 模板接口、注册器、打印页面组合；与桌面环境解耦 |
+| src/core/preview-samples.ts | 未导入数据时的示例收据，按当前页面容量生成，不分配流水号 |
 | src/main/workbooks.ts | WorkbookReader 接口及 .xlsx 适配器 |
 | src/main/ledger.ts | 持久编号、批次快照及删除记录 |
 | src/main/settings-store.ts | 版本化设置及原子写入 |
@@ -76,6 +77,8 @@ importGroupTree 按三级分组统计有效行、待修改行、选中张数和
 
 A4 预览使用 printPreviewRows 在已选同组收据中定位当前行所在页，并按全局已选顺序展示待分配编号。预览查询不修改流水号。设置页面的实时文件名示例和正式导出使用相同的 receiptFileStem，保持前缀、命名方式和字符替换一致。
 
+工作台预览请求显式传递当前 receiptsPerPage，主进程校验为 1 或 2，并只覆盖本次预览上下文；省略时沿用已保存设置，历史预览继续使用原批次快照。切换每页张数无需先保存设置。未导入时由 createPreviewSamples 提供对应张数的不同示例；导入后始终使用真实勾选数据，不补充示例。界面共用 printPreviewRows 计算本页张数，并展示当前分组、组内已选数量及空白半页原因。
+
 记录列表通过 listBatchPage 传递经校验的学校、年级、项目、文本、页码和每页条数，返回当前页、真实总条数及有效页码。无筛选时使用数据库 COUNT/LIMIT/OFFSET；有筛选时逐批匹配同一张收据，统计所有匹配批次并仅构建当前页摘要，末页删除后自动钳制到有效页。学校、姓名和任意编号查找仍覆盖全库。原 listBatches 继续为已有调用提供最多 200 条摘要，bootstrap 提供全库分类选项和真实总数。
 
 界面默认每页 5 条，可选 5/10/20/50；historyPageSize 在设置校验器中为旧配置补默认值，修改后持久保存。筛选或每页条数变化时回到第一页，刷新保留当前页；使用请求版本号保持最新结果。显式翻页沿用整块加载反馈，自动筛选合并短时间内的输入变化。过滤结果仍对应完整批次，重新导出维持原有批次语义。原收据预览可指定匹配编号，旧批次输出目录经过全库归属检查。