ai_soc_sw/projects/P01_errlens_app/docs/01_需求概要.md

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