113 lines
4.1 KiB
Markdown
113 lines
4.1 KiB
Markdown
|
# 项目上下文 - ErrLens 错题本
|
|||
|
|
|
|||
|
|
## 项目愿景
|
|||
|
|
|
|||
|
|
打造跨平台的学生错题本应用，配套 Web 管理后台和数据训练算法，形成"数据采集 → AI 分析 → 个性化推荐"的数据飞轮。
|
|||
|
|
|
|||
|
|
## 当前阶段
|
|||
|
|
|
|||
|
|
**框架搭建阶段**（2026-05-23 完成）
|
|||
|
|
|
|||
|
|
已完成：
|
|||
|
|
- ✅ "1 人 + 2AI（Dev AI + QA AI）"协作框架
|
|||
|
|
- ✅ 完整目录结构和权限体系（R/W/RW/- 四态）
|
|||
|
|
- ✅ AI 配置文件（coder.json、tester.json、workflow.json）
|
|||
|
|
- ✅ 提示词模板（code-style.md、doc-template.md、bug-report.md）
|
|||
|
|
- ✅ Skill 工具（ai-collab-setup、add-subproject、resume-context）
|
|||
|
|
- ✅ 项目级文档目录（docs/、tools/、data/）
|
|||
|
|
|
|||
|
|
待启动：
|
|||
|
|
- ⏳ P01_errlens_app 小程序开发
|
|||
|
|
- ⏳ P02_errlens_training 数据训练算法
|
|||
|
|
- ⏳ P03_errlens_web Web 管理后台
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
| 层级 | 技术选型 | 说明 |
|
|||
|
|
|------|---------|------|
|
|||
|
|
| 小程序 | Taro + React + TypeScript | 跨平台（微信优先，预留支付宝/抖音） |
|
|||
|
|
| Web 管理 | Next.js + React + TypeScript | SSR，便于 SEO 和性能 |
|
|||
|
|
| 后端 | NestJS + TypeScript | 统一语言，便于维护 |
|
|||
|
|
| 数据库 | PostgreSQL | 关系型数据，支持复杂查询 |
|
|||
|
|
| AI 训练 | Python + PyTorch | 错题分析和推荐算法 |
|
|||
|
|
| 包管理 | pnpm | 快速、节省磁盘空间 |
|
|||
|
|
| 协作框架 | 1 人 + 2AI | Dev AI（编码）+ QA AI（测试） |
|
|||
|
|
|
|||
|
|
## 团队架构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
人类负责人（唯一决策者）
|
|||
|
|
├── Dev AI（编码 AI）- 编写代码、文档、影响评估
|
|||
|
|
└── QA AI（测试 AI）- 编写测试、执行测试、质量保障
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
详细权限见 [AGENTS.md](../AGENTS.md)
|
|||
|
|
|
|||
|
|
## 关键决策
|
|||
|
|
|
|||
|
|
| 决策 | 原因 | 日期 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| 采用 R/W/RW/- 四态权限体系 | 比二元权限更灵活，明确只读路径 | 2026-05-23 |
|
|||
|
|
| 项目级文档放在根目录 docs/ | 不属于任何子项目，业界标准做法 | 2026-05-23 |
|
|||
|
|
| 新增 tools/ 和 data/ 目录 | 开发工具和训练数据需要独立管理 | 2026-05-23 |
|
|||
|
|
| 创建 resume-context Skill | 解决多电脑切换时的上下文同步问题 | 2026-05-23 |
|
|||
|
|
| 工作流增加 retry 机制 | 允许最多 3 轮测试修复循环 | 2026-05-23 |
|
|||
|
|
| 工作流增加 escalation 机制 | 第 3 轮仍有严重 Bug 时升级给人类 | 2026-05-23 |
|
|||
|
|
|
|||
|
|
## 待解决问题
|
|||
|
|
|
|||
|
|
1. **Web 管理后台具体功能** - 尚未确定，需要简化设计，保持可扩展性
|
|||
|
|
2. **数据来源** - 用户有一些数据但不够，需要数据飞轮思维
|
|||
|
|
3. **跨平台优先级** - 目前主要是微信，但框架上要考虑跨平台
|
|||
|
|
4. **AI 训练算法细节** - 错题分析和推荐算法的具体实现方案
|
|||
|
|
|
|||
|
|
## 下一步计划
|
|||
|
|
|
|||
|
|
1. [ ] 完成产品需求文档（PRD）
|
|||
|
|
2. [ ] 完成系统架构设计
|
|||
|
|
3. [ ] 启动 P01_errlens_app 小程序开发
|
|||
|
|
4. [ ] 设计数据采集方案
|
|||
|
|
5. [ ] 规划 Web 管理后台功能
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
errlens/
|
|||
|
|
├── docs/ # 项目级总体文档
|
|||
|
|
│ ├── 01_产品需求/
|
|||
|
|
│ ├── 02_系统架构/
|
|||
|
|
│ ├── 03_开发规范/
|
|||
|
|
│ ├── 04_部署运维/
|
|||
|
|
│ ├── 05_变更日志/
|
|||
|
|
│ └── 06_开发日志/
|
|||
|
|
├── tools/ # 开发工具脚本
|
|||
|
|
├── data/ # 训练数据
|
|||
|
|
├── projects/ # 子项目
|
|||
|
|
│ ├── P01_errlens_app/ # 错题本小程序
|
|||
|
|
│ ├── P02_errlens_training/# 数据训练算法
|
|||
|
|
│ └── P03_errlens_web/ # Web 管理后台
|
|||
|
|
├── review/ # 任务交接中心
|
|||
|
|
├── reports/ # 测试/质量报告
|
|||
|
|
├── shared/ # 共享资源
|
|||
|
|
└── .ai/ # AI 协作配置
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 开发环境
|
|||
|
|
|
|||
|
|
- **操作系统**: Windows / macOS / Linux（跨平台开发）
|
|||
|
|
- **IDE**: Trae CN
|
|||
|
|
- **Node.js**: >= 20.x
|
|||
|
|
- **包管理器**: pnpm >= 9.0.0
|
|||
|
|
- **Python**: >= 3.10（AI 训练）
|
|||
|
|
|
|||
|
|
## 同步机制
|
|||
|
|
|
|||
|
|
- **代码同步**: Git（远程仓库：GitCode）
|
|||
|
|
- **上下文同步**: `docs/PROJECT_CONTEXT.md` + `docs/06_开发日志/`
|
|||
|
|
- **恢复上下文**: 使用 `resume-context` Skill
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**最后更新**: 2026-05-23
|
|||
|
|
**维护者**: 人类负责人 + Dev AI
|