From 5770e496ff97128fc91edbd09c1ec2df065e8a54 Mon Sep 17 00:00:00 2001
From: zenfun <zenfun510@gmail.com>
Date: Mon, 22 Dec 2025 14:03:06 +0800
Subject: [PATCH] chore(deps): bump foundation to v0.3.0

---
 Dockerfile |  2 +-
 README.md  | 14 ++++++++++++--
 go.mod     |  4 +---
 go.sum     |  2 ++
 4 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index 63d102e..1f0dd54 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -16,4 +16,4 @@ COPY --from=builder /app/ez-api .
 
 EXPOSE 8080
 
-CMD ["./ez-api"]
\ No newline at end of file
+CMD ["./ez-api"]
diff --git a/README.md b/README.md
index 7957472..13bcb54 100644
--- a/README.md
+++ b/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`（见下文）。
 
 ## 设计决策
 
diff --git a/go.mod b/go.mod
index 104268a..3124c4b 100644
--- a/go.mod
+++ b/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
diff --git a/go.sum b/go.sum
index dbbb52d..aa66eb7 100644
--- a/go.sum
+++ b/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=