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>
This commit is contained in:
+11
-2
@@ -1,7 +1,7 @@
|
||||
# 技术栈(Tech Stack)
|
||||
|
||||
> "用什么"的统一速查表。选型与理由在此集中维护;"怎么把它们搭起来"见 [架构设计](04-architecture.md)。
|
||||
> ⚠️ 标 **待定** 的项目尚未决策,**不要在代码里擅自选定**——先在此文档定下来再用。
|
||||
> 当前 MVP 技术栈已全部定稿。若未来新增待定项,先在本文决策,再进入代码。
|
||||
|
||||
## 一、技术栈一览
|
||||
|
||||
@@ -27,7 +27,7 @@ MVP 的技术栈已全部敲定(上表均为 ✅)。以下是几条"现在
|
||||
- **音频分发**:MVP 由单二进制直接提供;带宽吃紧后把 `audio/` 外挂到对象存储 / CDN,仅改静态资源路由。
|
||||
- **鉴权**:Session Cookie 起步;若将来要做第三方客户端 / 开放 API,再考虑补 JWT 通道。
|
||||
|
||||
> 选型不臆造、未定先标待定的纪律见 [编码规则](05-coding-rules.md);取舍方向见 [项目愿景](01-vision.md) 的"产品原则"。
|
||||
> 选型不臆造、未定先写入文档决策的纪律见 [编码规则](05-coding-rules.md);取舍方向见 [项目愿景](01-vision.md) 的"产品原则"。
|
||||
|
||||
## 三、构建与运行命令
|
||||
|
||||
@@ -38,4 +38,13 @@ MVP 的技术栈已全部敲定(上表均为 ✅)。以下是几条"现在
|
||||
| 格式化 / 静态检查 | `gofmt -w .` · `go vet ./...` |
|
||||
| 校验内容数据 | `python3 scripts/validate_episodes.py` |
|
||||
|
||||
Windows PowerShell 等价命令:
|
||||
|
||||
```powershell
|
||||
$env:GOOS='js'; $env:GOARCH='wasm'; go build -o app.wasm
|
||||
go build
|
||||
go vet ./...
|
||||
python scripts/validate_episodes.py
|
||||
```
|
||||
|
||||
> 实际目录布局、模块划分、数据模型见 [架构设计](04-architecture.md);真实数据 schema 另见 `CLAUDE.md`。
|
||||
|
||||
Reference in New Issue
Block a user