# 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` 控制模式切换; - 文本输入使用 `TextEditingController`,双向绑定 `AppBar` 预览组件。