BSM Infra Full
BSM 后端服务 Go workspace，包含 19 个独立业务模块和一个统一端口运行的 all 聚合模块。Go 版本为 1.26.5。
快速开始
Windows：
go work sync
./scripts/verify-workspace.ps1
Linux/macOS：
go work sync
./scripts/verify-workspace.sh
运行独立服务：
cd module/base/passport
go run ./cmd/main
运行聚合服务：
cd all
go run ./cmd/main --workspace=default
all 默认读取 all/etc/default_.yaml。指定 --workspace=tenant01 时，开发模式读取 all/etc/tenant01_dev.yaml。workspace 仅允许字母、数字、下划线和连字符，最长 64 个字符。
模块
| 领域 | 模块 |
|---|---|
| module/base | ads、cloud、cms、feedback、fts、initial、logs、mgt、passport、sender |
| module/ec | address、mall、market、order |
| module/finance | wallet |
| module/social | feed、group、relation |
| all | 聚合 15 个 base/ec/finance 服务，统一提供 gRPC、grpc-gateway 和 Gin HTTP |
Services 配置决定 all 启用哪些服务；BSM_SERVICES 环境变量可临时覆盖，例如 passport,order,wallet。
配置安全
仓库内 YAML 仅为结构示例，凭据使用 CHANGE_ME。部署时必须通过密钥管理或发布系统注入真实值，禁止提交密码、令牌、私钥和云密钥。
生产环境至少应替换全部 CHANGE_ME，关闭公网数据库/Redis/etcd，评估关闭 gRPC reflection，保持 mgt.InitRootUser=false，并在入口层启用 TLS 和访问控制。
常用脚本
| 脚本 | 用途 |
|---|---|
| scripts/verify-workspace.ps1 | Windows：gofmt、go vet、go test |
| scripts/verify-workspace.sh | Linux/macOS：gofmt、go vet、go test |
| scripts/build-all-linux.sh | 构建 Linux amd64 独立服务 |
| scripts/generate-protobuf.sh | 重新生成 protobuf |
| scripts/update-all.sh | 更新全部依赖，执行后必须审阅差异 |
文档
开发约定
- 新模块必须加入 go.work，不得提交本机绝对路径 replace。
- 模块保留独立 cmd/main，通过 service.Expose 接入 all。
- 默认测试不得访问网络或真实基础设施；集成测试使用 integration build tag。
- protobuf 全限定名称必须跨模块唯一。
- 提交前运行 workspace 验证脚本和 git diff --check。