# fms

**Repository Path**: mx-sky/fms

## Basic Information

- **Project Name**: fms
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-28
- **Last Updated**: 2026-10-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 财小柚 · 功能介绍文档

> 产品版本：V4.x（2026-10 代码基线）
> 分析方式：以**前端源码为准**（`frontend/src` 路由、导航、全部视图组件逐页核查），后端 `backend/routers` 23 个路由模块辅助印证
> 定位：面向中国中小企业的**私有化部署、买断制财务管理系统**，重点服务代理记账机构（多账套）；核心原则＝财务核算独立可用 + 业务模块可开关 + 多账套隔离 + 数据全链路可追溯 + 自动化优先（OCR / 导入 / 匹配 / RPA）

---

## 1. 文档索引

| 编号 | 文档 | 对应菜单 | 页面数 |
|---|---|---|---|
| 01 | [工作台与消息](01-工作台与消息.md) | 工作台 | 3 |
| 02 | [账套中心](02-账套中心.md) | 账套中心（可选模块） | 5 |
| 03 | [财务核算](03-财务核算.md) | 财务核算 | 17 |
| 04 | [资金管理](04-资金管理.md) | 资金管理 | 10 |
| 05 | [往来管理](05-往来管理.md) | 往来管理 | 7 |
| 06 | [发票管理](06-发票管理.md) | 发票管理 | 9 |
| 07 | [税务管理](07-税务管理.md) | 税务管理 | 3 |
| 08 | [风险中心](08-风险中心.md) | 风险中心 | 3 |
| 09 | [进销存](09-进销存.md) | 进销存（可选模块） | 12 |
| 10 | [工资管理](10-工资管理.md) | 工资管理（可选模块） | 5 |
| 11 | [固定资产](11-固定资产.md) | 固定资产（可选模块） | 4 |
| 12 | [AI助手与自动化](12-AI助手与自动化.md) | AI助手 | 7 |
| 13 | [财务报表](13-财务报表.md) | 财务报表 | 8 |
| 14 | [财务档案](14-财务档案.md) | 财务档案 | 1 |
| 15 | [基础资料](15-基础资料.md) | 基础资料 | 12 |
| 16 | [系统管理](16-系统管理.md) | 系统管理 | 8 |
| 17 | [许可证与激活体系](17-许可证与激活体系.md) | 系统管理→许可信息 + 云端许可服务端 | 1 |

## 2. 产品总览

### 2.1 技术架构

| 层 | 技术 | 说明 |
|---|---|---|
| 前端 | Vue 3 + TypeScript + Vite + Pinia + Vue Router（hash 路由） | `frontend/src`，自定义轻量 UI 组件库，ECharts 图表 |
| 后端 | Python FastAPI + SQLite | `backend`，统一返回 `{ code, data, message }`，默认端口 3456 |
| 请求 | axios | 自动携带 `X-Book-Id`（当前账套）、`X-User-Id`、`Authorization: Bearer` |
| OCR | 本机 Ollama（离线降级） | 发票/回单/报销票据识别 |
| 部署 | 双 exe 本地部署（Nuitka） | `打包发布` 目录 |

### 2.2 核心概念

- **多账套**：一套系统管理多家公司（代理记账场景），顶栏账套切换器可随时切换，切换后整页刷新、菜单与模块开关随账套联动。
- **模块开关**：账套中心 / 进销存 / 工资管理 / 固定资产 / 自动化中心为可选模块，可在「系统管理 → 模块开关」按账套启停，关闭后菜单整组隐藏。
- **角色权限**：超级管理员 / 老板 / 会计 / 出纳 / 办税员五种内置角色；角色可配置「菜单权限」与「按钮权限」两级授权。
- **凭证状态机**：草稿 → 已审核 → 已过账；审核/记账/红冲/反审核/反结账均有独立动作端点，不允许绕过业务逻辑直接改状态。

### 2.3 登录与演示账号

- 入口：`/login`，账号密码登录，支持记住账号、错误抖动提示、登录成功回跳来源页。
- 演示账号（后端种子数据，初始密码均为 `123456`）：

| 账号 | 角色 | 说明 |
|---|---|---|
| admin | 超级管理员 | 系统全部权限（内置） |
| zhangkj | 会计 | 账务处理 · 申报 · 报表 |

### 2.4 全局布局与通用交互（MainLayout.vue）

| 区域 | 功能 |
|---|---|
| 品牌区 | 点击回工作台；品牌名「财小柚 · 小规模财税系统」 |
| 侧边栏菜单 | 15+1 组手风琴菜单：默认展开当前模块，其余折叠；「我的常用」收藏置顶显示 |
| 收藏星标 | 每个菜单项 hover 出现 ☆，点击加入「我的常用」（localStorage 持久化，最多 8 个） |
| 收起菜单 | 侧边栏底部「收起菜单」，折叠为图标栏 |
| 账套切换器 | 顶栏账套名 → 下拉切换账套（显示账套名称/纳税人规模/期间/行业，当前账套打勾） |
| 全局搜索 | 顶栏搜索框：搜菜单功能（含隐藏项），展示「搜索结果 / 我的常用 / 最近访问」，支持直接收藏 |
| 最近访问 | 路由变化自动记录，最多 10 条，搜索下拉展示前 8 条 |
| 刷新页面 | 顶栏刷新图标 |
| 帮助中心 | 顶栏帮助图标 → `/system/help` |
| 消息通知 | 顶栏铃铛，显示未读数（>99 显示 99+）→ `/message/notice` |
| 用户区 | 头像 + 姓名 + 角色；退出登录按钮 |
| 移动端 | 抽屉菜单 + 底部 5 项高频导航（工作台/凭证/往来/报表/我的） |

### 2.5 通用列表页交互（CrudPage.vue，配置驱动）

基础资料、系统管理等大量页面复用「配置驱动 CRUD」组件，通用操作包括：

| 操作 | 说明 |
|---|---|
| 批量操作 | 进入批量模式：显示「已选 N 项」，可批量删除/批量改状态 |
| 搜索 | 关键词输入（300ms 防抖即搜）+ 下拉筛选 + 查询/重置 |
| 导出 | 按可见列导出 CSV（金额两位小数、状态输出中文文案） |
| 导入 | 弹窗导入：下载模板 → 上传 → 预览校验 → 确认写入 |
| 打印 | 调用浏览器打印 |
| 新增/编辑 | 表单抽屉，必填校验，只提交表单字段 |
| 删除 | 二次确认，支持 `canDelete` 前置校验（如"已引用不可删"） |
| 列设置 | 自定义列显隐（localStorage 记忆） |
| 行操作 | 编辑 / 删除 / 独立业务动作（如确认、设为默认、红冲） |
| 分页 | 页码 + 每页条数，展示共 N 条 |

## 3. 全量菜单树（以 config/nav.ts 为准）

```
工作台
├── 工作台总览 /workbench
└── 消息中心 /message/notice

账套中心（模块开关 book）
├── 账套总览 /books/overview
├── 账套列表 /books/list
├── 导入导出 /books/import
├── 结账检查 /books/check
└── 账套日志 /books/logs

财务核算
├── 智能凭证中心 /accounting/smart
├── 填制凭证 /voucher/entry
├── 凭证查询 /voucher/list
├── 凭证审核 /voucher/audit
├── 账簿查询 /ledger/balance （页内 11 账簿 Tab）
├── 期初余额 /accounting/opening
├── 结账向导 /closing/wizard
└── 期末调汇 /closing/fx

资金管理
├── 流水查询 /fund/flows
├── 收款单 /contact/receipt
├── 付款单 /contact/payment
├── 银行对账 /fund/reconcile
├── 历史对账 /fund/reconcile-history
├── 资金日报 /fund/daily
└── 资金日记账 /fund/journal

往来管理
├── 应收账款 /contact/receivable
├── 应付账款 /contact/payable
├── 往来核销 /contact/writeoff
├── 核销历史 /contact/writeoff-history
├── 账龄分析 /contact/aging
└── 坏账管理 /contact/baddebt

发票管理
├── 进项发票 /invoice/purchase
├── 销项发票 /invoice/sales
├── 未开票收入 /invoice/uninvoiced
├── 发票汇总 /invoice/summary
├── 费用小票 /invoice/expense
├── 发票风险检测 /invoice/risk
└── 凭证生成规则 /invoice/voucher-rules

税务管理
├── 报税工作台 /tax
├── 个税申报 /tax/iit
└── 申报记录 /tax/returns

风险中心
├── 风险预警 /risk/alerts
├── 合规检查 /risk/compliance
└── 风险报告 /risk/report

进销存（模块开关 inventory）
├── 采购订单 /inventory/purchase
├── 销售订单 /inventory/sales
├── 出入库单 /inventory/stock
├── 盘点管理 /inventory/check
├── 仓库调拨 /inventory/transfer
├── 仓库管理 /inventory/warehouses
├── 商品管理 /inventory/goods
├── BOM 档案 /inventory/bom
├── 组装拆卸 /inventory/assembly
├── 库存报表 /inventory/flow （页内 5 Tab）
├── 成本核算 /inventory/cost
└── 库存预警 /inventory/warning

工资管理（模块开关 payroll）
├── 工资表 /payroll/salary
├── 费用报销 /expense/reimburse
├── 个税测算 /payroll/iit
├── 计提凭证 /payroll/entry
└── 部门工资汇总 /payroll/dept

固定资产（模块开关 asset）
├── 资产清单 /asset/list
├── 固定资产明细账 /asset/detail
├── 资产类别 /asset/category
└── 折旧汇总表 /asset/dep-summary

AI助手（常驻）
├── AI 对话 /ai/chat
├── 知识库 /ai/kb
├── 模型设置 /ai/settings
├── 导入中心 /automation/import
├── 导入模板（隐藏项） /automation/templates
├── 字段映射（隐藏项） /automation/mapping
├── 自动匹配规则（隐藏项） /automation/match-rules
├── 自动凭证规则（隐藏项） /automation/voucher-rules
├── 执行日志（隐藏项） /automation/logs
└── RPA 任务与日志 /automation/rpa

财务报表
├── 资产负债表 /report/balance
├── 利润表 /report/profit
├── 现金流量表 /report/cashflow
├── 权益变动表 /report/equity
├── 经营状况表 /report/business
├── 费用统计表 /report/expense
├── 导出模板库 /report/export-templates
└── 预算执行 /report/budget

财务档案
└── 财务档案 /archive

基础资料
├── 会计科目 /basic/subjects
├── 凭证类型 /basic/vtype
├── 辅助核算 /basic/aux
├── 现金流对照 /basic/cashflow-map
├── 现金流量项目 /basic/cashflow
├── 计量单位 /basic/units
├── 收支类型 /basic/flow-categories
├── 币种汇率 /basic/currency
├── 往来单位 /basic/customer （页内 客户+供应商 Tab）
├── 部门管理 /basic/dept
├── 员工管理 /basic/employee
└── 银行账户 /basic/bank

系统管理
├── 企业信息 /system/company
├── 用户管理 /system/users
├── 角色管理 /system/roles
├── 模块开关 /system/modules
├── 参数设置 /system/params
├── 操作日志 /system/logs
└── 帮助中心 /system/help

AI 额外路由（独立）
├── /mine 我的（个人设置）
└── /payslip 工资条自查（公开页，凭 token 查看）

## 4. 兼容重定向路径（旧链接兜底，均为 redirect）

| 旧路径 | 跳转至 | 说明 |
|---|---|---|
| /message/todo | /message/notice | 待办事项已并入消息中心 |
| /books → /books/overview | 账套中心 | 默认进入总览 |
| /fund/accounts | /basic/bank | 银行账户已迁入基础资料 |
| /fund/rules | /automation/voucher-rules | 凭证生成规则归并自动化中心 |
| /voucher/print | /automation/templates | 凭证打印模板归入导入模板 |
| /ledger/aux-balance、/ledger/subj-aux-detail、/ledger/subj-aux-balance | /ledger/aux-detail | 辅助核算账历史路径 |
| /tax/vat、/tax/cit、/tax/other、/tax/calendar、/tax/prefill、/tax/rpa | /tax | 报税工作台旧深链 |
| /asset/dep | /asset/list | 计提折旧为资产清单页按钮 |
| /report/profit-q、/report/cashflow-q | /report/profit、/report/cashflow | 季报归并主表 |
| /report/ap-stat | /report/ar-stat | 应付统计归并应收应付统计 |
| /setting/help、/help | /system/help | 帮助中心路径归一 |
| /:pathMatch(.*)* | /workbench | 未匹配路径兜底 |
```