diff --git a/docs/experts/00_PROJECT_OVERVIEW.md b/docs/experts/00_PROJECT_OVERVIEW.md index ceca2439..a7b99d47 100644 --- a/docs/experts/00_PROJECT_OVERVIEW.md +++ b/docs/experts/00_PROJECT_OVERVIEW.md @@ -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`。 --- diff --git a/docs/llm_gateway_product_technical_blueprint_v1_2026-03-16.md b/docs/llm_gateway_product_technical_blueprint_v1_2026-03-16.md index 249c0cc4..3e8b9be2 100644 --- a/docs/llm_gateway_product_technical_blueprint_v1_2026-03-16.md +++ b/docs/llm_gateway_product_technical_blueprint_v1_2026-03-16.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。 部署建议: diff --git a/docs/resource_assessment_plan_v1_2026-03-18.md b/docs/resource_assessment_plan_v1_2026-03-18.md index 946461f5..a60ccec1 100644 --- a/docs/resource_assessment_plan_v1_2026-03-18.md +++ b/docs/resource_assessment_plan_v1_2026-03-18.md @@ -164,7 +164,7 @@ S2 (W19-W34): [Router Core自研] 10人 如果招聘困难: 1. **外包部分非核心功能**(如管理后台) -2. **使用云服务商托管服务**(如托管Redis、Kafka) +2. **使用云服务商托管服务**(如托管Redis ~~、Kafka~~) 3. **延迟非关键功能**(如部分S3机器人能力) --- diff --git a/docs/technical_architecture_design_v1_2026-03-18.md b/docs/technical_architecture_design_v1_2026-03-18.md index c8eba29b..6c5a1ac5 100644 --- a/docs/technical_architecture_design_v1_2026-03-18.md +++ b/docs/technical_architecture_design_v1_2026-03-18.md @@ -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 | - | 持续集成 |