docs: 建立项目文档体系(vision/requirements/tech-stack/architecture/coding-rules)

- docs/01-vision        核心目标、目标用户、产品原则、非目标
- docs/02-requirements  产品语言需求 + MVP 验收标准(无技术词)
- docs/03-tech-stack    go-app / 纯CSS / SQLite / Session Cookie / 单二进制部署
- docs/04-architecture  系统结构、前后端职责、真实 episodes.json 数据模型、技术难点
- docs/05-coding-rules  AI 写代码前必读的硬约束(防跑偏)
- CLAUDE.md             AI 入口:文档地图、真实数据 schema、强制必读编码规则

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
ila
2026-06-21 14:03:36 +08:00
co-authored by Claude Opus 4.8
parent 05f215974e
commit fd37ff6383
7 changed files with 501 additions and 0 deletions
+27
View File
@@ -0,0 +1,27 @@
# 走遍美国 · 英语学习 PWA
> 一个用 Go (go-app + WebAssembly) 构建的渐进式 Web 应用 (PWA),基于「走遍美国 (Family Album, U.S.A.)」素材,帮助用户通过音频 + 同步字幕进行沉浸式英语听力学习。
本主页汇总项目的核心文档,按"为什么 → 要什么 → 用什么 → 怎么搭 → 怎么写"分层。
## 📌 一句话定位
大屏手机 / 平板优先,可安装、可离线,账号化的「走遍美国」音频精听学习工具。
## 🗂 文档导航
- [项目愿景](01-vision.md) — 为什么 / 为谁 / 产品原则 / 不做什么
- [需求](02-requirements.md) — 要什么 + 验收标准(产品语言,无技术词)
- [技术栈](03-tech-stack.md) — 用什么:框架 / 数据库 / UI / 状态管理 / 部署(速查)
- [架构设计](04-architecture.md) — 怎么搭:系统结构、职责划分、数据模型、技术难点
- [编码规则](05-coding-rules.md) — 怎么写:AI 写代码前必读的硬约束
## ⚡ 当前阶段
第一版 (MVP) 最小闭环:**课程列表 + 音频播放 + 字幕同步 + 生词本 + 账号同步**。后续迭代加入测验与打卡。
## 🛠 技术栈速览
- 前端:go-app (Go → WebAssembly),PWA 可安装 / 离线
- 后端:Go `net/http` + SQLite
- 素材:26 集英文文稿 + 逐句时间戳(音频覆盖 ep1–17,ep18–26 待补)