good fit
你的团队想要可见的结构,而不是框架约定
Plumego 适合那些希望 route ownership、中间件顺序和依赖 wiring 都写在代码里的团队——而不是交给框架注册机制管理。
使用场景
假设你已决定使用 Plumego。本页将具体服务场景映射到对应的模块、需要确认的适配信号,以及每种场景的最佳起步页面。如果你还在评估是否适合,请先看「为什么选择 Plumego」。
当服务形态需要在代码库增长后依然保持可读、多团队需要从同一基线起步、或者能力工作应当留在 HTTP 内核之外——Plumego 的拟合度最强。
good fit
Plumego 适合那些希望 route ownership、中间件顺序和依赖 wiring 都写在代码里的团队——而不是交给框架注册机制管理。
good fit
稳定根承担长期兼容性承诺。能力工作从 x/* 家族起步,内核就不会吸入每一项快速演进的工作。
slow down
如果团队更希望路由和依赖注入被框架默认处理,Plumego 可能会显得过于显式。
每张卡片说明涉及的能力模块、要验证的适配信号,以及该场景最合适的起步页面。
internal api
当一次 PR 应该让 reviewer 看清哪些路由被注册、哪些中间件按序执行、依赖由谁持有——而不需要先读框架源码——Plumego 更合适。
模块: core, router, contract, middleware 仅限稳定根
platform service
当新服务应该从同一份可读的参考布局起步,而不是每个团队各自写 bootstrap,Plumego 是最强的。用同一套 canonical 起点,结构漂移就能保持在低水位。
模块: reference/standard-service canonical 参考
multi-tenant saas
当服务需要 JWT 租户身份、per-tenant 配额执行和策略评估,且这些逻辑应该在 HTTP 内核之外——就用 x/tenant。稳定根承担 HTTP 基线,x/tenant 承担租户层,两者互不污染。
模块: x/tenant 实验性 — 采用前先评估
ai service
当你需要多 provider 抽象、session 生命周期、streaming 响应处理和 tool-call 路由,同时还要保持稳定 HTTP 内核,就用 x/ai。稳定根保持传输层兼容,x/ai 承接快速演进的 AI 能力工作。
模块: x/ai 实验性 — 采用前先评估
进入"为什么选择 Plumego"查看更完整的团队层面判断,或先看架构页,了解哪些模块是稳定的,哪些仍在实验阶段。