lzh
b61896d3ba
05-移动端开发： - 01-移动端工程结构与页面分域.md - 补充 UniApp 分包策略（主包 2MB 限制） - 页面路由配置与生命周期规范 - Token 双 Token 无感刷新逻辑 - 内存泄漏防护清单 - 02-硬件交互与弱网离线策略.md - 智能工牌蓝牙通信协议（BadgeStatus/NotifyType） - iBeacon 协议格式与信标配置 - 蓝牙扫描 Hook 实现（useBluetoothScan） - 权限处理与超时机制 08-附录： - 01-术语表.md - IoT 设备术语（工牌、信标、RSSI） - 工单状态机（Mermaid 状态图） - 优先级与触发来源 - 移动端 BLE 术语 - 02-错误码清单.md - 后端统一错误码（全局 + OPS 模块） - 前端 ResultEnum 状态码 - 蓝牙扫描状态与错误处理 - 错误码对照速查表
AIoT 开发者文档中心 (Developer Documentation)
📌 文档中心定位
这是 AIoT 项目的唯一官方技术知识库。这里的文档不写长篇大论的废话，只提供能够真正指导研发团队（包含 AI Agent）完成代码编写、系统联调、排障和协作的硬核指南。它是团队的技术契约与协作基线。
🚀 当前项目阶段
项目当前正处于「Ops 迭代与 IoT 冲刺」交汇期：
- 一阶段 Ops 为核心：保洁、安保等工单业务的底层基础建设已完成，目前处于持续迭代和业务深化阶段。
- 下一阶段重心：研发重心正全面转向 IoT（物联网）领域 的设备接入、物模型管理与控制链路打通。
📦 三大主仓
所有业务开发均围绕以下三个核心 Git 仓库展开：
- 后端主仓：
aiot-platform-cloud - Web前端主仓：
yudao-ui-admin-vben - 移动端主仓：
aiot-uniapp
🗺️ 按角色推荐阅读路径
无论你是人类开发者还是 AI Agent，请根据你的角色选择对应的阅读入口。详细的阅读地图请查阅：00-阅读地图
- 新人 (Newbie)：先看本 README ➔ 02-项目当前状态 ➔ 03-代码仓与协作边界 ➔ 本地环境搭建
- 后端 (Backend)：03-代码仓边界 ➔ 后端协作规范 ➔
02-Ops领域/03-IoT领域的具体业务方案 - 前端/移动端 (FE/Mobile)：前端/移动端规范 ➔ API 对接规范 ➔ UI/组件库规范
- 测试 (QA)：02-项目当前状态 ➔ 核心业务流程图 (01/02目录) ➔ 部署与联调说明
- 运维 (Ops)：03-代码仓边界 ➔ 06-平台支撑 ➔ CI/CD与中间件配置
- 产品 (PM)：业务状态 ➔ 01-业务与架构 对应的领域设计
- Agent (AI 助手)：通读
00-导航与总览➔ 不同项目的基本规范 ➔ 检索相关业务目录下的.md
⭐ 当前优先阅读清单
针对当前项目阶段，以下文档的优先级最高，请在开发前务必对齐：
- 00-导航与总览/03-代码仓与协作边界.md - 弄清你的代码该提交到哪、遇到 bug 去哪个仓排查。
- 07-协作规范/01-不同项目的基本规范.md - 开发红线与基本目录结构。
02-Ops领域或03-IoT领域中你目前负责的具体模块设计。
🛡️ 文档维护原则 (Truth Source)
在信息发生冲突时，请遵循以下可信度倒排原则（前面的优先级最高）：
- 代码 (Code)：代码是最终的真相。
- 项目负责人确认 (Tech Lead)：重大歧义直接找 Lead 确认并立即更新文档。
- 数据库/配置 (DB/Config)：线上实际运行的表结构和 Nacos 配置。
- 旧文档 (Old Docs)：未及时更新的文档仅作参考。如果你发现文档已过期，你就有责任顺手更新它。
🗂️ 全局目录总览
00-导航与总览/：新手上路、项目状态、协作边界（入口）01-业务与架构/：全局架构设计02-Ops领域/：工单、保洁、安保核心文档03-IoT领域/：设备接入、物模型与数据流04-前端开发/：Web 管理端开发专项05-移动端开发/：小程序/App 开发专项06-平台支撑/：中间件与 DevOps 基础设施07-协作规范/：开发、测试、发布的流程与规约08-附录/：术语表与历史存档