Files
EAP_Interface_html/设置页面UI优化/Logo授权管理/implementation_plan.md
T
zhy200308 fa961c8820 feat(ui): 交付第11个收官页面【Logo授权管理】UI重构与全链路真实交互 (11/11 全量完工)
- 页面交付清单 (🎉 设置页面全部 11/11 已 100% 完工交付):
  1. 语言设置 (已完工)
  2. 版型切换 (已完工)
  3. 心率区间设置 (已完工)
  4. 自动连接配置 (已完工)
  5. 手环配置 (已完工)
  6. DFU固件升级 (已完工)
  7. 用户管理 (已完工)
  8. 设备数据库管理 (已完工)
  9. 数据上传 (已完工)
  10. 版本信息 (已完工)
  11. Logo授权管理 (本次交付·已完工·全量大圆满)
- 核心重构亮点:
  1. 采纳 Master-Detail Inset Studio 经典双栏比例 (360px 1fr);
  2. 左侧 360px 品牌控制面板集成【文本Logo / 图片Logo】分段器与当前模式说明;
  3. 右侧 1fr 建立所见即所得的【顶部栏实时效果预览】真实模拟舱;
  4. 文本模式支持 0 延迟实时打字同步回显与 10/15 字数超长校验;
  5. 图片模式支持真实选择本地 PNG/SVG 透明背景图片与预设 Logo 一键切换;
  6. 集齐 6 件套交付物 (baseline_ui.html, image.png, DESIGN_SPEC.md, implementation_plan.md, CARD 任务卡, README 更新)。
2026-08-17 18:53:51 +08:00

43 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Logo 授权管理 - 工程实施方案 (Implementation Plan)
## 1. 数据模型与接口规范 (Data Model & Schema)
```typescript
export type LogoMode = 'TEXT' | 'IMAGE';
export interface LogoAuthorizationConfig {
mode: LogoMode; // 当前生效模式
customTeamName: string; // 自定义团队文本名称 (最长 15 字符)
imageLogoUri?: string; // 自定义 Logo 图片本地/云端 URI
lastUpdated: string; // 更新时间戳
}
```
---
## 2. 状态机与双向同步流程 (State Machine & Workflow)
```mermaid
stateDiagram-v2
[*] --> LoadConfig: 读取本地 SharedPreferences / MMKV 品牌持久化配置
LoadConfig --> TextMode: 模式为 TEXT
LoadConfig --> ImageMode: 模式为 IMAGE
TextMode --> MockupSyncText: 输入框打字 / 字符计数联动
ImageMode --> MockupSyncImage: 上传图片 / 预设切换
MockupSyncText --> SaveConfig: 点击保存
MockupSyncImage --> SaveConfig: 点击保存
SaveConfig --> GlobalAppBarBroadcast: 全局 EventBus / ViewModel 广播更新系统 AppBar
```
---
## 3. 原生实施映射 (Native Implementation Mapping)
- **Android (Kotlin / Jetpack Compose)**:
- 左侧 `Card(modifier = Modifier.width(360.dp))` 包含 `SingleChoiceSegmentedButtonRow`;
- 右侧 `TopAppBar` 模拟舱使用 `SubcomposeLayout` 或 `Box`,依据 `logoMode` 动态渲染 `Text(teamName)` 或 `AsyncImage(model = logoUri)`;
- 图片选择基于 Android `ActivityResultContracts.PickVisualMedia()`。
- **Flutter**:
- `SegmentedButton<LogoMode>` 控制模式切换;
- 文本输入使用 `TextEditingController`,双向绑定 `AppBar` 预览组件。