feat(T-001): 初始化 go 模块 + go-app 最小可运行页面

- go.mod：module lingo，依赖 go-app v10.1.11
- main.go：go-app 装配入口；init() 注册路由（Handler 仅为已注册路由返回
  app shell），newHandler() 抽出便于测试，main() 起 http 服务
- main_test.go：in-process httptest 冒烟测试，验证根路径 200 +
  home 组件预渲染 + wasm 引导脚本注入
- .gitignore：忽略 /bin/ 构建产物
- 06-tasks：T-001 标 DONE；current-state 更新为 Phase 0 进行中、下一任务 T-002

验证：gofmt 干净 · go vet 通过 · go test 通过 · GOOS=js GOARCH=wasm go build 通过 · go build 通过

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

.gitignore

@@ -37,6 +37,9 @@ go.work.sum
 # 前端构建产物
 *.wasm
 
+# 后端构建产物
+/bin/
+
 # 设计参考图（第三方截图，仅本地参考，不入库）
 /design_images/
 

docs/06-tasks.md

@@ -24,7 +24,7 @@
 
 | ID | 任务 | 依赖 | 验收要点 | 状态 |
 | --- | --- | --- | --- | --- |
-| T-001 | 初始化 go 模块 + go-app 最小可运行页面 | — | `go.mod` 就位；`GOOS=js GOARCH=wasm go build` 通过；浏览器打开能看到一个最简页面 | TODO |
+| T-001 | 初始化 go 模块 + go-app 最小可运行页面 | — | `go.mod` 就位；`GOOS=js GOARCH=wasm go build` 通过；浏览器打开能看到一个最简页面 | DONE |
 | T-002 | 后端静态服务 + **音频路径映射** | T-001 | 访问 `/family-album/audio/u0101.mp3` 能播到磁盘 `family-album-usa/audio/u0101.mp3`；wasm/静态资源正常加载 | TODO |
 | T-003 | 加载并解析 `episodes.json` 为 Go 结构体 | T-001 | struct 与真实 schema 一致（line 仅 `{t,en}`，无 zh）；启动时成功载入 26 集；前端可拿到课程数据 | TODO |
 

docs/current-state.md

@@ -5,9 +5,9 @@
 ## 当前快照
 
 - 日期：2026-06-21
-- 阶段：MVP 起步前 / 文档与素材已就位
+- 阶段：MVP 进行中 / Phase 0 地基起步
-- Go 模块：尚未初始化，当前无 `go.mod`
+- Go 模块：已初始化（`go.mod`，module `lingo`，go-app v10.1.11）
-- 生产代码：尚未开始
+- 生产代码：`main.go`（go-app 装配入口 + home 骨架组件）、`main_test.go`（app shell 冒烟测试）
 - 设计稿：已完成 `design_mockups/list.html` 和 `design_mockups/play.html`
 - 内容素材：`family-album-usa/episodes.json` 和 `family-album-usa/audio/` 已存在
 
@@ -21,36 +21,36 @@
 | `design_mockups/` | 已有 | UI spike，作为视觉参考 |
 | `scripts/` | 已有 | 内容数据校验等脚本 |
 | `notion_docs/` | 只读 | Notion 原始导出，不作为事实来源 |
-| `go.mod` | 不存在 | T-001 需要创建 |
+| `go.mod` | 已有 | module `lingo`，依赖 go-app v10 |
+| `main.go` | 已有 | go-app 装配入口（T-001） |
 
 ## 任务看板状态
 
 以 [`06-tasks.md`](06-tasks.md) 为准。
 
-当前应领取的第一个开发任务：
+- `T-001` 已 `DONE`（go 模块 + 最小可运行页面）。
-
+- 下一个可领取任务：`T-002`（后端静态服务 + 音频路径映射）或 `T-003`（解析 episodes.json），二者都只依赖 T-001，取最靠前的 **T-002**。
-- `T-001`：初始化 go 模块 + go-app 最小可运行页面
-
-不要跳到课程列表、账号、生词本或 PWA 离线任务。
 
 ## 当前可运行内容
 
-目前没有生产 App 可运行。
+最小 go-app 应用已可构建运行：
 
-可以直接打开这些 HTML spike 查看设计参考：
+```bash
+GOOS=js GOARCH=wasm go build -o web/app.wasm .   # 构建前端 wasm
+go build -o bin/lingo . && ./bin/lingo           # 起服务器，访问 http://localhost:8000
+```
 
-- `design_mockups/list.html`
+设计参考 spike：`design_mockups/list.html`、`design_mockups/play.html`。
-- `design_mockups/play.html`
 
 ## 开始编码前检查
 
-开始 T-001 前：
+开始任意任务前：
 
 1. 读根目录 `AGENTS.md`。
 2. 读 `CLAUDE.md`。
 3. 读 `docs/05-coding-rules.md`。
-4. 确认 `docs/06-tasks.md` 中 T-001 仍是第一个可做任务。
+4. 在 `docs/06-tasks.md` 取第一个 `TODO` 且依赖均 `DONE` 的任务（当前为 `T-002`）。
-5. 将 T-001 状态改为 `DOING`。
+5. 将该任务状态改为 `DOING`。
 
 ## 维护规则
 

go.mod

@@ -0,0 +1,7 @@
+module lingo
+
+go 1.23.0
+
+require github.com/maxence-charriere/go-app/v10 v10.1.11
+
+require github.com/google/uuid v1.6.0 // indirect

go.sum

@@ -0,0 +1,12 @@
+github.com/davecgh/go-spew v1.1.0 h1:ZDRjVQ15GmhC3fiQ8ni8+OwkZQO4DARzQgrnXU1Liz8=
+github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/maxence-charriere/go-app/v10 v10.1.11 h1:4JUSlVQ8zVIeL3acFJEpuerP6FLoEQWg6CUTtHcz7Ro=
+github.com/maxence-charriere/go-app/v10 v10.1.11/go.mod h1:FqUW4on4nJewVfBnSkuxQd3fvtK2RdKS/z76OOUDAAY=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/stretchr/testify v1.6.1 h1:hDPOHmpOpP40lSULcqw7IrRb/u7w6RpDC9399XyoNd0=
+github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c h1:dUUwHk2QECo/6vqA44rthZ8ie2QXMNeKRTHCNY2nXvo=
+gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

main.go

@@ -0,0 +1,70 @@
+// 走遍美国 · 英语精听 PWA —— go-app 装配入口（T-001 最小可运行骨架）。
+//
+// 同一份代码两处运行：
+//   - 编译成 wasm 在浏览器跑（app.RunWhenOnBrowser）
+//   - 编译成普通二进制在服务器跑（http.Server + app.Handler）
+//
+// 构建：
+//
+//	GOOS=js GOARCH=wasm go build -o web/app.wasm   # 前端
+//	go build -o bin/lingo                          # 后端
+package main
+
+import (
+	"log"
+	"net/http"
+
+	"github.com/maxence-charriere/go-app/v10/pkg/app"
+)
+
+// home 是根页面组件，目前仅是最小占位骨架。
+type home struct {
+	app.Compo
+}
+
+// Render 渲染最小首页，验证 go-app 骨架可运行。
+func (h *home) Render() app.UI {
+	return app.Div().
+		Style("font-family", "system-ui, -apple-system, sans-serif").
+		Style("max-width", "440px").
+		Style("margin", "0 auto").
+		Style("padding", "3rem 1.5rem").
+		Body(
+			app.H1().Text("走遍美国 · 精听"),
+			app.P().
+				Style("color", "#6b6b6b").
+				Text("Family Album, U.S.A. — go-app 骨架已就绪（T-001）。"),
+		)
+}
+
+// init 注册前端路由。放在 init 而非 main，确保服务器（渲染 app shell）、
+// 浏览器 wasm 入口、以及测试三处都能看到路由——go-app 的 Handler 只为
+// 已注册的路由返回 app shell，未注册的路径会 404。
+func init() {
+	app.Route("/", func() app.Composer { return &home{} })
+}
+
+// newHandler 构造服务器端的 go-app Handler，提供 app shell、wasm 与静态资源
+// （默认从 web/ 目录读取 app.wasm）。抽出为函数以便测试。
+func newHandler() *app.Handler {
+	return &app.Handler{
+		Name:        "走遍美国精听",
+		ShortName:   "精听",
+		Description: "基于「走遍美国」的英语精听 PWA",
+		Lang:        "zh",
+	}
+}
+
+func main() {
+	// 浏览器侧：启动 go-app（此调用在 wasm 之外无副作用）。
+	app.RunWhenOnBrowser()
+
+	// 服务器侧。
+	http.Handle("/", newHandler())
+
+	const addr = ":8000"
+	log.Printf("serving on http://localhost%s", addr)
+	if err := http.ListenAndServe(addr, nil); err != nil {
+		log.Fatal(err)
+	}
+}

main_test.go

@@ -0,0 +1,37 @@
+package main
+
+import (
+	"net/http"
+	"net/http/httptest"
+	"strings"
+	"testing"
+)
+
+// TestHandlerServesAppShell 在进程内验证 go-app Handler 能返回 app shell：
+//   - 根路径返回 200；
+//   - home 组件被服务端预渲染进 HTML（最小页面可见）；
+//   - 引导 wasm 的脚本（wasm_exec.js / app.js）已注入。
+//
+// 用 httptest 而非真实网络，避免依赖本机端口。
+func TestHandlerServesAppShell(t *testing.T) {
+	h := newHandler()
+
+	req := httptest.NewRequest(http.MethodGet, "/", nil)
+	rec := httptest.NewRecorder()
+	h.ServeHTTP(rec, req)
+
+	if rec.Code != http.StatusOK {
+		t.Fatalf("根路径状态 = %d, 期望 200", rec.Code)
+	}
+	body := rec.Body.String()
+	for _, want := range []string{
+		`lang="zh"`,     // 语言
+		"走遍美国 · 精听",     // home 组件预渲染内容
+		"/wasm_exec.js", // wasm 运行时
+		"/app.js",       // 加载 app.wasm 的引导脚本
+	} {
+		if !strings.Contains(body, want) {
+			t.Errorf("app shell 未包含 %q", want)
+		}
+	}
+}