面向电商场景、给不懂会计的人用的合规记账报税工具。零外部依赖(Node 内置 node:http + node:sqlite),本地运行,数据不出本机。

开源地址:https://gitee.com/yupeng3311/my-open-source

给普通人的 4 步用法

打开 http://localhost:3000,首页就是工作台,跟着 4 步走:

  1. 建立店铺(店铺管理页):填名称、业主、地区即可,系统自动建好会计科目。
  2. 记一笔(记一笔页):有收入或支出就来记,选「收入/支出」+ 大白话分类 + 金额,系统自动生成正规凭证,不用懂借贷
  3. 算税(算税页):选年份季度,自动算增值税、附加税、经营所得个税,并写出每一步怎么算的,让你看得懂。
  4. 报税提醒(报税提醒页):列出每个申报节点、截止日、距今几天,点开有一步步操作指引(去哪个网站、填什么)。红色 = 快到期/已逾期,优先处理。

进阶功能(凭证查询、科目余额表、手工凭证)在「账簿查询」页,日常不用管。

已实现功能

  • 工作台:4 步引导 + 本月收支概览 + 智能下一步建议
  • 记账明细:收入/支出/报销统一流水页,支持按类型/日期范围/关键字筛选,每页 50 条分页,含记录人、事由、分类、单号、票据类型
  • 记一笔:大白话分类(卖货收入 / 进货货款 / 快递费 / 房租 / 推广费…),每个字段有备注说明,支持记录人
  • 算税引擎(Phase 2):增值税(自动判断季度 30 万免征额)、附加税(六税两费减半)、经营所得个税(5 级累进 + 200 万减半),含大白话计算过程
  • 报税提醒(Phase 3):各税种申报节点 + 截止日 + 倒计时 + 分步操作指引,临期/逾期高亮
  • 多店铺:一个公司管多个个体户,顶部下拉切换
  • 费用报销:员工买东西凭发票/收据来系统提交 → 会计审批 → 付款,自动生成「借费用/贷其他应付款」+「借其他应付款/贷银行」两笔凭证;有合规票据的费用自动计入税前扣除,合法少交税;支持票据拍照上传留档;无票支出标红提醒扣除风险。
  • 平台流水导入(Phase 4):淘宝/拼多多/抖音等导出的销售明细 CSV 一键导入,自动识别金额/日期列,按天汇总生成收入凭证。
  • AI 问答助手(Phase 5):大白话提问,DeepSeek 大模型基于全公司所有个体户数据回答 + 给决策建议(已预配置 DeepSeek,开箱即用;也可改本地 Ollama)。系统提示词内置合规护栏。
  • 公司总览:全公司视角,显示每个个体户滚动 12 个月销售额、距 500 万余额与进度条、本季增值税免征状态、本年利润,红/黄/绿预警——核心目标:各主体不超 500 万保住小规模。
  • 智能分配建议:记一笔时填金额后点「获取分配建议」,系统基于各主体滚动销售额推荐记到哪个个体户(收入→余额最大者平衡负载;支出→收入最高者保成本匹配),并可一键切到该店铺。
  • 账簿查询(进阶):凭证列表、科目余额表/试算平衡、手工凭证录入(强制借贷必平)

AI 配置说明

已预配置 DeepSeek(见 ai.config.json),ecom-accounting/ai.config.json 里的添加DeepSeek API 。如需改用本地 Ollama 或其它 OpenAI 兼容服务,编辑 ai.config.json 的 base/key/model 或设环境变量 AI_API_BASE/AI_API_KEY/AI_MODEL

运行

cd ecom-accounting
node server.js        # 或 npm start

浏览器访问 http://localhost:3000(需 Node ≥ 22.5,数据存于 data.db)。

API

方法路径说明
GET/POST/api/merchants店铺列表 / 新增(自动建科目)
PUT/DELETE/api/merchants/:id更新 / 删除店铺
GET/api/merchants/:id/accounts科目列表
GET/POST/api/merchants/:id/vouchers凭证列表(可 year/month)/ 新增
POST/api/merchants/:id/quick-entry记一笔(income/expense → 自动凭证)
GET/api/merchants/:id/trial-balance?year&month科目余额表 / 试算平衡
GET/api/merchants/:id/tax?year&quarter算税(增值税/附加/个税 + 计算过程)
GET/api/merchants/:id/overview工作台概览(本月收支、凭证数)
GET/api/merchants/:id/transactions?page&pageSize&type&startDate&endDate&q记账明细(收入/支出/报销统一分页,每页 50 条)
GET/api/merchants/:id/reminders报税日历(节点+截止日+操作指引)
GET/POST/api/merchants/:id/reimbursements报销单列表 / 员工提交(可带票据图片)
POST/api/reimbursements/:id/approve审批入账(自动生成费用凭证)
POST/api/reimbursements/:id/pay付款给员工(自动生成付款凭证)
POST/api/reimbursements/:id/reject驳回报销
POST/api/merchants/:id/import-platform平台流水 CSV 导入(按日汇总生成收入凭证)
POST/api/merchants/:id/ai-askAI 问答(DeepSeek 全公司数据,否则本地规则)
GET/api/company/overview公司总览(各主体滚动12月销售额/500万进度/免征状态)
POST/api/allocate-suggest智能分配建议(推荐记到哪个个体户+理由+明细)

合规红线

只做合法税务筹划(用足免税额、据实扣除、依法享减半优惠)。不提供隐瞒收入、虚开发票、私户收款不申报、拆分交易等任何违法功能。重大税务安排请咨询持证税务师/CPA。

路线图

  • Phase 1 ✅ 多主体账套 + 凭证引擎 + 科目余额表
  • Phase 2 ✅ 税务计算引擎(增值税/附加税/经营所得个税)
  • Phase 3 ✅(简化版)申报日历提醒 + 分步操作指引
  • Phase 4 ✅ 平台流水 CSV 导入(票据管理已由「费用报销」覆盖)
  • Phase 5 ✅ AI 问答助手(本地规则 + 可配置大模型双模式)