📚 课程介绍

欢迎来到"教你1天做好一个宠物健康及营养分析AI小程序"系列课程！在这个系列中，我们将从零开始，用1天时间完成一个功能完整、可商用的宠物健康AI小程序。本课程将带你掌握微信小程序开发、CloudBase云开发、AI集成等热门技术。

🎯 项目背景

随着宠物经济的快速发展，宠物主人对科学养宠的需求日益增长。市面上缺乏一款能够提供个性化宠物营养建议、健康管理、AI咨询的综合性小程序。本项目正是为了填补这一市场空白而诞生。

💡 项目核心功能

1. 宠物档案管理

• 支持多宠物档案创建
• 记录宠物基本信息（品种、年龄、体重、特殊需求等）
• 宠物健康数据追踪

2. AI宠物专家

• 24小时智能咨询服务
• 基于DeepSeek大模型的专业回答
• 多模式Prompt工程，提供个性化建议
• 支持商品营养查询和宠物护理指导

3. 智能营养分析

• 根据宠物信息计算营养需求
• 智能推荐适合的宠物食品
• AI生成个性化推荐理由
• 商品营养成分详细展示

4. 健康趋势分析

• 健康数据可视化
• 体重、食欲、活跃度等指标追踪
• 健康趋势图表展示
• 异常数据预警

5. 游客模式

• 零门槛体验核心功能
• 无需登录即可试用
• 引导用户注册转化

🏗️ 技术架构设计

技术栈选择

前端技术

• 微信小程序原生开发：保证性能和用户体验
• WXML + WXSS：小程序标准UI语言
• JavaScript ES6+：现代化JavaScript开发

后端技术

• 腾讯CloudBase：一站式后端云服务
• 云函数（Node.js）：无服务器架构，按需计费
• 云数据库：文档型数据库，灵活便捷
• 云存储：用于存储宠物照片、健康报告等

AI服务

• 微信小程序AI接口：官方提供的AI能力
• DeepSeek模型：强大的大语言模型
• Prompt工程：多模式智能对话

系统架构图

🎨 架构设计原则

1. 前后端分离

• 前端专注UI展示和用户交互
• 后端处理业务逻辑和数据管理
• 通过云函数API进行通信

2. 微服务化

• 每个云函数负责独立功能模块
• 降低耦合度，提高可维护性
• 支持独立部署和扩展

3. 数据驱动

• 所有功能基于用户和宠物数据
• AI分析依赖完整的数据模型
• 支持数据可视化分析

4. 用户友好

• 游客模式降低使用门槛
• 渐进式引导用户注册
• 简洁直观的操作界面

🔧 开发环境搭建

必备工具

1. 微信开发者工具

下载地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html
版本要求：建议使用 Stable 版本（1.06.0 以上）

2. Node.js环境

下载地址：https://nodejs.org/
版本要求：Node.js 14.x 或更高版本
验证安装：node -v && npm -v

3. 腾讯云账号

注册地址：https://cloud.tencent.com/
开通服务：CloudBase 云开发服务

项目初始化

1. 创建微信小程序

// 在微信开发者工具中创建新项目
项目名称：pet
AppID：使用你的AppID或测试号
后端服务：选择"腾讯云CloudBase"

2. 项目目录结构

pet/
├── cloudfunctions/              # 云函数目录
│   ├── pet_user_service/        # 用户管理服务
│   ├── pet_pet_service/         # 宠物管理服务
│   ├── pet_ai_expert_service/   # AI专家服务
│   ├── pet_recommendation_service/ # 推荐服务
│   └── pet_health_analysis/     # 健康分析服务
├── miniprogram/                 # 小程序前端目录
│   ├── pages/                   # 页面目录
│   │   ├── index/               # 首页
│   │   ├── pet-form/            # 宠物信息表单
│   │   ├── ai-pet-expert-chat/  # AI专家聊天
│   │   ├── recommendations/     # 推荐页面
│   │   └── health-trends/       # 健康趋势
│   ├── components/              # 组件目录
│   ├── utils/                   # 工具函数
│   ├── app.js                   # 小程序入口
│   ├── app.json                 # 小程序配置
│   └── app.wxss                 # 全局样式
├── project.config.json          # 项目配置
└── README.md                    # 项目说明

3. CloudBase环境配置

// 在腾讯云控制台创建CloudBase环境
环境名称：pet-dev（开发环境）
环境ID：自动生成（如：scottzhongtest-8go7e6fme0bff9a2）
资源配置：按需选择

📦 核心依赖配置

小程序配置文件 project.config.json

{
  "miniprogramRoot": "miniprogram/",
  "cloudfunctionRoot": "cloudfunctions/",
  "setting": {
    "urlCheck": true,
    "es6": true,
    "enhance": true,
    "postcss": true,
    "minified": true,
    "newFeature": true,
    "useIsolateContext": true,
    "useCompilerModule": true
  },
  "appid": "你的AppID",
  "projectname": "宠物健康AI小程序",
  "libVersion": "2.20.1"
}

小程序全局配置 app.json

{
  "pages": [
    "pages/index/index",
    "pages/pet-form/index",
    "pages/ai-pet-expert-chat/index",
    "pages/recommendations/index",
    "pages/health-trends/index"
  ],
  "window": {
    "backgroundTextStyle": "light",
    "navigationBarBackgroundColor": "#fff",
    "navigationBarTitleText": "宠物健康AI助手",
    "navigationBarTextStyle": "black"
  },
  "sitemapLocation": "sitemap.json",
  "style": "v2",
  "lazyCodeLoading": "requiredComponents"
}

CloudBase初始化 app.js

App({
  onLaunch: function () {
    // 初始化云开发
    if (!wx.cloud) {
      console.error('请使用 2.2.3 或以上的基础库以使用云能力');
    } else {
      wx.cloud.init({
        env: 'scottzhongtest-8go7e6fme0bff9a2', // 你的环境ID
        traceUser: true,
      });
      console.log('CloudBase初始化成功');
    }
  },
  
  globalData: {
    userInfo: null,
    cloudBaseReady: false
  }
});

🔑 关键技术点

1. 云函数通信机制

// 前端调用云函数
wx.cloud.callFunction({
  name: 'pet_user_service',
  data: {
    action: 'getUserInfo',
    userId: 'xxx'
  }
}).then(res => {
  console.log('云函数返回:', res.result);
});

2. 数据库操作

// 获取数据库引用
const db = wx.cloud.database();

// 查询数据
db.collection('pet_pets')
  .where({ user_id: 'xxx' })
  .get()
  .then(res => {
    console.log('查询结果:', res.data);
  });

3. AI接口调用

// 初始化AI模型
wx.cloud.init({ env: 'your-env-id' });
const model = wx.cloud.extend.AI.createModel("deepseek");

// 调用AI生成内容
const result = await model.streamText({
  data: {
    model: "deepseek-r1",
    messages: [{ role: "user", content: "你好" }]
  }
});

📊 预期学习成果

完成本课后，你将：

1. ✅ 理解宠物健康AI小程序的整体架构
2. ✅ 掌握微信小程序与CloudBase的集成方式
3. ✅ 了解云函数微服务化设计思路
4. ✅ 完成开发环境的搭建和配置

🎓 下节预告

在第2课中，我们将深入学习：

• CloudBase环境的详细配置
• 数据库表结构设计
• 数据模型的最佳实践
• 初始数据的导入方法

准备好了吗？让我们开始这段精彩的开发之旅吧！

---