ilaandClaude Opus 4.8
6e30daceab
- 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>
走遍美国 · 英语学习 PWA
一个用 Go (go-app + WebAssembly) 构建的渐进式 Web 应用 (PWA)，基于「走遍美国 (Family Album, U.S.A.)」素材，帮助用户通过音频 + 同步字幕进行沉浸式英语听力学习。
本主页汇总项目的核心文档，按"为什么 → 要什么 → 用什么 → 怎么搭 → 怎么写"分层。
📌 一句话定位
大屏手机 / 平板优先，可安装、可离线，账号化的「走遍美国」音频精听学习工具。
🗂 文档导航
- AI 开发入口 — AI coding agent 的阅读顺序、任务领取规则、验证命令
- 项目愿景 — 为什么 / 为谁 / 产品原则 / 不做什么
- 需求 — 要什么 + 验收标准（产品语言，无技术词）
- 技术栈 — 用什么：框架 / 数据库 / UI / 状态管理 / 部署（速查）
- 架构设计 — 怎么搭：系统结构、职责划分、数据模型、技术难点
- API 合约草案 — 账号、生词本、进度 API 的目标形状
- 路由与页面结构 — go-app 页面路由、页面职责、组件归属
- 当前实现状态 — 仓库现实状态、当前可做任务、维护规则
- 编码规则 — 怎么写：AI 写代码前必读的硬约束
- 任务看板 — 做哪一步：MVP 任务拆解、依赖、状态（AI 的 Jira）
⚡ 当前阶段
第一版 (MVP) 最小闭环：课程列表 + 音频播放 + 字幕同步 + 生词本 + 账号同步。后续迭代加入测验与打卡。
🛠 技术栈速览
- 前端：go-app (Go → WebAssembly)，PWA 可安装 / 离线
- 后端：Go
net/http+ SQLite - 素材：26 集英文文稿 + 逐句时间戳（音频覆盖 ep1–17，ep18–26 待补）
🤖 AI coding 入口
仓库级 AI 规则见根目录 ../AGENTS.md；更详细的项目开发导航见 AI 开发入口。