0. 界面总览
侧边栏结构
所有页面切换通过左侧 侧边栏 完成，页面地址（含场景、视图参数）持久化到 URL 哈希，刷新不丢失：
| 菜单项 | 功能 |
|---|---|
| 仪表盘 | 概览：业务入口卡片、统计卡片、快速上手工作流 |
| 业务名称 | 点击切换到该业务的数据页，右侧显示该业务下的所有记录 |
| 业务设置 | 增删改业务，调整排序和图标 |
| 文档模板 | 所有单记录模板的表格列表，支持编辑、字段管理、复制、发布/下架 |
| 报表模板 | 列表（批量导出）模板管理 |
| 帮助 | 打开本帮助页 |
仪表盘（默认首页）
未选择业务时显示仪表盘，包含：
- 统计卡片 — 总记录数、总模板数、业务数
- 业务网格 — 每个业务的入口卡片，显示模板数+记录数，点击进入该业务
- 快速上手 — 4 步工作流引导（创建业务→设置字段→录入数据→生成输出）
全页录入/编辑
数据录入和编辑均采用 全页表单（非模态框），顶部有返回按钮，100% 宽度铺满内容区，支持分组字段和子表操作。
1. 快速开始
访问方式
基本流程
- 创建场景 — 如"发票""合同"，将模板按场景分类管理
- 创建模板 — 命名后直达模板编辑器，上传 Excel 底版，定义字段和单元格映射
- 录入数据 — 点击场景旁的录入按钮，选模板后进入全页表单填写
- 生成 Excel — 选中模板后点击下载或保存到本地
2. 业务设置
什么是业务？
业务是对单个数据场景的分类管理（相当于传统的"单据类型"）。每个业务有自己的字段定义、文档模板和数据。例如：发票、合同、装箱单、报价单各为一个独立业务。
管理业务
在侧边栏点击 业务设置 进入管理页，支持：
- 修改 — 点击 ✏️ 编辑业务名称、图标、排序
- 删除 — 删除后该业务下的模板业务置空
侧边栏业务
每个业务在侧边栏显示为独立条目，点击即切换到该业务的数据视图。每个业务条目右侧有 ＋ 按钮，点击直接录入数据（自动选用该业务的模板）。
3. 数据管理
数据页
选中场景后，右侧展示该场景下的所有记录，以表格形式呈现。每条记录的操作列：
| 按钮 | 功能 |
|---|---|
| 👁️ | 预览记录详情（只读模态框，分组展示字段和子表） |
| ✏️ | 全页编辑表单 |
| 📋 模板名 ▾ | 选择生成模板（选中后持久化到 localStorage，刷新不丢失） |
| 📥 下载 | 使用选定模板生成 Excel 并下载 |
| 🗑️ | 删除记录 |
录入数据
点击场景旁的 ＋ 按钮，或侧边栏的 ＋ 录入：
- 该场景只有单个模板 — 直接进入全页录入表单
- 多个模板 — 弹出模板选择窗口，点击目标模板进入全页表单
表单字段按分组排列，子表行可动态增删。公式字段在输入时自动实时预览。
搜索与筛选
- 搜索框 — 全文搜索，匹配所有字段内容
- 模板筛选 — 下拉选择模板，过滤到单个模板时展开所有可见字段列
4. 文档模板
模板列表
文档模板 用表格展示所有单记录模板（1条记录→1个输出文件），显示图标、名称、业务、字段数、数据数、状态。顶部有 ＋ 新建模板 按钮。
报表模板
报表模板 用于批量数据导出（N条记录→1张Excel表格），支持子表字段展开为多行、主字段重复填充。操作方式类似文档模板，但映射的是Excel列字母而非单元格地址。
新建模板
点击按钮后直接创建默认模板（名"新模板"、草稿状态）并跳转到编辑器，无需中间弹窗。在编辑器内修改名称、场景、版本、文件名格式等。
操作列
| 按钮 | 功能 |
|---|---|
| ✏️ 编辑 | 进入模板编辑器 |
| 📑 字段 | 跳转到字段管理（同编辑器） |
| 📋 复制 | 复制模板及其所有字段/映射/上传的 Excel 底版 |
| 📤/📥 发布/下架 | 切换发布状态，草稿模板在录入时不可选 |
| 🗑️ | 删除模板（含所有字段、记录、子表数据） |
模板编辑器
全页编辑器，顶部包含：
- ← 返回按钮
- 模板名称（可点击编辑区的名称输入框修改）
- 发布/下架、删除操作
- 文件命名规则、编号前缀/补齐位数等配置
- Excel 模板上传
- 字段配置表格（支持添加/编辑/删除字段）
- 子表列编辑器
5. 字段配置
字段类型
| 类型 | 说明 |
|---|---|
| 文本 | 单行文本输入 |
| 数字 | 数字输入，支持小数位数设置 |
| 日期 | 日期选择器 |
| 多行文本 | 文本域，适合地址、备注等大段内容 |
| 下拉选择 | 预定义选项，每行一个 |
| 自动编号 | 保存时自动生成编号，支持按字段分组重置 |
| 公式 | 自动计算字段，支持 SUM(_items.amount) 等表达式 |
| 明细行 | 子表结构，需在列编辑器中定义子字段 |
Excel 单元格映射
编辑字段时，填写 Excel 单元格地址（如 B3）指定该字段写入模板的哪个格子。支持：
- 简单地址：B3 — 写入 B3 单元格
- 合并格式：地址 A2 + 格式
{buyer_name} - {contract_no}→ 写入张三 - CONT-0001 - 纯列字母：F 或 F+1 — 自动跟随子表末行位置
6. 编号系统
工作原理
每个模板有独立的计数器。保存新记录时，系统：
- 读取模板的编号前缀 + 当前计数器值
- 生成 INV-2026-0001
- 计数器自动 +1
删除记录不影响计数器，避免编号重复。编辑记录时 保留原有编号不被覆盖。
前缀占位符
| 占位符 | 说明 | 示例（2026年6月） |
|---|---|---|
{year} | 四位年份 | 2026 |
{ym} | 六位年月 | 202606 |
{y} | 两位年份 | 26 |
配置示例
| 前缀 | 生成效果 |
|---|---|
INV-{year}- | INV-2026-0001 |
PO-{ym}- | PO-202606-0001 |
CONT- | CONT-0001（无占位符，原样输出） |
7. Excel 输出
每条记录需要先选择模板（选中后蓝色高亮），然后使用两个输出按钮：
| 按钮 | 功能 | 适用场景 |
|---|---|---|
| 📥 下载 | 浏览器下载 | 临时查看、单次使用 |
| ⬇ 下载 | 生成 Excel 下载到本地 | 日常使用（v3 服务端生成） |
文件名
文件名由模板的"文件名格式"控制，默认 {_no}。支持引用任意字段值：
多模板生成
每条记录可以选用不同的模板生成，互不影响。选中的模板会持久化到浏览器本地存储，刷新页面不丢失。
8. 明细表（子表）
定义子表字段
- 添加一个类型为 明细行 的字段
- 点击字段操作栏的 📋 列 按钮
- 定义子表列：Key、列名、类型（文本/数字）、宽度、公式、小数位数、Excel 列字母
列公式
子表列可以定义公式，如 qty*price，自动计算行内值：
模板中的子表区域
子表在 Excel 底版中需要预留位置，通常包含表头行和一行示例数据。生成时，系统：
- 识别子表范围（从模板配置的起始行号开始）
- 插入足够的数据行（不覆盖下方 TOTAL / 备注 / 签名）
- 合并单元格自动恢复（行偏移适配）
- 公式备份后重新填入（避免插入行破坏引用）
9. 团队与权限（申请开通 / 多用户）
申请开通与登录
当前为专业版 · 审核开通制：首页点「申请开通」提交公司名、工作区标识（登录用 slug，建议公司名拼音+编号）、登录账号与联系方式；审核通过后按联系方式告知，即可用「工作区标识 + 账号 + 密码」登录。
试用期 14 天（到期可联系续期/转正式）。每个工作区数据完全隔离；不同公司互不可见。
每个工作区数据完全隔离；不同公司互不可见。
成员与角色
管理员在侧栏「成员管理」添加成员并指定角色：
| 角色 | 说明 |
|---|---|
| 管理员 | 全部权限：业务/字段/模板/成员/授权/审计/工作区设置 |
| 编辑 | 可录入/修改/删除已授权业务的数据、可生成下载 |
| 只读 | 仅查看与生成下载，不能改数据 |
新成员默认看不到任何业务——管理员需在「业务设置 → 业务卡片 → 👥 授权」中勾选其可访问的业务并指定角色。
对外分享
「业务设置 → 分享」生成免登录填单链接：设有效期、勾选对方可见字段后发给客户/同事；提交数据回到对应业务，随时可停用/删除。建议只勾选必要字段。
工作区设置与套餐
侧栏「工作区设置」查看用量（成员/业务/记录/模板，标注已用/上限）与套餐。免费版配额见设置页说明；达到上限后写入会被拦截提示。公测期可免费申请「专业版」（更高配额），将工作区标识发给官方即可。
9. 数据与安全
数据保存在云端服务器（v3 多租户库，按工作区隔离），每日自动备份到服务器 data/backups/，无需手动操作。
重要提醒：删除业务/记录/模板前均有二次确认；如需彻底回滚可在服务器执行每日备份还原（联系管理员）。
11. 常见问题
数据存在哪里？
云端模式：数据实时保存到服务器 SQLite（data-v3/database.db），浏览器只做展示与录入，刷新/换设备不丢失。
数据会丢吗？
每次保存即写入服务器并落盘（事务提交）；服务器每日备份。记录删除需二次确认，业务删除需 force 确认。
Excel 模板有什么要求？
上传 .xlsx 底版（保留格式/边框/Logo），在「文档模板 → 编辑」中把业务字段映射到底版单元格（如 B3）或组合文本（A9|TO:{buyer_name}）；子表字段填起始行，明细自动逐行下插并平移公式。
如何修改登录密码？
侧边栏「设置 ▾ → 修改密码」，输入当前密码与新密码即可。
登录不上 / 忘记密码怎么办？
确认访问的是 https://sheetdrive.cc、工作区标识/用户名/密码正确。忘记密码请联系工作区管理员在「成员管理」中重置，或由服务器管理员重置。
如何导出/带走我的数据？
工作区管理员在「工作区设置 → 数据导出」可一键导出本工作区全部数据（业务/字段/记录与明细/模板与映射/分享配置）为 JSON 文件，用于本地存档、备份或迁移。导出会记录到审计日志。
分享链接怎么用？
在「业务设置」打开业务的「分享」：新建链接（设有效期/勾选对方可见字段）→ 复制链接发给客户/同事，对方无需账号即可填表提交；链接可随时停用/删除，提交数据回到对应业务记录中。
生成的文件名怎么来的？
文件名 = 模板「文件命名规则」格式展开，默认 {_no}（记录编号，如 INV-202606-0014.xlsx）；老记录保留原编号，新记录保存时自动生成。