备忘录，记录研发的阶段性输出：

- [20261116-ESP32] 在样板上集成之前测试通过的Zenoh通信代码，同时集成无源蜂鸣器，LED灯。 集成和测试IMU传感器BMI270的数据上报，SDA=GPIO2、SCL=GPIO1（以 A0 芯片手册原理图为准，与之前投产前群里发的引脚分配excel表相反）
- [20261116-SERVR] 新增虚拟项圈(模拟器)，行为识别模拟器，相当于有一个虚拟的猫在做随机的虚拟的行为，方便服务器与APP端的API接口测试。补充服务端联调与 API 契约：
  - Debug 构建新增 API 请求/响应日志，按启动时间生成日志文件并在单文件达到 1 MB 后轮转；默认递归脱敏令牌、密码、验证码、手机号、配对码等敏感字段，受控本地排错可通过 `SHOW_SENSITIVE=1` 显示原值，Release 构建不生成该日志。
  - 扩充 API、APP、ESP32 和测试文档，补齐 JSON 字段中文说明、接口权限约束及请求/响应示例，并说明日志格式和敏感信息处理。
  - 精简项圈设置响应，移除未再使用的 `settingsVersion`，保留设备命令版本 `deviceSettingsVersion`；设备重新登录替换会话时同步清理旧遥测在线租约。
- [20261115-SRVR] 自上次提交 `636c2b3` 以来的研发改进：
  - 完善用户与设备管理 API：短信注册/登录、密码登录、验证码校验与 Redis 保存、刷新/注销/重置密码、APP 多设备会话列表及撤销；集成阿里云短信，并区分 debug/release 的验证码显示与发送行为。支持按授权分享 GPS/IMU 数据，并可签发短期 APP Zenoh 客户端证书。
  - 完善项圈管理与遥测安全：开通口令、配对码哈希、项圈绑定/解绑及多用户关联；加入 GPS/IMU 发布授权、Ed25519 签名、序号校验、系统信息上报和 GPS 向在线 APP 分发。
  - 增加业务能力：GPS 电子围栏（默认半径 2 公里、凸多边形校验与越界告警）、APP 一键寻宠（项圈闪灯/蜂鸣器命令及确认）、IMU 行为识别处理器订阅样本并发布行为结果。行为处理目前是带 `simulated` 标记的启发式原型，不是生产级训练模型。
  - 统一服务配置与部署：配置支持 CLI、环境变量、YAML 及明确优先级；TCP/TLS 根据 Router endpoint scheme 选择；管理与遥测共享解析后的配置和 Redis client。合并管理 API 与遥测为统一服务；移除可显式传入的 `--role all`，省略 `--role` 默认同时启动两者，`api`/`telemetry` 仍可单独启动。
  - 支持多实例部署：API 可由 Zenoh 路由到多个实例；Redis tenant-scoped 租约选出唯一遥测消费者，实例退出后可接管。该方案提供遥测高可用，不会并行提升遥测吞吐量；进一步扩吞吐仍需分区队列/消费者组。
  - 完善联调和设备资产工具：新增项圈遥测模拟器（系统信息、GPS、随机行为 IMU、签名与寻宠确认）；新增 SQLite 项圈 ID 发号/台帐工具，并将 `collarId` 规定为跨 tenant 全局唯一且不可复用（服务端尚未强制冲突检查）。API Shell 脚本可 `source` 后单步调用并输出请求/响应；文档拆分并补充 ESP32、APP、API、架构、部署和完整测试流程，本地开通步骤按生成公钥、注册项圈、绑定用户、启动模拟器组织。
  - 修复 IMU 验签：`serde_json` 默认浮点解析可能改变 IMU 浮点数末位，导致签名文本不一致；启用 `float_roundtrip` 并添加 JSON 往返回归测试。`cargo test --locked`、`cargo check --locked --bins`、格式和 diff 检查通过。
- [20261111-SERVR] 测试用我自己的个人实名信息对接阿里云API服务，成功发送第一条短信，移动和联通，电信均没问题。用公司的账号发送短信。联通和电信都测试通过，移动收不到短信。
- [20261110-SERVR] 落实短信服务的购买事宜，着手集成阿里云短信服务的API的集成和调试工作。
- [20261109-ALL] ★★★因4G流量的方案直接影响ESP32和服务器的开发内容，甚至产品的竞争力，决定跟产品经理进行核实和沟通，很不理想。后又亲自联系中国移动，客服指派的客户经理提供了一个相当不错的流量方案，300MB/卡/月，3元，确定购买细节她还可以提流程申请打半折，另外还可以自由定制套餐，并且提供了eSIM贴片卡合作商的技术参数细节。如果硬件电路设计这边的更换方案的时间充裕，建议更换。
- [20261108-SERVR] 同APP研发一起调试通过了用户注册和通过密码登录，注销，查看APP设备列表，项圈设备列表等16个API接口。 
- [20261107-ALL] ★★★跟APP研发一起商讨数据库设计，确定业务功能，这或许是本产品目前为止比较确定的竞争优势之一？
  - 一个项圈设备可以对应多个用户。也就是，一个家庭的多个成员，都可以查看同一个宠物。也可支持亲朋好友之间的分享，实现宠物的他人代看功能，权限可以随时取消。
  - 一个用户也可以对应多个项圈设备。也就是，一个家庭的一个成员名下有多个宠物。
  - 一个用户还可以同时有多台APP设备。也就是，一个家庭的一个养猫成员，有多台设备，如手机，平板等各种APP设备。可以随时踢除可疑的登录设备。
  
- [20261107-ALL] ★★★讨论本产品跟竞品相比，哪些环节可以具备差异性的竞争优势。讨论3D模型外协合作超越竞品的可行性问题，经产品经理确认，本环节预算有限，放弃专业团队和精模方案。
- [20261106-ALL] 落实公司名义下的公网服务器的购买和二级域名的事宜。之前是本人用自己的公网服务器测试。https://xsj.mmozi.com
- [20261106-ALL] 公司NAS备份方案问题。为了节省预算，省去另购机械硬盘的成本，改回最初我的方案[原先有三个方案]，固态硬盘安装NAS系统，机械硬盘当作备份盘(目前是Basic模式，后续增加机械硬盘可做RAID1)。系统已经安装好，需持续运行观察一周时间。
- [20261106-ALL] ★★★讨论本产品跟竞品相比，哪些环节可以具备差异性的竞争优势。讨论eSim的可行性方案，解决4G流量自由和尺寸问题[硬件电路设计方案以及产品准入合规和用户体验问题]，经产品经理，本环节不再继续。
- [20261106-ESP32] 与新入职员工对接工作内容，确认他的前期主要职责是全权负责协助硬件电路设计过程中的软件测试工作，后期逐步介入和全面接管ESP32上的软件开发工作。
- [20261103-SERVR] 讨论APP跟服务器的通信接口，先以用户登录和多设备多用户管理接口为例。
- [20261030-APP] 安卓，鸿蒙和iOS集成zenoh客户端，实现基本的PUB/SUB,测试均通过。
- [20261021-SERVR] 本地部署zenoh路由，连接公网的zenoh路由，测试本地的丢包情况。
- [20261014-SERVR] 公网服务器上部署zenoh路由，测试PUB/SUB,Query/Reply等模式。
- [20261014-ESP32] 配合硬件电路设计，测试ESP32上的无源蜂鸣器的占空比，声音频率，LED灯光颜色/亮度的渐变等效果。
- [20261014-ESP32] ESP32上的zenoh客户端运行已有3天，没有丢包和重连等异常现象发生。
- [20261011-ESP32] ESP32上集成zenoh客户端，测试通信效果，打算长期运行。
- [20260928-ESP32] ESP32上测试4G模块的TCP/UDP通信，imu数据采集。
