hwd32/ai_soc_sw
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor(arch): 信息架构升级 — 三层四角色控制面板 + 跨平台 task 交接协议

Browse Source 
核心变化：
- dashboard.md 替代 DASHBOARD + ROADMAP，人类+Arch AI 唯一入口
- DECISIONS.md 人类决策入口，≤3 条待决策
- .ai/tasks/ 14 个独立 task 文件（Coder 8 + Tester 6），弱模型自包含可独立执行
- 旧 today/queue 归档，每个角色启动 ≤2 个文件
- ADR-012 跨平台「高模型指挥小模型」协作架构落地
- 知识库补全：L-002~005、P-004~005、ADR-011~012
- Arch AI 上下文资源管理硬约束写入 principles.md

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
tupingr
2026-05-26 15:17:06 +08:00
parent 5b428d0810
commit 6992f59cd2
38 changed files with 1630 additions and 105 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.ai/archive/DASHBOARD.md
+59
View File
@@ -0,0 +1,59 @@
# ErrLens 项目仪表盘
> 人类视角 · 30 秒了解项目全貌 · 无需懂代码
---
## 当前状态
**Phase 2/4 — MVP 开发** · 进度 0%
Phase 1 基础搭建已收尾（100%）。PRD/架构/数据模型全部锁定，Dev AI 开始编码。
---
## 四个阶段
| 阶段 | 进度 | 状态 | 一句话说明 |
|------|------|------|------------|
| 1. 基础搭建 | 100% | ✅ | 搭骨架：PRD 锁定、架构文档完成、旧架构合并 |
| 2. MVP | 0% | ← 当前 | 做核心：错题录入、AI 分析、PDF 打印、图像预处理 |
| 3. 功能完善 | 0% | 未开始 | 加功能：推荐、多端、训练迭代 |
| 4. 打磨发布 | 0% | 未开始 | 提质量：性能、安全、文档 |
---
## 现在在做什么
- **Dev AI 启动编码** — 数据库 Schema → Auth → Image → Print → User → Upload → 页面骨架
- **Arch AI 补尾** — ADR-010（题库抽象层）、UI 规范迁移
- **Phase 2 目标** — 拍照录入 + AI 分析 + PDF 输出 + 用户系统完整闭环
---
## 需要你关注的事
- [ ] 无。30 项决策已全部确认，Phase 2 由 AI 执行开发。
---
## 快速入口
| 你想看什么 | 去哪里 |
|------------|--------|
| **产品需求文档** | **[docs/01_产品需求/PRD.md](docs/01_产品需求/PRD.md)** |
| **系统架构设计** | **[docs/02_系统架构/](docs/02_系统架构/)** |
| **怎么使用这套体系** | **[docs/使用手册.md](docs/使用手册.md)** |
| 详细任务看板 | [ROADMAP.md](ROADMAP.md) |
| 项目为什么要这样做 | [docs/share/](docs/share/) |
| 架构决策记录 | [.ai/knowledge/decisions.md](.ai/knowledge/decisions.md) |
| 怎么搭建的开发环境 | [ENVIRONMENT.md](ENVIRONMENT.md) |
| AI 角色怎么分工 | [AGENTS.md](AGENTS.md) |
---
## 可分享内容
→ [docs/share/](docs/share/) — 项目开发全记录，可对外发布
*仪表盘每次阶段切换时更新，不随每日任务变化。*
.ai/archive/ROADMAP.md
+83
View File
@@ -0,0 +1,83 @@
# ErrLens 项目路线图
> 人类 + AI 共享视野。状态由 Arch AI 维护。
---
## 阶段总览
```
Phase 1 [==========] 基础搭建 ✅ 已完成 (100%)
Phase 2 [----------] MVP ← 当前 (0%)
Phase 3 [----------] 功能完善 (0%)
Phase 4 [----------] 打磨发布 (0%)
```
| 阶段 | 名称 | 状态 | 进度 | 预计重点 |
|------|------|------|------|----------|
| 1 | 基础搭建 | DONE | 100% | 框架、脚手架、PRD、架构设计、旧架构合并 |
| 2 | MVP | ACTIVE | 0% | 错题录入、AI 分析、PDF 打印、图像预处理 |
| 3 | 功能完善 | PLANNED | 0% | 个性化推荐、多端、训练迭代 |
| 4 | 打磨发布 | PLANNED | 0% | 性能优化、安全审计、文档完善 |
---
## Phase 1 回顾（已完成）
| 交付物 | 版本 | 完成日期 |
|------|------|----------|
| 信息架构重构 | — | 2026-05-25 |
| 错题本 PRD | v0.4.0 | 2026-05-26 |
| 系统架构（总体+技术+模块+数据模型） | v0.4.0 | 2026-05-26 |
| P01 文档改写（代码检测→错题本） | — | 2026-05-26 |
| 5 项决策确认（题库/AI/用户/商业化/学科） | — | 2026-05-26 |
| ADR-009 数据质量闭环 | — | 2026-05-26 |
| 旧架构合并 30 项决策 | — | 2026-05-26 |
---
## 当前阶段 (Phase 2) 任务看板
### TODO（待领）
| 任务 | 项目 | 描述 | 优先级 | 负责人 |
|------|------|------|--------|--------|
| P01-001 | App | 数据库 Schema 实现 + 迁移脚本 | P0 | Dev AI |
| P01-002 | App | Auth 模块（微信登录 + JWT） | P0 | Dev AI |
| P01-005 | App | Image 模块（图像预处理管线） | P0 | Dev AI |
| P01-006 | App | Print 模块（PDF 生成 + S3 + 过期清理） | P0 | Dev AI |
| P01-004 | App | Upload 模块（图片上传 + S3） | P1 | Dev AI |
| P01-003 | App | User 模块（个人信息 CRUD + 邀请链） | P1 | Dev AI |
| P01-007 | App | 页面路由 + 基础页面骨架（含打印页） | P1 | Dev AI |
| CROSS-001 | 共享 | 共享工具库日期格式 bug 修复 | P0 | Dev AI |
### DOING
| 任务 | 项目 | 描述 | 负责人 | 预计完成 |
|------|------|------|--------|----------|
| — | — | （无） | — | — |
### DONE
| 任务 | 项目 | 描述 | 完成日期 |
|------|------|------|----------|
| — | — | （Phase 2 暂无完成项） | — |
---
## 阻塞项
| 级别 | 描述 | 影响范围 | 分配给 | 创建日期 |
|------|------|----------|--------|----------|
| YELLOW | CROSS-001 日期格式 bug | CROSS-001 无法关闭 | Dev AI | 2026-05-23 |
---
## 最近更新
| 日期 | 事件 |
|------|------|
| 2026-05-26 | Phase 1 收尾（100%），Phase 2 启动，Dev AI 工作台初始化 |
| 2026-05-26 | 旧架构合并完成：30 项决策落地，5 份架构文档升级至 v0.4.0 |
| 2026-05-25 | 信息架构重构完成 + 项目模板化（ai_project 分支） |
| 2026-05-23 | 框架搭建完成：目录结构、权限体系、7 个 Skill |
.ai/archive/arch-queue.md
+21
View File
@@ -0,0 +1,21 @@
# Arch AI · 任务队列
## 当前阶段 (Phase 1) 任务
| # | 任务 | 优先级 | 状态 | 依赖 |
|---|------|--------|------|------|
| 1 | 信息架构重构 | P0 | DONE | — |
| 2 | 错题本 PRD 编写 | P0 | DONE | 1 |
| 3 | 系统架构设计 | P0 | DONE | 2 |
| 4 | P01 文档改写 | P1 | DONE | 2 |
| 5 | PRD 修订（根据人类反馈） | P0 | TODO | 人类审阅 |
| 6 | 将 Dev 任务写入 Dev 工作台 | P1 | TODO | 3 |
| 7 | 补充 ADR-009 技术选型决策 | P1 | TODO | 3 |
| 8 | 架构提示词模板 | P2 | TODO | — |
## 未来阶段预留
| # | 任务 | 阶段 | 优先级 |
|---|------|------|--------|
| — | Phase 2 MVP 架构设计 | 2 | — |
| — | Phase 3 功能迭代架构 | 3 | — |
.ai/archive/arch-today.md
+45
View File
@@ -0,0 +1,45 @@
# Arch AI · 今日任务 · 2026-05-26
## 已完成
- [x] **[P0]** 编写 `docs/01_产品需求/PRD.md` v0.3.0 — 错题本产品需求文档（已锁定）
- [x] **[P0]** 设计 `docs/02_系统架构/` — 总体架构、技术选型、模块设计、数据模型（v0.3.0）
- [x] **[P1]** 将 P01 项目文档从"代码检测"改写为"错题本"
- [x] **[P1]** 更新 ROADMAP.md 任务看板（PRD 完成后分配 Dev 任务）
- [x] **[P0]** 数据质量架构闭环：人机协同修正（ADR-009）
- [x] **[P0]** 决策落地：双题库源、用户树状邀请、数学+英语双学科、Freemium
- [x] **[P0]** 旧架构合并：30 项决策逐项确认，5 份架构文档更新至 v0.4.0
- [x] **[P0]** Phase 1 收尾：ROADMAP/DASHBOARD 更新，Dev 工作台初始化，ADR-010 补充
- [x] **[P0]** Phase 2 启动：8 个 Dev 任务入队，依赖关系图完成
## Phase 1 收尾清单
| 动作 | 状态 |
|------|------|
| ROADMAP Phase 1 → DONE 100% | ✅ |
| ROADMAP Phase 2 → ACTIVE | ✅ |
| DASHBOARD 阶段切换 | ✅ |
| Dev AI queue.md 重写 | ✅ |
| Dev AI today.md 初始化 | ✅ |
| ADR-010 题库抽象层 | ✅ |
## 旧架构合并（30 项决策全部确认）
| # | 决策 | 结论 |
|---|------|------|
| 1 | 题库来源 | 自有 PDF 录入 + 作业帮 API 双源，架构层抽象适配 |
| 2 | AI 能力 | 分层使用：Coze 测试/验证，Claude 架构，其他 AI 做 Coding |
| 3 | 用户体系 | MVP 仅微信登录，邀请码分享形成树状结构 |
| 4 | 商业化 | 基础免费 + 会员，MVP 全免费 |
| 5 | 首发学科 | 数学 + 英语 |
## 明天 (2026-05-27)
1. UI 设计规范迁移（从旧架构迁移到新架构 `docs/02_系统架构/UI设计规范.md`）
2. 测试方案迁移（从旧架构迁移，调整为 Coze 沙盒自动化测试方案）
3. 部署方案重写（三环境 dev/test/prod + Coze 沙盒配置）
4. 根据人类反馈做修订
## 阻塞
（无）
.ai/archive/dev-queue.md
+36
View File
@@ -0,0 +1,36 @@
# Dev AI · 任务队列
## Phase 2 MVP 任务
| # | 任务 ID | 项目 | 描述 | 优先级 | 状态 |
|---|---------|------|------|--------|------|
| 1 | P01-001 | App | 数据库 Schema 实现 + 迁移脚本 | P0 | TODO |
| 2 | P01-002 | App | Auth 模块（微信登录 + JWT） | P0 | TODO |
| 3 | CROSS-001 | 共享 | 共享工具库日期格式 bug 修复 | P0 | TODO |
| 4 | P01-005 | App | Image 模块（图像预处理管线） | P0 | TODO |
| 5 | P01-006 | App | Print 模块（PDF 生成 + S3 + 清理） | P0 | TODO |
| 6 | P01-004 | App | Upload 模块（图片上传 + S3 + 缩略图） | P1 | TODO |
| 7 | P01-003 | App | User 模块（个人资料 CRUD + 邀请链） | P1 | TODO |
| 8 | P01-007 | App | 页面路由 + 基础页面骨架 | P1 | TODO |
## 依赖关系
```
P01-001 (DB Schema)
├─→ P01-002 (Auth) ──→ P01-003 (User) ──→ P01-007 (Pages)
├─→ P01-004 (Upload) ──→ P01-005 (Image)
└─→ P01-006 (Print)
```
- P01-001 是所有模块的前置依赖，优先完成
- P01-002/004 可并行
- P01-005 依赖 P01-004（需要上传的图片 URL 做输入）
- P01-007 最后做，需要在各模块 API 稳定后
## 参考文档
- PRD: `docs/01_产品需求/PRD.md` (v0.4.0)
- 总体架构: `docs/02_系统架构/总体架构.md` (v0.4.0)
- 技术选型: `docs/02_系统架构/技术选型.md` (v0.4.0)
- 模块设计: `docs/02_系统架构/模块设计.md` (v0.4.0)
- 数据模型: `docs/02_系统架构/数据模型.md` (v0.4.0)
.ai/archive/dev-today.md
+29
View File
@@ -0,0 +1,29 @@
# Dev AI · 今日任务 · 2026-05-26
## 状态：Phase 2 MVP 启动
Phase 1（基础搭建）已收尾。PRD v0.4.0 / 系统架构 v0.4.0 / 数据模型 v0.4.0 全部锁定。
## 待领取（按优先级）
| # | 任务 | 优先级 | 说明 |
|---|------|--------|------|
| 1 | P01-001 | P0 | 数据库 Schema 实现 + Drizzle 迁移脚本。参考 [数据模型.md](../../../docs/02_系统架构/数据模型.md) 全部表定义 |
| 2 | P01-002 | P0 | Auth 模块（微信 code2session + JWT 签发 + AuthGuard）。参考 [模块设计.md](../../../docs/02_系统架构/模块设计.md#31-auth-模块) |
| 3 | CROSS-001 | P0 | 共享工具库日期格式 bug 修复 |
| 4 | P01-005 | P0 | Image 模块（Sharp 图像预处理管线：透视校正 + CLAHE 增强 + 笔迹去除）。参考 [模块设计.md](../../../docs/02_系统架构/模块设计.md#36-image-模块图像预处理) |
| 5 | P01-006 | P0 | Print 模块（PDFKit 生成 + S3 上传 + 24h 过期清理）。参考 [模块设计.md](../../../docs/02_系统架构/模块设计.md#37-print-模块pdf-输出p0) |
| 6 | P01-004 | P1 | Upload 模块（图片上传 S3 + 缩略图） |
| 7 | P01-003 | P1 | User 模块（个人信息 CRUD + 邀请码生成 + 邀请链查询） |
| 8 | P01-007 | P1 | 页面路由 + 9 个基础页面骨架（含打印预览页） |
## 关键架构文档
- [数据模型.md](../../../docs/02_系统架构/数据模型.md) — 所有表定义、索引、Drizzle Schema 示例
- [模块设计.md](../../../docs/02_系统架构/模块设计.md) — API 接口、模块结构
- [总体架构.md](../../../docs/02_系统架构/总体架构.md) — 数据流、部署架构
- [技术选型.md](../../../docs/02_系统架构/技术选型.md) — 技术栈版本
## 已完成
（Phase 2 暂无）
.ai/archive/qa-queue.md
+19
View File
@@ -0,0 +1,19 @@
# QA AI · 任务队列
## 当前阶段 (Phase 1)
暂无测试任务。所有活跃任务处于 TODO 状态。
## 测试流程
1. 确认任务已进入 REVIEW 状态（见 ROADMAP.md）
2. 读取 `review/active/{任务ID}/task.md` — 理解任务
3. 读取 `review/active/{任务ID}/acceptance.md` — 确认验收标准
4. 读取 `review/active/{任务ID}/impact.md` — 了解影响范围
5. 在 `projects/{项目}/tests/` 编写测试
6. 执行测试，生成报告到 `reports/`
7. 提交反馈到 `review/active/{任务ID}/feedback/`
## 已完成的测试
（无）
.ai/archive/qa-today.md
+18
View File
@@ -0,0 +1,18 @@
# QA AI · 今日任务 · 2026-05-25
## 进行中
（无）
## 待执行
当前没有进入 REVIEW 状态的任务，暂无测试任务。
## 已完成
（无）
## 说明
等待 Dev AI 完成代码开发后，任务状态转为 REVIEW 时开始测试工作。
关注 `ROADMAP.md` 中的 DOING 列，当有任务进入 REVIEW 时立即介入。