go-spring · lvan100 · Jun 14, 2025 · Jun 3, 2025 · Jun 3, 2025 · Jun 3, 2025
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -24,8 +24,7 @@ jobs:
         run: go mod download
 
       - name: Run tests
-        run: go test -count=1 -coverprofile=coverage.txt ./... &&
-          grep -v "^github.com/go-spring/spring-core/log" coverage.txt > coverage.txt.tmp && mv coverage.txt.tmp coverage.txt
+        run: go test -count=1 -coverprofile=coverage.txt ./...
 
       - name: Upload results to Codecov
         uses: codecov/codecov-action@v5

diff --git a/.gitignore b/.gitignore
@@ -32,7 +32,9 @@ go.work.sum
 
 /conf/remote/
 
-doc/examples/bookman/conf/
-doc/examples/bookman/log/*.log
+docs/**/bookman/conf/
+docs/**/bookman/log/*.log
 
-coverage.txt
+coverage.txt
+
+log/access.log
diff --git a/README.md b/README.md
@@ -4,10 +4,13 @@
    <img src="https://img.shields.io/github/license/go-spring/spring-core" alt="license"/>
    <img src="https://img.shields.io/github/go-mod/go-version/go-spring/spring-core" alt="go-version"/>
    <img src="https://img.shields.io/github/v/release/go-spring/spring-core?include_prereleases" alt="release"/>
-   <img src="https://codecov.io/gh/go-spring/spring-core/branch/main/graph/badge.svg" alt="test-coverage"/>
+   <a href="https://codecov.io/gh/go-spring/spring-core" > 
+      <img src="https://codecov.io/gh/go-spring/spring-core/graph/badge.svg?token=SX7CV1T0O8" alt="test-coverage"/>
+   </a>
+   <a href="https://deepwiki.com/go-spring/spring-core"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </div>
 
-[中文](README_CN.md)
+[English](README.md) | [中文](README_CN.md)
 
 **Go-Spring is a high-performance framework for modern Go application development, inspired by the Spring / Spring Boot
 ecosystem in the Java community.**

diff --git a/README_CN.md b/README_CN.md
@@ -4,10 +4,13 @@
    <img src="https://img.shields.io/github/license/go-spring/spring-core" alt="license"/>
    <img src="https://img.shields.io/github/go-mod/go-version/go-spring/spring-core" alt="go-version"/>
    <img src="https://img.shields.io/github/v/release/go-spring/spring-core?include_prereleases" alt="release"/>
-   <img src="https://codecov.io/gh/go-spring/spring-core/branch/main/graph/badge.svg" alt="test-coverage"/>
+   <a href="https://codecov.io/gh/go-spring/spring-core" > 
+      <img src="https://codecov.io/gh/go-spring/spring-core/graph/badge.svg?token=SX7CV1T0O8" alt="test-coverage"/>
+   </a>
+   <a href="https://deepwiki.com/go-spring/spring-core"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
 </div>
 
-[English](README.md)
+[English](README.md) | [中文](README_CN.md)
 
 **Go-Spring 是一个面向现代 Go 应用开发的高性能框架，灵感源自 Java 社区的 Spring / Spring Boot。**
 它的设计理念深度融合 Go 语言的特性，既保留了 Spring 世界中成熟的开发范式，如依赖注入（DI）、自动配置和生命周期管理，

diff --git a/conf/expr_test.go b/conf/expr_test.go
@@ -55,7 +55,7 @@ func TestExpr(t *testing.T) {
 		var v struct {
 			A int `value:"${a}" expr:"checkInt(2$)"`
 		}
-		p := conf.Map(map[string]interface{}{
+		p := conf.Map(map[string]any{
 			"a": 4,
 		})
 		err := p.Bind(&v)

diff --git a/doc/examples/servers/gin/.keep b/doc/examples/servers/gin/.keep
diff --git a/docs/0. overview/overview.md b/docs/0. overview/overview.md
@@ -0,0 +1 @@
+todo 项目概览、目标、特性，解决了什么问题
diff --git a/docs/1. getting-started/getting-started.md b/docs/1. getting-started/getting-started.md
@@ -0,0 +1 @@
+todo 快速开始、安装、HelloWorld、项目结构引导
diff --git a/docs/2. concepts/concepts.md b/docs/2. concepts/concepts.md
@@ -0,0 +1 @@
+todo 核心架构理念、DI、配置系统、生命周期管理等
diff --git a/docs/3. guides/guides.md b/docs/3. guides/guides.md
@@ -0,0 +1 @@
+todo 常见操作，如创建服务、注入 Bean、读取配置、测试
diff --git a/doc/examples/bookman/README.md → docs/4. examples/bookman/README.md b/doc/examples/bookman/README.md → docs/4. examples/bookman/README.md
diff --git a/doc/examples/bookman/README_CN.md → docs/4. examples/bookman/README_CN.md b/doc/examples/bookman/README_CN.md → docs/4. examples/bookman/README_CN.md
diff --git a/...examples/bookman/conf/app-test.properties → ...examples/bookman/conf/app-test.properties b/...examples/bookman/conf/app-test.properties → ...examples/bookman/conf/app-test.properties
diff --git a/doc/examples/bookman/conf/app.properties → docs/4. examples/bookman/conf/app.properties b/doc/examples/bookman/conf/app.properties → docs/4. examples/bookman/conf/app.properties
diff --git a/doc/examples/bookman/go.mod → docs/4. examples/bookman/go.mod b/doc/examples/bookman/go.mod → docs/4. examples/bookman/go.mod
diff --git a/doc/examples/bookman/go.sum → docs/4. examples/bookman/go.sum b/doc/examples/bookman/go.sum → docs/4. examples/bookman/go.sum
diff --git a/doc/examples/bookman/init.go → docs/4. examples/bookman/init.go b/doc/examples/bookman/init.go → docs/4. examples/bookman/init.go
diff --git a/doc/examples/bookman/log/.keep → docs/4. examples/bookman/log/.keep b/doc/examples/bookman/log/.keep → docs/4. examples/bookman/log/.keep
diff --git a/doc/examples/bookman/main.go → docs/4. examples/bookman/main.go b/doc/examples/bookman/main.go → docs/4. examples/bookman/main.go
diff --git a/doc/examples/bookman/public/index.html → docs/4. examples/bookman/public/index.html b/doc/examples/bookman/public/index.html → docs/4. examples/bookman/public/index.html
diff --git a/doc/examples/bookman/src/app/app.go → docs/4. examples/bookman/src/app/app.go b/doc/examples/bookman/src/app/app.go → docs/4. examples/bookman/src/app/app.go
diff --git a/...es/bookman/src/app/bootstrap/bootstrap.go → ...es/bookman/src/app/bootstrap/bootstrap.go b/...es/bookman/src/app/bootstrap/bootstrap.go → ...es/bookman/src/app/bootstrap/bootstrap.go
diff --git a/...ookman/src/app/common/handlers/log/log.go → ...ookman/src/app/common/handlers/log/log.go b/...ookman/src/app/common/handlers/log/log.go → ...ookman/src/app/common/handlers/log/log.go
diff --git a/...bookman/src/app/common/httpsvr/httpsvr.go → ...bookman/src/app/common/httpsvr/httpsvr.go b/...bookman/src/app/common/httpsvr/httpsvr.go → ...bookman/src/app/common/httpsvr/httpsvr.go
diff --git a/...man/src/app/controller/controller-book.go → ...man/src/app/controller/controller-book.go b/...man/src/app/controller/controller-book.go → ...man/src/app/controller/controller-book.go
diff --git a/.../bookman/src/app/controller/controller.go → .../bookman/src/app/controller/controller.go b/.../bookman/src/app/controller/controller.go → .../bookman/src/app/controller/controller.go
diff --git a/doc/examples/bookman/src/biz/biz.go → docs/4. examples/bookman/src/biz/biz.go b/doc/examples/bookman/src/biz/biz.go → docs/4. examples/bookman/src/biz/biz.go
diff --git a/doc/examples/bookman/src/biz/job/job.go → docs/4. examples/bookman/src/biz/job/job.go b/doc/examples/bookman/src/biz/job/job.go → docs/4. examples/bookman/src/biz/job/job.go
diff --git a/.../biz/service/book_service/book_service.go → .../biz/service/book_service/book_service.go b/.../biz/service/book_service/book_service.go → .../biz/service/book_service/book_service.go
diff --git a/...service/book_service/book_service_test.go → ...service/book_service/book_service_test.go b/...service/book_service/book_service_test.go → ...service/book_service/book_service_test.go
diff --git a/...ples/bookman/src/dao/book_dao/book_dao.go → ...ples/bookman/src/dao/book_dao/book_dao.go b/...ples/bookman/src/dao/book_dao/book_dao.go → ...ples/bookman/src/dao/book_dao/book_dao.go
diff --git a/...bookman/src/dao/book_dao/book_dao_test.go → ...bookman/src/dao/book_dao/book_dao_test.go b/...bookman/src/dao/book_dao/book_dao_test.go → ...bookman/src/dao/book_dao/book_dao_test.go
diff --git a/...mples/bookman/src/idl/http/proto/proto.go → ...mples/bookman/src/idl/http/proto/proto.go b/...mples/bookman/src/idl/http/proto/proto.go → ...mples/bookman/src/idl/http/proto/proto.go
diff --git a/...ples/bookman/src/sdk/book_sdk/book_sdk.go → ...ples/bookman/src/sdk/book_sdk/book_sdk.go b/...ples/bookman/src/sdk/book_sdk/book_sdk.go → ...ples/bookman/src/sdk/book_sdk/book_sdk.go
diff --git a/docs/4. examples/chatAI/chatAI.html b/docs/4. examples/chatAI/chatAI.html
@@ -0,0 +1,181 @@
+<!DOCTYPE html>
+<html lang="zh">
+<head>
+    <meta charset="UTF-8"/>
+    <title>Chat AI</title>
+    <style>
+        body {
+            font-family: "Segoe UI", sans-serif;
+            background-color: #f3f4f6;
+            padding: 2em;
+            display: flex;
+            justify-content: center;
+        }
+
+        .container {
+            background: #fff;
+            padding: 2em;
+            border-radius: 12px;
+            box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+            width: 100%;
+            max-width: 1200px;
+        }
+
+        h1 {
+            margin-bottom: 1em;
+            font-size: 1.5em;
+            color: #333;
+        }
+
+        .input-row {
+            display: flex;
+            gap: 1em;
+        }
+
+        input[type="text"] {
+            flex: 1;
+            padding: 0.75em;
+            border: 1px solid #ccc;
+            border-radius: 8px;
+            font-size: 1em;
+            outline: none;
+            transition: border 0.2s;
+        }
+
+        input[type="text"]:focus {
+            border-color: #4f46e5;
+        }
+
+        button {
+            padding: 0.75em 1.5em;
+            background-color: #4f46e5;
+            color: white;
+            border: none;
+            border-radius: 8px;
+            font-size: 1em;
+            cursor: pointer;
+            transition: background-color 0.2s;
+        }
+
+        button:hover {
+            background-color: #4338ca;
+        }
+
+        button:disabled {
+            background-color: #a5b4fc;
+            cursor: not-allowed;
+        }
+
+        #response {
+            margin-top: 1.5em;
+            padding: 1em;
+            background-color: #f9fafb;
+            border: 1px solid #ddd;
+            border-radius: 8px;
+            min-height: 240px;
+            white-space: pre-wrap;
+            font-family: monospace;
+            line-height: 1.4;
+            position: relative;
+        }
+
+        .loading-dots::after {
+            content: '';
+            display: inline-block;
+            width: 1em;
+            text-align: left;
+            animation: dots 1s steps(3, end) infinite;
+        }
+
+        @keyframes dots {
+            0% {
+                content: '';
+            }
+            33% {
+                content: '.';
+            }
+            66% {
+                content: '..';
+            }
+            100% {
+                content: '...';
+            }
+        }
+    </style>
+</head>
+<body>
+<div class="container">
+    <h1>🧠 Chat AI</h1>
+    <div class="input-row">
+        <input type="text" id="userInput" placeholder="请输入你的问题..."/>
+        <button id="sendBtn">Send</button>
+    </div>
+    <div id="response"></div>
+</div>
+
+<script>
+    const sendBtn = document.getElementById("sendBtn");
+    const userInput = document.getElementById("userInput");
+    const responseDiv = document.getElementById("response");
+
+    let controller = null;
+
+    sendBtn.addEventListener("click", async () => {
+        if (sendBtn.textContent === "Stop") {
+            if (controller) controller.abort();
+            sendBtn.textContent = "Send";
+            return;
+        }
+
+        const input = userInput.value.trim();
+        if (!input) return;
+
+        responseDiv.textContent = "";
+        responseDiv.classList.add("loading-dots");
+        sendBtn.textContent = "Stop";
+        controller = new AbortController();
+
+        try {
+            const res = await fetch("/chat/sse", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json"
+                },
+                body: JSON.stringify({message: input}),
+                signal: controller.signal
+            });
+
+            if (!res.ok) throw new Error(`HTTP error: ${res.status}`);
+
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder("utf-8");
+
+            while (true) {
+                const {done, value} = await reader.read();
+                if (done) break;
+                const chunk = decoder.decode(value, {stream: true});
+
+                // Remove the two line breaks specified in the SSE protocol
+                // and add a line break at the end
+                const processedChunk = chunk.endsWith('\n\n')
+                    ? chunk.slice(0, -1)
+                    : chunk;
+
+                responseDiv.textContent += processedChunk;
+            }
+
+        } catch (err) {
+            if (err.name === 'AbortError') {
+                responseDiv.textContent += "\n⛔️ The user has terminated the connection.";
+            } else {
+                responseDiv.textContent = `❌ Error: ${err.message}`;
+            }
+        } finally {
+            sendBtn.textContent = "Send";
+            responseDiv.classList.remove("loading-dots");
+            controller = null;
+        }
+    });
+</script>
+</body>
+</html>
diff --git a/docs/4. examples/chatAI/go.mod b/docs/4. examples/chatAI/go.mod
@@ -0,0 +1,15 @@
+module chatai
+
+go 1.24
+
+require github.com/go-spring/spring-core v0.0.0
+
+require (
+	github.com/expr-lang/expr v1.17.2 // indirect
+	github.com/magiconair/properties v1.8.10 // indirect
+	github.com/pelletier/go-toml v1.9.5 // indirect
+	github.com/spf13/cast v1.7.1 // indirect
+	gopkg.in/yaml.v2 v2.4.0 // indirect
+)
+
+replace github.com/go-spring/spring-core => ../../../
diff --git a/doc/examples/miniapi/go.sum → docs/4. examples/chatAI/go.sum b/doc/examples/miniapi/go.sum → docs/4. examples/chatAI/go.sum
diff --git a/docs/4. examples/chatAI/main.go b/docs/4. examples/chatAI/main.go
@@ -0,0 +1,73 @@
+/*
+ * Copyright 2025 The Go-Spring Authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package main
+
+import (
+	"embed"
+	"fmt"
+	"net/http"
+	"time"
+
+	"github.com/go-spring/spring-core/gs"
+	"github.com/go-spring/spring-core/util/sysconf"
+)
+
+//go:embed chatAI.html
+var files embed.FS
+
+func main() {
+	// Disable the write timeout for the HTTP server
+	sysconf.Set("http.server.writeTimeout", "0")
+
+	// Serve static files from the embedded file system under the "/public/" path
+	http.Handle("/public/", http.StripPrefix("/public/", http.FileServer(http.FS(files))))
+
+	// Handle the Server-Sent Events (SSE) endpoint
+	http.HandleFunc("/chat/sse", func(w http.ResponseWriter, r *http.Request) {
+
+		// Set the necessary HTTP headers for SSE
+		w.Header().Set("Content-Type", "text/event-stream")
+		w.Header().Set("Cache-Control", "no-cache")
+		w.Header().Set("Connection", "keep-alive")
+		w.Header().Set("Access-Control-Allow-Origin", "*")
+
+		flusher, ok := w.(http.Flusher)
+		if !ok {
+			http.Error(w, "Streaming unsupported!", http.StatusInternalServerError)
+			return
+		}
+
+		// Send an SSE message every second for 10 seconds
+		for i := 0; i < 10; i++ {
+			select {
+			case <-r.Context().Done():
+				// Exit the loop if the client disconnects
+				return
+			default:
+				// Each SSE message must end with two newlines to be recognized correctly by the client
+				// See more about SSE protocol: https://www.ruanyifeng.com/blog/2017/05/server-sent_events.html
+				fmt.Fprintf(w, "data: Message %d at %s\n\n", i, time.Now().Format("15:04:05"))
+				flusher.Flush()
+				time.Sleep(1 * time.Second)
+			}
+		}
+	})
+
+	gs.Run()
+}
+
+// open http://127.0.0.1:9090/public/chatAI.html in the browser
diff --git a/docs/4. examples/examples.md b/docs/4. examples/examples.md
@@ -0,0 +1 @@
+todo 完整的 demo 项目或代码片段
diff --git a/doc/examples/miniapi/go.mod → docs/4. examples/miniapi/go.mod b/doc/examples/miniapi/go.mod → docs/4. examples/miniapi/go.mod
diff --git a/doc/examples/noweb/go.sum → docs/4. examples/miniapi/go.sum b/doc/examples/noweb/go.sum → docs/4. examples/miniapi/go.sum
diff --git a/doc/examples/miniapi/main.go → docs/4. examples/miniapi/main.go b/doc/examples/miniapi/main.go → docs/4. examples/miniapi/main.go
@@ -17,9 +17,11 @@
 package main
 
 import (
+	"context"
 	"net/http"
 
 	"github.com/go-spring/spring-core/gs"
+	"github.com/go-spring/spring-core/util/syslog"
 )
 
 func main() {
@@ -34,7 +36,10 @@ func main() {
 	// - Property Binding: Binds external configs (YAML, ENV) into structs.
 	// - Dependency Injection: Wires beans automatically.
 	// - Dynamic Refresh: Updates configs at runtime without restart.
-	gs.Run()
+	gs.RunWith(func(ctx context.Context) error {
+		syslog.Infof("app started")
+		return nil
+	})
 }
 
 //~ curl http://127.0.0.1:9090/echo

diff --git a/doc/examples/noweb/go.mod → docs/4. examples/noweb/go.mod b/doc/examples/noweb/go.mod → docs/4. examples/noweb/go.mod
diff --git a/doc/examples/startup/go.sum → docs/4. examples/noweb/go.sum b/doc/examples/startup/go.sum → docs/4. examples/noweb/go.sum
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		todo 项目概览、目标、特性，解决了什么问题
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		todo 快速开始、安装、HelloWorld、项目结构引导
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		todo 核心架构理念、DI、配置系统、生命周期管理等
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		todo 常见操作，如创建服务、注入 Bean、读取配置、测试