ops-console v1.0.2 (versionCode 8) 源码入库

2026-09-03 18:01:05 +08:00
commit 685fff27c8
170 changed files with 53049 additions and 0 deletions
--- a/docs/class-diagram.mermaid
+++ b/docs/class-diagram.mermaid
@@ -0,0 +1,87 @@
+classDiagram
+    class StoreInfo {
+        +String orgId
+        +String name
+        +String address
+        +String contactPhone
+        +String activationCode
+        +int status
+        +DateTime? expireTime
+        +DateTime? createTime
+        <<新增>>
+        +String? themeId
+        +String? splashUrl
+        +String? logoUrl
+        +String? provinceCode
+        +String? cityCode
+        +String? districtCode
+        +String? addressDetail
+        +StoreInfo.fromJson(Map)
+        +Map toJson()
+        +String get regionText()
+    }
+
+    class RegionNode {
+        +String code
+        +String name
+        +List~RegionNode~ sub
+        +RegionNode.fromJson(Map)
+    }
+
+    class StoreTheme {
+        <<enum>>
+        classic
+        ocean
+        forest
+        sunset
+        mono
+        +String get id
+        +String get label
+        +Color get primary
+    }
+
+    class StoreThemePresets {
+        <<const>>
+        +List~StoreTheme~ all
+        +StoreTheme? byId(String)
+    }
+
+    class RegionData {
+        -List~RegionNode~ _tree
+        +Future~void~ load()
+        +List~RegionNode~ get provinces
+        +List~RegionNode~ citiesOf(String)
+        +List~RegionNode~ districtsOf(String,String)
+        +String nameOf(String)
+        +String tryMapAddress(String)~List~String?~
+    }
+
+    class StoreLocalCache {
+        +Future~void~ saveTheme(String orgId, String themeId)
+        +Future~String?~ getTheme(String orgId)
+        +Future~void~ saveBranding(String orgId, String splashUrl, String logoUrl)
+        +Future~Map?~ getBranding(String orgId)
+        +Future~void~ saveRegion(String orgId, String p, String c, String d, String detail)
+    }
+
+    class OrgService {
+        +Future~void~ saveStore(Map)  // TODO 对接 POST /sys/store/save
+        +Future~void~ updateStore(Map) // TODO 对接 POST /sys/store/update
+        +Future~void~ setStoreTheme(String,String) // TODO POST /sys/store/theme
+        +Future~void~ setStoreBranding(String,String,String) // TODO POST /sys/store/branding
+    }
+
+    class DeviceService {
+        +Future~void~ bindDeviceByScan(String scanPayload, String storeId, String? groupId) // TODO POST /device/bind
+    }
+
+    class DeviceScanPage {
+        +String mode  // 'query' | 'bind'
+        +String? storeId
+        +String? groupId
+    }
+
+    StoreInfo "1" *-- "1" StoreTheme : themeId 关联
+    RegionData "1" *-- "0..*" RegionNode : 树
+    OrgService ..> StoreInfo : 读写
+    DeviceService ..> DeviceScanPage : 扫码结果