copy-book
项目摘要
copy-book 是单用户信息管理与 SQL 工作台。系统将密码本、快捷内容、SQL 模板、SQL 历史、库表索引、解析记录和临时文件工作区组织在统一侧边栏结构中。公开案例只讨论架构、交互和安全方法，不展示站点入口或任何实际保存内容。
作者职责
- 设计多模块信息架构、分组筛选和紧凑工作台布局。
- 实现 React 前端、Edge Functions API、Cookie 会话和 KV 数据层。
- 整合 SQL 历史与 SQL 工具箱，并编写迁移和归一化脚本。
- 处理边缘运行时兼容、坏数据隔离、分页加载和构建拆包。
系统架构
React/Vite 构建前端，Edge Functions 提供鉴权和数据 API，KV Storage 保存索引、记录和应用设置。敏感字段在写入前加密。不同模块共享统一记录模型和导航体系，但按 kind、分组与标签维持明确的数据隔离。
关键设计决策
- 使用显式记录 ID 索引，不依赖不同边缘环境中不稳定的 KV 全量枚举行为。
- 列表读取隔离单条异常记录，使坏数据不再导致整个 bootstrap 或列表接口失败。
- SQL 工具按独立入口和后端分页组织，避免一次加载全部历史数据。
- 大型工具页面使用路由级懒加载，降低不相关模块进入首页构建块的概率。
安全边界
账号密码模式使用服务端会话 Cookie；受信设备模式只接受边缘安全层注入的私有请求头，不能由普通公开请求直接获得免登录状态。AI API Key 只通过部署环境读取，不写入 KV。公开案例不包含域名、Cookie、密码、SQL 正文、表名或迁移数据。
数据与迁移边界
历史数据迁移分为导出、dry-run、本地导入和受控远程导入。标签、记录类型和 SQL 元数据在写入前统一归一化。每个脚本明确数据源、目标环境和鉴权方式，避免把本地私有配置提交到仓库。
验证证据
- 完整门禁覆盖 lint、类型、测试和构建。
- SQL 列表采用分页接口，配置与数据分离加载，并消除大构建块警告。
- 读取接口对未知类型和单条坏数据执行隔离处理。
已知限制
- 项目是单用户私人工具，不提供公开演示或多租户权限模型。
- 边缘运行时的 Cookie 与 KV 行为需要在目标平台进行人工联调。
- 私人数据的最终备份、恢复和密钥保管仍由部署者负责。
后续演进
后续可继续收敛数据模型和迁移工具，并为高风险写入补充更明确的确认与恢复机制。