SaaS会计服务

安全SaaS会计（MCP就绪）

规则压倒了氛围。
这是一个安全的、规则优先的SaaS会计师，它接收银行式交易，用确定性逻辑对其进行分类，并将其同步到一个干净的UI+Notion友好的结构中——所有这些都由MCP工具编排。

---

这个项目做什么

此回购是 真正的SaaS会计师的MVP，设计得像一个生产系统：

• 阅读 交易馈送 （目前模拟TD/PayPal风格数据）
• 将它们存储在 PostgreSQL/SQLite风格模式
• 运行a 逻辑规则引擎 致：
  • 自动对商家进行分类（例如，优步→ 运输）
  • 桶装费用（食品、交通、娱乐等）
  • 附上预算和利用率
• 暴露a web用户界面 可视化：
  • 总支出
  • 每桶花费
  • 最近分类交易
• 暴露干净的HTTP API+MCP工具表面，因此AI代理可以：
  • 摄取交易
  • 应用规则
  • 同步到Notion
  • 生成报告

默认情况下，它完全运行 本地 随着 模拟数据，但该架构是为插入而构建的 格子/花式+概念 以安全、只读的方式。

---

特性

• 🔐 安全第一架构

  • 围绕只读聚合器（Plaid/Flinks）设计。
  • 任何银行凭证都不会接触到该应用程序。
  • 在实际部署中使用最少的PII和加密存储。

• 🧠 逻辑编程会计师

  • 基于优先级的规则引擎(pattern + field → category + bucket).
  • 确定性的、可解释的分类。
  • 每个桶的预算和简单的利用率统计数据。

• 🧩 MCP就绪

  • 清洁工具表面，以：
    • 获取交易记录
    • 应用规则
    • 同步到Notion
    • 生成月度报告
  • 构建由LLM代理驱动，但不依赖于LLM代理。

• 📊 现代用户界面

  • FastAPI提供最少的HTML+CSS前端。
  • 显示：
    • 标题指标
    • 铲斗故障
    • 最近交易表。

• 🧱 MVP映射到真正的SaaS

  • 明确界限：
    • 数据层（聚合器→ DB)
    • 逻辑层（规则+预算）
    • 同步层（通知/报告）
  • 易于扩展到多租户、适当的身份验证和真正的开放式银行。

---

建筑

该系统分为三个主要层：

1.数据层

• 从提供者抽象（目前为模拟JSON）接收事务。

• 标准化事务模式：

  复制

  {
    "id": "txn_123",
    "date": "2025-11-29",
    "amount": -23.45,
    "currency": "CAD",
    "merchant": "UBER *TRIP",
    "raw_category": "Travel",
    "source_system": "TD_CHEQUING"
  }