智能饮水杯系统产品系统Vibe Coding

当代人普遍存在饮水不足、习惯不规律的问题，且水温、水质、饮水量缺乏量化追踪手段，存在"想喝但不知道喝多少、喝的水到底好不好"的痛点。SmartCup 智饮杯面向学生、白领、户外作业、慢病管理及家庭关怀场景，基于 ESP32-S3 硬件 + 微信小程序 + 微信云开发 + DeepSeek 大模型，实现饮水行为数字化、水质可视化、AI 个性化建议，并通过家庭成员数据共享辅助亲情监护。技术上打通 BLE 实时采集、4G Cat1 兜底上报、自定义帧协议、Three.js 3D 杯体展示、LLM 代理安全调用，覆盖端—云—端完整链路。

SmartCup 覆盖"嵌入式固件 → 云端服务 → 微信小程序"完整全栈，主要功能模块包括：
1.BLE 实时数据采集：基于 ESP32-S3，通过自定义帧协议解析温度（DS18B20）、TDS 水质、水量（YW01）等传感器数据并实时上报。
2.饮水打卡与周报：自动 / 手动打卡，统计日/周饮水趋势，生成可视化周报。
3.AI 饮水助手：接入 DeepSeek，结合用户画像与实时传感器数据，给出个性化饮水建议（chat 页 + hydrationAdvice 云函数）。
4.加热控制：MOSFET 加热开关，含超温 / 蓝牙断连 / 传感器失效三重安全保护。
5.双模定位：外置 GPS（NEO-6M） + 4G Cat1（E840-TTL）云端上报，配合手机定位地图用于防丢与户外作业记录。
6.家庭关怀：家庭成员饮水数据共享与提醒，子女可远程查看父母饮水情况。
7.3D 杯体展示：Three.js / threejs-miniprogram 在小程序端渲染 GLB / STL 杯体模型，含材质动画与交互。
8.水质标准查询：内置 TDS 标准库，实时比对饮水水质。
9.设备诊断 / 设置：可视化查看 BLE 连接、传感器读数、固件版本，支持 OTA 升级。
整套系统包含 14 个小程序页面与 10 个云函数，覆盖 BLE / 4G 通信、云开发、LLM 代理、3D 渲染、硬件控制完整链路。

职责覆盖：本人负责从 0 到 1 全栈搭建——硬件层基于 ESP32-S3 编写 Arduino C++ 固件，集成 DS18B20 / TDS / YW01 传感器，自定义 BLE 帧协议与 4G Cat1 桥接；云端层搭建 10 个微信云函数（bindCup / drinkRecord / familyCare / hydrationAdvice / gpsReport 等）并独立部署 Node.js LLM 代理，避免 API Key 落入小程序；小程序前端使用微信原生框架 + Three.js 落地 14 个页面、BLE 通信、设备控制、3D 杯体展示与 AI 对话。

技术栈：微信小程序原生 · Three.js / threejs-miniprogram · 微信云开发（云函数） · Node.js · ESP32-S3 Arduino C++ · BLE · 4G Cat1 · DeepSeek API · Vite · GSAP。

亮点：端—云—端分层解耦；LLM 密钥收敛到独立 Node 代理；加热三重安全防护 + 4G 链路兜底；3D 模型与水流动画一体化展示。

难点：① 小程序 BLE API 在不同 Android 厂商下稳定性差异显著，连接 / 重连 / 分包写入需兼容处理；② Three.js 模型资源在 WebGL 小程序环境下的加载、首屏性能与动画编排；③ 自定义 BLE 帧协议的小端对齐、分包粘包边界处理；④ 4G 模块功耗与离线消息堆积的平衡。