# 文档导航

以下文档描述由 `pet_collar_service` 二进制按角色承载的管理 API 与遥测处理：

1. [API 契约](./zenoh-rpc-api.md)：RPC、遥测 topic、数据结构、权限和错误码。
2. [ESP32 项圈固件接口与开发指南](./esp32-development.md)：设备开通、签名遥测、寻宠控制和固件联调。
3. [APP 接口与业务开发指南](./app-development.md)：用户会话、项圈管理、围栏、分享、订阅和 APP 验收。
4. [架构与安全边界](./architecture.md)：运行时数据流、会话隔离和部署要求。
5. [开发与配置](./development.md)：代码地图、配置方式、启动和扩展流程。
6. [测试指南](./testing.md)：单元测试、API 集成测试和测试数据管理。

根目录 [README](../README.md) 提供项目简介和快速启动入口。YAML 配置示例见
[service.example.yaml](../service.example.yaml)。

JSON 字段查阅：通用 RPC 信封和全部 RPC 字段见 API 契约；APP 与 ESP32 的专项字段见各自开发指南；
脚本执行顺序、测试请求和应答示例见测试指南。
