# 我的开源

**Repository Path**: yupeng3311/my-open-source

## Basic Information

- **Project Name**: 我的开源
- **Description**: 小店记账报税助手（电商个体工商户）
面向电商场景、给不懂会计的人用的合规记账报税工具。零外部依赖（Node 内置 node:http + node:sqlite），本地运行，数据不出本机。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-07
- **Last Updated**: 2026-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小店记账报税助手（电商个体工商户）

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

## 给普通人的 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`。

## 运行

```bash
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 问答助手（本地规则 + 可配置大模型双模式）
------------------------------------------------------------------------
如有疑问可在本人博客留言https://lumenjiangxiang.cn/