s2f/pmdocs/0-req-S2F.md

# 财务 AI 助手需求文档（第一模块：薪酬财务对账）

**项目编号**: S2F  
**文档版本**: v1.0  
**创建日期**: 2026-07-06  
**状态**: 已确认

## 1. 引言与目标

### 1.1 产品概述

本项目定位为面向金蝶中小企业客户的财务 AI 助手。产品不替代金蝶账套，而是作为金蝶财务系统前置的 AI 中间层，帮助财务人员把分散在 Excel、业务系统、HR、发票、报销、银行流水等来源中的数据，整理成可核对、可解释、可导入金蝶的结构化结果。

第一阶段先建设“薪酬财务对账模块”（第一模块，内部产品名：薪财通 AI），解决"HR 数据到财务凭证之间"的整理、核对、解释和转换工作。后续阶段再扩展发票报销、预算执行、现金流异常、往来对账和经营分析等财务 AI 助手能力。

### 1.2 核心价值主张

**总体价值：把分散财务数据整理成可核对、可解释、可入账的结构化结果。**

**第一模块价值：将薪酬对账工作从 3 天压缩到 30 分钟。**

使用金蝶的中小企业财务人员，第一阶段每月只需上传工资、社保、个税等表格，AI 自动完成薪酬对账、异常识别、成本分析和凭证生成。

### 1.3 业务目标

**总项目目标**：
- 建设面向金蝶中小企业客户的财务 AI 助手
- 帮助财务人员完成数据整理、对账、解释、凭证生成和经营分析辅助
- 在不替代金蝶的前提下，补齐“业务数据/Excel 到财务系统”之间的 AI 中间层能力

**第一模块目标**：
- 帮助财务人员节省 90% 以上的薪酬对账时间
- 降低人工对账错误率（目标准确率 > 90%）
- 提升财务与 HR 数据口径一致性
- 为企业节省人力成本（100人企业年节省 3.6-5.4 万元）

### 1.4 产品定位与边界

**总项目定位**：
- 财务 AI 助手，服务金蝶中小企业客户
- 金蝶财务软件的增效工具，而非替代品
- 连接业务数据、Excel 数据、HR 数据、发票/报销数据、银行流水与金蝶财务系统
- AI 辅助决策，不替代财务人员的专业判断

**第一阶段定位**：
- 第一模块为薪酬财务对账，不是项目的全部边界
- 第一阶段专注工资、社保、公积金、个税、人工成本分析和金蝶凭证生成
- 先验证一个高频财务场景，再扩展为完整财务 AI 助手

**明确不做**（避免与金蝶竞争）：
- ❌ 账套管理
- ❌ 正式凭证入账
- ❌ 法定财务报表生成
- ❌ ERP 和进销存主流程
- ❌ 银行支付和资金调拨

## 2. 术语表

| 术语 | 定义 |
|---|---|
| 薪酬对账 | 核对工资表、社保表、个税表、银行回单等多源数据的一致性 |
| 金蝶凭证 | 符合金蝶财务软件导入格式的会计凭证模板 |
| 字段映射 | AI 识别不同企业表格中相同含义但命名不同的字段 |
| 异常检测 | 自动识别离职未停社保、个税不匹配等常见错误 |
| 部门成本分摊 | 将人工成本按部门或费用科目拆分 |
| 多租户 | 不同企业数据严格隔离，互不可见 |
| 私有化部署 | 企业在自己的服务器上部署系统 |

## 3. 角色定义

### 3.1 核心用户

**财务主管**
- 职责：审核薪酬对账结果、人工成本分析、凭证生成
- 痛点：每月对账耗时长、异常难追溯、老板经常追问成本变化
- 使用场景：查看异常清单、审核凭证、生成成本分析报告

**总账会计**
- 职责：执行薪酬对账、生成凭证、导入金蝶
- 痛点：表格来源多、格式不统一、重复性工作多
- 使用场景：上传表格、处理异常、导出凭证模板

**出纳兼会计**（中小企业常见）
- 职责：工资发放、社保缴纳、凭证入账
- 痛点：身兼多职、时间紧、容易出错
- 使用场景：快速完成对账和凭证生成

### 3.2 相关用户

**HR 薪酬专员**
- 职责：提供工资表、社保表、考勤数据
- 使用场景：可选上传权限，协助财务核对

**企业老板/管理层**
- 职责：关注人工成本变化
- 使用场景：查看人工成本分析报告（第二阶段移动端）

**外包记账公司**（潜在客群）
- 职责：代理多家企业的财务工作
- 使用场景：批量处理多个企业的薪酬对账（企业版）

## 4. 功能性需求

### 4.0 财务 AI 助手模块规划

| 阶段 | 模块 | 目标 | 状态 |
|---|---|---|---|
| 第一阶段 | 薪酬财务对账助手 | 工资、社保、个税、公积金对账，人工成本分析，金蝶凭证生成 | 本需求文档详细定义 |
| 第二阶段 | 薪酬模块自动化增强 | 历史对比、企业规则沉淀、自动文件夹监控、完整自然语言问答 | 规划中 |
| 第三阶段 | 金蝶生态连接 | 金蝶 API、多账套、行业模板、代账公司批量处理 | 规划中 |
| 第四阶段 | 财务 AI 助手扩展 | 发票报销、预算执行、现金流异常、往来对账、经营分析看板 | 路线规划 |

### 4.1 MVP 核心功能（第一阶段：薪酬财务对账模块）

#### REQ-001: 薪酬数据上传

**WHEN** 财务人员需要进行月度薪酬对账  
**THE system SHALL** 支持通过 Web 界面拖拽上传 Excel 文件（.xls / .xlsx / .csv）

**输入要求**：
- 工资表（必需）
- 社保表（必需）
- 个税表（必需）

**约束条件**：
- 单次上传文件大小 < 10MB
- 支持 50-500 人规模数据
- 文件格式自动识别

#### REQ-002: AI 字段智能识别

**WHEN** 用户上传 Excel 文件  
**THE system SHALL** 使用 AI 自动识别字段含义并生成映射建议

**识别字段**：
- 员工姓名、工号、部门、岗位
- 应发工资、实发工资、个税
- 社保个人部分、社保公司部分
- 公积金个人部分、公积金公司部分
- 奖金、提成、扣款

**要求**：
- 识别准确率 > 90%
- 支持用户手动修正
- 记住企业历史映射规则，下次自动应用

#### REQ-003: 薪酬对账与异常检测

**WHEN** 字段映射完成  
**THE system SHALL** 自动执行多维度对账并输出异常清单

**检测规则**：
- 离职员工仍有工资发放
- 入职员工未缴社保
- 已离职员工社保未停缴
- 个税金额与工资数据不匹配
- 社保基数异常波动（环比变化 > 30%）
- 公积金缴纳比例异常（超出合理范围 5%-12% 或与历史月份差异 > 2%）
- 部门归属为空或与上月不一致
- 银行实发金额与工资表实发金额不一致（第二阶段）

**输出**：
- 异常清单 Excel（异常类型、员工姓名、详细说明、建议处理方式）

#### REQ-004: 人工成本分析

**WHEN** 对账完成  
**THE system SHALL** 自动生成月度人工成本分析报告

**分析维度**：
- 本月人工成本总额（工资 + 社保 + 公积金）
- 与上月环比变化（金额、比例）
- 按部门拆分的人工成本明细
- 按费用科目拆分（管理费用、销售费用、研发费用）
- 新增/离职员工带来的成本变化
- 奖金、提成等特殊项目影响

**输出格式**：
- Excel 报表
- 支持复制到月度经营分析

#### REQ-005: 金蝶凭证模板生成

**WHEN** 用户确认对账结果  
**THE system SHALL** 根据企业配置生成可导入金蝶的凭证模板

**凭证类型**：
- 工资计提凭证
- 工资发放凭证
- 个税计提/代扣凭证
- 社保凭证（公司部分 + 个人部分）
- 公积金凭证（公司部分 + 个人部分）
- 部门费用分摊凭证

**要求**：
- 支持自定义科目映射
- 记住企业规则配置
- Excel 格式符合金蝶导入规范

#### REQ-006: 预置问题问答

**WHEN** 用户在 AI 工作台、成本分析页面查看数据  
**THE system SHALL** 提供预置问题列表，用户点击后基于当前数据返回答案

**预置问题示例**：
- 本月还缺哪些文件？
- 哪些字段需要人工确认？
- 哪些异常最严重？
- 为什么本月人工成本上涨/下降？
- 哪些部门变化最大？
- 现在可以生成金蝶凭证吗？

**要求**：
- 不做开放式对话，仅支持预置问题
- 答案基于当前任务数据生成
- 响应时间 < 3 秒
- 答案包含关键数据点（金额、比例、员工名单）

**AI Native 价值**：
- 降低用户查找信息成本
- 主动提示关键问题
- 提升"AI 助手"体验

### 4.2 第二阶段功能（暂不实现）

- 自动文件夹监控（本地 + 网盘同步）
- 可选输入文件支持（公积金表、考勤表、银行回单）
- 历史数据对比（12个月环比/同比）
- **完整自然语言问答**（开放式对话，不限于预置问题）
- 金蝶 API 直接对接
- 移动端支持

## 5. 非功能性需求

### 5.1 性能要求

**NFR-001: 数据处理性能**
- WHEN 处理 200 人企业的薪酬数据  
- THE system SHALL 在 30 秒内完成从上传到结果输出

**NFR-002: AI 识别性能**
- WHEN 执行 AI 字段识别  
- THE system SHALL 在 5 秒内返回映射结果

**NFR-003: 凭证生成性能**
- WHEN 生成金蝶凭证模板  
- THE system SHALL 在 3 秒内完成生成和下载准备

**NFR-004: 并发支持**
- WHEN 多个用户同时使用系统  
- THE system SHALL 支持至少 50 个并发用户

### 5.2 安全要求

**NFR-005: 数据传输安全**
- THE system SHALL 使用 HTTPS 加密传输所有数据
- THE system SHALL 对文件上传进行加密处理

**NFR-006: 数据存储安全**
- THE system SHALL 使用 AES-256 加密存储敏感数据
- THE system SHALL 对员工姓名进行脱敏展示（张**、李**）
- THE system SHALL 支持定期数据库备份

**NFR-007: 访问控制**
- THE system SHALL 实现多租户严格隔离（企业 A 无法访问企业 B 数据）
- THE system SHALL 支持按角色权限控制：
  - 财务主管：全部权限
  - 总账会计：查看和编辑权限
  - 出纳：仅查看权限
  - HR：可选上传权限

**NFR-008: 审计日志**
- THE system SHALL 记录所有数据访问和操作日志
- THE system SHALL 保留审计日志 3 年

**NFR-009: 数据删除机制**
- THE system SHALL 支持用户主动删除历史数据
- THE system SHALL 在企业注销后 30 天内自动删除所有数据
- THE system SHALL 符合《个人信息保护法》要求

### 5.3 可用性要求

**NFR-010: 界面友好性**
- THE system SHALL 提供直观的拖拽上传界面
- THE system SHALL 在每个关键步骤提供操作指引
- THE system SHALL 支持"一键修正"异常字段映射

**NFR-011: 错误提示**
- THE system SHALL 在操作失败时提供明确的错误原因和解决建议
- THE system SHALL 在数据异常时提供上下文说明

**NFR-012: 新手引导**
- THE system SHALL 为首次使用的用户提供完整操作演示
- THE system SHALL 提供示例数据供用户快速体验

### 5.4 兼容性要求

**NFR-013: 浏览器兼容**
- THE system SHALL 支持 Chrome、Edge、Safari、Firefox 最新两个版本
- THE system SHALL 优先优化 Chrome 体验

**NFR-014: 文件格式兼容**
- THE system SHALL 支持 .xls、.xlsx、.csv 格式
- THE system SHALL 兼容 Excel 2007 及以上版本

**NFR-015: 金蝶版本兼容**
- THE system SHALL 生成的凭证模板兼容金蝶云星辰、精斗云、K/3

### 5.5 可扩展性要求

**NFR-016: 数据规模扩展**
- THE system SHALL 支持从 50 人扩展到 1000 人企业
- THE system SHALL 在不重构的前提下支持数据量线性增长

**NFR-017: 功能扩展**
- THE system SHALL 设计模块化架构，便于后续增加新功能
- THE system SHALL 预留 API 接口，便于第三方集成

### 5.6 可维护性要求

**NFR-018: 代码质量**
- THE system SHALL 使用 TypeScript 提供类型安全
- THE system SHALL 保持核心模块测试覆盖率 > 80%
- THE system SHALL 遵循 RESTful API 设计规范

**NFR-019: 部署要求**
- THE system SHALL 支持 Docker 容器化部署
- THE system SHALL 支持私有化部署（Docker Compose）
- THE system SHALL 提供完整的部署文档和脚本

**NFR-020: 监控与日志**
- THE system SHALL 记录所有 API 调用和性能指标
- THE system SHALL 在异常发生时自动记录堆栈信息

### 5.7 合规性要求

**NFR-021: 数据合规**
- THE system SHALL 符合《个人信息保护法》
- THE system SHALL 符合《数据安全法》
- THE system SHALL 提供数据处理协议模板

**NFR-022: 财务合规**
- THE system SHALL 生成的凭证符合企业会计准则
- THE system SHALL 在界面明确标注"最终决策权在财务人员"

### 5.8 数据保留策略

**NFR-023: 历史数据保留**
- 免费版：仅保留当月数据
- 基础版：保留 12 个月历史数据
- 专业版：保留 36 个月历史数据
- 企业版：无限制保留（可配置）

## 6. 范围边界

### 6.1 包含（In Scope）

✅ 手动上传 Excel 表格  
✅ AI 字段识别和映射  
✅ 工资、社保、个税对账  
✅ 异常检测与清单生成  
✅ 人工成本分析  
✅ 金蝶凭证模板导出  
✅ 多租户数据隔离  
✅ 基础安全（加密、访问控制、审计）  
✅ Docker 私有化部署  

### 6.2 不包含（Out of Scope - 第一阶段）

❌ 自动文件夹监控  
❌ 金蝶 API 直接对接  
❌ 移动端应用  
❌ 复杂审批流  
❌ 完整 HR 系统功能  
❌ 银行支付系统对接  
❌ 个税/社保直接申报  
❌ 等保三级认证  
❌ **预算管理与预算执行跟踪**  
❌ **发票真伪核验**  
❌ **现金流监控与银行账户余额管理**  

**说明**：
- 预算管理、发票核验、现金流监控也是财务 AI 助手的目标场景，但不进入第一阶段薪酬财务对账 MVP
- 这些功能进入第四阶段“财务 AI 助手扩展”，不应提前挤占第一模块的开发范围

### 6.3 未来可能包含（Future Scope）

⏰ 历史数据环比/同比分析（第二阶段）  
⏰ 完整自然语言问答（第二阶段）  
⏰ 自动文件夹监控（第二阶段）  
⏰ 多账套支持（第三阶段）  
⏰ 行业化模板（第三阶段）  
⏰ 金蝶 API 对接（第三阶段）  
⏰ **发票与报销 AI 助手**（第四阶段）  
⏰ **预算执行 AI 分析**（第四阶段）  
⏰ **现金流异常 AI 监控**（第四阶段）  
⏰ **往来对账 AI 助手**（第四阶段）  
⏰ **经营分析 AI 看板**（第四阶段）  

## 7. 关键约束与假设

### 7.1 技术约束

- 前端：Next.js (React) + TypeScript + Tailwind CSS
- 后端：Python (FastAPI) + Pydantic
- 数据库：PostgreSQL
- AI：LLM API（GPT-4 或国产大模型）
- 部署：Docker + Docker Compose

### 7.2 业务约束

- 目标客群：50-500 人规模企业
- 数据来源：Excel 手动上传（第一阶段）
- 输出格式：Excel 凭证模板
- 金蝶版本：兼容主流版本（云星辰、精斗云、K/3）

### 7.3 资源约束

- 开发周期：MVP 需在 3 个月内完成
- 团队配置：产品经理 × 1，全栈工程师 × 2，AI 工程师 × 1
- 初始预算：控制在合理范围（云服务、AI API 成本）

### 7.4 关键假设

- ✓ 假设目标用户已使用金蝶财务软件
- ✓ 假设用户可以从 HR 或行政获取 Excel 表格
- ✓ 假设用户有基本的 Excel 和财务知识
- ✓ 假设不同企业的薪酬结构可以通过 AI 识别标准化
- ✓ 假设异常检测规则可以覆盖 80% 以上的常见错误

## 8. 验收标准

### 8.1 功能验收

- [ ] 可以成功上传工资表、社保表、个税表
- [ ] AI 字段识别准确率 > 90%
- [ ] 异常检测能覆盖 MVP 7 类异常，并保留第二阶段银行实发对账规则
- [ ] 人工成本分析报告包含所有必需维度
- [ ] 金蝶凭证模板可以被金蝶软件成功导入
- [ ] 多租户数据严格隔离，无数据泄露

### 8.2 性能验收

- [ ] 200 人企业数据处理时间 < 30 秒
- [ ] AI 字段识别响应时间 < 5 秒
- [ ] 凭证生成时间 < 3 秒
- [ ] 支持 50 个并发用户

### 8.3 安全验收

- [ ] 数据传输使用 HTTPS
- [ ] 敏感数据已加密存储
- [ ] 审计日志完整记录
- [ ] 多租户隔离通过安全测试

### 8.4 用户体验验收

- [ ] 首次使用用户能在 15 分钟内完成一次完整流程
- [ ] 新手引导清晰易懂
- [ ] 错误提示明确具体
- [ ] 异常处理流程顺畅

### 8.5 商业验收（MVP 阶段）

- [ ] 获得 10 个付费客户（或深度参与的种子用户）
- [ ] 首月留存率 > 60%
- [ ] NPS > 40
- [ ] 用户平均完成时间 < 30 分钟

## 9. 风险与依赖

### 9.1 技术风险

**RISK-001: AI 识别准确率不足**
- 影响：用户需要大量修正，降低使用体验
- 缓解措施：积累行业标准模板、记住企业规则、持续训练模型

**RISK-002: 异常检测误报率高**
- 影响：增加用户工作量，降低信任度
- 缓解措施：规则可配置、提供"忽略"功能、基于反馈优化

**RISK-003: 数据安全事故**
- 影响：数据泄露导致法律责任和信任崩塌
- 缓解措施：从第一天就做安全设计、购买网络安全保险、定期安全审计

### 9.2 业务风险

**RISK-004: 金蝶推出类似功能**
- 影响：最大威胁，可能导致竞争失败
- 缓解措施：快速获客建立先发优势、与代理商深度绑定、专注体验

**RISK-005: 市场需求不足**
- 影响：获客困难、用户流失高
- 缓解措施：MVP 快速验证、深度访谈调整方向、灵活调整定价

### 9.3 外部依赖

- LLM API 稳定性和成本（GPT-4 或国产大模型）
- 金蝶凭证导入格式兼容性
- 用户提供的数据质量（表格格式、字段完整性）

## 10. 需求优先级（MoSCoW）

### Must Have（MVP 必须）
- REQ-001: 薪酬数据上传
- REQ-002: AI 字段智能识别
- REQ-003: 薪酬对账与异常检测
- REQ-004: 人工成本分析
- REQ-005: 金蝶凭证模板生成
- NFR-005 ~ NFR-009: 核心安全要求
- NFR-010 ~ NFR-012: 可用性要求
- NFR-019: Docker 部署支持

### Should Have（第二阶段优先）
- 历史数据保存（12 个月）
- 环比变化分析
- 自定义科目映射界面
- 自然语言问答
- 自动文件夹监控

### Could Have（第二阶段可选）
- 可选输入文件支持（公积金、考勤、银行回单）
- 移动端查看
- 金蝶 API 对接

### Won't Have（第一阶段不做）
- 完整 HR 系统
- 银行支付对接
- 个税/社保直接申报
- 等保三级认证

## 11. 关联文档

- 产品方向建议：`../薪财通AI_产品方向建议.md`
- PRD 文档：`pmdocs/1-prd-S2F.md`
- 任务文档：`pmdocs/2-task-S2F.md`
- 运行手册：`run.md`

## 12. 变更历史

| 版本 | 日期 | 变更内容 | 变更人 |
|---|---|---|---|
| v1.0 | 2026-07-06 | 初始版本，基于产品方向建议生成 | AI |

---

**当前状态**: 需求、PRD、任务文档与运行手册已生成，可进入开发执行阶段。