# 宠物管家小程序第一版本产品需求文档

## 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月
**负责人**：产品开发团队