Spec-driven flow for AI agents…

# 报销审批系统规格文档与技术设计

一、规格文档

1. 项目概述

• 目标：规范化员工报销提交、审批、打款全流程
• 范围：PC端 + 移动端；覆盖差旅、办公、招待等常见费用类型
• 角色：员工（提交人）、审批人（多级）、财务审核员、系统管理员

2. 审批角色定义（3个）

• 直接主管：初审，核实业务真实性与必要性
• 部门负责人：跨级复核，关注部门预算
• 财务审核员：票据合规性、金额准确性、制度符合性

3. 五级金额阈值（建议区间，需按公司制度校准）

| 级别 | 金额区间 | 审批路径 |

|---|---|---|

| L1 | 小额（如 ≤500元） | 直接主管 |

| L2 | 500–2,000元 | 主管 → 财务 |

| L3 | 2,000–10,000元 | 主管 → 部门负责人 → 财务 |

| L4 | 10,000–50,000元 | 主管 → 部门负责人 → 分管领导 → 财务 |

| L5 | >50,000元 | 全链路 + CFO终审 |

> 注：阈值具体数值需结合公司实际制度确认，此处为常见实践参考。

4. 核心功能需求

• 提交：费用类型、金额、发票附件（OCR识别辅助）、事由说明
• 审批：逐级流转、驳回需填理由、超时提醒（如48小时）
• 查询：员工查进度、审批人看待办、管理员看统计
• 异常处理：撤回（财务打款前）、代审批（需授权记录）

5. 非功能需求

• 附件大小限制（如单张 ≤10MB）、操作日志留痕、敏感数据脱敏、权限最小化

---

二、技术设计方案

1. 架构选型

• 前端：Vue3 / React + 移动端H5（或小程序）
• 后端：Java Spring Boot / Node.js，RESTful API
• 数据库：MySQL（业务数据）+ Redis（缓存待办、会话）
• 文件存储：OSS对象存储，发票图片私有 bucket

2. 核心设计

• 审批流引擎：基于规则表实现（阈值、角色、顺序可配置），支持条件分支；可复用 Flowable/Activiti 或自研轻量状态机
• 状态机：草稿 → 审批中 → 已通过 / 已驳回 / 已打款；每次流转写审计日志表
• 规则配置：阈值存数据库而非硬编码，管理员可调整并生效于新单据
• 消息通知：对接企业微信/钉钉/邮件，审批超时自动催办

3. 安全与合规

• RBAC权限模型；金额计算使用 DECIMAL 避免浮点误差；发票查重防止重复报销；关键操作全量审计日志，保留 ≥1年

4. 关键接口（示例）

• POST /reimbursements 提交
• POST /reimbursements/{id}/approve|reject 审批
• GET /todos 待办列表

实施建议：先做MVP（提交+三级审批），阈值引擎可配置化，后续迭代接入OCR与预算联动。