 hailin
|
a893dbdb1b
|
feat(genex-mobile): Token 持久化 — 登录状态跨重启保持
## 核心变更
### 新增 SessionStorage (lib/core/storage/session_storage.dart)
- flutter_secure_storage 封装层
- Android: EncryptedSharedPreferences（AES-256，Android Keystore 托管密钥）
- iOS: Keychain（AccessibilityFirstUnlock）
- 存储键: genex_access_token / genex_refresh_token / genex_user_json
- API: save() / load() / updateTokens() / getRefreshToken() / clear()
### 升级 ApiClient (lib/core/network/api_client.dart)
- 新增 Dio 错误拦截器（_buildAuthInterceptor）
- 401 自动触发 Token 静默刷新，成功后无感重试原始请求
- Completer 并发锁：多个 401 同时发生只执行一次刷新，其余等待结果
- 跳过重试的端点：/auth/refresh、/auth/login、/auth/register 等
- configureAuthCallbacks()：注册 onTokenRefreshed / onSessionExpired 反向回调
### 升级 AuthService (lib/core/services/auth_service.dart)
- _setAuth()：登录/注册后 await 写入 SecureStorage
- _clearAuth()：登出/Token 过期后 await 清除 SecureStorage
- restoreSession()：App 冷启动时从 SecureStorage 恢复 Token + 注册 ApiClient 回调
- refreshToken()：主动刷新（正常由拦截器自动触发，无需手动调用）
### 升级 main.dart
- await AuthService.instance.restoreSession() 在 runApp 前执行
- initialRoute 动态判断：isLoggedIn → '/main'，否则 '/'
- 全局 NavigatorKey（_navigatorKey）挂载到 MaterialApp
- 监听 authState ValueNotifier：Token 过期后自动导航回 '/'（pushNamedAndRemoveUntil）
## 用户体验
- 登录后关闭 App 再打开：直接进主界面，无需重新登录
- Access Token 过期：ApiClient 自动静默刷新，用户无感知
- Refresh Token 过期：清除本地会话，跳回欢迎页，提示重新登录
- 主动登出：清除 SecureStorage，跳回欢迎页
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
2026-03-04 02:01:27 -08:00 |
|
hailin
|
535f53041f
|
feat(deploy): Nginx反向代理 + SSL + 前端切换域名
部署架构:
- Nginx (跳板机 14.215.128.96) → Kong (192.168.1.222:48080)
- SSL: Let's Encrypt 证书已为 api.gogenex.com 签发
- HTTP 自动 301 → HTTPS
前端 API 地址:
- genex-mobile: https://api.gogenex.com (ApiClient + UpdateService)
- miniapp: https://api.gogenex.com (development config)
- 备案完成后切回 https://api.gogenex.cn
Namecheap DNS 新增:
- admin.gogenex.com → 154.84.135.121
- ws.gogenex.com → 154.84.135.121
备注:
- gogenex.cn 的 80/443 端口被世纪互联 ISP 拦截，需完成 ICP 备案
- admin/ws 子域名的 SSL 证书待 DNS 传播后申请
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
2026-03-02 00:00:58 -08:00 |
|
hailin
|
8ed667bcf4
|
feat(联调): 前端指向远程API + 启用阿里云SMS
- genex-mobile ApiClient/UpdateService 指向 154.84.135.121:48080
- miniapp dev 环境指向 154.84.135.121:48080
- docker-compose 添加 ALIYUN SMS 环境变量透传
- auth-service 添加 @alicloud/dysmsapi20170525 等 SDK 依赖
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
2026-02-24 00:18:05 -08:00 |
|
hailin
|
184a7d16db
|
feat: 三端集成 App升级 + 内部推送 + FCM外部推送框架 (genex-mobile/admin-app/mobile)
从 rwadurian/frontend/mobile-app 移植升级系统和通知系统到 Genex 三个 Flutter 客户端，
适配目标项目轻量架构（ValueNotifier 替代 Riverpod，Dio HTTP 客户端，移除 screenutil）。
## 新增核心模块 (每个 app 13 个 Dart 文件)
### 升级系统 (core/updater/)
- UpdateService: 统一升级服务单例，支持 Google Play + 自建服务器双渠道
- VersionChecker: 版本检测器，调用 GET /api/app/version/check
- DownloadManager: APK 下载管理，支持断点续传 + SHA256 校验
- ApkInstaller: APK 安装器 (Platform Channel)
- AppMarketDetector: 应用市场来源检测
- SelfHostedUpdater: 自建服务器渠道更新对话框 (i18n 化)
- GooglePlayUpdater: Google Play 应用内更新
### 通知系统 (core/services/ + core/providers/)
- NotificationService: 通知 + 公告 API 服务
- GET /notifications, /notifications/unread-count
- PUT /notifications/:id/read
- GET /announcements, /announcements/unread-count
- PUT /announcements/:id/read, /announcements/read-all
- NotificationBadgeManager: 未读徽章管理器
- ValueNotifier<int> 驱动 UI
- 30秒定时自动刷新 + 前后台切换刷新 (WidgetsBindingObserver)
### FCM 推送框架 (core/push/)
- PushService: Firebase 推送服务框架
- Firebase 代码注释保护，无配置文件时静默跳过
- 设备 token 注册 POST /device-tokens
- 待 Firebase 配置文件就绪后取消注释即可启用
### HTTP 客户端 (core/network/)
- ApiClient: Dio 封装单例，baseUrl = https://api.gogenex.cn
## Android 原生配置 (每个 app)
- AndroidManifest.xml: 添加 REQUEST_INSTALL_PACKAGES 权限 + FileProvider
- res/xml/file_paths.xml: FileProvider 路径配置
- MainActivity.kt: APK 安装器 + 应用市场检测 MethodChannel
## UI 层改造 (每个 app)
- main.dart: 异步启动，初始化 UpdateService/PushService/NotificationBadgeManager
- MainShell: 消息 Tab 徽章改为 ValueListenableBuilder 动态未读数，进入后 3 秒检查更新
- SettingsPage: StatefulWidget 化，动态版本号 (PackageInfo)，点击版本号手动检查更新
- MessagePage: 移除 mock 数据，接入 NotificationService API，4 Tab 分类 + 下拉刷新 + 标记已读
## i18n 新增 (~35 keys/语言)
- update.*: 25 个升级相关 keys
- notification.*: 9 个通知相关 keys
- genex-mobile: 4 语言 (zh_CN/zh_TW/en/ja) 分文件
- admin-app: 3 语言 (zh_CN/en_US/ja_JP) 内联单文件
- mobile: 4 语言 (zh_CN/zh_TW/en/ja) 分文件
## 三端差异化配置
| App | MethodChannel 前缀 | applicationId |
|-----|-------------------|---------------|
| genex-mobile | cn.gogenex.consumer | cn.gogenex.consumer |
| admin-app | cn.gogenex.issuer | cn.gogenex.issuer |
| mobile | cn.gogenex.mobile | cn.gogenex.mobile |
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
2026-02-13 07:02:14 -08:00 |