aijianhua/docs/需求文档.md

# 爱鉴花项目需求文档

## 版本历史
| 版本号 | 修订日期 | 修订人 | 修订说明 |
|--------|----------|--------|----------|
| v1.0.0 | 2024-01-20 | 系统 | 初始版本创建 |
| v1.1.0 | 2024-03-15 | 产品经理 | 完善官网功能需求细节 |
| v1.1.1 | 2024-03-15 | 产品经理 | 补充非功能需求技术要求 |
| v1.1.2 | 2024-03-15 | 开发工程师 | 修复数据库设计问题，更新文档一致性 |

## 1. 项目概述
爱鉴花是一款通过AI图片识别植物类型的微信小程序应用，为用户提供花卉相关信息、购买、配送等服务。

## 2. 产品定位
爱鉴花旨在为花卉爱好者提供一个集植物识别、花卉信息查询、购买、配送于一体的综合服务平台。

## 3. 用户群体
- 花卉爱好者
- 园艺爱好者
- 对植物感兴趣的一般用户

## 4. 功能需求

### 4.1 微信小程序 (uni-app)
- **拍照识别植物**: 支持拍照或相册选择图片，AI识别植物种类
- **植物信息展示**: 展示识别结果，包括植物名称、科属、习性、养护方法等
- **花卉商城**: 商品分类浏览、搜索、详情查看、加入购物车
- **花卉配送**: 在线下单、配送地址管理、配送时间选择、订单跟踪
- **园艺工具**: 园艺知识文章、植物养护指南、工具推荐
- **用户个人中心**: 用户信息管理、订单历史、收藏夹、收货地址管理

### 4.2 后端接口 (Node.js)
- **植物识别API**: 接收图片文件，调用AI服务，返回识别结果
- **用户管理API**: 用户注册、登录、信息修改、密码重置
- **商品管理API**: 商品CRUD操作、分类管理、库存管理
- **订单管理API**: 订单创建、状态更新、查询、取消
- **支付接口**: 微信支付集成、支付状态回调处理
- **数据统计API**: 用户行为统计、销售数据统计、识别数据统计

### 4.3 后台管理系统 (Vue3)
- **用户管理**: 用户列表查看、信息编辑、权限管理、封禁操作
- **商品管理**: 商品添加/编辑/删除、分类管理、库存调整、上下架
- **订单管理**: 订单列表查看、状态更新、详情查看、导出功能
- **数据统计**: 用户增长统计、销售报表、识别数据统计、图表展示
- **系统设置**: 系统参数配置、权限角色管理、操作日志查看

### 4.4 官方网站 (HTML5 Bootstrap)
- **首页模块**
  - 公司简介展示（品牌标语、核心价值主张）
  - 核心功能展示（智能识别、知识库、社区交流三大功能卡片）
  - 产品展示区（微信小程序、API服务、企业版三款产品）
  - 最新动态展示（最新3条新闻摘要）
  - 联系入口（快速联系按钮）

- **关于我们模块**
  - 公司详细介绍（成立时间、使命愿景、发展规模）
  - 企业文化展示（价值观、企业精神）
  - 发展历程时间线（关键里程碑事件）
  - 团队介绍（核心团队成员信息、照片、职位）

- **产品介绍模块**
  - 产品功能详细说明（各产品功能特点、优势）
  - 功能对比表格（三款产品功能差异对比）
  - 使用案例展示（真实用户使用场景和效果）
  - 客户评价系统（用户评价卡片、星级评分）
  - 价格方案展示（各产品定价和套餐）

- **新闻中心模块**
  - 公司动态（产品发布、版本更新、活动通知）
  - 行业资讯（花卉行业最新趋势和技术）
  - 媒体报道（媒体采访、报道文章）
  - 分类筛选（按类别查看新闻）
  - 搜索功能（关键词搜索新闻内容）

- **联系我们模块**
  - 联系表单（姓名、邮箱、电话、消息内容）
  - 实时表单验证（前端验证、错误提示）
  - 表单提交反馈（成功/失败提示信息）
  - 联系信息展示（地址、电话、邮箱、工作时间）
  - 在线地图集成（公司位置地图展示）
  - 社交媒体链接（微信、微博、GitHub）

- **通用功能**
  - 响应式设计（桌面端、平板、手机适配）
  - 导航系统（主导航菜单、面包屑导航）
  - 页脚信息（版权声明、备案信息、政策链接、友情链接）
  - SEO优化（meta标签、结构化数据）
  - 性能优化（图片懒加载、资源压缩）

## 5. 非功能需求

### 5.1 性能要求
- **页面加载速度**: 首屏加载时间 ≤ 3秒，完整页面加载时间 ≤ 5秒
- **资源优化**: 图片压缩（WebP格式支持），CSS/JS文件合并压缩
- **缓存策略**: 浏览器缓存优化，CDN加速部署
- **响应时间**: 用户操作响应时间 ≤ 100ms
- **技术栈版本**: Node.js 16.0.0+, MySQL 8.0+, Redis 6.0+, Vue.js 3.0+

### 5.2 可用性要求
- **浏览器兼容性**: 支持 Chrome、Firefox、Safari、Edge 等主流浏览器
- **设备兼容性**: 完美支持桌面端、平板、手机等不同设备尺寸
- **可访问性**: 符合WCAG 2.1 AA标准，支持屏幕阅读器
- **错误处理**: 友好的错误提示和恢复机制

### 5.3 安全性要求
- **表单安全**: 防止XSS攻击，输入内容过滤和转义
- **HTTPS强制**: 全站HTTPS加密传输
- **数据验证**: 前后端双重数据验证机制
- **隐私保护**: 用户数据加密存储，符合GDPR要求

### 5.4 可维护性要求
- **代码规范**: 遵循HTML5、CSS3、ES6+编码规范
- **文档完整**: 完整的代码注释和技术文档
- **模块化设计**: 组件化开发，便于维护和扩展
- **版本控制**: Git版本管理，清晰的commit记录

### 5.5 SEO要求
- **搜索引擎友好**: 合理的URL结构，语义化HTML标签
- **结构化数据**: Schema.org标记，丰富搜索结果展示
- **元数据优化**: 每个页面独立的title、description、keywords
- **站点地图**: XML sitemap自动生成和提交

### 5.6 监控和分析
- **性能监控**: Google Analytics集成，性能指标监控
- **错误监控**: 前端错误日志收集和分析
- **用户行为分析**: 热点图、转化漏斗分析
- **安全监控**: 安全漏洞扫描和预警