chore(deps): bump foundation to v0.3.0

README.md

@@ -95,6 +95,16 @@ auth:
 
 ### 本地运行
 
+运行前需要准备依赖（Postgres + Redis），否则会出现连接错误
+
+建议先启动基础依赖：
+
+```bash
+docker compose up -d postgres redis
+```
+
+然后在本地设置必要环境变量（可基于 `.env.example`）：
+
 ```bash
 go run cmd/server/main.go
 ```
@@ -135,7 +145,7 @@ docker run -p 8080:8080 --env-file .env ez-api
   go work init
   go work use ./ez-api ./balancer ./foundation
   ```
-  如果你只使用已发布的 `github.com/ez-api/foundation v0.1.0`（或更高 tag），则不需要 `go.work`。
+  如果你只使用已发布的 `github.com/ez-api/foundation v0.3.0`（或更高 tag），则不需要 `go.work`。
 
 ### 集成测试
 
@@ -165,7 +175,7 @@ cd ez-api
 ## 依赖约定
 
 - Control Plane（ez-api）与 Data Plane（balancer）共享一部分“协议约定/基础设施”代码（JSON、日志、provider type 规则），统一沉淀在 `github.com/ez-api/foundation`。
-- 本仓库的 `go.mod` 需要依赖一个可用的 `foundation` 版本：发布后建议锁定到 `v0.1.0`（或更高 tag）；本地联调可使用 `go.work`（见下文）。
+- 本仓库的 `go.mod` 需要依赖一个可用的 `foundation` 版本：发布后建议锁定到 `v0.3.0`（或更高 tag）；本地联调可使用 `go.work`（见下文）。
 
 ## 设计决策
 

go.mod

@@ -4,7 +4,7 @@ go 1.24.5
 
 require (
 	github.com/alicebob/miniredis/v2 v2.35.0
-	github.com/ez-api/foundation v0.2.0
+	github.com/ez-api/foundation v0.3.0
 	github.com/gin-gonic/gin v1.11.0
 	github.com/pelletier/go-toml/v2 v2.2.4
 	github.com/redis/go-redis/v9 v9.17.2
@@ -18,8 +18,6 @@ require (
 	gorm.io/gorm v1.31.1
 )
 
-replace github.com/ez-api/foundation => ../foundation
-
 require (
 	github.com/KyleBanks/depth v1.2.1 // indirect
 	github.com/bytedance/sonic v1.14.0 // indirect

go.sum

@@ -20,6 +20,8 @@ github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f h1:lO4WD4F/rVNCu3HqELle0jiPLLBs70cWOduZpkS1E78=
 github.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f/go.mod h1:cuUVRXasLTGF7a8hSLbxyZXjz+1KgoB3wDUb6vlszIc=
+github.com/ez-api/foundation v0.3.0 h1:qQyc02/UE8Jgv07cHDuLineQdAfWmROnjrpJIRBLt90=
+github.com/ez-api/foundation v0.3.0/go.mod h1:bTh1LA42TW4CXi1SebDEUE+fhEssFUphzcGEzyAFFZI=
 github.com/frankban/quicktest v1.14.6 h1:7Xjx+VpznH+oBnejlPUj8oUpdxnVs4f8XU8WnHkI4W8=
 github.com/frankban/quicktest v1.14.6/go.mod h1:4ptaffx2x8+WTWXmUCuVU6aPUX1/Mz7zb5vbUoiM6w0=
 github.com/fsnotify/fsnotify v1.9.0 h1:2Ml+OJNzbYCTzsxtv8vKSFD9PbJjmhYF14k/jKC7S9k=