首页/技术文档

DOCUMENTATION

清晰的架构,可靠的起点。

了解当前技术方向、项目准备方式与系统边界。本页为基础规划说明,具体部署文档将随实现逐步补充。

规划文档 · v0.1

文档概览

iboxbox 智能空间面向别墅、大平层与商业空间。当前方向是通过设备管理、场景编排和自研界面,组织统一的使用体验。

本站为品牌和交互预览,未接入设备、账户、项目数据或远程管理服务。以下架构描述的是建设方向,不代表所有环节已经上线。

系统架构

设备接入Home AssistantNode-RED自研 Web / App

设备接入层

整理设备型号、通信方式、可用接口与网络条件。先验证,再纳入方案。不同设备的控制能力和状态反馈可能不同。

设备管理与场景编排

当前规划使用 Home Assistant 组织设备与状态,使用 Node-RED 编排需要的场景逻辑。流程图表达职责分层,具体数据流与接口按实现确定。

使用界面

自研 Web / App 面向家庭和商业用户提供相应入口。日常操作界面与系统管理入口分开规划,优先围绕常用场景设计。

可演进的技术方向

对外品牌不绑定单一底层平台。后续可按项目评估 KNX、BACnet、Modbus、Matter、天翼云 IoT 与 IBMS 等方向,实际支持清单以验证结果为准。

了解 Home Assistant 的角色

项目准备指南

在开始方案讨论前,建议准备以下信息:

  • 空间资料:空间类型、面积、平面图和房间用途。
  • 装修进度:新建、装修中或已入住,以及预期交付时间。
  • 使用需求:最常用的活动、希望简化的操作和不同使用者的习惯。
  • 现有设备:品牌、型号、数量、安装位置和控制方式。
  • 网络条件:已有布线、覆盖情况和可用的设备安装空间。
  • 项目边界:预算范围、维护责任和需要保留的原有系统。

优先写清“想要什么体验”,再讨论设备清单。例如“观影前一次完成灯光与窗帘调整”,比先选定若干设备更有助于明确目标。

接入与验证

检查项需要明确的问题
接口与授权是否提供可用接口?是否涉及许可证或云端依赖?
指令与反馈哪些操作可控制?执行后能否获得可靠状态反馈?
异常情况断网、掉电、重启或设备离线时如何处理?
手动操作墙面按键和设备原有控制是否保留,如何与自动化协调?
验收方式谁验证结果,用哪些实际场景判断是否完成?

交付与维护

项目交付宜包含设备清单、场景说明、操作指引、配置备份与权限移交。远程维护方式、响应范围和费用应按实际项目约定。

管理入口应独立鉴权,访问范围按需开放。不能把后台地址当作公开演示入口,也不应在网页或公开资料中包含密码、令牌与设备访问凭据。

实际安装、升级和恢复步骤将在对应系统实现并验证后补充。当前不提供未经验证的一键部署指令。