流程概述¶

DocuSnap-Backend 系统支持三种主要的业务流程：文档处理、表单处理和表单自动填充。这些流程共享相似的处理架构，但在细节上有所不同，以适应不同的业务需求。本页面提供这些流程的概述。

主要业务流程¶

DocuSnap-Backend 系统支持以下三种主要业务流程：

文档处理流程：
将文档图像转换为文本
分析文档结构和内容
提取关键信息
生成结构化的文档数据
表单处理流程：
将表单图像转换为文本
识别表单字段和值
提取字段-值对
生成结构化的表单数据
表单自动填充流程：
分析空白表单结构
匹配用户提供的信息与表单字段
生成填充后的表单数据
标识缺失的必要信息

通用处理架构¶

尽管三种业务流程在细节上有所不同，但它们共享一个通用的处理架构：

graph TD
    A["客户端请求"] --> B["请求验证与解密"]
    B --> C["任务创建与队列"]
    C --> D["OCR 处理"]
    D --> E["LLM 处理"]
    E --> F["结果存储"]
    F --> G["响应加密与返回"]
    H["状态查询"] --> I["结果检索"]
    I --> J["响应生成"]

这个通用架构包括以下关键步骤：

请求接收与验证：
接收客户端的加密请求
解密请求数据
验证请求参数和格式
任务管理：
创建任务记录
将任务添加到处理队列
分配工作线程处理任务
OCR 处理：
处理图像，提取文本内容
并行处理多个图像
合并 OCR 结果
LLM 处理：
根据任务类型构建提示
调用 LLM API 分析文本
解析 LLM 响应
结果处理：
存储处理结果
更新任务状态
加密响应数据
状态查询：
客户端查询任务状态
检索任务结果
返回状态或结果

流程差异¶

虽然三种业务流程共享通用架构，但它们在以下方面存在差异：

1. 提示构建¶

每种流程使用不同的提示模板引导 LLM 进行特定类型的分析：

文档处理：提示 LLM 分析文档结构、识别标题、段落、列表等，提取关键信息
表单处理：提示 LLM 识别表单字段和值，提取字段-值对
表单填充：提示 LLM 将用户提供的信息与表单字段匹配，生成填充后的表单数据

2. 输入参数¶

不同流程接受不同的输入参数：

文档处理：仅接受文档图像
表单处理：仅接受表单图像
表单填充：接受表单图像和用户提供的信息

3. 结果格式¶

不同流程生成不同格式的结果：

文档处理：生成包含文档结构和内容的 JSON 数据
表单处理：生成包含字段-值对的 JSON 数据
表单填充：生成包含填充字段和缺失字段的 JSON 数据

4. 处理策略¶

不同流程使用不同的处理策略：

文档处理：侧重于理解文档结构和内容
表单处理：侧重于准确识别字段和值
表单填充：侧重于信息匹配和推断

数据流图¶

下图展示了 DocuSnap-Backend 系统中的数据流：

数据流程图

这个数据流图展示了从客户端请求到响应的完整数据流向，包括请求处理、任务执行、结果存储和响应处理等阶段。

异步处理模式¶

DocuSnap-Backend 系统采用异步处理模式，将请求接收和任务处理分离，提高系统响应能力和并发处理能力：

请求接收：
客户端发送请求
系统快速创建任务并返回任务 ID
客户端不需要等待处理完成
异步处理：
工作线程从队列获取任务
执行 OCR 和 LLM 处理
存储处理结果
状态查询：
客户端使用任务 ID 查询状态
系统返回当前状态或处理结果
客户端可以定期轮询或实现回调机制

这种异步处理模式适合处理耗时的 OCR 和 LLM 操作，避免客户端长时间等待，提高用户体验。

错误处理¶

DocuSnap-Backend 系统实现了全面的错误处理机制，确保流程的可靠性和稳定性：

请求验证错误：
参数缺失或格式错误
解密失败或签名验证失败
返回适当的错误代码和消息
处理错误：
OCR 处理失败
LLM API 调用失败
结果解析失败
记录错误信息，更新任务状态
系统错误：
数据库操作失败
资源不足
服务不可用
记录详细错误日志，返回通用错误消息

错误处理机制确保系统能够优雅地处理各种异常情况，提供清晰的错误反馈，并尽可能地恢复正常操作。

在接下来的页面中，我们将详细介绍每种业务流程的具体实现和数据流向。