CosRay-Backend 文档站后端实现、跨端协议与部署维护统一入口

文档范围 ​

本站覆盖三类内容：

• CosRay-Backend 当前实现与接口行为
• CosRay-App 与 CosRay-Detector-Firmware 的对接契约摘要
• 文档站点自身的部署、发布与维护规则

站点结构 ​

• 快速开始：本地启动后端与文档站点

• 架构总览：系统边界、数据流和真值来源

• 认证与用户：JWT、注册、刷新、当前用户

• 设备管理：Detector 模型、CRUD、隔离规则

• 数据包上传：上传约束、错误码、IoTDB 写入语义

• 协议与字段映射：Firmware、App、Backend 三端对齐说明

• 额外端点：/health（健康检查）与 token/verify（Ninja-JWT 内置）。

• 部署到 GitHub Pages：文档站点的构建与发布路径

维护原则 ​

1. 后端运行行为以 core 下实现和测试为准。
2. 跨端字段和协议以 Firmware 结构体与 App DTO 为源头约束。
3. 文档只保留当前有效内容，历史规划与模板页不再作为长期入口。