ilaandClaude Opus 4.8
89503ee2f0
- 04-architecture 第四节：新增「go-app 注意事项（避坑表）」，收录 Handler 仅为已注册路由返回 app shell（否则 404）、前后端同包需 //go:build 隔离、wasm 由 app.js 引导、web/ 读 app.wasm、Name 不进 title 等坑 - 05-coding-rules 第 5 节：加指引——写 go-app 代码前先扫避坑表，踩到新坑往那补 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 开发入口。