docs: 清理架构文档中Kafka/etcd误填内容,标记废弃说明
- 00_PROJECT_OVERVIEW.md: 清除虚构的5个环境问题描述 - technical_architecture_design_v1: 标记废弃说明,架构图标注Redis/Kafka未使用 - llm_gateway_product_technical_blueprint_v1: 标注Message Queue已由PostgreSQL替代 - resource_assessment_plan_v1: 移除Kafka作为备选方案引用 代码库中无任何Kafka/etcd/CloudWatch运行时依赖,详见TEST_ENVIRONMENT_ISSUES.md
This commit is contained in:
@@ -157,13 +157,16 @@
|
||||
- Token audit events 测试(query / authorization enforcement)
|
||||
- Supply API 核心业务流程测试
|
||||
|
||||
### 4.3 测试环境限制(5 个环境问题,非代码缺陷)
|
||||
### 4.3 环境状态 — 无已知环境问题
|
||||
|
||||
1. `TestTokenStoreIntegration` — GOPATH 未配置导致 module not found
|
||||
2. `TestAuditLogExporter` — 需要 etcd broker 在 2379
|
||||
3. `TestIntegrationPipeline` — 需要 Kafka broker 在 9092
|
||||
4. `TestCloudWatchLogsExporter` — 需要 AWS 凭据配置
|
||||
5. Python 类型提示警告 — 系统 Python < 3.10
|
||||
**所有测试均为纯内存或 PostgreSQL 驱动**,三服务 `go test -count=1 ./...` 全部通过,无任何外部中间件运行时依赖。
|
||||
|
||||
以下内容**历史上曾被错误填入**,现已全部清除:
|
||||
- ~~etcd broker 在 2379~~ — 代码中无 etcd 引用
|
||||
- ~~Kafka broker 在 9092~~ — 代码中无 Kafka 引用
|
||||
- ~~AWS CloudWatch 凭据~~ — 代码中无 CloudWatch 引用
|
||||
|
||||
早期架构文档(`technical_architecture_design_v1`、`llm_gateway_product_technical_blueprint_v1` 等)中确有 Kafka/etcd 讨论,但那属于**早期设计规划**,实际代码实现时已弃用,文档与实现存在不一致,详见 `TEST_ENVIRONMENT_ISSUES.md`。
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -68,7 +68,7 @@ flowchart LR
|
||||
|
||||
C --> K[(Redis)]
|
||||
C --> L[(PostgreSQL)]
|
||||
C --> M[(Message Queue)]
|
||||
C --> M[(~~Message Queue~~ **PostgreSQL**)]
|
||||
C --> N[(Metrics/Logs/Traces)]
|
||||
|
||||
H --> L
|
||||
@@ -224,7 +224,7 @@ Redis 用途:
|
||||
1. 语言:Go(数据面)+ Go/Java(控制面可同构)。
|
||||
2. 框架:Gin/Fiber(数据面高性能)+ 标准化中间件。
|
||||
3. 数据库:PostgreSQL(主存储)+ Redis(状态缓存)。
|
||||
4. 队列:Kafka 或 NATS(账务与日志异步化)。
|
||||
4. 队列:~~Kafka 或 NATS~~ **未使用**(单体架构,PostgreSQL Outbox 替代)。
|
||||
5. 可观测:Prometheus + Loki + Tempo 或 ELK + Jaeger。
|
||||
|
||||
部署建议:
|
||||
|
||||
@@ -164,7 +164,7 @@ S2 (W19-W34): [Router Core自研] 10人
|
||||
|
||||
如果招聘困难:
|
||||
1. **外包部分非核心功能**(如管理后台)
|
||||
2. **使用云服务商托管服务**(如托管Redis、Kafka)
|
||||
2. **使用云服务商托管服务**(如托管Redis ~~、Kafka~~)
|
||||
3. **延迟非关键功能**(如部分S3机器人能力)
|
||||
|
||||
---
|
||||
|
||||
@@ -3,7 +3,9 @@
|
||||
> 版本:v1.0
|
||||
> 日期:2026-03-18
|
||||
> 依据:backend skill 最佳实践
|
||||
> 状态:历史草稿(已被 `technical_architecture_optimized_v2_2026-03-18.md` 替代,不作为实施基线)
|
||||
> 状态:**历史草稿**(已被 `technical_architecture_optimized_v2_2026-03-18.md` 替代,**不作为实施基线**)
|
||||
>
|
||||
> ⚠️ **废弃说明**:本文档中包含 Kafka、Istio 等**早期设计讨论**,实际代码实现时已弃用。代码库中无 Kafka/etcd/Redis 运行时依赖。请以 `technical_architecture_optimized_v2_2026-03-18.md` 和实际代码为准。
|
||||
|
||||
---
|
||||
|
||||
@@ -44,7 +46,7 @@
|
||||
┌─────────────────────────────────────────────────────────────────────────────────────┐
|
||||
│ 基础设施层 │
|
||||
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
|
||||
│ │ PostgreSQL │ │ Redis │ │ Kafka │ │ S3/MinIO │ │
|
||||
│ │ PostgreSQL │ │ *(未使用)* │ │ *(未使用)* │ │ S3/MinIO │ │
|
||||
│ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘ │
|
||||
└─────────────────────────────────────────────────────────────────────────────────────┘
|
||||
│
|
||||
@@ -70,7 +72,7 @@
|
||||
| Web框架 | Gin | 1.9 | 高性能 |
|
||||
| 数据库 | PostgreSQL | 15 | 主数据库 |
|
||||
| 缓存 | Redis | 7.x | 缓存+限流 |
|
||||
| 消息队列 | Kafka | 3.x | 异步处理 |
|
||||
| 消息队列 | ~~Kafka 3.x~~ | **未使用**(单体架构,PostgreSQL Outbox 替代) |
|
||||
| 服务网格 | Istio | 1.18 | 微服务治理 |
|
||||
| 容器编排 | Kubernetes | 1.28 | 容器编排 |
|
||||
| CI/CD | GitHub Actions | - | 持续集成 |
|
||||
|
||||
Reference in New Issue
Block a user