@tokensapi/dsh-finance 0.1.0-beta.1

package/README.md

@@ -0,0 +1,53 @@
+# TokensCowork 财务报表插件
+
+基于银行流水生成基础资产负债表和利润表的 TokensCowork 本地插件。
+
+> 当前为 Beta 测试版本，面向 TokensCowork 0.4.4 / 0.4.5 的 MVP 验收，不建议用于正式财务核算。
+
+## 安装 Beta 版本
+
+```bash
+npm install @tokensapi/dsh-finance@beta
+```
+
+当前已完成 MVP 阶段 0 至阶段 5 的源码实现：包含 Host Storage Domain、Typert Remote、侧边栏入口，以及公司、科目、期初设置、流水导入、数据总览、财务报表和备份恢复工作台。
+
+## 已实现
+
+- 多公司创建、切换、改名和删除，数据按公司隔离；
+- 每家公司自动初始化基础会计科目；
+- 一级科目新增、编辑、停用和安全删除；
+- 期初日期、14 种本位币和科目期初余额设置；
+- 期初平衡检查、锁定和二次确认解锁；
+- 金额以最小货币单位整数存储，界面按币种精度输入和展示；
+- Host 端版本冲突、锁定状态、科目引用和币种变更保护。
+- CSV、Excel（XLSX/XLS）文件和粘贴表格文本导入；
+- 中英文常见表头识别、日期和金额标准化、科目编码/名称精确匹配；
+- 最多 10 MB、20,000 行的 Host 端限制，以及逐行错误预览和修正；
+- 确认导入时由 Host 重新校验，并原子创建未审核批次及全部流水。
+- 按公司查看导入批次、日期范围、条数、流入、流出和净额；
+- 查看批次流水明细，编辑或删除未审核流水，并修改批次资金科目；
+- 批次审核与反审核，所有状态变化和删除操作均有二次确认；
+- Host 强制已审核批次只读，空批次不能审核。
+- 根据流水方向生成借贷相等的双边过账结果；
+- 利润表只统计所选期间内的已审核流水；
+- 资产负债表统计截止日期余额，并将累计净利润自动计入指定结转科目；
+- 关键指标、资产负债平衡差额提示、日期快捷范围和两张报表文本复制。
+- 全量 JSON 备份导出、备份统计预览和覆盖恢复二次确认；
+- 恢复前校验格式、版本、重复 ID、公司归属、科目引用、审核状态、日期和金额；
+- 恢复采用单次版本化状态替换，损坏文件不会覆盖当前数据。
+
+## 开发命令
+
+```bash
+pnpm install
+pnpm run check
+```
+
+## 当前边界
+
+- 本地持久化，不向未经授权的远程服务发送财务数据。
+- 当前仅支持一级科目和单一公司本位币；
+- 尚未在真实 TokensCowork 环境完成安装、界面人工操作、应用重启持久化和插件卸载/重载验收；
+- 在上述环境验收完成前，当前状态应视为“MVP 源码完成”，不是生产就绪版本；
+- 正式财务数据由 TokensCowork Host Storage Domain 保存，不使用浏览器 localStorage。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: tokens-cowork-finance
+      name: '@tokensapi/dsh-finance'