# KnowledgeInsight-gateway **Repository Path**: CmbTestWorker/knowledge-insight-gateway ## Basic Information - **Project Name**: KnowledgeInsight-gateway - **Description**: No description available - **Primary Language**: Java - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-17 - **Last Updated**: 2026-11-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # knowledge-insight-gateway 知识数据中台 Java 网关。当前已实现 **G0 最小路由转发**:把 `/api/**` 请求透传到配置的上游,保留方法、路径、查询串、请求头和 body;鉴权、空间权限、HMAC 签名、限流、审计等能力后续添加。 ## 快速开始 前置:JDK 21(本机通过 Homebrew 安装时路径为 `/opt/homebrew/opt/openjdk@21`)。 ```bash export JAVA_HOME=/opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk/Contents/Home export PATH="$JAVA_HOME/bin:$PATH" ./mvnw spring-boot:run # 默认监听 http://localhost:8080,默认上游 http://localhost:8100 # 指定下游地址 GATEWAY_UPSTREAM_URI=http://127.0.0.1:9000 ./mvnw spring-boot:run curl http://localhost:8080/health/live curl http://localhost:8080/health/ready ``` 测试: ```bash ./mvnw test ``` 当前测试覆盖 GET、POST body 与健康端点,使用 JDK `HttpServer` 作为 mock 上游。 ## 当前能力边界 | 能力 | 状态 | | --- | --- | | `/api/**` 透明路由转发 | ✅ 已实现 | | 方法/路径/查询串/请求头/body 透传 | ✅ 已实现 | | `/health/live`、`/health/ready` | ✅ 已实现 | | 认证 / 空间权限 / 内部签名 | ⏳ 后续 G1 | | 按 Manager / Core 拆分路由、路径改写 | ⏳ 后续 | | 限流 / 审计 / Redis | ⏳ 后续 | | 统一错误码 | ⏳ 后续 | 配置: | 环境变量 | 默认 | 说明 | | --- | --- | --- | | `SERVER_PORT` | `8080` | 监听端口 | | `GATEWAY_UPSTREAM_URI` | `http://localhost:8100` | 当前唯一上游 | | `GATEWAY_ROUTE_PATH` | `/api/**` | 透传路径 | ## 设计文档 | 文档 | 内容 | | --- | --- | | [01-最小路由实现](docs/01-最小路由实现.md) | 当前 G0 实现、配置、测试与局限 | | [00-实现方案](docs/00-实现方案.md) | 完整实施阶段(G0 已实现;G1/G2 后续) | | [06-网关服务](docs/06-网关服务.md) | 鉴权、路由、SSE、错误码、限流与审计的完整设计 | 上游文档:[01-总体设计与原则](../知识中台/01-总体设计与原则.md)、[02-数据模型](../知识中台/02-数据模型.md)、[09-工程规范与测试](../知识中台/09-工程规范与测试.md);下游服务见 [07-平台管理服务](../knowledge-insight-manager/docs/07-平台管理服务.md)。