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

64 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 当前实现状态
> 本文记录代码与任务看板的现实状态,帮助 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`](06-tasks.md) 为准。
- `T-001` 已 `DONE`(go 模块 + 最小可运行页面)。
- 下一个可领取任务:`T-002`(后端静态服务 + 音频路径映射)或 `T-003`(解析 episodes.json),二者都只依赖 T-001,取最靠前的 **T-002**。
## 当前可运行内容
最小 go-app 应用已可构建运行:
```bash
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`。
- 新增可运行命令。
- 发现文档和代码现实不一致。