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