feat(P01): 迁移 Taro 小程序项目代码
- 迁移前端源码 (src/) - 迁移后端服务 (server/) - 迁移配置文件 (package.json, tsconfig.json 等) - 更新需求概要文档 - 更新架构设计文档 - 更新接口定义文档 - 更新环境配置文档 - 创建测试目录结构和配置 项目技术栈: - Taro 4.1.9 (跨端框架) - React 18 - TypeScript - NestJS (后端) - Tailwind CSS 4 - shadcn/ui 组件库
This commit is contained in:
@@ -1,21 +1,108 @@
|
||||
# P01_errlens_app - 需求概要
|
||||
|
||||
## 项目概述
|
||||
ErrLens 是一个 AI 辅助编程工具,旨在帮助开发者快速定位和修复代码错误。
|
||||
|
||||
## 核心功能
|
||||
1. **错误检测** - 实时分析代码中的潜在问题
|
||||
2. **智能修复** - 自动生成修复建议
|
||||
3. **代码审查** - 提供代码质量评估
|
||||
4. **学习建议** - 根据错误类型提供学习资源
|
||||
ErrLens 小程序应用是一个基于 **Taro 4 框架**开发的多端小程序项目,支持微信小程序、抖音小程序和 H5 平台。
|
||||
|
||||
## 用户角色
|
||||
- 初级开发者:学习编程时获得实时反馈
|
||||
- 中级开发者:提高代码质量和效率
|
||||
- 团队负责人:监控团队代码质量
|
||||
## 项目定位
|
||||
|
||||
- **产品类型**:AI 辅助编程工具的移动端入口
|
||||
- **目标用户**:开发者、编程学习者、代码审查人员
|
||||
- **核心价值**:随时随地访问 ErrLens 的代码错误检测和修复建议功能
|
||||
|
||||
## 技术栈
|
||||
- 前端:React + TypeScript
|
||||
- 后端:Node.js + Express
|
||||
- 数据库:PostgreSQL
|
||||
- AI 服务:自定义模型 + OpenAI API
|
||||
|
||||
### 前端框架
|
||||
| 技术 | 版本 | 说明 |
|
||||
|------|------|------|
|
||||
| Taro | 4.1.9 | 跨端开发框架 |
|
||||
| React | 18.x | UI 框架 |
|
||||
| TypeScript | 5.x | 类型安全 |
|
||||
| Tailwind CSS | 4.x | 原子化样式 |
|
||||
| Zustand | 5.x | 状态管理 |
|
||||
|
||||
### 后端框架
|
||||
| 技术 | 版本 | 说明 |
|
||||
|------|------|------|
|
||||
| NestJS | 10.x | Node.js 服务端框架 |
|
||||
| Express | 5.x | HTTP 服务器 |
|
||||
| PostgreSQL | 15+ | 关系数据库 |
|
||||
| Drizzle ORM | 0.45.x | ORM 工具 |
|
||||
|
||||
### 集成服务
|
||||
| 服务 | 说明 |
|
||||
|------|------|
|
||||
| Supabase | 数据库连接 |
|
||||
| S3 兼容存储 | 文件存储 |
|
||||
| Coze SDK | AI 能力集成 |
|
||||
|
||||
## 核心功能模块
|
||||
|
||||
### 1. 首页模块
|
||||
- [ ] 欢迎页面展示
|
||||
- [ ] 功能快捷入口
|
||||
- [ ] 最新动态/公告
|
||||
|
||||
### 2. 代码分析模块
|
||||
- [ ] 代码上传/粘贴
|
||||
- [ ] 错误检测结果展示
|
||||
- [ ] 修复建议生成
|
||||
|
||||
### 3. 用户模块
|
||||
- [ ] 用户登录/注册
|
||||
- [ ] 个人中心
|
||||
- [ ] 历史记录
|
||||
|
||||
### 4. 设置模块
|
||||
- [ ] 主题切换
|
||||
- [ ] 通知设置
|
||||
- [ ] 关于我们
|
||||
|
||||
## 页面结构
|
||||
|
||||
```
|
||||
pages/
|
||||
├── index/ # 首页
|
||||
├── analyze/ # 代码分析
|
||||
├── history/ # 历史记录
|
||||
├── profile/ # 个人中心
|
||||
└── settings/ # 设置页面
|
||||
```
|
||||
|
||||
## 组件库
|
||||
|
||||
项目使用 **Taro 版 shadcn/ui** 组件库,位于 `src/components/ui/`:
|
||||
|
||||
| 组件类型 | 示例组件 |
|
||||
|---------|---------|
|
||||
| 基础组件 | Button, Input, Textarea |
|
||||
| 布局组件 | Card, Dialog, Drawer, Sheet |
|
||||
| 数据展示 | Table, Badge, Avatar |
|
||||
| 导航组件 | Tabs, Breadcrumb |
|
||||
| 反馈组件 | Toast, Alert, Progress |
|
||||
|
||||
## 多端支持
|
||||
|
||||
| 平台 | 状态 | 说明 |
|
||||
|------|------|------|
|
||||
| 微信小程序 | ✅ 支持 | 主流平台 |
|
||||
| 抖音小程序 | ✅ 支持 | 字节系平台 |
|
||||
| H5 | ✅ 支持 | Web 端预览 |
|
||||
|
||||
## 用户体验目标
|
||||
|
||||
- **加载速度**:首屏加载 < 2s
|
||||
- **交互流畅**:帧率 >= 60fps
|
||||
- **跨端一致**:各端 UI 表现一致
|
||||
- **离线可用**:支持本地缓存
|
||||
|
||||
## 安全要求
|
||||
|
||||
- 用户数据加密存储
|
||||
- API 请求鉴权
|
||||
- 敏感信息脱敏
|
||||
|
||||
---
|
||||
|
||||
**文档版本**:v1.0.0
|
||||
**最后更新**:2026-05-22
|
||||
|
||||
Reference in New Issue
Block a user