aeells/forge-kit
GitHub: aeells/forge-kit
为基于 Quarkus 的 JVM 微服务提供生产级限流、指标采集和健康检查等开箱即用的基础设施组件。
Stars: 1 | Forks: 0
# Forge Kit
[](https://opensource.org/licenses/MIT)
[](https://quarkus.io/)
[](https://conventionalcommits.org)
[](http://commitizen.github.io/cz-cli/)
**CI Status**
[](https://github.com/aeells/forge-kit/actions/workflows/00-hygiene-check.yml) [](https://github.com/aeells/forge-kit/actions/workflows/01-build-test.yml) [](https://github.com/aeells/forge-kit/actions/workflows/02-static-analysis.yml)
[](https://github.com/aeells/forge-kit/actions/workflows/03-release-bump.yml) [](https://github.com/aeells/forge-kit/actions/workflows/04-publish-packages.yml) [](https://github.com/aeells/forge-kit/actions/workflows/51-code-coverage.yml)
[](https://codecov.io/github/aeells/forge-kit)
## 概述
**Forge Kit** 是直接从 👉 **[Forge Platform](https://forgeplatform.software)** 中提取的基础设施组件集合。
它提供了基于 Quarkus 的组件，用于安全性、可观测性和跨切面服务关注点 —— 而不涉及特定领域逻辑。
Forge Kit 展示了延续至完整 Forge Platform 的以下能力：
- 架构的有序组合与关注点分离
- 微服务跨切面关注点的实现
- 严格的编码标准、文档和测试组织
## Forge Kit 提供的内容
### 🔒 安全与防护
- **速率限制与节流** (`forge-throttle`)
- 确定性的速率限制，清晰区分已认证与未认证的容量。
- [文档 →](forge-impl/forge-throttle/README.md)
### 📈 可观测性
- **指标框架** (`forge-metrics`)
- Micrometer 集成，支持 Prometheus 就绪的指标。
- 服务、熔断器和数据库性能记录器
- [文档 →](forge-impl/forge-metrics/README.md)
- **健康检查** (`forge-health-aws`)
- 支持 AWS 环境的存活和就绪探针。
- [文档 →](forge-impl/forge-health-aws/README.md)
### 🧱 平台工具
- **通用工具** (`forge-common`)
- 校验、错误处理和方法入口日志记录原语。
- [文档 →](forge-impl/forge-common/README.md)
每个模块均可独立使用并配有文档。
## 快速开始
将所需模块添加到您的项目中：
```
io.forge
forge-throttle
1.0.5
```
每个模块都包含针对性的文档和示例。
**📚 文档**
- [示例 →](examples/)
- [模板 →](templates/)
- [架构决策记录 →](docs/architecture/decisions/)
- [代码质量与 CI 强制执行](docs/CODE_QUALITY.md)
## 与 Forge Platform 的关系
Forge Kit 包含完整 Forge Platform 所使用的跨切面基础设施原语。
Forge Platform 在此基础上扩展了领域服务、身份流、通知、审计能力和运维工具。
如果您的目标是快速交付生产就绪的微服务，完整的平台可能是更好的起点。
## 支持
Forge Kit 是开源的，由社区提供支持。
对于寻求平台级支持或架构咨询的组织，
请参阅 👉 [Forge Platform](https://forgeplatform.software)。
## 许可证
Forge Kit 基于 [MIT 许可证](LICENSE) 授权。
标签：Forge Kit, Health Checks, JS文件枚举, JVM, Metrics, Quarkus, Rate Limiting, 中间件, 健康检查, 域名枚举, 开发工具包, 开源, 微服务框架, 最佳实践, 服务稳定性, 漏洞利用检测, 生产级基础设施, 监控指标, 自定义请求头, 运维工具, 限流