2026-08-10 11:42:45 +08:00
|
|
|
# BSM Infra Full Wiki
|
|
|
|
|
|
|
|
|
|
| 文档 | 内容 |
|
|
|
|
|
| --- | --- |
|
|
|
|
|
| [系统架构](architecture.md) | 模块边界、聚合入口、请求分流和依赖注入 |
|
|
|
|
|
| [开发与运维](operations.md) | 配置、启动、验证、构建、发布和排障 |
|
|
|
|
|
| [审计报告](audit-2026-08-10.md) | 已修复问题、剩余风险和后续优先级 |
|
2026-08-11 19:09:29 +08:00
|
|
|
| [API 接入总览](api/00-overview.md) | gRPC、动态 HTTP RPC、grpc-gateway、鉴权和 JSON 规则 |
|
|
|
|
|
|
|
|
|
|
## 客户端 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。
|
2026-08-10 11:42:45 +08:00
|
|
|
|
|
|
|
|
修改模块入口、配置结构、聚合协议或发布方式时，应同步更新本目录和根 README。
|
