refactor: centralize protobuf and remove go-zero

README.md

@@ -10,8 +10,10 @@ BSM 后端服务的 Go workspace，包含基础能力、电商、财务、社交
 | `module/ec` | address、delivery、mall、market、order |
 | `module/finance` | wallet |
 | `module/social` | feed、group、relation |
+| `protobuf` | 跨服务共享的 protobuf 定义，目前包含 `blocks.proto` |
+| `shared` | 跨模块复用的轻量公共代码（日志与 gRPC 连接抽象） |
 | `cmd` | 聚合上述服务的单体启动器 |
-| `go.work` | 20 个 Go 模块的 workspace 定义 |
+| `go.work` | 22 个 Go 模块的 workspace 定义 |
 
 各服务的接口、配置和部署细节见对应 `module/**/README.md`。
 
@@ -20,7 +22,7 @@ BSM 后端服务的 Go workspace，包含基础能力、电商、财务、社交
 - Go 1.26.5
 - Git
 - 按所运行服务准备 PostgreSQL、Redis、etcd、MQ 或对象存储等外部依赖
-- 重新生成 protobuf 时，按服务目录中的生成脚本或团队约定的 `protoc` 命令安装相应生成器
+- 重新生成 protobuf 时可使用仓库内 `.tools/` 的工具，或在 `PATH` 中安装 `protoc`、`protoc-gen-go`、`protoc-gen-go-grpc` 和 `protoc-gen-grpc-gateway`
 
 确认工具链：
 
@@ -29,6 +31,14 @@ go version
 go work sync
 ```
 
+统一重新生成 protobuf：
+
+```bash
+bash scripts/generate-protobuf.sh
+```
+
+脚本以根目录 `protobuf/blocks.proto` 为共享定义，并为各服务生成 protobuf、gRPC 和 grpc-gateway 代码。生成后的兼容别名继续保留旧模块中的公共类型名。
+
 更新所有 workspace 模块的依赖：
 
 ```bash