审计文档分析工具

审计流程

AuditFlow是一个文本和语音聊天应用程序，供审计师从试算表和总账等财务文件中提取见解。它使用Supabase（PostgreSQL）和SQLAlchemy ORM构建MCP服务器，使用Weaviate Vector Store进行混合搜索，结合BM25、元数据和语义搜索进行数据检索，并与n8n集成。

特性

• 文本和语音聊天界面：通过使用文本或语音输入的自然语言查询与您的财务文档进行交互
• 财务文件分析：为试算表和总账文件提供专门支持
• 混合搜索：结合BM25、元数据过滤和语义搜索，实现准确的数据检索
• MCP服务器架构：基于模型上下文协议，用于可扩展的AI集成
• 工作流程自动化：与n8n无缝集成，实现自动化审计工作流程

技术栈

• 数据库：Supabase（PostgreSQL）
• 对象关系映射：SQL炼金术
• 向量存储：编织
• MCP服务器：与n8n集成
• 工作流程自动化：n8n
• 搜索：混合搜索（BM25+语义+元数据）

先决条件

• Python 3.8+
• 紫外线 （Python包安装程序）
• 辅助账户和项目
• Weaviate实例（云或自托管）
• n8n实例（可选，用于工作流自动化）

安装

1. 克隆存储库：

git clone https://github.com/UmarEhtisham/AuditFlow-Chat.git
cd auditflow

2. 使用uv安装依赖项：

uv sync

或者在开发模式下安装软件包：

uv pip install -e .

3. 设置环境变量：

cp .env.example .env

编辑 .env 使用您的Supabase凭据：

SUPABASE_URL=your_supabase_direct_url

备注：其他凭据（Weaviate、n8n webhooks）在n8n工作流中配置。

4. 运行应用程序：

python main.py

数据库将在首次运行时自动初始化。

用法

AuditFlow通过由n8n工作流支持的WhatsApp集成进行访问。所有交互（文本查询、语音消息和文档上传）都通过WhatsApp处理。

文本查询

向配置的WhatsApp号码发送短信，其中包含您的审核查询：

"Show me all transactions above PKR 10,000 in the general ledger"
"Summarize the trial balance for 2024"
"Find all entries related to account 1200"

语音查询

向WhatsApp号码发送包含您的问题的语音消息。系统将自动转录和处理您的音频查询。

文档上传

直接通过WhatsApp发送财务文件（Excel、PDF）：

1. 附上您的试算表或总账文件
2. 添加说明文档类型的标题（可选）
3. 系统将处理并索引文档以供查询

建筑

AuditFlow使用多层架构：

1. 数据层：Supabase PostgreSQL存储结构化财务数据
2. 矢量图层：编织索引文档嵌入以进行语义搜索
3. 搜索层：结合关键字（BM25）、元数据和语义搜索的混合搜索
4. MCP服务器：处理AI模型交互和上下文管理
5. 集成层：n8n用于自动化流程的工作流

搜索功能

AuditFlow的混合搜索结合了三种方法：

• BM25搜索：传统的基于关键字的精确匹配搜索
• 语义搜索：概念相似性的向量嵌入
• 元数据筛选：按日期范围、金额、账户类型等过滤。

许可证

MIT许可证

版权所有（c）2025 AuditFlow

特此免费向任何获得副本的人授予许可 本软件和相关文档文件（“软件”），以处理 在软件中不受限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或销售 软件的副本，并允许软件的接收者 根据以下条件提供：

上述版权声明和本许可声明应包含在所有 软件的副本或实质性部分。

软件按“原样”提供，不提供任何形式的明示或明示担保 隐含的，包括但不限于适销性保证， 适用于特定目的且不造成伤害。在任何情况下 作者或版权持有人对任何索赔、损害赔偿或其他 因以下原因产生的责任，无论是在合同、侵权或其他诉讼中， 出于或与软件、使用或其他交易有关 软件。

致谢

• 内置于 Supabase
• 由...驱动 Weaviate
• 自动化与 n8n
• 用途 SQLAlchemy

由以下材料制成❤️ 适用于各地的审计师