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