diff --git a/README.md b/README.md index 4777159..b060fb5 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,63 @@ -# AI Assistant Starter 🚀 +# Next.js 管理后台 & AI 智能抽背助手开发项目 🚀 -**Web 应用类 AI 助手快速启动模板** - 包含完整的配置、技能和文档，开箱即用！ +**Web 应用类 AI 助手开发仓库** - 包含完整的配置、技能和文档，开箱即用！ ## 🎯 项目定位 -这是一个 **AI 助手开发模板仓库**，专门用于快速创建 Web 应用类 AI 助手。以后创建新的 AI 助手时，直接克隆这个仓库，修改配置即可使用，无需重复配置！ +这是一个 **AI 助手开发项目仓库**，目前包含两个主要项目： + +1. **Next.js 管理后台模板**（模板 242）- 工作空间 223 +2. **AI 智能抽背助手 Web 应用**（模板 244）- 工作空间 226 🆕 + +--- + +## 📊 当前项目进展 + +### 🎯 AI 智能抽背助手（主项目 - 2026-03-28） + +**状态**: 🔄 BMAD PRD 流程进行中 + +**工作空间**: 226 +**模板**: 244 +**容器配置**: 8v16G (PostgreSQL + Redis + MinIO) + +#### 已完成 ✅ +- [x] 工作空间和模板创建 +- [x] 开发容器配置和启动 +- [x] BMAD 工作流安装 +- [x] 需求文档编写（1092行，包含10个界面详细UI分析） +- [x] 需求文档传输到容器 +- [x] UI 设计分析完成（第一组4个界面 + 第二组6个界面） +- [x] 模板概述文档创建（template-244-overview.md） + +#### 进行中 🔄 +- [ ] **BMAD PRD 流程** - 产品经理（John）正在创建 PRD + - 已完成：执行摘要、成功标准、用户旅程映射 + - 下一步：领域需求分析 + +#### 待开始 📋 +- [ ] 技术架构设计 +- [ ] 数据库设计 +- [ ] 前端开发环境搭建 +- [ ] 后端 API 开发 +- [ ] AI 模型集成 + +**详细文档**: +- 需求文档: [docs/ai-tutor-requirements.md](docs/ai-tutor-requirements.md) +- 模板概述: [docs/template-244-overview.md](docs/template-244-overview.md) + +--- + +### 🛠️ Next.js 管理后台（模板项目） + +**状态**: ✅ 已完成基础配置 + +**工作空间**: 223 +**模板**: 242 + +**技术栈**: Next.js + React + Tailwind CSS + Prisma + +**详细文档**: [docs/template-242-overview.md](docs/template-242-overview.md) --- @@ -269,6 +322,27 @@ MIT License - 自由使用、修改和分发 **维护者**: d8dfun **创建时间**: 2026-03-28 **最后更新**: 2026-03-28 + +## 📅 最近更新 + +### 2026-03-28 + +#### AI 智能抽背助手项目 +- ✅ 创建工作空间 226 和模板 244 +- ✅ 完成需求文档编写（1092行，包含完整UI分析） +- ✅ 整合 UI 分析到主需求文档（10个界面详细分析） +- ✅ 传输需求文档到容器（替换旧版本） +- ✅ 安装 BMAD 工作流平台 +- ✅ 启动 BMAD PRD 流程（产品经理 John 已介入） +- ✅ 创建模板概述文档（template-244-overview.md） +- 🔄 PRD 创建进行中（已完成执行摘要、成功标准、用户旅程映射） + +#### 文档更新 +- ✅ 更新 CLAUDE.md，添加工作空间 226 和模板 244 信息 +- ✅ 创建 template-244-overview.md +- ✅ 更新 README.md，添加项目进展信息 +- ✅ 整合 UI 分析报告（删除独立报告，所有分析整合到主文档） + **AI 助手**: Claude Sonnet 4.6 --- diff --git a/docs/template-244-overview.md b/docs/template-244-overview.md new file mode 100644 index 0000000..5f75a8d --- /dev/null +++ b/docs/template-244-overview.md @@ -0,0 +1,242 @@ +# 模板 244 概述 - AI 智能抽背助手 Web 应用 + +## 📋 基本信息 + +- **模板ID**: 244 +- **工作空间ID**: 226 +- **工作空间名称**: AI智能抽背助手 +- **模板名称**: AI智能抽背助手Web应用 +- **创建日期**: 2026-03-28 +- **项目类型**: 微信小程序（全栈应用） + +--- + +## 🎯 项目定位 + +**AI 智能抽背助手** 是一款基于微信小程序的智能学习辅助应用，致力于解决学习者"记不住、忘得快"的核心痛点。 + +### 核心价值主张 + +**"AI 懂你何时会忘，在遗忘前精准复习"** + +通过 AI 驱动的艾宾浩斯遗忘曲线算法，在用户即将遗忘知识点的关键时刻主动推送精准复习，将复习从"被动任务"转变为"主动救星"。 + +### 目标用户 + +- **K12 学生**：背诵古诗词、英语单词、历史知识点 +- **大学生**：专业课程知识点记忆、考试复习 +- **职业考试考生**：教师资格证、会计师、法律职业资格等备考 + +--- + +## 🛠️ 技术栈 + +### 前端技术 +- **框架**: 微信小程序原生开发 / uni-app（待确定） +- **状态管理**: 待定 +- **UI 组件**: 微信小程序原生组件 + +### 后端技术 +- **框架**: 待定（Node.js / Python / Java） +- **API**: RESTful API +- **数据库**: PostgreSQL（容器已配置） +- **缓存**: Redis（容器已配置） +- **对象存储**: MinIO（容器已配置） + +### AI 能力 +- **语音识别**: 微信语音识别 API / 第三方 ASR +- **自然语言处理**: 文本相似度匹配 +- **记忆算法**: 艾宾浩斯遗忘曲线 + +--- + +## 📁 项目结构 + +``` +226-244-template-6/ +├── docs/ +│ ├── ai-tutor-requirements.md # 完整需求文档（1092行） +│ └── PROJECT_INFO.md # 项目信息文档 +├── .bmad/ # BMAD 工作流配置 +│ ├── core/ # 核心配置 +│ ├── bmm/ # BMAD Method 模块 +│ └── _config/ # 配置文件 +└── (待创建的项目代码) +``` + +--- + +## 🌐 容器访问地址 + +### 开发环境 +- **VSCode**: `d8d-ai-vscode-23964-226-244-template-6-group.dev.d8d.fun` +- **应用端口**: `d8d-ai-vscode-8080-226-244-template-6-group.dev.d8d.fun` +- **MinIO Console**: `minio-9000-226-244-template-6-group.dev.d8d.fun` + +### 容器配置 +- **规格**: 8v16G +- **数据库**: PostgreSQL +- **缓存**: Redis +- **对象存储**: MinIO + +--- + +## 📊 需求文档 + +### 核心功能模块（5个） + +1. **用户管理模块** + - 注册登录（手机号、邮箱、第三方） + - 个人信息编辑 + - 账号设置 + +2. **收藏与分享模块** + - 题目收藏 + - 分享功能（微信、QQ、微博） + +3. **任务制定模块** + - 学习任务设置 + - 定时提醒 + +4. **AI 语音抽背模块** + - 抽背模式设定（范围、模式、间隔） + - 抽背过程交互（语音/文字） + - 抽背结果反馈 + - 记忆曲线助力 + - 后台查询 + +5. **要点背诵模块** + - 文字抽背（卡片式） + - 音频带背（挖空交互） + - 关联试题 + +### UI 设计分析 + +**已分析界面总数**: 10个 + +#### 第一组：主入口界面（4个界面） +- 界面 1: 主入口/抽背启动页 +- 界面 2: AI智能抽背助手 +- 界面 3: 抽背工作台 +- 界面 4: 抽背报告页 + +#### 第二组：完整功能界面（6个界面） +- 界面 1: 首页（学习概览、任务、记忆曲线、高频考点） +- 界面 2: 知识点目录页 +- 界面 3: 音频带背详情页（挖空） +- 界面 4: 卡片背诵详情页 +- 界面 5: 答题详情页 +- 界面 6: 答题关联知识点页 + +**UI 分析文档**: `/workspace/group/docs/ai-tutor-requirements.md` 第六、七节 + +--- + +## 🚀 开发环境设置 + +### BMAD 工作流 + +**已安装**: ✅ BMAD Method 平台 + +**可用技能**: +- `bmad-help` - 智能指南 +- `bmad-quick-spec` - 快速规格定义 +- `bmad-dev-story` - 实施开发 +- `bmad-pm` - 产品经理（John） +- `bmad-architect` - 架构师（Winston） +- `bmad-dev` - 开发者（Amelia） + +### 开发工具 + +**D8D MCP 工具**: +- `d8d_start_dev_container` - 启动开发容器 +- `d8d_exec_dev_container_command` - 执行命令 +- `d8d_invoke_dev_container_subagent` - 调用子代理 + +**子代理交互**（推荐开发方式）: +```bash +# 调用容器内的 Claude 子代理 +mcp__d8d__d8d_invoke_dev_container_subagent( + item_id=244, + item_type="template", + workspace_id=226, + message="你的问题或指令", + backgroundMode=true # 推荐使用后台模式 +) +``` + +--- + +## 📈 项目进展 + +### 已完成 ✅ + +- [x] 工作空间和模板创建 +- [x] 开发容器配置（8v16G + PostgreSQL + Redis + MinIO） +- [x] BMAD 工作流安装 +- [x] 需求文档传输到容器（1092行，完整版） +- [x] UI 设计分析（10个界面详细分析） +- [x] 需求文档整合（UI分析已整合到主文档） +- [x] 项目信息文档创建 + +### 进行中 🔄 + +- [ ] BMAD PRD 流程（已启动，等待用户确认继续） +- [ ] 技术架构设计 +- [ ] 数据库设计 + +### 待开始 📋 + +- [ ] 前端开发环境搭建 +- [ ] 后端 API 开发 +- [ ] AI 模型集成 +- [ ] 测试与部署 + +--- + +## 🎯 MVP 范围 + +### 一级功能（必须有） + +1. 用户注册登录（微信授权登录） +2. 知识点管理（添加/编辑/删除） +3. AI 语音抽背（核心功能） +4. 记忆曲线系统（艾宾浩斯遗忘曲线算法） +5. 智能复习提醒 +6. 学习进度可视化 +7. 答题模式（选择题/填空题） + +### 二级功能（MVP 后期 / 1.0 版本） + +1. 音频带背 +2. 卡片背诵 +3. 知识点关联 +4. 学习报告 +5. 分享功能 + +### 三级功能（1.0 版本之后） + +1. 后台管理系统 +2. 社区功能 +3. 高级数据分析 +4. 多端同步 + +--- + +## 📞 联系方式 + +- **项目仓库**: https://gitea.d8d.fun/d8dfun/nextjs-admin-assistant +- **开发分支**: feature/ai-tutor-requirements +- **容器**: 模板 244（工作空间 226） + +--- + +## 📅 更新记录 + +- **2026-03-28**: 创建模板 244，配置开发环境，传输需求文档，启动 BMAD PRD 流程 + +--- + +**维护者**: AI 智能抽背助手开发团队 +**文档版本**: 1.0 +**最后更新**: 2026-03-28