Files
lingo/docs/current-state.md
ilaandClaude Opus 4.8 6e30daceab 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>
2026-06-21 19:45:13 +08:00

2.3 KiB
Raw Permalink Blame History

当前实现状态

本文记录代码与任务看板的现实状态,帮助 AI coding agent 避免只看计划而忽略仓库现状。

当前快照

  • 日期:2026-06-21
  • 阶段:MVP 进行中 / Phase 0 地基起步
  • 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/ 已存在

当前目录要点

路径 状态 说明
docs/ 已有 项目规范化文档,当前事实来源
family-album-usa/episodes.json 已有 课程内容数据
family-album-usa/audio/ 已有 mp3 音频目录
design_mockups/ 已有 UI spike,作为视觉参考
scripts/ 已有 内容数据校验等脚本
notion_docs/ 只读 Notion 原始导出,不作为事实来源
go.mod 已有 module lingo,依赖 go-app v10
main.go 已有 go-app 装配入口(T-001)

任务看板状态

以 06-tasks.md 为准。

  • T-001 已 DONE(go 模块 + 最小可运行页面)。
  • 下一个可领取任务:T-002(后端静态服务 + 音频路径映射)或 T-003(解析 episodes.json),二者都只依赖 T-001,取最靠前的 T-002。

当前可运行内容

最小 go-app 应用已可构建运行:

GOOS=js GOARCH=wasm go build -o web/app.wasm .   # 构建前端 wasm
go build -o bin/lingo . && ./bin/lingo           # 起服务器,访问 http://localhost:8000

设计参考 spike:design_mockups/list.html、design_mockups/play.html。

开始编码前检查

开始任意任务前:

  1. 读根目录 AGENTS.md。
  2. 读 CLAUDE.md。
  3. 读 docs/05-coding-rules.md。
  4. 在 docs/06-tasks.md 取第一个 TODO 且依赖均 DONE 的任务(当前为 T-002)。
  5. 将该任务状态改为 DOING。

维护规则

当实际代码状态发生变化时,同步更新本文件:

  • 新增或移动入口文件。
  • 初始化 Go 模块。
  • 任务从 TODO 进入 DOING 或 DONE。
  • 新增可运行命令。
  • 发现文档和代码现实不一致。