fix version 1

docs/ads.md

@@ -143,3 +143,22 @@ flowchart TD
 7. **补测试**：为 `ByPos` 增加 2~3 条最小用例——命中启用广告、同 `pos_key` 下含 `status != 1` 的记录（须被过滤）、`key` 为空。
 
 > 本报告只列出与现有实现直接相关的修复项，不引入新的分层、抽象封装或 DTO/VO 改造。
+
+## 9. 整改记录（2026-09-22）
+
+> 本节记录按本报告结论执行的代码整改。整改遵循**最小修正**原则：未引入新框架、抽象层、DTO/VO、事件总线，未拆分服务边界，**未修改任何 `proto/*.proto` 与生成的 `pb/*.go`**；新增/修改注释均为中文；口令类摘要统一使用 bcrypt（验证码等短时效一次性凭证仍按原有 Redis 明文比对链路存储）。校验方式：`GOWORK=off go build ./...` + `GOWORK=off go vet ./...` + `gofmt -l`（仓库根 workspace 模式存在 genproto 拆包的 ambiguous import，属本机既有问题）。
+
+| 编号 | 级别 | 问题 | 处理结果 |
+| --- | --- | --- | --- |
+| A1 | 中 | 鉴权策略两处矛盾（模块 yaml 匿名 vs 聚合未放行） | 未处理：本模块无「高」级问题，本轮未改动 `module/base/ads` 任何文件 |
+| A2 | 中 | 广告读取仅凭 `pos_key`，无租户/端隔离 | 未处理（保持现状） |
+| A3 | 中 | `Databases` 未校验，缺失即启动 panic | 未处理：本轮未改动本模块，其余服务已按同一模式补上非空校验，可后续对齐 |
+| A4 | 低 | README 宣称的缓存/性能/监控能力未实现 | 未处理（文档问题） |
+| A5 | 低 | `ByPos` 无返回条数上限 | 未处理 |
+| A6 | 低 | 死代码与死配置 + 无自动化测试 | 未处理 |
+
+### 未纳入本轮范围
+
+报告中「中」「低」级别的项（分页上限、死代码、README 与实现不符、单测缺失、可维护性等）**本轮未处理**；如需继续，按各报告第 8 节「修复建议」的顺序推进即可。
+
+> 本轮整改未修改任何 `proto/*.proto` 与 `pb/*.go`，因此少数需要新增接口字段才能完整实现的项目（已在处理结果中标注）做了安全降级。