云定制主页管理 (ops-console) — 变更清单
包名：com.ainetv.aishicloud · version：1.0.0+1
标记说明：✅ 已实现 / 已修复 | ⏳ 待后端 / 待验收 | ❌ 已知问题
所有 release APK 均通过 flutter analyze --no-fatal-infos（0 error）
v6-fix68（2026-08-29）
修复两个功能性 Bug：① 设备列表「删除」按钮点击后返回「删除失败：未知异常，请联系管理员」；② 设备详情页修改房号后不生效，页面仍显示 Web 端原有房号。
根因（通过静态分析 Web 前端 JS 逆向真实后端契约得出）：
- 删除失败：后端
POST /device/info/delete 接收的是裸 JSON 数组 [id]（Web 端 Ao(t) → $.adornData(t,!1) → JSON.stringify([id,...])）。旧实现误传 {'ids':[id]}（对象），后端无法解析请求体 → 抛出「未知异常」。
- 房号不保存：后端设备表房号字段名为
roomId（Web 端设备编辑表单 prop:'roomId'、列表列 prop:'roomId' 标签「房间号」）。旧实现发送 roomNo，后端忽略该未知字段 → 更新“成功”但房号未变，刷新后回显旧值。
改动：
lib/services/device_service.dart：
deleteDevice(id)：body 由 {'ids':[id]} 改为裸数组 [id]，并在 id 可转为数字时按数字发送（复刻 Web 端 Yo() 的 Number(id) 行为），兼容数字/字符串两种主键；activateDeviceByScan：扫码激活的房号字段 roomNo → roomId（update 与 save 两条路径）。
lib/screens/home/device_detail_page.dart：DeviceGroupRoomSheet 提交时房号字段 roomNo → roomId。lib/models/device.dart：toJson 房号输出键 roomNo → roomId（fromJson 读取别名列表保留 roomNo/roomId 等，确保后端返回 roomId 时正确回显）。- 版本号
v6-fix67 → v6-fix68。
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
设备服务 |
deleteDevice(id)：删除 body 由 {'ids':[id]} 改为裸数组 [id]，对齐 Web 端契约 |
| ✅ 已修复 |
设备/扫码 |
房号字段统一为后端 roomId（update/save/详情编辑/toJson） |
| ✅ 已更新 |
版本号 |
登录页版本号 v6-fix67 → v6-fix68 |
v6-fix67（2026-08-31）
设备列表页「向左滑动显示删除按钮」手势。
用户需求：在「设备 MAC 排序」列表中，为每个 MAC 项增加向左滑动手势，滑动后露出删除按钮（位于行右侧）；点击删除按钮才弹出确认对话框，确认后执行删除、取消则保留。
实现选择：原先用 Dismissible 会在滑动过阈值松手时自动弹确认框（红色背景仅为装饰、不可点击），不满足「先露按钮再点击」的交互。故改用 flutter_slidable（新增依赖 flutter_slidable: ^3.1.0）：向左滑揭示一个可点击的红色「删除」动作（位于行右侧），点击动作才触发确认框。
改动：
pubspec.yaml：新增 flutter_slidable: ^3.1.0（flutter pub get 已解析）。lib/services/device_service.dart：新增 deleteDevice(String id)——POST /device/info/delete，body 为 {ids: [id]}，与分组/用户等模块的删除接口约定保持一致。lib/screens/home/device_list_page.dart：
- 列表
itemBuilder 每行用 Slidable（endActionPane + ScrollMotion）包裹，向左滑动揭示右侧红色 SlidableAction（删除图标 + t.delete 文案）；dismissible: null 表示不自动滑出删除，仅作按钮；
SlidableAction.onPressed 调用 _confirmDeleteDevice(device)：弹出 AlertDialog（标题 确认删除 / 内容 是否确认删除该设备（设备名/MAC）？，取消/删除按钮）；
- 取消 → 返回
false，行回弹保留；
- 确认 → 先入
_pendingDeleteIds 本地隐藏该行（避免抖动），再调 deleteDevice，成功 ref.invalidate(devicesByStoreProvider) + SnackBar 已删除，真正由列表刷新移除；异常则移出 _pendingDeleteIds 恢复显示并 SnackBar 删除失败：{原因}；
- 新增
_rowKey(Device)：${id 或空}__${mac} 作为行唯一键，避免 device.id 为空时 ValueKey('') 重复触发 Flutter 断言崩溃；_filter 与 _pendingDeleteIds 均改用该键。
| 类型 |
模块 |
内容 |
| ✅ 新增 |
依赖 |
pubspec.yaml：flutter_slidable: ^3.1.0 |
| ✅ 新增 |
设备服务 |
lib/services/device_service.dart：deleteDevice(id) 调 POST /device/info/delete，body {ids:[id]} |
| ✅ 新增 |
设备列表 |
lib/screens/home/device_list_page.dart：每行 Slidable（startToEnd）露可点击红色「删除」按钮，点击才弹确认框；确认删除、取消保留；删除中本地隐藏防抖、失败回滚并提示；_rowKey 防空 id 重复键 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix66 → v6-fix67 |
v6-fix66（2026-08-31）
修复 Web 端删除设备后，手机端设备列表仍显示已删除设备的问题。
用户反馈：在 Web 后台删除设备后，手机端设备列表未同步，仍显示该设备 MAC（如截图中 08:C3:ED:64:16:72）。
根因：设备列表页使用 devicesByStoreProvider（Riverpod FutureProvider.family）做缓存，但只在「下拉刷新」「切换门店筛选」「扫码成功」三种场景下刷新；日常从 Web 端删除设备后，手机端没有自动刷新机制，因此一直展示旧缓存。
改动：
lib/screens/home/device_list_page.dart：
_DeviceListPageState 混入 WidgetsBindingObserver，在 initState/dispose 中注册/注销生命周期监听；- 新增
didChangeAppLifecycleState 处理：应用从后台切回前台（AppLifecycleState.resumed）且跳过首次启动事件后，调用 ref.invalidate(devicesByStoreProvider) 失效所有门店筛选参数下的设备列表缓存，并静默刷新门店列表，使手机端与 Web 端数据同步；
- 合并原有的
dispose 方法，确保 removeObserver 与控制器释放同时执行。
lib/screens/device/device_scan_page.dart：
- 将扫码查询命中后端设备、扫码绑定/激活成功后的
ref.invalidate(devicesProvider) 改为 ref.invalidate(devicesByStoreProvider)，失效门店筛选 Provider 族（而不是只失效无参数的 devicesProvider），确保返回列表页时看到最新数据。
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
设备列表 |
lib/screens/home/device_list_page.dart：App 切回前台自动刷新设备/门店列表，同步 Web 端变更 |
| ✅ 已修复 |
扫码页 |
lib/screens/device/device_scan_page.dart：扫码成功后失效 devicesByStoreProvider 全族，而非仅 devicesProvider |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix65 → v6-fix66 |
v6-fix65（2026-08-31）
扫码绑定流程改造：扫码成功后改为页面内表单（门店分组下拉 + 房号输入），替代原先分步弹窗。
新增需求：扫码成功后，在页面上直接提供「门店分组」选择控件（从分组列表选取）与「房号」输入框，并明确两者的校验规则，保证移动端布局清晰、操作便捷。
改动：lib/screens/device/device_scan_page.dart
- 移除原
_confirmBind / _pickGroup / _pickStore 三步弹窗流程。
- 新增
_enterBindForm：扫码识别 MAC 后进入表单态，停止相机预览；
- 激活模式（无预填门店）：加载门店下拉，选择门店后级联加载其分组；
- 绑定模式（路由已预填门店）：门店固定展示，直接加载分组。
- 新增
_buildBindForm（SingleChildScrollView + Card）：已识别设备 MAC 卡片、门店分组 DropdownButtonFormField、房号 TextFormField、提交/重新扫码按钮；分组加载中显示进度。
- 校验规则（
_validateForm）：
- 门店：仅激活模式必填（未选门店 →
请先选择门店）；
- 门店分组：必填（未选 →
请选择门店分组；门店无分组 → 该门店暂无设备分组…）；
- 房号：必填且格式校验（非空、长度 1~20、仅含中英文/数字/连字符/斜杠，否则
房号格式不正确…）；错误信息以输入框 errorText 实时回显。
_submitBind 校验通过调 DeviceService().activateDeviceByScan(mac, storeId, groupId, roomNo)（后端 roomNo 字段已支持），写本地绑定缓存并 ref.invalidate(devicesProvider)，成功 SnackBar 后 context.pop()；登录失效仍兜底跳 /login。- i18n（
lib/utils/i10n.dart）新增 scanGroupLabel / scanStoreRequired / scanGroupRequired / scanRoomRequired / scanRoomInvalid / scanRoomHint / scanRescan / scanFormInvalid / scanFormDeviceTitle。
| 类型 |
模块 |
内容 |
| ✅ 新增 |
扫码页 |
页面内绑定表单：门店分组下拉 + 房号输入 + 实时校验 + 提交/重扫 |
| ✅ 已删除 |
扫码页 |
移除 _confirmBind / _pickGroup / _pickStore 分步弹窗 |
| ✅ 新增 |
i18n |
表单相关中文/英文文案 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix64 → v6-fix65 |
v6-fix60（2026-08-31）
修复设备详情页在线状态与 Web 端不一致的问题。
用户截图：手机端设备详情页状态显示「离线」，但 Web 端同一设备显示「在线」。根因：移动端详情接口 /device/info/info/{id} 返回的 status/lastSyncTime 滞后于列表接口 /device/info/list；Web 端设备列表正是走列表接口并显示最新在线状态。修复后详情页先用 ID 取详情，再用设备 MAC 从列表接口拉一次最新状态并合并，保证手机端详情与 Web 端列表/心跳一致。
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
设备模型 |
lib/models/device.dart：新增 copyWith 方法；lastSyncTime 解析兼容 heartbeatTime / heartbeat_time / lastHeartbeat / last_heartbeat 等 Web 端心跳命名字段 |
| ✅ 已修复 |
设备服务 |
lib/services/device_service.dart：fetchDeviceById 在拿到详情后调用 _mergeWithFreshListStatus：用 detail.mac 调 /device/info/list?mac=...&limit=1 取最新状态，合并 status 与 lastSyncTime；列表接口失败时不阻断详情展示 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix59 → v6-fix60 |
v6-fix61（2026-08-31）
修复「设备列表页扫码时弹出『查询失败：登录已过期，请重新登录』」的体验问题。
用户操作：设备列表页右上角二维码（mode=query 扫码查设备，注意：真正「激活」是底部 + 按钮 mode=bind&activate=1）→ 触发 _queryDevice 读取 devicesProvider.future（GET /device/info/list）。当 token 过期：拦截器 ApiInterceptor.onResponse 识别到 code==401 或「token失效/登录」类文案 → 调 _refreshAndRetry 自动刷新令牌并重试一次；若刷新令牌也失败（refreshToken 失效），则 _notifyUnauthorized() 清空令牌并触发 authProvider.onUnauthorized 回调 → 路由 redirect 自动跳 /login。问题是拦截器最终 handler.reject(ApiException(401,'登录已过期，请重新登录'))，该异常冒泡到扫码页 catch，被 formatApiError 取出后以「查询失败：登录已过期，请重新登录」SnackBar 暴露给用户，与登录页跳转形成竞态/困惑。
修复：新增 isUnauthorizedError() 统一识别登录失效异常；扫码页 4 个 catch（查设备 / 激活绑定 / 加载门店 / 加载分组）在捕获到登录失效时不再展示底层错误，直接 context.go('/login') 兜底跳转（与拦截器已触发的路由重定向一致）。自动刷新令牌能力保持不变（首次 401 静默重试成功则用户无感）。
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
网络层 |
lib/services/api_client.dart：新增顶层 isUnauthorizedError(Object?)，识别 ApiException(401) 或含「登录已过期」文案的登录失效异常，供 UI 层复用 |
| ✅ 已修复 |
扫码页 |
lib/screens/device/device_scan_page.dart：_queryDevice / _confirmBind / _pickGroup / _pickStore 四处 catch 增加登录失效判断——命中时跳过错误 SnackBar、改为 context.go('/login') 引导重新登录 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix60 → v6-fix61 |
v6-fix64（2026-08-31）
设备列表页登录过期错误提示与扫码页保持一致。
之前设备列表页加载失败时，若遇登录过期，会整屏显示「设备列表加载失败：登录已过期，请重新登录」+ 重试按钮（仍用 error.toString() 暴露底层异常）。拦截器已通过 _notifyUnauthorized 清空令牌并触发路由 redirect 跳 /login，此处应与之对齐——不再展示底层错误。
改动：lib/screens/home/device_list_page.dart 的 devicesAsync.when(error:) 分支：
- 命中登录失效（
isUnauthorizedError）时不再展示错误文案与重试按钮，改为显示加载占位（路由重定向会接管跳登录页）；
- 其他错误改用
formatApiError(error) 输出友好文案（不再直接 error.toString()）。
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
设备列表 |
lib/screens/home/device_list_page.dart：error 分支登录失效走加载占位、其余错误用 formatApiError；补充 api_client.dart 导入 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix63 → v6-fix64 |
v6-fix63（2026-08-31）
精简设置页与设备列表页：移除运行环境切换、显示运行指标开关及设备列表右上角二维码按钮。
用户反馈（截图）：设置页中「运行环境」与「显示运行指标」两项不需要继续展示，要求直接删掉；设备列表页右上角二维码按钮也直接删掉。
改动：
lib/screens/profile/settings_page.dart：
- 移除「运行环境」
_AppSettingsTile（含测试/预发切换、AppConfig.switchEnvironment、ApiClient.instance.reconfigure 等逻辑）。
- 移除「显示运行指标」
SwitchListTile 及其对应的 showRuntimeMetricsProvider watch。
- 删除不再使用的导入：
metrics_visibility_provider、app_config、environment、staging_config、test_config；删除不再使用的 _envLabel 私有方法。
lib/screens/home/device_list_page.dart：移除 AppBar actions 中的二维码 IconButton（mode=query 扫码入口）。底部的「扫码激活」浮动按钮（mode=bind&activate=1）保留。
| 类型 |
模块 |
内容 |
| ✅ 已删除 |
设置页 |
lib/screens/profile/settings_page.dart：删除运行环境切换与显示运行指标开关 |
| ✅ 已删除 |
设备列表 |
lib/screens/home/device_list_page.dart：删除 AppBar 右上角二维码按钮 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix62 → v6-fix63 |
v6-fix62（2026-08-31）
修复扫码查询「未找到设备。请确认二维码内容」且无法识别/连接设备的问题，并优化错误提示。
用户反馈：设备列表页右上角扫码后弹「未找到设备。请确认二维码内容」，未能跳转到对应设备。
根因：device_scan_page.dart 的 _queryDevice（query 模式）把扫码 原始字符串 直接与 device.mac/deviceSn/id 做小写等值比较，但 bind 模式会用 _extractMacFromPayload 解析 JSON（{"mac":"..."}）或归一化 MAC。因此当二维码是 {"mac":"..."} JSON，或 MAC 分隔符/大小写与设备记录不一致时，query 模式永远匹配不到 → 误报「未找到设备」。此外原提示「请确认二维码内容」过于笼统，对「二维码有效但设备尚未联网/同步」的场景没有引导。
修复：
- query 模式新增
_parseScanPayload：解析纯 MAC（兼容 :/-/无分隔）与 JSON（mac/id/sn/deviceUid 等字段），并用 _normalizeMac 归一化比较，忽略分隔符与大小写差异。
- 本地列表未命中时，按 MAC/SN 调后端
/device/info/list 兜底查询，覆盖「设备已激活但本地缓存尚未刷新」的场景，命中即刷新列表并跳转详情。
- 错误提示分级：二维码无法识别（非 MAC 也非含标识的 JSON）→ 「无法识别该二维码，请扫描设备二维码或确认二维码内容」；二维码有效但设备暂未就绪 → 「未找到对应设备（MAC）。设备可能尚未联网或同步，请确认设备已开机联网、已激活并归属当前账号后重试」。
- 登录失效（401）仍按既有逻辑兜底跳登录页。
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
扫码页 |
lib/screens/device/device_scan_page.dart：_queryDevice 改为先解析 payload（MAC/JSON）、归一化 MAC 比较；本地未命中时按 MAC/SN 后端兜底查询并跳转详情 |
| ✅ 已修复 |
扫码页 |
新增静态 _parseScanPayload（兼容纯 MAC 与 JSON）与 _normalizeMac（去分隔符转大写） |
| ✅ 已优化 |
文案 |
lib/utils/i10n.dart：新增 scanPayloadUnrecognized（无法识别二维码）、scanDeviceNotReady(identifier)（设备暂未就绪引导）；原 scanDeviceNotFound 不再使用 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix61 → v6-fix62 |
v6-fix59（2026-08-28）
修复环境切换后再操作导致的 LateInitializationError。
用户截图显示报错：LateInitializationError: Field '_dio' has already been initialized.，调用栈指向 ApiClient.reconfigure → SettingsPage 的环境切换 SegmentedButton。根因：ApiClient._dio 声明为 late final，reconfigure() 重复调用时会二次赋值，触发 LateInitializationError。修复后支持重复重建，并在环境/语言切换入口增加 try-catch，避免崩溃。
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
网络层 |
lib/services/api_client.dart：ApiClient._dio 由 late final 改为 late，reconfigure() 改为返回 ({bool success, String? error})，允许安全重复调用，内部捕获异常避免抛崩溃 |
| ✅ 已修复 |
设置页 |
lib/screens/profile/settings_page.dart：环境切换 closure 加 try-catch，先切换环境、重建 Dio、提示「环境已切换，请重新登录」、再 logout；失败时 SnackBar 提示错误。语言切换也加 try-catch 防御 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix58 → v6-fix59 |
v6-fix58（2026-08-28）
移除登录页副标题「设备与系统运维监控」。
用户截图显示登录页标题「云定制主页管理」下方仍显示「设备与系统运维监控」一行副标题文字，需移除该文本及相关 UI 元素，保持页面其余布局与功能不受影响。
| 类型 |
模块 |
内容 |
| ✅ 已移除 |
登录页 |
lib/screens/login/login_page.dart 删除副标题 Text('设备与系统运维监控') 及其上方的 SizedBox(height: 8)，登录页不再展示该文字 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix57 → v6-fix58 |
v6-fix57（2026-08-28）
优化 App「用户管理-新增用户」交互（依据 MuMu 录屏 云定制主页管理(5).mp4）。
打开新增/编辑用户弹窗时，系统默认先弹出「所属组织」选择界面，打断了先填表单（用户名/账号/密码等）的正常流程。调整为：组织选择置于表单填写完成之后，仅用户主动点击「所属组织」字段才展开。
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
用户管理-新增/编辑用户 |
lib/screens/admin/sys/user_page.dart 的 _UserForm 中 OrgPickerFormField 显式设置 autoOpen: false，打开用户表单不再自动弹出组织选择器，需先填完必填信息、再主动点击字段触发 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix56 → v6-fix57 |
v6-fix56（2026-08-28）
修复 App 组织选择器交互问题（依据 MuMu 录屏 云定制主页管理(2)(3)(4).mp4）。
视频2/3：门店管理 → 点击编辑门店时，「所属组织」选择器在表单打开后自动弹出，影响操作流程。视频4：用户管理 → 编辑用户 → 点击「所属组织」选择器后，列表未将当前已选组织置顶，导致需滑动查找。
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
门店编辑页 |
lib/screens/store/store_list_page.dart 中 _StoreFormSheet 的 OrgPickerFormField 显式设置 autoOpen: false，进入编辑/新增表单时不再自动弹出组织选择器，仅用户主动点击字段时才展开 |
| ✅ 已修复 |
组织选择器 |
lib/widgets/org_picker_sheet.dart 中 OrgPickerSheet 在过滤后把当前 _selectedId 对应的选项置顶到列表最前面，保持其他项原有层级顺序；搜索关键字为空时当前选择一目了然，搜索时仍按名称过滤 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix55 → v6-fix56 |
v6-fix55（2026-08-27）
用户纠正：v6-fix54 后加的"服务器地址"自由输入设置实为一条可切生产的入口（可手填生产 IP 58.220.83.58），违反"仅测试环境"要求。本版本移除该入口，改为"强制防生产切换"机制：默认锁定测试环境，永不可进入生产模式。
| 类型 |
模块 |
内容 |
| ✅ 已重构 |
环境配置 |
新增 lib/config/ 模块：AppEnvironment 枚举（仅 test / staging，刻意不含 production）、TestConfig / StagingConfig（测试/预发敏感配置分文件独立管理，禁止交叉引用生产）、AppConfig（按当前环境解析 origin/前缀/验证码开关，默认 test）、ProductionGuard（启动期强制守卫） |
| ✅ 已移除 |
可切生产入口 |
删除 lib/utils/server_config.dart 及设置页"服务器地址"自由输入对话框（原可手填任意 URL 含生产 IP）；所有网络层（api_client / auth_service / marquee_web_source）改为读 AppConfig 当前环境地址 |
| ✅ 已新增 |
启动守卫 |
main.dart 启动即调用 ProductionGuard.enforce()：① 编译期 assert(!kAllowProduction)（kAllowProduction 恒 false）；② 运行期解析当前后端 host，若命中生产拒绝名单（58.220.83.58 / api.ainetv.com / ainetv.com 或含 prod）则 print 清晰报错并 exit(1) 阻断启动，确保系统无法进入生产模式 |
| ✅ 已新增 |
环境切换函数 |
AppConfig.switchEnvironment(AppEnvironment) 仅接受预定义 test / staging 枚举值，显式排除 production，禁止解析/接收任何生产标识字符串；设置页仅提供 TEST/预发 分段切换（无生产按钮） |
| ✅ 已清理 |
常量 |
AppConstants 移除 apiBaseUrl / apiFullBaseUrl / enableCaptcha（原注释含生产 IP 兜底），仅保留 apiPrefix；默认配置不再含任何生产默认值/兜底/隐式生产配置 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix54 → v6-fix55 |
| ✅ 已验证 |
构建 |
flutter analyze 0 error；release APK ops-console-release-v6-fix55.apk（33.9MB）验鲜：v6-fix55=1、ProductionGuard=1、默认 origin=ips-test.ainetv.com（测试）；prod-ip 仅出现在守卫拒绝名单中，非活动端点 |
v6-fix54（2026-08-27）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
Web-公司介绍内容展示 |
修复 Web 端「公司介绍」选中大类后右侧小类列表偶发"暂无数据"的问题：parseIntroSubcategoryList / parseIntroDetailList 现在兼容后端 {data: [...]} 与 {data: {list, totalCount}} 两种返回；loadChildren 始终以当前 treeData 重新定位节点，避免 selectedNode 引用过期，并在 API 解析为空时使用树节点已携带的完整小类数据兜底展示 |
| ✅ 已优化 |
App-公司介绍数据加载 |
门店内容页加载大类由 getIntroCategoryAll() + 客户端过滤改为 getIntroCategoryList(page, limit, orgId) 服务端过滤，与 Web 端 store-company-intro.vue 的查询方式完全一致，避免门店权限/分页差异导致数据不一致 |
| ✅ 已优化 |
App-公司介绍保存字段 |
小类表单的 categoryType 预填父大类值；保存时若为空则不下发，与 Web 端保存行为对齐，避免空字符串覆盖后端默认值 |
| ✅ 已调整 |
文案 |
移除代码注释中的"门店维度"表述；管理首页入口、页面标题继续使用 companyIntro/introCategoryTitle（即"公司介绍"） |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix53 → v6-fix54 |
v6-fix53（2026-08-27）
| 类型 |
模块 |
内容 |
| ✅ 已重构 |
公司介绍-门店维度 |
将公司介绍入口从「大类→小类→详情」三级结构改为「门店维度」展示：新增 IntroStoreListPage 门店列表页（参考门店管理页布局，支持关键字搜索门店），点击进入 IntroStoreContentPage 门店介绍内容页 |
| ✅ 已新增 |
公司介绍-门店介绍内容页 |
按门店加载其下所有公司介绍大类，并按 categoryType 内容类型分组呈现；每个分类可展开查看小类，每个小类可展开查看详情内容；数据层级：门店 → 内容类型 → 分类 → 小类 → 详情 |
| ✅ 已保留 |
公司介绍-原管理入口 |
原 /admin/intro/category 三级管理页保留，可作为后台管理备用入口；管理首页公司介绍入口改为 /admin/intro/store-list |
| ✅ 已新增 |
公司介绍-快捷操作 |
门店内容页支持直接在分类/小类/详情层级新增、编辑、删除；新增分类时自动带入当前门店 orgId |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix52 → v6-fix53 |
v6-fix52（2026-08-27）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
公司介绍-小类/详情图片上传 |
根因：原 UploadService.uploadImage 走 POST /sys/upload 通用本地上传，与公司介绍模块（Web 端 company-intro-subcategory-form.vue）使用的腾讯云 COS STS 直传通道不一致，导致上传失败、无法保存。现改为对齐 Web 流程：计算文件 MD5 → GET /theme/resource/check-md5 秒传判断 → GET /theme/upload/credential 取 STS 临时凭证（bucket/region/key）→ 用临时密钥直传 COS（putObject，原生 q-sign-algorithm=sha1 签名）→ POST /theme/resource/register 注册 tv_resource → 返回 https://ipscdn.ainetv.cn/{key} 访问地址 |
| ✅ 已新增 |
依赖 |
新增 crypto（文件 MD5）；腾讯云 COS 直传客户端 vendoring 到 lib/services/cos/cos_client.dart（基于 flutter_cos_client MIT 实现，修复签名有效期硬性 now+3600 与后端 STS ExpiredTime 冲突导致的 403，去掉未维护 0.0.1 包依赖与 mime 依赖） |
| ✅ 已完善 |
错误提示 |
上传各阶段（凭证不完整 / 云存储失败 / 资源注册失败）统一抛出 ApiException，message 为可展示中文；前端 catch 已能显示 e.message，便于定位失败原因 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix51 → v6-fix52 |
v6-fix51（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
公司介绍-新增/修改 |
修复「保存失败」提示不展示后端真实原因的问题：拦截器返回的是 DioException（其 .error 才是 ApiException），原代码 e is ApiException ? e.message : t.saveFailed 永远走兜底，导致只能看到「保存失败」。三个表单（大类/小类/详情）的保存与删除异常提示统一改为 formatApiError(e)，可正确显示后端 msg |
| ✅ 已修复 |
公司介绍-新增大类 |
与 Web 前端字段对齐：saveIntroCategory 请求体移除后端未使用的 orgName；orgId 在发送前 int.tryParse 转为数字，与 Web 一致 |
| ✅ 已新增 |
公司介绍-表单校验 |
新增大类/小类/详情保存前进行客户端校验：名称/标题/类型编码/媒体地址非空；类型编码禁止中文。减少无效请求，错误反馈更即时 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix50 → v6-fix51 |
v6-fix50（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
网络层（写操作失败） |
api_client.dart 的 ApiInterceptor.onRequest 不再给 POST/PUT 等业务 body 注入防缓存字段 t：此前该字段会作为未知列进入后端 insert，导致「列表能读、新增/修改 500 失败」。防缓存 t 仅在 GET 的 query 上保留；写入请求 body 保持纯净 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix49 → v6-fix50 |
v6-fix49（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已更新 |
后端环境切换 |
constants.dart 的 apiBaseUrl 由生产环境 http://58.220.83.58 切回测试环境 https://ips-test.ainetv.com（HTTPS）；生产地址保留为注释便于后续切回 |
| ✅ 已恢复 |
登录验证码 |
enableCaptcha 由 false 恢复为 true：测试环境 ips-test.ainetv.com 提供 /api/captcha.jpg（HTTP 200），登录页重新显示验证码输入与刷新 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix48 → v6-fix49 |
v6-fix48（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已更新 |
桌面/启动图标 |
将 com_ainetv_ainetvcloud_xxxhdpi_640dpi_云管理.png 生成并覆盖 Android 5 个密度（mdpi/hdpi/xhdpi/xxhdpi/xxxhdpi）的 mipmap-*/ic_launcher.png |
| ✅ 已更新 |
登录页 logo |
登录页继续使用 assets/images/logo.png，已同步替换为同一源图 |
| ✅ 已更新 |
应用内图标 |
设置页「关于」弹窗新增 applicationIcon，统一使用 assets/images/logo.png（64×64 显示） |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix47 → v6-fix48 |
v6-fix47（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
登录页 logo |
将顶部蓝色 Icons.monitor_heart 图标替换为橙色云朵 logo 图片（assets/images/logo.png，文字已改为「云管理」，保留底部「ainetv」） |
| ✅ 已修复 |
验证码加载失败 |
新增 AppConstants.enableCaptcha 开关（默认 false）：关闭时隐藏验证码输入区与刷新按钮，登录时 captcha/uuid 传空串，避免生产环境 58.220.83.58 未暴露 /api/captcha.jpg 导致登录页报错 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix46 → v6-fix47 |
v6-fix46（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已更新 |
后端环境切换 |
constants.dart 的 apiBaseUrl 由测试环境 https://ips-test.ainetv.com 切换为生产环境 http://58.220.83.58（明文 HTTP，Android 已开启 usesCleartextTraffic）；测试地址保留为注释便于回退 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix45 → v6-fix46 |
v6-fix45（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
手机端全屏显示 |
修复应用在手机上未全屏、四周出现黑边的问题：main.dart 启动时设置 SystemUiMode.edgeToEdge + 透明状态栏/导航栏；styles.xml / styles-night.xml 的 NormalTheme 启用 windowDrawsSystemBarBackgrounds 并将状态栏/导航栏颜色设为透明 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix44 → v6-fix45 |
v6-fix44（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已移除 |
公司介绍门店筛选 |
移除大类列表顶部「筛选门店」FilterChip 区域（含「全部门店」多选），保留大类/小类/详情三级列表、表单、树形组织选择器、图片/视频上传等其余所有功能与布局 |
| ✅ 已清理 |
冗余代码 |
移除 _stores、_selectedOrgIds、_loadStores、_applyOrgFilter、_buildOrgFilter 及 StoreInfo import；_storeName 改为仅从组织树回查；initState 改调用 _loadOrgNodes() 以支持列表门店名称回显 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix43 → v6-fix44 |
v6-fix43（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已调整 |
公司介绍门店选择器节点规则 |
树形组织选择器仅展示渠道（type=1）、代理商（type=2）与门店（type=3）；渠道与代理商节点 selectable=false（禁用、灰色、不可点击）；门店节点保持可选；平台（type=0）与设备分组（type=4）不展示 |
| ✅ 已新增 |
节点选择工具方法 |
新增 _isOrgVisible、_isOrgSelectable，统一控制选择器内组织节点的展示与可选状态 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix42 → v6-fix43 |
v6-fix42（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已改造 |
公司介绍大类门店选择器 |
「所属门店」从 DropdownButtonFormField 改为与用户管理一致的树形组织选择器：底部弹窗、实时搜索组织名称、按组织层级缩进展示；复用 OrgPickerSheet/OrgPickerFormField 组件，数据走 OrgService.getOrgTree()（组织树 / flatList / select 三阶回退） |
| ✅ 已实现 |
编辑态自动高亮当前节点 |
编辑大类时 OrgPickerFormField 自动展开选择器，并默认选中高亮当前 orgId 对应的门店组织节点；若当前 category 所属组织不在用户可见树中，自动补入选项保证可展示 |
| ✅ 已新增 |
组织树工具方法 |
intro_category_page 新增 _loadOrgNodes、_buildOrgPickerOptions、_buildHierarchicalOptions、_buildHierarchyFromFlatList、_findOrgByName、_findOrgById，与用户管理 _UserForm 对齐 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix41 → v6-fix42 |
v6-fix41（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
公司介绍大类门店选择 |
修复新增/编辑大类时「所属门店」下拉为空、无法选择门店的问题：intro_category_page._loadStores 改用 OrgService.getMyStores()（组织树 / myStores / listByLoginOrg 三阶回退），覆盖当前用户可见的所有门店；表单打开前强制重新加载门店；编辑时若当前 category 所属门店不在返回列表中，自动补入下拉项；空字符串 orgId 统一视为未选择，避免收起态显示空白 |
| ✅ 已新增 |
国际化 |
i10n.dart 新增 introStoreLoadFailed（门店列表加载失败提示）中英 key |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix40 → v6-fix41 |
v6-fix38（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
公司介绍多门店筛选 |
大类列表页门店筛选由单选下拉改为 FilterChip 多选，空选表示「全部门店」，数据按所选门店列表实时过滤 |
| ✅ 已实现 |
公司介绍图片上传 |
新增 UploadService，小类/详情表单支持从相册选择图片、本地即时预览、Dio FormData 上传至 /sys/upload，成功后自动回填 mediaUrl 并切换为网络预览；保留手动输入 mediaUrl 兜底 |
| ✅ 已对齐 |
大类表单 |
新增「所属门店」必填下拉（orgId/orgName 联动）；移除 Web 后台不存在的 status 字段，保存字段与 Web 端一致 |
| ✅ 已对齐 |
小类/详情表单 |
新增「排序号」字段；status 语义与 Web 后台统一为 1=启用/0=禁用；小类新增可选「类型编码」字段（默认预填父大类编码） |
| ✅ 已改造 |
保存接口分流 |
IntroService 三个 save* 方法按 id 是否存在分流到 /save（新增）或 /update（编辑），与 Web 端 companyIntro.ts 保持一致 |
| ✅ 已修正 |
状态语义 |
IntroCategory/IntroSubcategory/IntroDetail 的 _parseStatus 改为后端原值映射（1=启用，0=禁用），列表 Chip 文案同步改为「启用/禁用」 |
| ✅ 已新增 |
国际化 |
i10n.dart 补充 introFilterStores、introSelectStoresHint、introCategoryStore、introStoreRequired、introSortOrder、introEnabled、introDisabled、introUploadImage、introPickImage、introImagePreview、introUploading、introUploadFailed、introInsertImage 中英 key |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix37 → v6-fix38 |
v6-fix40（2026-08-26）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
滚动字幕速度档位化 |
数字速度输入改为 5 档下拉选择（慢/较慢/中/较快/快），新增 MarqueeConfig/MarqueeSpeed 配置结构，提供 setSpeed/setGrade/copyWith 接口与 speedFromValue/gradeFromValue 历史值吸附；落库仍为 Web 端原值（200/100/50/30/10），卡片与表单直观显示当前生效档位 |
| ✅ 已实现 |
滚动字幕级别选择 |
新增 3 级「级别」下拉（危险/紧急/普通），落库原值（50/40/20），与 Web 端 scrolling-text.data.ts 一致；列表与表单显示当前生效级别 |
| ✅ 已实现 |
滚动字幕字体颜色色板 |
「字体颜色 / 背景颜色」由手动输入 #HEX 改为对齐 Web 端 el-color-picker 的色板弹窗：饱和度/明度 2D 选择区 + 色相条 + HEX 输入框 + 实时预览 + 取消/确定，回填 #RRGGBB |
| ✅ 已修复 |
公司介绍大类门店名称 |
新增/编辑大类「所属门店」选中后正确展示门店组织名称：下拉增加 selectedItemBuilder 确保收起态渲染所选名称；列表卡片在接口未返回 orgName 时按 orgId 从本地门店列表回查名称 |
| ✅ 已对齐 |
公司介绍小类图片上传 |
小类素材固定为图片（与 Web 端一致，Web 端无媒体类型选择、始终 mediaType=image）；新增图片类型（jpg/png/gif/webp）与大小（≤300KB，建议 1920×1080）校验，超限给出提示；上传仍走后端 /sys/upload，返回 URL 存入 mediaUrl |
| ✅ 已对齐 |
公司介绍详情图片/视频上传 |
详情表单保留「媒体类型」图片/视频切换；图片（≤3MB）/ 视频（≤30MB）类型与大小校验与 Web 端一致，视频走 pickVideo；上传路径与返回结构同小类 |
v6-fix39（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
滚动字幕起止时间筛选 |
「滚动字幕」新增/编辑表单的开始时间、结束时间改为纯 HH:mm:ss 滚轮选择器，不再复用日期时间选择器，与 Web 端 /theme/scrollingText 时间字段格式（HH:mm:ss）一致 |
| ✅ 已实现 |
时间滚轮控件 |
新增 _TimePickerSheet 底部弹窗：三列 ListWheelScrollView 滚轮（时 00-23 / 分 00-59 / 秒 00-59），FixedExtentScrollController 定位初始值；底部「取消/确定」按钮，确定后回传 DateTime(2000,1,1,h,m,s)，与 MarqueeMessage._parseDateTime 基准日期一致 |
| ✅ 已对齐 |
默认值与范围 |
新增字幕默认起止时间为 00:00:00 ~ 23:59:59；编辑时回显既有 startTime/endTime；秒级精度，可选范围覆盖全天，与 Web 后台一致 |
| ✅ 已新增 |
国际化 |
i10n.dart 补充 marqueeHour/marqueeMinute/marqueeSecond（时/分/秒）中英 key，供滚轮单位标签使用 |
| ✅ 已清理 |
死代码 |
移除 _TimePickerSheet._buildWheel 中的未使用 selected 局部变量，消除 analyze 警告 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix38 → v6-fix39 |
v6-fix37（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
组织选择器高亮 |
OrgPickerSheet 列表项选中时立即通过本地 _selectedId 状态更新高亮背景、文字颜色与对勾图标，并延迟 120ms 后关闭弹窗，解决选中条目需要额外按一次才显示高亮的问题 |
| ✅ 已优化 |
选择器视觉反馈 |
已选项文字加粗并显示 Icons.check_circle，高亮底色透明度由 0.24 提升至 0.38，选中状态与视觉反馈同步呈现 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix36 → v6-fix37 |
v6-fix36（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
滚动字幕数据源 |
移动端 MarqueeWebSource 默认接口由 /marquee/list 改为与 Web 后台一致的 /theme/scrollingText/list；解析 totalCount 与 Web 端字段映射（orgId→storeId、orgName→storeName、scrollSpeed→speed、bgColor→backgroundColor），解决移动端列表为空的问题 |
| ✅ 已修复 |
滚动字幕新增/编辑 |
修复 _MarqueeFormState 中 late String? _storeId 未在 initState 初始化导致的 LateInitializationError；新增「状态」下拉框（启用/禁用），表单提交携带真实状态 |
| ✅ 已改造 |
滚动字幕服务 |
MarqueeService 新增/编辑/删除/启用/禁用均优先调用 Web 后台 `/theme/scrollingText/save |
| ✅ 已优化 |
列表卡片 |
_StatusChip 改为「启用/禁用」；_MarqueeCard 操作按钮改为「启用/禁用」；时间范围展示改为 HH:mm:ss，与 Web 后台一致 |
| ✅ 已新增 |
国际化 |
i10n.dart 补充 marqueeStatus、marqueeStatusEnabled、marqueeStatusDisabled 中英 key |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix35 → v6-fix36 |
v6-fix35（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已重构 |
设备详情页 |
DeviceDetailPage 按需求分四个清晰区块：基本信息（设备名称、设备 ID、型号、状态）、配置参数（所属门店、分组、房号、位置、操作系统、设备序列号、设备 UID、创建时间）、网络信息（IP 地址、MAC 地址）、运行时数据（在线时长、最后活跃时间）；原信息卡拆分为带标题的分区块卡片，缺口字段（设备名称 / 设备 ID / 最后活跃时间）已补齐并回显 |
| ✅ 已更新 |
详情头部 |
标题由「型号」改为「设备名称」（型号降级为副标题），与列表点击进入的语义一致 |
| ✅ 已新增 |
国际化 |
i10n.dart 补充 basicInfo、configParams、networkInfo、runtimeData、deviceName、deviceId、modelLabel、deviceSnLabel、deviceUidLabel、createTime、lastActiveTime 等中英 key |
| ✅ 已保留 |
刷新同步 |
详情页下拉刷新（RefreshIndicator）刷新 deviceDetailProvider，与设备列表数据保持一致；「下发指令 / 修改分组」按钮保持可用 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix34 → v6-fix35 |
v6-fix34（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
Web 端滚动字幕数据源 |
新增 lib/services/marquee_web_source.dart 作为独立的 Web 端内容获取层；支持配置请求地址（baseUrl / path）与请求方式（GET/POST 等），内置超时、网络异常、HTTP 错误、业务码错误、解析失败等完善错误处理；将结果封装为结构化 MarqueeFetchResult |
| ✅ 已扩展 |
滚动字幕数据模型 |
MarqueeMessage 新增 fontColor、backgroundColor、fontSize、level、startTime、endTime 字段，兼容 Web 端返回的 JSON 格式 |
| ✅ 已改造 |
字幕服务 |
MarqueeService.getMarqueeList 优先调用 MarqueeWebSource 获取 Web 端数据，失败时自动回退到本地 SharedPreferences 缓存 |
| ✅ 已更新 |
UI |
MarqueeManagementPage 列表卡片展示字体颜色、背景颜色、字体大小、级别、生效时间；新增/编辑表单支持设置颜色、字号、级别与起止时间 |
| ✅ 已新增 |
国际化 |
i10n.dart 补充字体颜色、背景颜色、字体大小、级别、开始/结束时间等中英 key |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix33 → v6-fix34 |
v6-fix33（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
滚动字幕管理 |
在「管理」界面新增「滚动字幕管理」入口；新增 MarqueeManagementPage（/admin/marquee），支持按门店查看、新增、编辑、删除、查询滚动字幕，并区分不同门店内容 |
| ✅ 已实现 |
下发/取消下发 |
字幕状态区分为「待下发」与「已下发」；点击「下发」调用设备指令 marqueeUpdate 按组织下发到门店设备，成功后状态更新为已下发；点击「取消下发」重置为待下发 |
| ✅ 已新增 |
数据模型 |
lib/models/marquee_message.dart 定义滚动字幕实体；lib/services/marquee_service.dart 基于 SharedPreferences 实现字幕记录本地持久化与 CRUD，并提供下发/取消下发能力 |
| ✅ 已新增 |
国际化 |
lib/utils/i10n.dart 补充滚动字幕管理相关 key（管理标题、新增/编辑、字幕内容、滚动速度、目标门店、状态、下发/取消下发等） |
| ✅ 已更新 |
管理首页 |
lib/screens/admin/admin_hub_page.dart 增加「滚动字幕管理」入口卡片 |
| ✅ 已更新 |
路由 |
lib/app/router.dart 增加 /admin/marquee 路由 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix32 → v6-fix33 |
v6-fix32（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
激活码管理 |
英文语言下激活码管理页所有中文硬编码文案（门店选择、当前激活码、复制、最大激活数、已激活数、创建时间、生成/重置激活码、生成弹窗等）全部替换为 AppLocalizations 国际化 key，切换英文后完整显示英文 |
| ✅ 已新增 |
国际化 |
i10n.dart 补充 copy、generate、generateActivationCodeHint、activationCodeCopied、activationCodeLoadFailed、generateFailedWithError 等 key |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix31 → v6-fix32 |
v6-fix31（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
管理模块返回键 |
管理中心「设备管理」「激活码」入口原 context.push('/device') / context.push('/device/activation') 会把页面压入设备分支导航栈，导致底部导航错乱 + 左上角返回箭头显示/点击异常 → 在 /admin 分支下新增别名路由 /admin/device（复用 DeviceListPage）与 /admin/activation（复用 DeviceActivationPage），入口改为 context.push('/admin/device') / context.push('/admin/activation')；仍保留 push 方式，用户可通过系统返回键回到管理首页 |
| ✅ 已修复 |
设备列表 AppBar |
DeviceListPage 的 AppBar 增加 automaticallyImplyLeading: false，从管理模块进入时不显示左上角返回箭头（DeviceActivationPage 此前已设置，保持生效） |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix30 → v6-fix31 |
⚠️ 备注：
- 原
/device 与 /device/activation 路由保留不变（设备 tab 入口及设备详情内的跳转仍使用），本次仅新增 /admin 分支下的别名路由，无命名冲突。
v6-fix30（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
角色选择器 |
用户编辑页「角色」字段由下拉框改为可视化 ChoiceChip 横向选择器；编辑时根据 roleId/roleName/roleNames 自动选中对应角色，选中项显示主题色高亮背景 + Icons.check 勾选图标；角色来自动态 widget.roles，新增用户默认选中当前登录用户角色 |
| ✅ 已删除 |
全局返回悬浮按钮 |
移除 AppBottomNav 中的全局返回 FAB（_BackFabLocation、floatingActionButton、floatingActionButtonLocation）及 navigator_key.dart 导入；同步删除不再被引用的 lib/app/navigator_key.dart，并移除 router.dart 中的 navigatorKey 引用 |
| ✅ 已删除 |
AppBar 返回键 |
扫描 lib/screens/** 所有 AppBar，移除自定义 leading 返回按钮（device_scan/device_group/store_config 三页），并对全部子页面 AppBar 设置 automaticallyImplyLeading: false，统一移除左上角返回箭头，保留标题与 actions |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix29 → v6-fix30 |
v6-fix29（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
组织选择器 |
新建/编辑门店与用户编辑页「所属组织」字段进入页面时自动弹出选择弹窗，已选项自动高亮勾选；弹窗支持关键字实时搜索与层级缩进展示 |
| ✅ 已实现 |
返回悬浮按钮 |
在 AppBottomNav 外层 Scaffold 增加全局返回悬浮按钮（左上角、仅非首页显示），点击优先 pop，不可 pop 时回到首页 |
| ✅ 已删除 |
AppBar 返回键 |
移除「设备管理」「用户管理」「激活码」「公司介绍」四页 AppBar 左上角返回箭头，统一由全局返回悬浮按钮负责返回 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix28 → v6-fix29 |
v6-fix28（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
默认选中 |
门店编辑页与用户管理编辑页进入时，已关联的组织/角色选项自动高亮选中；用户编辑时若后端未返回 ID，通过名称反向匹配并增加只读占位项兜底展示 |
| ✅ 已修复 |
门店组织搜索 |
编辑门店「所属组织」搜索框输入关键字后，新增实时搜索结果列表；点击结果立即更新 _parentId、清空搜索关键字并刷新页面，修复「选中无反应」问题 |
| ✅ 已优化 |
门店默认上级 |
编辑门店加载组织树后，若 store.parentId 为空，自动在组织树中按 store.orgId 查找门店节点并取其 parentId 作为默认上级；新增/仍为空时回退到当前用户所在组织 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix27 → v6-fix28 |
v6-fix27（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已优化 |
门店表单 |
编辑门店「所属组织」下拉选项仅渲染渠道（type=1）与代理商（type=2），门店类型（type=3）已过滤隐藏；新增组织名称关键字搜索框，输入时实时模糊匹配并动态筛选渠道/代理组织 |
| ✅ 已优化 |
默认选中 |
新增门店时，若未指定上级组织则默认选中当前登录用户所在组织；新增用户时，默认选中当前登录用户的所属组织与角色 |
| ✅ 已更新 |
用户模型 |
User 模型新增 orgId/roleId 字段；AuthService 从登录响应与 /sys/user/info 中解析并持久化，供表单默认选中使用 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix26 → v6-fix27 |
v6-fix26（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
用户编辑 |
编辑用户时角色字段为空 → 当列表接口未返回角色信息时，自动调用 /sys/user/info/{id} 拉取详情；同时通过 roleName/roleNames 反向匹配 roleId，确保角色下拉与用户信息页/Web 端展示一致 |
| ✅ 已优化 |
用户表单 |
新增/编辑用户「所属组织」下拉改为按组织层级自上而下排序：优先调用 /sys/org/tree，递归扁平化为带深度的选项并逐层缩进展示；失败时回退到 /sys/org/flatList 并按 parentId 重建层级顺序 |
| ✅ 已修复 |
返回按钮 |
管理模块入口进入的「设备列表」「激活码管理」「用户管理」页面左上角返回箭头点击无响应 → 统一将返回目标改为 /admin，确保回到管理首页 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix25 → v6-fix26 |
v6-fix25（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已优化 |
门店表单 |
编辑门店「所属组织」下拉列表改为按组织层级自上而下排序：调用 /sys/org/tree 获取树形结构，递归扁平化为带深度的选项；列表中从最上级组织开始，逐层缩进展示其下级组织，层级关系清晰 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix24 → v6-fix25 |
v6-fix24（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
修改分组 |
分组下拉仍展示全部门店分组 → 修复 /device/group/list 接口参数：Web 端按 orgId 过滤门店，移动端此前只传 storeId 导致后端忽略门店过滤；现同时携带 orgId 与 storeId，确保仅返回当前设备所属门店的分组 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix23 → v6-fix24 |
v6-fix23（2026-08-25）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
修改分组 |
分组下拉报 DioException [unknown]: null → 改为调用已有接口 /device/group/list?storeId=xxx；同时增强 Device.storeId 解析，支持从 store/storeInfo/org 嵌套对象取门店 ID |
| ✅ 已修复 |
新建门店保存 |
保存仍提示「未知异常」→ _save() 先按 Web 端字段契约（type='STORE'/status='ACTIVE'）提交；失败时自动 fallback 到旧后端兼容格式（type=3/status=1），并展示后端返回的具体错误信息 |
| ✅ 已修复 |
首页快捷操作 |
「系统管理」文字/图标有误 → 改为「用户管理」并替换为 Icons.people |
| ✅ 已修复 |
返回按钮 |
管理模块下的「设备管理」「激活码」「用户管理」「公司介绍」页面左上角返回键无响应 → 统一为各页 AppBar 增加显式 leading 返回按钮（可 pop 时 pop，不可 pop 时回退到 /admin） |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix22 → v6-fix23 |
v6-fix22（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已调整 |
首页快捷操作 |
移除「媒资管理」入口；当前项目阶段暂不需要，后续如需可在 HomePage._buildDashboard 中恢复 _QuickAction(mediaManagement) |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix21 → v6-fix22 |
v6-fix21（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
修改分组 |
分组下拉改为仅展示当前设备所属门店的分组：调用门店专用接口 /sys/store/deviceGroups/{storeId}，避免 /device/group/list 跨门店返回全部分组；无门店上下文时保留「未分组」与当前分组可选 |
| ✅ 已修复 |
返回按钮 |
扫码激活页左上角返回键无响应 → AppBar 增加显式 leading 返回按钮；全面排查并把设备列表/扫码页/首页管理入口/管理中心的 context.go 改为 context.push，确保子页面返回正常；为设备分组页、门店配置页也增加显式返回兜底 |
| ✅ 已修复 |
门店保存 |
门店保存仍失败（提示「未知异常，请联系管理员」）→ 对齐 Web 端 /sys/org/saveOrUpdate 字段契约：type 改为字符串 'STORE'，新增 orderNo/status，补充 storeProfile 对象（storeName/phone/address/province/city）；移除后端不识别字段；所属组织下拉仅展示代理商（type=2），与 Web 端一致 |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix20 → v6-fix21 |
⚠️ 备注：
- 门店保存字段已按 Web 端「新增门店」payload 重构；若后端仍返回具体业务错误，弹窗会展示后端 msg，请把完整错误文字发我进一步对齐。
- 返回按钮修复后，从底部导航进入的 tab 根页（首页/设备/门店/管理/我的）仍保持
go 替换，子页面统一使用 push，返回行为与原生一致。
v6-fix20（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
新增门店 |
门店新增保存时报错 → _save() 增加「所在地区」「所属组织」必选项校验；保存失败/成功/校验失败均通过页面中央 AlertDialog 提示，避免 SnackBar 被遮挡 |
| ✅ 已优化 |
门店表单 |
新增 i18n 词条 regionRequired/parentOrgRequired；硬编码中文接入国际化 |
| ✅ 已修复 |
激活码管理 |
「重置激活码」结果提示改为页面居中 AlertDialog 展示（成功/失败均居中），替代原左下角 SnackBar |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix19 → v6-fix20 |
v6-fix19（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
设备列表 |
顶部搜索框 hint 被截断（搜索设备名称 / 房号）→ 顶部改为两行布局：第一行放门店下拉 + 型号筛选，第二行放全宽搜索框，确保 hint 完整显示；i18n searchDeviceHint 中英文词条已确认同步 |
| ✅ 已修复 |
设备详情 |
遥测字段（位置 / 操作系统 / 运行时长）全显示空或 0分 → Device.fromJson 新增详情响应兜底解包（`{device |
| ✅ 已修复 |
修改分组 |
弹窗原显示「所属分组 ID」文本输入框 → 改为 DropdownButtonFormField 分组名称下拉，进入时按设备所属门店拉取 /device/group/list，下拉显示分组名称（groupName）、提交 groupId，与 Web 端一致；无门店上下文时安全降级 |
| ✅ 已修复 |
公司介绍 |
左上角返回箭头点击无响应 → AppBar 增加显式 leading 返回按钮：context.pop() 回管理中心，内部层级逐级返回，无法 pop 时兜底跳转 /admin |
| ✅ 已修复 |
编译 |
修复 Device.fromJson 引用未定义的 _firstNum 导致的编译错误（原交付版本潜在隐患）；补充 num? _firstNum(...) 静态辅助方法 |
| ✅ 已优化 |
i18n |
新增 back（返回）、groupListLoading（加载分组列表…）等词条，弹窗内所有硬编码中文均接入 lib/utils/i10n.dart |
| ✅ 已更新 |
版本号 |
登录页底部版本号 v6-fix18 → v6-fix19 |
⚠️ 备注：
- 设备详情遥测依赖后端
/device/info/info/{id} 实际返回字段；已做 device/info/data 等多层包络与 cpu_usage/os/uptime 等常见别名兼容，若后端确无数据则统一显示「无」，不崩溃。
- 修改分组下拉依赖设备携带的门店 ID（
Device.storeId）；若该字段后端未返回，下拉仅含「未分组」与当前分组，仍可正常提交。
⏳ 待验收：4 项修复在真机/模拟器上的实际表现。
v6-fix18（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
新增门店 |
激活码改为由系统依据 web 端已有规则自动生成：移除手动输入框，保存门店后若终端数>0 自动调用 /device/activationCode/generate；每次点击「创建激活码」仅生成一个唯一码 |
| ✅ 已实现 |
门店编辑 |
编辑页直接展示「最大终端数 / 已用终端数」及当前正在使用的激活码，并提供「创建激活码」按钮 |
| ✅ 已修复 |
门店详情 |
创建时间字段空白 → StoreInfo 兼容 createTime/create_time/createdTime/createdAt/created_at 等常见别名；列表项与详情弹窗均补充展示创建时间 |
| ✅ 已修复 |
语言切换 |
切换英文后启动报错「token 失效」→ ApiInterceptor 刷新 token 成功后同步持久化到 CredentialStorage，避免语言切换/进程重启后恢复到旧令牌 |
| ✅ 已修复 |
扫码页 |
英文模式下扫码页全部文案接入 i10n，包括标题、提示、权限、弹窗、成功/失败提示等 |
| ✅ 已优化 |
门店表单 |
省市区、详细地址、联系电话、所属组织、保存/创建按钮等剩余硬编码中文全部接入 i10n |
⏳ 待验收：新增门店自动生成激活码、编辑页终端数/激活码展示、英文切换不报错、扫码页英文文案。
v6-fix17（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
设备模型 |
新增 Device.model 字段，按 model/modelName/deviceModel/productModel/productName/board/hardware/brand/deviceType/type 等常见别名解析真实型号 |
| ✅ 已修复 |
设备显示 |
DeviceListTile / DeviceDetailPage 标题统一使用 device.model，避免把 MAC 地址误当型号展示 |
| ✅ 已修复 |
型号过滤 |
设备列表「型号」筛选框改为基于 Device.model 过滤 |
| ✅ 已优化 |
降级处理 |
型号解析不到时，依次降级为 name（若 name 不是 MAC）→ deviceSn → mac；并新增 _isMacAddress 识别 MAC 格式，确保 MAC 不会混入型号展示 |
⏳ 待验收：设备标题是否显示真实型号（非 MAC）。
v6-fix16（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
设备列表 |
顶部搜索区新增「型号」输入框，按 Device.name / deviceSn 实时过滤设备列表 |
| ✅ 已优化 |
设备列表 |
Riverpod AsyncValue.when 启用 skipLoadingOnRefresh/skipLoadingOnReload，刷新/重新加载时保留已有数据，避免全屏转圈覆盖已加载项 |
| ✅ 已优化 |
设备列表 |
门店下拉已加载过门店后不再重新显示转圈；状态 Chip 颜色与 DeviceStatus 严格对应（在线绿/离线灰/告警橙） |
⏳ 待验收：型号筛选是否生效、刷新是否不再全屏转圈。
v6-fix15（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
设备列表 |
标题前增加「型号：」前缀（如「型号：rk3566_r」），并接入 i10n |
| ✅ 已修复 |
扫码页 |
移除 AppBar「相册识别」按钮，进入页面即直接调用摄像头扫描；说明当前代码无「实时截屏/摄像头」选择弹窗，若仍出现请确认版本/入口 |
| ✅ 已实现 |
新增门店 |
表单新增「终端数」与「激活码」字段；保存门店后若终端数>0，自动调用 /device/activationCode/generate 创建激活码；saveOrUpdateOrg 改为返回 orgId 供后续操作 |
⏳ 待验收：设备标题前缀、扫码页直接摄像头、新增门店激活码/终端数。
v6-fix14（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
设备列表 |
web 端有房间号但手机端显示「未设置」→ 扩大 Device.fromJson 房号字段兼容：roomNo/room/roomNumber/room_id/roomNum/roomName/houseNumber/roomCode 等常见别名 |
✅ 已验收：设备列表房号。
v6-fix13（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
门店详情 |
激活码仍显示「—」→ 改从激活码专用接口 /device/activationCode/info/{orgId} 拉取 code 字段，作为真实激活码展示；接口无值时回退门店列表里的 activationCode |
| ✅ 已修复 |
设备列表 |
副标题改为用户指定格式：门店：XXX门店 MAC：AA:BB:CC:DD:EE:FF 房号：V888（缺失项显示「未设置」） |
✅ 已验收：门店详情激活码、设备副标题格式。
v6-fix12（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
用户管理 |
角色/组织显示「未分配」→ 兼容后端嵌套对象/数组返回（roles/org/dept 等），并建立完整 orgId→name 映射 |
| ✅ 已修复 |
设备列表 |
副标题改为 MAC · 所属门店 · 房号（原为设备型号/MAC） |
| ✅ 已修复 |
门店管理 |
手机端新增/编辑门店真实上报后端（/sys/org/saveOrUpdate），不再本地占位 |
| ✅ 已修复 |
门店列表 |
按创建时间倒序，最新门店排最前面（与 web 一致） |
⏳ 待验收：用户管理角色/组织回显、新增门店 web 可见、门店列表排序。
v6-fix11（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
国际化 i18n |
设备详情、下发指令、修改分组/房号、激活码管理、用户管理、公司介绍等页面接入英文翻译 |
| ✅ 已修复 |
编译 |
修复 8 个 analyze error（i10n 重复定义、store_list 误用 t.normal/t.disabled、device_list 漏传参、user_page 漏 t 声明） |
v6-fix10（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
门店编辑-界面配置 |
按设备分组展示已启用/添加的主题（接入 /theme/page/org/{orgId}/photos，ThemeGroup→ThemePage[]） |
| ✅ 已修复 |
设备列表 |
Device.fromJson 兼容 deviceName/ipAddress/deviceIp 等字段，正确回显设备名、房号、MAC、IP |
v6-fix9（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已实现 |
国际化 i18n |
底部导航、首页、设备列表、门店列表、管理入口、设置页接入英文翻译（首批） |
v6-fix8（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
门店详情 |
联系电话/激活码/到期时间/创建时间字段空白 → 调 /sys/org/listByLoginOrg 回填 |
| ✅ 已修复 |
扫码 |
路由冲突（scan 在 :id 后导致被当 deviceId）→ 路由前置 |
| ✅ 已修复 |
管理页 |
移除「门店配置」入口（后端 /device/storeConfig/{orgId} 500） |
v6-fix7（2026-08-24）
| 类型 |
模块 |
内容 |
| ✅ 已修复 |
登录-记住密码 |
CredentialStorage 由 Directory.current（Android 不可写）迁移到 shared_preferences，记住账号密码 + 免登录恢复均生效 |
历史（本会话早段）
| 版本 |
类型 |
模块 |
内容 |
| v6-fix6 |
✅ 已修复 |
门店编辑 |
移除扫码绑定按钮/启动图Logo区块；主题皮肤改接 web 模板；所属组织下拉过滤+透传 parentId |
| v6-fix5 |
✅ 已修复 |
登录灰块 |
localizationsDelegates 漏默认 delegate 致 TextField 崩溃 → 补全三个默认 delegate |
| v6-fix3 |
✅ 已实现 |
排障 |
ErrorWidget.builder 红色错误页 + DIAG 横幅，替代 release 灰屏 |
⏳ 已知待办 / 未改项
- ❌ 门店配置 功能：后端
/device/storeConfig/{orgId} 持续 500，前端已移除入口并给友好提示，需后端修复后恢复。
- ⏳ 门店编辑「界面配置」目前为展示型（显示分组/主题/激活主题），移动端切换激活主题需后端
/theme/page/active 支持，可后续迭代。
- ⏳ 切换英文后如仍有个别深层弹窗/页面为中文，多为未接 i18n 的入口，截图可继续补。
交付物索引
| 版本 |
APK 路径 |
大小 |
| v6-fix35 |
E:/Project/ops-console/ops-console-release-v6-fix35.apk |
33.5MB |
| v6-fix34 |
E:/Project/ops-console/ops-console-release-v6-fix34.apk |
33.5MB |
| v6-fix33 |
E:/Project/ops-console/ops-console-release-v6-fix33.apk |
33.5MB |
| v6-fix32 |
E:/Project/ops-console/ops-console-release-v6-fix32.apk |
33.5MB |
| v6-fix31 |
E:/Project/ops-console/ops-console-release-v6-fix31.apk |
33.5MB |
| v6-fix30 |
E:/Project/ops-console/ops-console-release-v6-fix30.apk |
33.5MB |
| v6-fix12 |
E:/Project/ops-console/ops-console-release-v6-fix12.apk |
33.4MB |
| v6-fix11 |
E:/Project/ops-console/ops-console-release-v6-fix11.apk |
35.0MB |
| v6-fix7~10 |
E:/Project/ops-console/build/app/outputs/flutter-apk/app-release.apk |
33.x MB |
