Commit Graph
12 Commits
Author SHA1 Message Date
ilaandClaude Opus 4.8 89503ee2f0 docs: 新增 go-app 避坑表,记录"未注册路由 404"等坑
- 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>
2026-06-21 20:00:56 +08:00
ilaandClaude Opus 4.8 6e30daceab feat(T-001): 初始化 go 模块 + go-app 最小可运行页面
- 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>
2026-06-21 19:45:13 +08:00
ilaandClaude Opus 4.8 5825d5f677 chore: 归一化 README.md 行尾为 LF
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 19:31:09 +08:00
ilaandClaude Opus 4.8 b9bcbf7e6b docs: 补全 AI 入口/API/路由/现状文档并对齐一致性
新增(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>
2026-06-21 19:30:14 +08:00
ilaandClaude Opus 4.8 39713eb8ac design: 效果稿改为清淡简洁风格,T-200 完成
- play.html / list.html:从深色重金属改为浅暖纸白 + 墨色 + 单一柔和赭石强调,
  去掉颗粒/暗角/发光,UI 改用 Public Sans / Noto Sans SC;补齐焦点态、
  cursor、44px 触控、对比度、prefers-reduced-motion、aria-label
- README:设计语言更新为「清淡简洁 · Swiss/Minimal」
- 06-tasks:T-200 标记 DONE

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 17:21:14 +08:00
ilaandClaude Opus 4.8 d37b83011a design: 新增播放页与课程列表 UI 效果稿(HTML/CSS)
- design_mockups/play.html:播放页,含逐句字幕高亮 + 点句跳转 + 播放器,
  用 ep1 真实台词;CSS 变量化,可迁移进 go-app
- design_mockups/list.html:26 集课程列表,含进度环、Act 音频状态、
  ep18+ 无音频降级态;用真实集标题
- design_mockups/README.md:设计语言与文档对应说明
- 06-tasks:新增 Phase D / T-200 设计任务

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 15:29:36 +08:00
ilaandClaude Opus 4.8 673b3a323a chore: 忽略 design_images 设计参考图目录
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 15:18:47 +08:00
ilaandClaude Opus 4.8 6091c441cd chore: 加入 episodes.json 校验与修正脚本
- scripts/validate_episodes.py:结构/字段/时间戳/音频对账等校验
- scripts/fix_episodes.py:重算统计字段、引号归一、去空白(自动备份)
- scripts/README.md:用法与已知数据缺口说明

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 15:16:59 +08:00
ilaandClaude Opus 4.8 060daf02a1 docs: 用户表预留 course_id,记录多教材扩展点
- 04-architecture 3.2:progress/vocab 加预留列 course_id(默认 family-album),
  避免将来接入新概念英语等时迁移用户数据;MVP 仅留列不写多教材逻辑
- 06-tasks:T-301 验收注明该预留列;待办池补"多教材接入"扩展点备忘

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 15:16:59 +08:00
ilaandClaude Opus 4.8 b7b549d679 docs: 新增任务看板(AI 的 Jira)并配置 .gitignore
- docs/06-tasks.md:MVP 拆为 22 个任务 / 7 个 Phase,带依赖与验收;
  强制"一次只做一个任务、做完即停",避免一次生成整个项目
- CLAUDE.md:文档地图加入任务看板,并增加按看板单任务开发的规则
- .gitignore:忽略内容素材 family-album-usa/、Notion 导出 notion_docs/、
  备份 *.bak、构建产物 *.wasm

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 14:29:28 +08:00
ilaandClaude Opus 4.8 fd37ff6383 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>
2026-06-21 14:03:36 +08:00
ila 05f215974e Initial commit 2026-06-21 13:20:43 +08:00