3 Commits

Include renames

Author	SHA1	Message	Date
AskaEth	074ffc4ebf	docs(gateway): gateway 剩余文件注释改中文（逐行 1:1，代码零字节改动） ... 主人 2026-10-03 拍板「注释一律中文」；gateway 至此整包注释中文化完成（本会话共 3 批： 已推库 16 个文件 + 本批剩余文件）。 校验：机械校验（非注释改动行）= 空；剥注释后代码文本逐行比对全等（不一致文件数 0）； 全树 go test ./... 58 包 ok / 0 FAIL；交叉编译绿。	2026-10-03 22:28:25 +08:00
AskaEth	5847705e35	fix(gateway): 修 Snapshot 交出活 map 导致进程被 fatal 打死（并发 map 迭代+写入） ... 现场：cy.log:560，2026-10-03 21:00:28.403，栈顶 encoding/json.mapEncoder.encode ← writeJSON(rest.go:383) ← adminObservabilityMetrics(observability.go:89)， 不可 recover，网关 recover 中间件接不住 ⇒ 单二进制进程整体退出（端口 10942 零监听、 所有后台服务含 backthink 心跳一起没；比第一次心跳 tick 早 32.6 秒）。 根因：MetricsCollector.Snapshot 在锁内只新造了 StatusCounts，却把 collector 自己的 活 map m.perMethod / m.perPath 直接交出去；锁外（handler 的 writeJSON）才开始遍历， 而每个请求的 logging 中间件（middleware.go:79）在别的 goroutine 里 Record 写这两个 map ⇒ 写有锁、迭代没锁。面板并行轮询十几个端点，/admin/observability/metrics 被打了 29 次 且常见同毫秒两个请求，必踩。 修法：Snapshot 改为交出副本（新增 copyCounts / copyStatusCounts，都在锁内遍历）， 并把「必须在锁外可安全编码」的原因写进文档注释。对外读侧语义不变（仍是全量累计）。 测试（新增 observability_metrics_test.go，242 行）：① 快照与 collector 双向隔离（确定性） ② 并发「写 + 编码快照」（-race 下复现生产竞态）③ 真 HTTP + 中间件 + 并行轮询 /configmetric 端点（= 21:00:28 现场）。 验证：go build/vet 绿；-race ./internal/services/gateway/... ok；全量 go test ./... 58 包 ok / 0 FAIL； linux/amd64 + darwin/arm64 交叉编译绿。 变异验证：把 Snapshot 改回交活 map → 确定性测试 FAIL（"snapshot shares the collector's perPath map"） + -race 报出与生产同一处的 DATA RACE（Record 写在 observability_metrics.go:64）。	2026-10-03 21:38:59 +08:00
Aska	e0a543cc37	feat(observability): 管理面板可观测性接真实数据——metrics/trace/audit 三端点 + 审计持久化 ... - observability.go/observability_metrics.go/observability_trace.go/observability_audit.go： 拆分保证 ≤500行/函数≤80。metrics 并发安全 MetricsCollector(方法/路径/状态计数、平均/最大延迟、 近1s QPS窗口)；trace 并发安全 RingBuffer(默认512, newest-first)+traceSink+MultiTraceWriter； audit AuditStore 接口+内存回退+SQLite 持久化(NewSQLiteAuditStore 参数化 SQL+audit_logs 表)。 - server.go：Deps.AuditStore + Server.obs + 3 路由 GET /admin/observability/{metrics,trace,audit}； ObserveSpan/TraceSink 注入点；middleware logging recordMetric；audit 落库(仅 slog→Append)。 - 前端 Obs.tsx：metrics 接 4 张真实 StatCard+请求分布、trace 接 span 列表(展开 props/events)、 audit 从后端拉(前端内存审计作回退)；api.ts/types.ts 加 obs 端点/类型(AdminObservabilityMetrics/ AdminTraceSpan/AuditRecord.id 放宽)。成本指标不伪造(保留'—'+注明)。 - wire.go 收口：Deps.AuditStore 注入 gateway.NewSQLiteAuditStore(ctx, a.db)(审计真落库)， 未注入回退内存。 - Docs/api-client.md §2/v0.6。 实机验证：三端点 200，metrics 返回 totalRequests:4/qps:4/perPath/statusCounts:{200:4}。 go build/vet/test 全绿 + 前端 tsc。trace 数据源对接(gw.TraceSink→loop tracer)因 gw/tracer 构造顺序留作可选后置(端点已就绪, 未对接 span 空)。	2026-09-06 21:02:46 +08:00