feat: Flutter 客户端 App + Web UI APK 下载入口

- 新增 Flutter 跨平台客户端项目 (clients/flutter/)
  - 29 个 Dart 文件: 服务层/状态管理/5个页面/BLE配网
  - BLE 蓝牙配网: 扫描设备、写入WiFi凭据、配网状态监听
  - HTTP API 客户端: 覆盖全部端点 (播放/场景/WiFi/视频/配置/文件/插件)
  - WebSocket 实时通信: 事件流 + 自动重连
  - 暗色主题 Material 3 UI, 中文界面
  - Android 配置: minSdkVersion 21, BLE/网络权限
  - PRD 产品需求文档 + 开发任务看板
- Web UI 添加 APK 下载入口 (routes.rs)
  - 下载弹窗 + 二维码 + /download/{filename} 静态文件路由
- BLE 插件增加自动重连循环 (ble/mod.rs)
- BLE 默认设备名修正为 'Showen' (config.rs)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
showen
2026-03-14 02:09:52 +08:00
parent d4f0eb7eca
commit bff9ec535d
45 changed files with 5903 additions and 75 deletions

View File

@@ -2508,3 +2508,20 @@ ScreenPlugin 已重构为 DevicePlugin 的 thin wrapper但 main.rs 中没有
P0 问题已解决DevicePlugin 现已完全集成到 ShowenV2 运行时!🎉
---
[2026-03-14 当前] 刘建国(PM) → 陈逸飞(CEO), 张婉琳(产品总监), Flutter 项目相关成员: Flutter 客户端立项文档已启动并完成首版产出。
本次输出:
- 已创建 `clients/flutter/PRD.md`:定义 Flutter App 的产品目标、用户场景、五大页面、BLE 配网协议、HTTP/WebSocket 能力范围、非功能需求、风险与验收标准。
- 已创建 `clients/flutter/TASKS.md`按基础架构、设备发现、BLE、HTTP、WebSocket、页面开发、配置/视频管理、测试发布 8 个模块拆解任务,标注优先级、依赖与预计工时。
关键决策:
- Flutter App 定位为 Phase 2 移动端主交付,优先完成“首次接入 + 高频控制 + 实时状态”三条主链路。
- 设备发现同时支持 BLE 扫描与手动输入 IP避免首次联网与局域网复连割裂。
- BLE 客户端实现按 read + notify 双模式兼容,降低服务端 notify 语义不完整带来的联调风险。
- 设置页中的视频上传标记为 P2首发优先保证配置查看/提交、视频列表与删除能力。
项目判断:
- 当前文档已足够支撑 Flutter 技术方案设计、UI 细化与开发排期。
- 后续需要在正式开发前冻结客户端共享数据模型,并安排一次 API/WebSocket/BLE 联调校准。