毛毛星球产品系统

面向流浪猫狗救助点与爱宠用户，通过物联网投喂机和现场摄像头做远程看护、远程投粮，并叠加宠物内容社区、直播互动和众筹助养，形成“看宠—投喂—社交—助养”一体化场景。

本项目是「猫屋」宠物物联网与内容平台的 Android / iOS 客户端。主要功能模块如下：

首页直播看护：对接现场摄像头实时预览、全屏、录屏与灯光控制，展示在线人数、今日出现、投喂排行、守护人和身份卡，支持聊天互动与分享。
智能投喂：按档位远程控制投喂机出粮，支持爱心币 / 钻石支付，投喂前校验设备在线，失败不扣费，并做幂等防重复提交。
广场内容：支持图文 / 视频发布、评论、收藏、举报，构成宠物内容社区。
猫档案：为救助点猫狗建档（品种、绝育、性格、领养信息等），方便用户了解和助养。
众筹助养：项目详情、支持、分享与深链打开。
赚币乐园：跑酷天梯、早起打卡、淘宝返利等。
账户与交易：短信 / 一键登录、充值提现、微信 / 支付宝支付

本项目由公司自研，采用「Flutter 客户端 + Java 微服务 + 运营管理后台 + MQTT 物联网硬件」一体化交付，覆盖远程看护、智能投喂、设备遥测、内容社区、档案助养、支付结算与后台运营。客户端一套 Flutter 代码同时发布 Android、iOS；服务端基于若依微服务拆分业务域，经网关统一对外；投喂机通过 MQTT 接入云端，管理后台完成设备绑定、指令下发与运营审核。

一、客户端（Flutter）
使用 Flutter + Dart，GetX 做状态与路由，Dio 统一封装鉴权、超时重试、401 会话失效。直播接入萤石 SDK，聊天接入腾讯云 IM；登录支持短信与阿里云号码认证；支付覆盖微信、支付宝及 iOS 内购。投喂前先查设备在线与运行快照（电量、余粮），离线不发起扣费；出粮过程轮询投喂状态，并与直播画面、公屏弹幕联动。

二、服务端（Java 微服务）
基于 Spring Cloud + Nacos、Gateway、Sa-Token、MySQL、Redis。按域拆分认证、用户、直播、投喂、支付、收益、档案、营销、游戏、任务等服务。用户端走 /api/**，管理端走 /admin/**。投喂执行、灯光控制、设备运行信息均以 cat_feeders.device_id 关联硬件；业务成功后再走 MQTT 下行，设备回执异步更新投喂单状态。

三、MQTT 硬件对接
投喂机通过 EMQX 接入，主题按设备编号区分：云端下行，通信为二进制帧，CRC16 Modbus 校验，指令带唯一码避免设备忽略重复包。出粮：App 下单校验 在线态（心跳 / 空闲 / 出粮中）后扣费，服务端下发出粮指令，设备上报开始、完成或失败，状态回写投喂记录