DataSage Lite Workspace

静态化的审计协同与管理工具集。所有页面可直接在浏览器中运行，无需构建流程。

目录

1. 快速开始
2. 项目结构
3. 核心页面一览
4. 共享基础设施
5. 开发规范
6. AI 助手提示词
7. 浏览器兼容与限制

---

快速开始

情景	操作指引
本地预览	直接双击任意 HTML 页面，使用支持 File System Access 的 Chromium 浏览器打开（Chrome ≥ 86 / Edge ≥ 86）。
静态部署	将整个仓库部署到任意静态服务器（Netlify、Vercel、GitHub Pages 等），入口为 index.html。
数据落盘	在项目管理、规则构建或审计手册管理页面点击“绑定仓库目录”。若浏览器不支持该 API，请使用页面的“导出 JSON”手动备份。

提示：

• 建议在调试阶段确认 chrome://flags/#file-system-access-api 已启用。
• 每次完成修改后建议执行“导出 JSON”用于版本管理备份。

---

项目结构

.
├── assets/
│   ├── css/
│   │   └── base.css
│   └── js/
│       ├── common.js
│       ├── storage.js
│       ├── repo-binding-bar.js
│       ├── project/
│       │   ├── workbench.js
│       │   ├── workpaper-shared.js
│       │   ├── workpaper-detail.js
│       │   ├── workpaper-programs.js
│       │   ├── workpaper-check-detail.js
│       │   ├── workpaper-risks.js       # 迁移跳转脚本
│       │   ├── workpaper-controls.js    # 迁移跳转脚本
│       │   └── workpaper-collection.js  # 历史脚本（保留）
│       ├── rules/
│       │   └── rules-lite.js
│       ├── handbook/
│       │   ├── handbook-shared.js
│       │   ├── handbook-manager.js
│       │   └── handbook-modules.js
├── index.html
├── project/
│   ├── workbench.html
│   ├── workpaper-detail.html
│   ├── workpaper-programs.html
│   ├── workpaper-check-detail.html
│   ├── workpaper-risks.html      # 迁移页（重定向）
│   ├── workpaper-controls.html   # 迁移页（重定向）
│   ├── workpaper-design.html
│   ├── fact-confirmation-detail.html
│   ├── audit-finding-detail.html
│   └── new.html
├── rules/
│   └── rules-lite.html
├── handbook/
│   ├── handbook-manager.html
│   └── handbook-modules.html
├── docs/
├── index.html
└── README.md

---

核心页面一览

主页 index.html

• 提供项目管理、规则构建、审计手册管理入口。
• 主页不承担仓库绑定；绑定入口在各业务页面头部。

审计手册管理（分层页面）

• 领域页 handbook/handbook-manager.html：布局与项目管理页保持一致，支持搜索与筛选（类型标签、模块情况），点击领域名称进入模块页。
• 模块页 handbook/handbook-modules.html：布局与项目管理页保持一致，支持搜索与筛选（模块情况、检查点风险等级），按领域展示“审计模块 + 全部检查点”列表，点击模块名称可编辑模块，点击检查点名称可编辑检查点。
• 两页均支持仓库绑定条与面包屑导航，结构为 审计领域 -> 审计模块 -> 检查点（1:N）。
• 审计领域字段：领域编码、领域名称、类型标签、模块描述。
• 审计模块字段：模块编码、模块名称、模块描述。
• 检查点字段：检查点编码、检查点名称、检查内容、样本口径、取证要求、检查依据、风险等级、判定标准。
• 使用 handbooks 分区下 manualDomains 字段持久化。

项目工作台 project/workbench.html

• 维护项目列表、项目详情、工作底稿及归档资料。
• 新建项目后可在绑定目录下创建 projects/<id>/ 落盘。

底稿概览 project/workpaper-detail.html

• 顶部展示底稿信息、进度统计与状态。
• 主区域仅维护“审计要点”列表（不再使用程序/风险/控制三层）。
• 支持：新增/编辑/删除审计要点、进入检查项管理页、CSV 导入导出。
• 当前层级：工作底稿 -> 审计要点 -> 检查项。

审计要点页 project/workpaper-programs.html

• 通过 projectId + workpaperId + pointId 定位数据。
• 左侧管理审计要点列表，右侧维护当前要点下的检查项。
• 支持审计要点新增/编辑/删除，检查项新增（跳详情页）/删除。

检查项详情 project/workpaper-check-detail.html

• 通过 projectId + workpaperId + pointId + checkId 编辑单条检查项。
• 支持证据与问题整改的增删改，保存后写回当前要点。

迁移页

• project/workpaper-risks.html 与 project/workpaper-controls.html 已退场，访问后会自动跳转到 project/workpaper-programs.html。

规则构建 rules/rules-lite.html

• 支持规则卡片/表格视图、过滤检索、向导配置和导出。

共享基础设施

模块	说明
DataSageCommon	showToast、download、uid、todayISO、sanitizeFilename 等工具。
DataSageStorage	基于 localStorage + File System Access 的分区存储层。
DataSageRepoBindingBar	仓库绑定条公共组件，统一处理“绑定目录 / 手动保存 / 状态文案”。
workpaper-shared.js	底稿结构守卫与标准化函数，当前主结构为“审计要点 + 检查项”。

---

开发规范

1. 保持纯前端形态，不引入构建流程。
2. 新增字段时先更新 ensure*Structure，再更新读写与导出逻辑。
3. 页面存储统一通过 DataSageStorage 分区读写：projects / rules / handbooks。
4. 危险操作必须有确认；状态反馈使用统一 toast。
5. 顶部仓库绑定能力统一复用 DataSageRepoBindingBar，避免重复维护。
6. 业务模型统一使用：工作底稿 -> 审计要点 -> 检查项。

---

AI 助手提示词

可直接向 AI 发送以下提示词生成底稿 CSV：

请根据以下审计项目信息生成一份底稿模板，输出 CSV 内容，列顺序为：
Workpaper Code, Workpaper Title, Point Code, Point Name, Point Description,
Check Code, Check Name, Check Criteria, Check Method, Check Result, Check Risk Level

项目信息：
- 底稿名称：<底稿名称，例如“收入循环审计底稿”>
- 审计目标与范围：<关键目标与范围>
- 主要审计要点：<列出要点，例如“收入确认”“回款真实性”>
- 参考检查项：<可给示例或留空>

请确保：
1. 底稿编码使用 WP001，要点编码使用 AP001，检查点编码使用 C001，按顺序递增。
2. CSV 首行使用英文字段名。
3. 若信息缺失，可基于常见实践补充并标注“示例”。
4. 返回纯文本 CSV（无需 Markdown 表格）。

生成后可在“底稿详情 -> 导入底稿”直接导入。

---

浏览器兼容与限制

• 推荐最新版 Chrome / Edge（支持 File System Access）。
• Firefox / Safari 仍可用 localStorage，但无法直接写入本地目录，请务必保留 JSON 备份。
• 如遇权限失效或 SecurityError，请重新绑定仓库目录或清除站点数据后重试。