面向电商场景、给不懂会计的人用的合规记账报税工具。零外部依赖(Node 内置 node:http + node:sqlite),本地运行,数据不出本机。
开源地址:https://gitee.com/yupeng3311/my-open-source
给普通人的 4 步用法
打开 http://localhost:3000,首页就是工作台,跟着 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-ask | AI 问答(DeepSeek 全公司数据,否则本地规则) |
| GET | /api/company/overview | 公司总览(各主体滚动12月销售额/500万进度/免征状态) |
| POST | /api/allocate-suggest | 智能分配建议(推荐记到哪个个体户+理由+明细) |
合规红线
只做合法税务筹划(用足免税额、据实扣除、依法享减半优惠)。不提供隐瞒收入、虚开发票、私户收款不申报、拆分交易等任何违法功能。重大税务安排请咨询持证税务师/CPA。
路线图
- Phase 1 ✅ 多主体账套 + 凭证引擎 + 科目余额表
- Phase 2 ✅ 税务计算引擎(增值税/附加税/经营所得个税)
- Phase 3 ✅(简化版)申报日历提醒 + 分步操作指引
- Phase 4 ✅ 平台流水 CSV 导入(票据管理已由「费用报销」覆盖)
- Phase 5 ✅ AI 问答助手(本地规则 + 可配置大模型双模式)
