# P01_errlens_app - 需求概要

## 项目概述

ErrLens 小程序应用是一个基于 **Taro 4 框架**开发的多端小程序项目，支持微信小程序、抖音小程序和 H5 平台。

## 项目定位

- **产品类型**：AI 辅助编程工具的移动端入口
- **目标用户**：开发者、编程学习者、代码审查人员
- **核心价值**：随时随地访问 ErrLens 的代码错误检测和修复建议功能

## 技术栈

### 前端框架
| 技术 | 版本 | 说明 |
|------|------|------|
| 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