fgomensoro/tenant-flow

# 租户流向 一个作为工程深度探索的多租户集成平台。包含 Webhook 摄取（Shopify、Stripe）、Postgres 行级安全、幂等处理，以及用于金融异常检测的 RAG 层。 ## 这是什么 tenant-flow 是一个从零开始实现的 B2B SaaS 集成平台：它摄取外部系统（Shopify、Stripe 等）的 Webhook，在多租户隔离下安全处理，并通过 API 和 AI 层暴露结果数据，该 AI 层能够检测异常并回答自然语言问题。 范围有意保持狭窄。目标不是构建一个产品，而是构建真实系统中那些有趣的工程决策所在的部分：租户隔离、幂等性、Webhook 可靠性、带严格数据边界的检索增强生成，以及可观测性和部署等运营考量。 ## 存在的原因 本仓库是一个学习项目，具有明确的约束：每一个有意义的决策都必须被推理、记录并可辩护。跳过教程，直接构建困难部分，并在过程中记录权衡。 项目的主要产物不仅仅是代码，更是 **架构决策记录（ADR）**，位于 [`docs/adr/`](./docs/adr/)。每个 ADR 记录一个决策：包括上下文、考虑的替代方案、所选方案以及明确接受的权衡。按顺序阅读 ADR，应能清晰理解系统是如何被推理构建出来的。 如果你在评估本仓库，ADR 是入手的起点。代码展示了构建了什么；ADR 展示了为何如此构建。 ## 状态 早期进行中。Phase 1（多租户 Webhook 处理器）正在构建中，随后是 Phase 2（用于异常检测和自然语言查询的 RAG 层）。 ## 仓库结构 ``` tenant-flow/ ├── docs/ │ └── adr/ # Architecture Decision Records │ └── 001-multitenancy-strategy.md ├── .gitignore ├── LICENSE └── README.md ``` 随着项目发展会添加更多结构。本 README 将在每个阶段结束时更新以反映当前状态。 ## 许可证 MIT — 参见 [`LICENSE`](./LICENSE)。

标签：ADR, API集成, B2B, PostgreSQL, RAG, SaaS平台, Stripe, Webhook, 事件处理, 人工智能, 力导向图, 可观测性, 工程深度, 幂等处理, 数据边界, 架构决策记录, 检索增强生成, 用户模式Hook绕过, 租户隔离, 行级安全, 财务异常检测, 部署运维, 集成平台, 领域驱动设计