wiki/README.md

# BSM Infra Full Wiki

| 文档 | 内容 |
| --- | --- |
| [产品与服务目录](产品与服务目录.md) | 服务域、服务清单、实现完成度、跨域耦合与运行拓扑 |
| [总体审计报告（2026-09-22）](audit-2026-09-22-总体审计报告.md) | 逐业务实现层审计汇总：P0/P1 风险台账、共性根因、修复优先级 |
| [系统架构](architecture.md) | 模块边界、聚合入口、请求分流和依赖注入 |
| [电商聚合开发上下文](../pkgs/ecmall/AGENT.md) | pkgs/ecmall 的注册表、配置、跨模块耦合、业务链路、缺口清单和开发指引 |
| [开发与运维](operations.md) | 配置、启动、验证、构建、发布和排障 |
| [审计报告（2026-08-10）](audit-2026-08-10.md) | 上一轮 workspace 层审计：已修复问题、剩余风险和后续优先级 |
| [API 接入总览](api/00-overview.md) | gRPC、动态 HTTP RPC、grpc-gateway、鉴权和 JSON 规则 |

## 逐微服务代码审计

按微服务名称组织的代码审计报告位于 [`../docs/`](../docs/README.md)（21 篇：18 个业务服务 + 2 个聚合入口 + 工作区与脚本）。索引见 [docs/README.md](../docs/README.md)。

## 客户端 API 文档

| 领域 | 文档 |
|---|---|
| Base gRPC | [Ads](api/01-ads.md)、[Cloud](api/02-cloud.md)、[CMS](api/03-cms.md)、[Feedback](api/04-feedback.md)、[Initial](api/05-initial.md)、[Passport](api/06-passport.md)、[Sender](api/07-sender.md) |
| EC gRPC | [Address](api/08-address.md)、[Mall](api/09-mall.md)、[Market](api/10-market.md)、[Order](api/11-order.md) |
| Finance gRPC | [Wallet](api/12-wallet.md) |
| Social gRPC | [Feed](api/13-feed.md)、[Group](api/14-group.md)、[Relation](api/15-relation.md) |
| 原生 REST | [FTS](api/16-fts-rest.md)、[Logs](api/17-logs-rest.md)、[MGT](api/18-mgt-rest.md) |

protobuf 文档覆盖每个 service/method、动态 HTTP 路径、请求示例、消息字段和枚举。修改 `.proto` 后在 `scripts/api-docgen` 目录运行 `./generate.ps1` 或 `./generate.sh` 并提交生成结果。social 模块当前存在已知 descriptor 名称冲突，因此生成时会显示 warning。

修改模块入口、配置结构、聚合协议或发布方式时，应同步更新本目录和根 README。