Kernel 能力分层总览
这组文档按照 github.com/aisphereio/kernel 的真实代码组织,而不是按照愿景或产品口号组织。
基础能力层:errorx / logx / configx
基础能力层解决的是所有服务都会遇到的问题:错误如何跨 HTTP/gRPC 表达,日志如何统一结构,配置如何加载、扫描、监听和热更新。
身份与访问控制层:authn / authz / accessx / iamx
身份与访问控制层解决四个问题:
服务装配层:serverx
serverx 是 Kernel 的服务装配主线。它的职责不是提供一个普通 HTTP server,而是把生成的服务模块、请求元信息、认证、授权、审计、准入、数据库和迁移统一装配成可运行服务。
Gateway 层:gatewayx 与 deploy HTTPRoute
Kernel 里有两类 Gateway 相关能力,容易混在一起:
Proto 与生成器层
Kernel 的开发范式是 proto-first:业务服务先声明 contract,再由生成器产生运行时 glue。这里的 contract 不只是 message 和 rpc,还包括 HTTP 路由、访问策略、审计、能力标签、Gateway 发布策略和部署路由。
业务服务如何使用 Kernel 能力
这篇文档从业务服务视角说明:一个基于 Kernel 的服务应该如何使用前面几层能力。