> For AI agents: the complete documentation index is available at https://docs.danqiuos.com/llms.txt, the full documentation bundle is available at https://docs.danqiuos.com/llms-full.txt.

# 财务报销示例方案

本方案沿用[快速开始](https://docs.danqiuos.com/start/quickstart.md)的顺序：**先建工作台与数据基座，再装配报销助理，最后验证两种入口共享同一业务记录。** 它是需按企业制度配置和验证的示例，不代表已部署的财务系统。

员工在工作台查看自己的报销单、补充材料和跟踪状态，也可以在与报销助理的对话中上传发票并说明用途。助理将信息整理为待确认的草稿，财务或审批人继续在获授权的流程中复核。

## 先确认业务范围

第一版可以只做报销草稿整理和人工复核，不接银行付款、自动记账或自动审批。开始前准备企业费用分类、必填字段、凭证要求、审批角色和可用于测试的发票样例。

发票识别只是提取资料，不等同于税务查验、真伪认证、审批通过或实际付款。需要这些能力时应另行确认接口、权限、业务规则和验收范围。

## 用 WorkBuddy 或 Codex 构建应用

先完成[AI 工具连接](https://docs.danqiuos.com/start/connect-ai.md)，加载官方 `workbench-app-development` Skill。向开发助手说明目标 Team 和业务流程：

```text
请使用 workbench-app-development Skill，构建企业财务报销场景。
第一版使用 Workbench 做“我的报销、报销详情、费用明细、附件、人工复核”页面，
使用 Arcubase 保存业务数据。后续由报销助理读取对话和发票，写入同一数据应用。

先核对企业、账号与 Team，确认我选择复用已有 App 还是新建。
请提出表结构、费用分类、状态流转、角色权限及样例验收方案，暂不写入或发布。
普通员工只能访问获授权的报销；财务与审批人按确认范围复核。
本版不自动审批、不记账、不付款。缺少企业制度时请询问，不自行确定报销标准。
```

确认结构和操作范围后，再让助手按 Skill 实施。业务数据选择 `arcubase`；若需读取成员、对话或文件等平台资源，再按实际功能选择 `octopus`。审批待办确实需要项目和任务时再选 `taskboard`，不能把任务状态直接当作完整财务审批制度。

## 建议的数据结构

| 对象        | 方案字段示例                    | 设计要点                 |
| --------- | ------------------------- | -------------------- |
| 报销单       | 申请人、部门、用途、币种、汇总金额、状态、提交时间 | 申请人来自确认的身份，汇总与明细一致   |
| 费用明细      | 所属报销单、费用日期、分类、金额、商户、备注    | 不把不同币种直接相加；金额和必填项需核对 |
| 发票与附件     | 关联明细、源文件引用、发票信息、识别待核对项    | 保留授权可访问的原文件，不只保留模型摘要 |
| 复核记录（如需要） | 报销单、处理人、处理时间、结论、意见        | 状态变更有真实责任人与证据        |

字段、关系和状态由企业确认后实现。例如可设计“草稿 → 待复核 → 退回补充 / 已复核”，但这不是平台预置的报销状态机。复用已有财务数据应用时，以既有结构和规则为准。

应用用户、报销助理、财务和审批人的权限分别配置。普通员工不能读取他人报销，助理不因有录入权限就拥有批准或付款权限。附件本身也必须按业务范围控制访问。

## 工作台先通过本地验收

让 AI 实施真实列表、详情、草稿编辑和当前范围内的复核操作，使用生成的 Arcubase 强类型客户端。按脚手架开发登录流程进入本地应用，检查真实记录或真实空状态。

经授权使用测试记录验证新增、修改、附件打开、状态流转和错误反馈；保存后回读实际数据。记录 App ID、表标识、字段 key、状态、关系与权限，下一步交给助理复用。先在本地验证，不以页面完成为由提前发布。

## 配置报销助理

可以让开发助手先准备岗位、Skill 和授权方案，再由已支持的 CLI 配置能力或管理员 Portal 完成装配：

```text
请为刚才的报销工作台设计并配置“报销助理”，复用同一个 Arcubase App。
先提出岗位说明、发票整理 Skill、字段映射、文件读取能力和最小数据授权。
不要新建另一份报销库，也不要授予审批或付款权限。

工作流程：核对当前申请人和 Team；读取获授权上传的发票及对话说明；
提取日期、商户、金额、币种等可辨认字段，并保留原文件引用；
标记低置信度或缺失信息；检查可能重复的发票及已有草稿；
展示费用明细和汇总，补齐用途等必填项，经人确认后创建或更新草稿。
写入后回读真实记录，返回报销单标识和结果摘要。

不能辨认或访问的资料请明确说明；不猜金额、用途或申请人。
发现疑似重复时先请人核对，不自动删单或合并。
先展示方案，经确认再装配，并报告实际员工标识和验证结果。
```

发票为图片时，确认员工启用并获准使用图像识别；PDF、扫描件或其他附件，应按当前环境实际支持的读取能力单独验证。文件上传成功并不代表已能读取其内容。所需能力包括 Arcubase 使用类工具及适用的文件/图像读取能力，参见[内容与资料工具](https://docs.danqiuos.com/reference/content.md)。

## CRIDO：从上传到报销草稿

| 环节        | 本方案设计                                          |
| --------- | ---------------------------------------------- |
| Cue       | 员工在报销助理会话中上传发票并提出报销请求                          |
| Reference | 企业报销制度、费用分类、字段结构、发票整理 Skill 和重复检查规则            |
| Input     | 已确认申请人、获授权附件、费用用途、日期与其他实际提供的信息                 |
| Do        | 读取资料、整理明细、核对缺项和疑似重复、请求确认、写入同一 Arcubase App 并回读 |
| Output    | 工作台可查询的报销草稿、明细、原始附件引用和待补充事项                    |

## 验证应用与助理的协作

使用已授权的测试发票，在报销助理会话中发送：

```text
请根据我上传的测试发票整理一份报销草稿，用途是【填写用途】，
归属【填写已确认的业务项目或部门】。先列出你识别的明细、金额和待补充信息，
等我确认后再保存，不提交审批，也不进行付款。
```

1. 对照原票核对日期、商户、金额和币种；模糊字段应明确待核对。
2. 人确认后，工作台能找到同一报销单，金额与明细一致，附件可由获授权人员打开。
3. 在工作台按权限补充用途或退回原因，助理再次查询时能读到最新结果。
4. 测试重复上传、无法读取的附件、缺失用途、取消确认和其他员工越权访问。
5. 如果纳入审批流程，单独验证各角色允许的状态迁移和记录；草稿保存不代表审批通过。

本地联合验收通过并明确批准发布后，按[Workbench 开发流程](https://docs.danqiuos.com/build/workbench.md)发布应用，再用最终地址复验。交付保留数据标识、员工与 Skill、角色权限、样例证据、业务规则版本和维护责任人。