安全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"
}