- 稳定性
- 稳定
- 作用域
- 全局
- 边界
- packages/platform
- edge
- gateway
- services
- platform当前层
- storage
可用性
99.88%
p99 延迟
32 ms
活跃连接
3,490
活跃租户
368
1import { prisma } from "@nebutra/db";
2import { getCurrentTenant } from "@nebutra/tenant";
3
4const tenant = getCurrentTenant();
5
6const posts = await prisma.post.findMany({
7 where: { tenantId: tenant.tenantId, published: true },
8 orderBy: { publishedAt: "desc" },
9 take: 10,
10});error.rate > 5%p95.latency > 800msdisk.usage > 80%alerting
基于 @nebutra/metering 的告警规则与投递 — 阈值/异常检测,路由到 PagerDuty / Discord / 产品内 banner。
查看analytics
基于 ClickHouse 的一方产品分析 — 事件写入、漏斗查询;营销站点不加载任何三方脚本。
查看- config
- db
- queue
- vault
- events
- ai
- tenant
- schedule
pnpm nebutra capability scaffold
capability-kit
可组合 capability 原语 — pricing tier ↔ feature flag ↔ quota ↔ UI gating,以单一声明式 manifest 串联。
查看- config.database.urlstring· required
- config.ai.defaultModelstring· default "claude-sonnet-4-6"
- config.ai.maxTokensnumber· default 4096
- config.cache.ttlnumber· default 60
validated at startup
config
类型化环境与运行时配置 — boot 时 Zod 校验,杜绝散落的 process.env 引用,缺 key 立刻失败。
查看db
类型化 Prisma client 包装 — extension 友好、RLS 兼容、读写分离时按租户绑定连接。
查看BILLING_PROVIDER_TIMEOUTQUEUE_RETRY_LIMITAUTH_TOKEN_REFRESHEDat packages/commerce/billing/src/charge.ts:42at @nebutra/queue: retryHandlererrors
应用错误类型分类 — UserError / AuthError / RateLimitError;到 HTTP、日志、Sentry、产品内 toast 各层映射一致。
查看feature-flags
服务端 + 客户端 flag 求值器 — GrowthBook / Statsig / 自建;按租户覆写、sticky 分桶、暴露为 React hook。
查看gateway-core
BFF 原语 — backends/gateway 与 edge handler 共用;中间件链、路由匹配、header 规整、request-id 透传。
查看graph-model
属性图模型层 — 用于知识 / 组织 / 资产图;边与点用 Zod 定型,可走 Prisma 或 Neo4j adapter。
查看health
所有后端服务的存活 + 就绪探针;把 db / queue / search 等下游聚合进同一份 /healthz 响应。
查看i18n
next-intl 桥接 — 运行时 locale、ICU 复数、货币/日期 formatter、按路由分包;构建期防止 key 漂移。
查看logger
结构化日志 — pino + Sentry transport;每请求一个 log 对象、breadcrumb 自动联动、PII 自动剥离。
查看provider-factory
自动探测的 provider 工厂模式 — 由环境变量决定 queue / search / notifications backend,一个 getX() 即可。
查看- /api/posts200 ok87 left
- /api/users429 throttledretry-after 12s
rate-limit
令牌桶限速器 — Upstash Redis / 内存;按路由 + 按租户配置,返回 429 + retry-after,决策可审计。
查看repositories
仓储模式原语 — findAll / findById / create / update / delete 统一 Repository<T>;换 backend 不动调用方。
查看status
公开状态页原语 — incident 时间线、组件图、订阅邮件;支持完整状态页与可嵌入 widget。
查看tenant-store
按租户的 KV 缓存 — 缓存数据库查询太热的 lookup;租户设置变更自动失效。
查看trace-store
OpenTelemetry 兼容的 span 存储与查询层;让 agent 能跨 iam / billing / webhooks 追踪一个 tool 调用。
查看