This commit is contained in:
yvan 2025-08-01 15:06:34 +08:00
parent 9260111312
commit 424890e0c7
2 changed files with 719 additions and 0 deletions

View File

@ -0,0 +1,300 @@
# 宠物管家小程序第一版本产品需求文档
## 1. 产品概述
### 1.1 产品定位
宠物管家第一版本是一款专注于宠物日常管理的小程序,提供宠物档案管理、日常记录、记账统计、家庭共养等核心功能。
### 1.2 目标用户
- **主要用户**:养宠家庭、宠物爱好者
- **次要用户**:准备养宠人群、宠物救助者
### 1.3 第一版本目标
- 帮助宠物主科学记录宠物日常生活
- 提供简单的数据统计和分析
- 支持家庭成员共同管理宠物
- 建立基础的宠物领养信息平台
## 2. 第一版本核心功能
### 2.1 宠物档案管理
#### 2.1.1 基础信息录入
- **必填信息**:宠物名字、品种、性别、生日、到家日期
- **可选信息**:体重、毛色、性格标签、特殊说明
- **头像上传**:支持拍照或从相册选择宠物照片
- **自动计算**:根据生日自动计算年龄和星座
#### 2.1.2 信息展示
- **宠物卡片**:在首页展示宠物基本信息和头像
- **陪伴天数**:自动计算从到家日期到现在的天数
- **详情页面**:完整展示宠物所有信息
- **编辑功能**:支持修改宠物信息
### 2.2 日常记录系统
#### 2.2.1 记录分类
- **随手记**:日常趣事、心情记录、文字+图片
- **大事记**:重要时刻记录(绝育、第一次吃奶、第一次吃猫粮、第一次用猫砂、第一次搞破坏、第一次出门、第一次发情、生日、到家等)
- **日常记录**:体重、尿便、饮食、喝水、记账
- **健康记录**:喂保健品、驱虫、疫苗、抗体水平、体检、看病、给药、住院、手术
- **洗护记录**:洗澡、剪指甲、洗耳朵、刷牙、梳毛、剃脚毛、美容、挤肛门腺、擦眼屎
- **清洁记录**:消毒、清洁、换猫砂、洗猫砂盆、洗食盆、洗水盆、洗玩具、洗笼子、换滤芯、换干燥剂
- **自定义类型**:用户可以自定义记录类型
#### 2.2.2 记录功能
- **添加记录**:选择记录类型,填写内容、时间、数值(如体重)
- **图片上传**:每条记录可以添加多张图片
- **时间线展示**:按时间顺序展示所有记录
- **分类筛选**:可以按记录类型筛选查看
- **编辑删除**:支持修改和删除已有记录
### 2.3 记账统计功能
#### 2.3.1 消费记录
- **记账分类**:食物、医疗、用品、服务、其他
- **记录内容**:金额、类别、备注、关联宠物、时间
- **多宠物支持**:可以选择消费是针对哪只宠物
#### 2.3.2 统计分析
- **宠物切换**:可以切换查看不同宠物的消费统计
- **时间维度**:按月份、按年份统计消费
- **图表展示**:简单的柱状图或折线图展示消费趋势
- **分类统计**:按消费类别统计金额和占比
## 3. 分享和家庭功能
### 3.1 分享设置
- **分享权限**:每条记录可以设置三种分享模式
- 公开:所有人可见
- 仅家人:只有家庭成员可见
- 私有:只有自己可见
- **默认设置**:可以设置默认的分享权限
- **批量设置**:可以批量修改已有记录的分享权限
### 3.2 家庭共养功能
- **创建家庭**:宠物主人可以创建家庭
- **邀请成员**:通过邀请码或微信直接邀请家人加入
- **成员权限**
- 主人:所有权限
- 家人:可以查看和添加记录
- 观察者:只能查看记录
- **消息推送**:重要事件(如生病、疫苗等)会推送给所有家庭成员
## 4. AI宠物助手基础版
### 4.1 基础对话功能
- **文字对话**用户可以通过文字与AI助手对话
- **知识问答**:回答宠物相关的基础问题(生病、训练、喂养等)
- **上下文记录**:保存对话历史,支持分页查看
- **对话打断**:用户可以随时开始新的对话主题
### 4.2 简单知识库
- **宠物生病**:常见疾病的症状和处理建议
- **宠物训练**:基础的训练方法和技巧
- **宠物喂养**:不同年龄段的喂养指导
- **紧急情况**:紧急情况的处理步骤
### 4.3 智能提醒功能
- **语义识别**:识别用户对话中的时间和任务
- 例如:"明天九点提醒我给宠物做疫苗"
- **自动生成**:自动生成提醒记录和任务
- **推送提醒**:到时间后推送提醒消息
- **状态跟踪**:提醒后询问用户是否完成,更新任务状态
### 4.4 每日总结
- **对话总结**:每天对当天的对话内容进行总结
- **健康关注**:如果提到宠物生病或不舒服,第二天会主动询问情况
- **站内消息**:重要提醒通过站内消息推送
## 5. 领养专区
### 5.1 发布领养信息
- **宠物信息**:名字、性别、种类、年龄、绝育状态、疫苗情况、驱虫情况、健康状况
- **图片上传**:支持上传多张宠物照片
- **详细描述**:宠物性格、习惯、特殊需求等文字描述
- **领养要求**:设置领养条件(如要求养过猫、要求对猫绝育、要求对猫驱虫等)
- **筛选问题**:设置申请者需要回答的问题
- **时效设置**:可以设置领养信息的有效期,或选择不限时
### 5.2 浏览和筛选
- **地区筛选**:按地理位置筛选附近的领养信息
- **基础搜索**:按宠物类型、性别、年龄等条件搜索
- **信息展示**:列表展示领养信息,包含基本信息和照片
- **详情查看**:点击查看完整的领养信息和要求
### 5.3 申请和沟通
- **申请报名**:有意向的用户可以申请领养
- **个人信息**:填写个人基本信息和养宠经验
- **回答问题**:回答发布者设置的筛选问题
- **申请说明**:说明自己的养宠条件和能力
- **消息通知**:申请后通知发布者
- **聊天功能**:申请通过后可以进行私聊沟通细节
### 5.4 管理和审核
- **管理员审核**:发布的领养信息需要管理员审核通过
- **申请管理**:发布者可以查看所有申请,选择合适的申请者
- **状态更新**:领养成功后更新信息状态
## 6. 技术方案
### 6.1 技术架构
- **前端框架**uni-app + Vue3支持微信小程序
- **后端框架**Node.js + Express
- **数据库**MongoDB
- **文件存储**腾讯云COS对象存储
- **AI服务**接入百度文心一言或腾讯AI
### 6.2 核心数据结构
- **用户表**用户基本信息、微信openid
- **宠物表**:宠物档案信息
- **记录表**:所有类型的记录统一存储
- **家庭表**:家庭成员关系
- **领养表**:领养信息和申请记录
### 6.3 关键功能实现
- **微信登录**:使用微信小程序授权登录
- **图片上传**集成腾讯云COS支持图片压缩
- **消息推送**:使用微信小程序模板消息
- **数据统计**前端使用uCharts生成图表
## 7. 第一版本开发计划
### 7.1 开发周期总计16周
#### 第1-2周项目搭建
- 前后端项目架构搭建
- 开发环境配置
- 数据库设计
- 基础UI组件开发
- 微信小程序配置
#### 第3-4周用户系统和宠物档案
- 微信登录功能
- 用户信息管理
- 宠物档案CRUD功能
- 宠物信息展示页面
- 图片上传功能
#### 第5-7周日常记录系统
- 记录分类和添加功能
- 记录列表和详情页
- 图片上传和展示
- 时间线展示
- 记录编辑和删除
#### 第8-9周记账统计功能
- 消费记录添加
- 按宠物和时间统计
- 图表展示功能
- 数据筛选和查看
#### 第10-11周分享和家庭功能
- 分享权限设置
- 家庭创建和邀请
- 成员权限管理
- 消息推送功能
#### 第12-13周AI助手基础版
- AI对话接口集成
- 知识库查询功能
- 对话历史记录
- 智能提醒功能
#### 第14-15周领养专区
- 领养信息发布
- 浏览和筛选功能
- 申请和审核流程
- 聊天功能
#### 第16周测试和优化
- 功能测试和bug修复
- 性能优化
- 用户体验优化
- 发布准备
### 7.2 团队配置
- **产品经理**1人负责需求管理和项目协调
- **UI设计师**1人负责界面设计和用户体验
- **前端开发**1-2人负责小程序开发
- **后端开发**1-2人负责API和数据库开发
- **测试**1人负责功能测试和质量保证
### 7.3 关键里程碑
- **第4周**:完成宠物档案管理功能
- **第7周**:完成日常记录系统
- **第9周**:完成记账统计功能
- **第11周**:完成家庭共养功能
- **第13周**完成AI助手基础版
- **第15周**:完成领养专区
- **第16周**:完成测试,准备发布
## 8. 功能优先级
### 8.1 高优先级(必须实现)
1. 宠物档案管理
2. 日常记录系统
3. 基础分享功能
4. 记账统计功能
### 8.2 中优先级(重要功能)
1. 家庭共养功能
2. AI助手基础版
3. 消息推送功能
### 8.3 低优先级(可选功能)
1. 领养专区
2. 高级AI功能
3. 复杂数据分析
## 9. 第一版本成功指标
### 9.1 用户指标
- **用户注册**目标1000个注册用户
- **活跃用户**日活跃用户50人以上
- **记录频次**用户平均每周记录3次以上
- **留存率**7日留存率达到30%以上
### 9.2 功能使用率
- **宠物档案**90%用户完成宠物档案创建
- **日常记录**70%用户使用记录功能
- **记账功能**40%用户使用记账功能
- **家庭共养**20%用户邀请家人加入
### 9.3 技术指标
- **系统稳定性**99%以上的可用性
- **响应速度**API响应时间小于2秒
- **图片上传**成功率95%以上
## 10. 风险控制
### 10.1 开发风险
- **进度延期**:每周进度检查,及时调整资源
- **技术难点**:提前验证关键技术,准备备选方案
- **质量问题**:建立测试流程,确保功能质量
### 10.2 用户风险
- **用户接受度**:通过小范围测试收集用户反馈
- **使用习惯**:简化操作流程,提供使用指导
- **数据安全**:严格保护用户隐私和宠物信息
## 11. 后续版本规划
### 11.1 第二版本V2.0
- 增强AI分析能力
- 添加更多宠物种类支持
- 完善社区功能
- 增加专家服务
### 11.2 长期规划
- 智能硬件集成
- 宠物健康预警系统
- 商业化功能
- 平台生态建设
---
**文档版本**:第一版本 v1.0
**创建日期**2025年1月
**预计完成时间**2025年5月
**负责人**:产品开发团队

View File

@ -0,0 +1,419 @@
# 宠物管家小程序第一版本功能拆分详细说明
## 1. 功能模块总览
### 1.1 核心功能模块
1. **用户系统** - 微信登录、用户信息管理
2. **宠物档案管理** - 宠物信息录入、展示、编辑
3. **日常记录系统** - 多类型记录的添加、查看、管理
4. **记账统计功能** - 消费记录、统计分析、图表展示
5. **分享权限管理** - 记录分享设置、隐私控制
6. **家庭共养功能** - 家庭创建、成员邀请、权限管理
7. **AI助手基础版** - 简单对话、知识查询、智能提醒
8. **领养专区** - 发布领养、浏览申请、沟通管理
## 2. 详细功能拆分
### 2.1 用户系统
#### 2.1.1 微信登录
**功能描述**:用户通过微信授权登录小程序
**具体实现**
- 调用微信小程序登录API获取code
- 后端通过code换取openid和session_key
- 生成JWT token返回给前端
- 前端存储token用于后续API调用
**页面设计**
- 登录页面:显示微信登录按钮
- 授权页面:获取用户基本信息授权
**数据字段**
- openid微信用户唯一标识
- nickname用户昵称
- avatar用户头像
- phone手机号可选
#### 2.1.2 用户信息管理
**功能描述**:用户可以查看和编辑个人信息
**具体实现**
- 个人中心页面展示用户信息
- 支持修改昵称、头像、手机号
- 头像支持拍照或从相册选择
### 2.2 宠物档案管理
#### 2.2.1 宠物信息录入
**功能描述**:用户可以添加宠物的基本信息
**必填字段**
- 宠物名字:文本输入
- 品种:下拉选择或文本输入
- 性别:单选(公/母)
- 生日:日期选择器
- 到家日期:日期选择器
**可选字段**
- 体重数字输入单位kg
- 毛色:文本输入
- 性格标签:多选标签
- 特殊说明:文本输入
- 头像:图片上传
**自动计算字段**
- 年龄:根据生日自动计算
- 陪伴天数:根据到家日期自动计算
- 星座:根据生日自动计算
#### 2.2.2 宠物信息展示
**首页宠物卡片**
- 宠物头像(圆形)
- 宠物名字
- 年龄和陪伴天数
- 快捷操作按钮(添加记录、查看详情)
**宠物详情页**
- 完整的宠物信息展示
- 编辑按钮
- 最近记录列表
- 统计数据概览
#### 2.2.3 多宠物管理
**功能描述**:支持用户管理多只宠物
**具体实现**
- 宠物列表页面
- 宠物切换功能
- 每只宠物独立的记录和统计
### 2.3 日常记录系统
#### 2.3.1 记录分类定义
**随手记**
- 内容:文字描述
- 图片可选最多9张
- 时间:默认当前时间,可修改
**大事记**
- 预设选项:绝育、第一次吃奶、第一次吃猫粮、第一次用猫砂、第一次搞破坏、第一次出门、第一次发情、生日、到家
- 自定义:用户可以添加自定义大事记
- 内容:文字描述
- 图片:可选
- 时间:必填
**日常记录**
- 体重数值输入kg+ 备注
- 尿便:次数 + 状态描述 + 图片
- 饮食:食物类型 + 分量 + 时间 + 图片
- 喝水水量ml+ 时间
- 记账:金额 + 类别 + 备注
**健康记录**
- 喂保健品:保健品名称 + 剂量 + 时间
- 驱虫:驱虫药名称 + 时间 + 下次提醒
- 疫苗:疫苗类型 + 时间 + 下次提醒
- 抗体水平:检测结果 + 时间
- 体检:体检项目 + 结果 + 图片
- 看病:症状 + 诊断 + 治疗方案 + 费用
- 给药:药品名称 + 剂量 + 频次 + 时间
- 住院:入院时间 + 出院时间 + 原因 + 费用
- 手术:手术类型 + 时间 + 费用 + 恢复情况
**洗护记录**
- 洗澡:时间 + 使用产品 + 图片
- 剪指甲:时间 + 备注
- 洗耳朵:时间 + 使用产品
- 刷牙:时间 + 使用产品
- 梳毛:时间 + 备注
- 剃脚毛:时间 + 备注
- 美容:时间 + 项目 + 费用 + 图片
- 挤肛门腺:时间 + 备注
- 擦眼屎:时间 + 备注
**清洁记录**
- 消毒:消毒区域 + 使用产品 + 时间
- 清洁:清洁项目 + 时间
- 换猫砂:时间 + 猫砂类型
- 洗猫砂盆:时间 + 清洁产品
- 洗食盆:时间
- 洗水盆:时间
- 洗玩具:时间 + 清洁方式
- 洗笼子:时间 + 清洁产品
- 换滤芯:设备名称 + 时间
- 换干燥剂:时间 + 位置
**自定义类型**
- 用户可以创建自定义记录类型
- 自定义字段配置
- 保存为模板供后续使用
#### 2.3.2 记录添加流程
1. 选择宠物(如果有多只)
2. 选择记录类型
3. 填写记录内容
4. 上传图片(可选)
5. 设置分享权限
6. 保存记录
#### 2.3.3 记录展示和管理
**时间线展示**
- 按时间倒序显示所有记录
- 不同类型用不同图标和颜色区分
- 支持下拉刷新和上拉加载
**分类筛选**
- 按记录类型筛选
- 按时间范围筛选
- 按宠物筛选(多宠物情况)
**记录详情**
- 完整的记录信息展示
- 图片查看(支持放大)
- 编辑和删除功能
### 2.4 记账统计功能
#### 2.4.1 消费记录
**记录字段**
- 金额:数字输入(精确到分)
- 类别:食物、医疗、用品、服务、其他
- 备注:文字描述
- 关联宠物:选择宠物(支持多选)
- 时间:默认当前时间,可修改
**快捷记录**
- 常用金额快捷按钮
- 常用类别快捷选择
- 语音输入金额
#### 2.4.2 统计分析
**宠物维度统计**
- 可以切换查看不同宠物的消费
- 支持查看所有宠物的总消费
**时间维度统计**
- 按月份统计:当月消费总额和分类占比
- 按年份统计:全年消费趋势
- 自定义时间范围统计
**图表展示**
- 柱状图:月度消费趋势
- 饼图:消费类别占比
- 折线图:消费变化趋势
#### 2.4.3 数据导出
- 支持导出Excel格式的消费记录
- 按时间范围和宠物筛选导出
- 包含详细的消费明细和统计汇总
### 2.5 分享权限管理
#### 2.5.1 分享设置
**三种分享模式**
- 公开:所有用户可见
- 仅家人:只有家庭成员可见
- 私有:只有自己可见
**设置方式**
- 添加记录时设置
- 记录详情页修改
- 批量修改多条记录
#### 2.5.2 默认设置
- 用户可以设置默认的分享权限
- 新记录自动使用默认设置
- 可以为不同类型的记录设置不同的默认权限
### 2.6 家庭共养功能
#### 2.6.1 家庭创建
**创建流程**
1. 用户点击创建家庭
2. 填写家庭名称
3. 选择要共享的宠物
4. 生成邀请码
**家庭信息**
- 家庭名称
- 创建时间
- 成员数量
- 共享宠物列表
#### 2.6.2 成员邀请
**邀请方式**
- 邀请码分享生成6位数字邀请码
- 微信直接邀请:通过微信分享邀请链接
**邀请流程**
1. 家庭主人发送邀请
2. 被邀请人点击链接或输入邀请码
3. 确认加入家庭
4. 设置成员权限
#### 2.6.3 权限管理
**角色定义**
- 主人:所有权限,可以邀请成员、设置权限、删除家庭
- 家人:可以查看和添加记录,不能删除其他人的记录
- 观察者:只能查看记录,不能添加或修改
**权限细分**
- 查看记录:所有角色都有
- 添加记录:主人和家人
- 编辑记录:只能编辑自己添加的记录
- 删除记录:只能删除自己添加的记录
- 管理宠物:只有主人可以
#### 2.6.4 消息推送
**推送场景**
- 新成员加入家庭
- 重要健康记录(生病、疫苗、体检等)
- 紧急情况记录
**推送方式**
- 微信小程序模板消息
- 站内消息通知
### 2.7 AI助手基础版
#### 2.7.1 基础对话功能
**对话界面**
- 聊天气泡样式
- 支持文字输入
- 显示AI回复
**知识问答**
- 宠物生病:常见疾病症状和处理建议
- 宠物训练:基础训练方法和技巧
- 宠物喂养:不同年龄段的喂养指导
- 紧急情况:紧急情况的处理步骤
#### 2.7.2 智能提醒功能
**语义识别**
- 识别时间表达明天、下周、9点等
- 识别任务内容:疫苗、体检、喂药等
- 生成结构化提醒
**提醒管理**
- 自动生成提醒记录
- 设置推送时间
- 提醒后询问完成状态
- 更新任务状态
#### 2.7.3 对话历史
**历史记录**
- 保存所有对话内容
- 按日期分组显示
- 支持搜索历史对话
**分页加载**
- 每页显示20条对话
- 支持上拉加载更多
- 新对话自动滚动到底部
#### 2.7.4 每日总结
**总结功能**
- 每天晚上自动总结当天对话
- 识别重要信息(健康问题、异常情况)
- 生成关注提醒
**主动关怀**
- 如果提到宠物生病,第二天主动询问情况
- 定期询问宠物状况
- 提供个性化建议
### 2.8 领养专区
#### 2.8.1 发布领养信息
**宠物信息**
- 基本信息:名字、性别、种类、年龄
- 健康状况:绝育、疫苗、驱虫、疾病情况
- 性格描述:文字描述宠物性格和习惯
- 图片上传最多9张宠物照片
**领养要求**
- 基础要求:年龄、居住条件、经济能力
- 特殊要求:养宠经验、是否同意绝育等
- 筛选问题:自定义问题列表
**发布设置**
- 有效期:可设置领养信息的有效期
- 联系方式:手机号或微信号
- 地区:选择所在城市和区域
#### 2.8.2 浏览和筛选
**列表展示**
- 宠物照片和基本信息
- 发布时间和地区
- 快速筛选标签
**筛选功能**
- 地区筛选:按省市区筛选
- 类型筛选:按宠物种类筛选
- 条件筛选:按年龄、性别、绝育状态筛选
**搜索功能**
- 关键词搜索
- 按品种搜索
- 按发布者搜索
#### 2.8.3 申请和沟通
**申请流程**
1. 查看领养详情
2. 填写申请信息
3. 回答筛选问题
4. 提交申请
5. 等待审核
**申请信息**
- 个人基本信息
- 养宠经验描述
- 居住环境说明
- 承诺和保证
**沟通功能**
- 简单的聊天界面
- 支持文字和图片
- 消息推送通知
#### 2.8.4 管理和审核
**发布者管理**
- 查看所有申请
- 筛选合适的申请者
- 与申请者沟通
- 选择最终领养者
**管理员审核**
- 审核发布的领养信息
- 处理举报和投诉
- 维护平台秩序
**状态管理**
- 发布中、已暂停、已完成
- 申请中、已通过、已拒绝
- 自动状态更新
## 3. 技术实现要点
### 3.1 数据存储
- 使用MongoDB存储所有数据
- 图片存储在腾讯云COS
- Redis缓存热点数据
### 3.2 API设计
- RESTful API设计
- JWT token认证
- 统一的错误处理和返回格式
### 3.3 性能优化
- 图片压缩和懒加载
- 分页加载减少数据量
- 缓存常用数据
### 3.4 安全考虑
- 用户数据加密存储
- API接口权限验证
- 图片内容安全检查
---
**文档版本**v1.0
**创建日期**2025年1月
**负责人**:开发团队