flu-cli-core 1.0.4 → 1.1.0

package/templates/core_files/config/app_agreement.dart.template

@@ -0,0 +1,297 @@
+import 'package:flutter/foundation.dart';
+import 'package:flutter/material.dart';
+import 'package:flutter/services.dart';
+
+import '../router/navigator_util.dart';
+import '../storage/storage_keys.dart';
+import '../storage/storage_util.dart';
+import 'agreement_document_page.dart';
+import 'app_env.dart';
+
+/// 负责在应用首次启动或协议版本变更时展示协议确认弹框。
+class AppAgreementGate extends StatefulWidget {
+  const AppAgreementGate({
+    super.key,
+    required this.child,
+  });
+
+  final Widget child;
+
+  @override
+  State<AppAgreementGate> createState() => _AppAgreementGateState();
+}
+
+class _AppAgreementGateState extends State<AppAgreementGate> {
+  bool _checked = false;
+  bool _consentChecked = false;
+  bool _hasAcceptedCurrentVersion = false;
+  bool _resolved = false;
+  bool _dialogVisible = false;
+
+  @override
+  void didChangeDependencies() {
+    super.didChangeDependencies();
+    if (_checked) return;
+    _checked = true;
+    WidgetsBinding.instance.addPostFrameCallback((_) => _showIfNeeded());
+  }
+
+  Future<void> _showIfNeeded() async {
+    if (!mounted || !EnvConfig.enableAgreementDialog) return;
+
+    final acceptedVersion =
+        StorageUtil.getString(StorageKeys.agreementAcceptedVersion) ?? '';
+    if (acceptedVersion == EnvConfig.agreementVersion) {
+      if (!mounted) return;
+      setState(() {
+        _hasAcceptedCurrentVersion = true;
+        _resolved = true;
+      });
+      return;
+    }
+
+    if (!mounted) return;
+    setState(() {
+      _resolved = true;
+    });
+
+    WidgetsBinding.instance.addPostFrameCallback((_) => _presentAgreementDialog());
+  }
+
+  Future<void> _presentAgreementDialog() async {
+    if (!mounted || _dialogVisible || _hasAcceptedCurrentVersion) return;
+
+    final dialogHostContext = NavigatorUtil.context;
+    if (dialogHostContext == null) {
+      WidgetsBinding.instance.addPostFrameCallback((_) => _presentAgreementDialog());
+      return;
+    }
+
+    _dialogVisible = true;
+    await showDialog<void>(
+      context: dialogHostContext,
+      useRootNavigator: true,
+      barrierDismissible: false,
+      builder: (dialogContext) {
+        final theme = Theme.of(dialogContext);
+        return PopScope(
+          canPop: false,
+          child: Dialog(
+            insetPadding: const EdgeInsets.symmetric(horizontal: 24, vertical: 24),
+            shape: RoundedRectangleBorder(
+              borderRadius: BorderRadius.circular(24),
+            ),
+            child: Padding(
+              padding: const EdgeInsets.fromLTRB(20, 20, 20, 16),
+              child: Column(
+                mainAxisSize: MainAxisSize.min,
+                crossAxisAlignment: CrossAxisAlignment.start,
+                children: [
+                  Row(
+                    children: [
+                      Container(
+                        width: 42,
+                        height: 42,
+                        decoration: BoxDecoration(
+                          color: theme.colorScheme.primary.withAlpha(18),
+                          borderRadius: BorderRadius.circular(14),
+                        ),
+                        child: Icon(
+                          Icons.verified_user_outlined,
+                          color: theme.colorScheme.primary,
+                        ),
+                      ),
+                      const SizedBox(width: 12),
+                      Expanded(
+                        child: Text(
+                          '服务协议与隐私保护说明',
+                          style: theme.textTheme.titleMedium?.copyWith(
+                            fontWeight: FontWeight.w700,
+                          ),
+                        ),
+                      ),
+                    ],
+                  ),
+                  const SizedBox(height: 16),
+                  Text(
+                    '欢迎使用 ${EnvConfig.appName}。为了保障你的合法权益并符合应用商店隐私合规要求，请先阅读《用户协议》和《隐私政策》。在你明确同意前，本应用不应开始处理与你授权无关的个人信息。',
+                    style: theme.textTheme.bodyMedium?.copyWith(height: 1.6),
+                  ),
+                  const SizedBox(height: 14),
+                  Container(
+                    padding: const EdgeInsets.all(14),
+                    decoration: BoxDecoration(
+                      color: theme.colorScheme.surface,
+                      borderRadius: BorderRadius.circular(16),
+                      border: Border.all(color: theme.dividerColor),
+                    ),
+                    child: Column(
+                      crossAxisAlignment: CrossAxisAlignment.start,
+                      children: [
+                        Text(
+                          '你可以查看完整文本，了解以下内容：',
+                          style: theme.textTheme.bodySmall?.copyWith(
+                            fontWeight: FontWeight.w600,
+                          ),
+                        ),
+                        const SizedBox(height: 8),
+                        Text(
+                          '1. 我们处理哪些信息及其用途\n'
+                          '2. 权限申请时机与拒绝影响\n'
+                          '3. 信息保存期限、共享规则与你的权利\n'
+                          '4. 运营主体、联系方式与协议生效日期',
+                          style: theme.textTheme.bodySmall?.copyWith(height: 1.6),
+                        ),
+                      ],
+                    ),
+                  ),
+                  const SizedBox(height: 12),
+                  Wrap(
+                    spacing: 8,
+                    runSpacing: 8,
+                    children: [
+                      OutlinedButton(
+                        onPressed: () => _openAgreementDocument(
+                          AgreementDocumentType.userAgreement,
+                        ),
+                        child: const Text('查看《用户协议》'),
+                      ),
+                      OutlinedButton(
+                        onPressed: () => _openAgreementDocument(
+                          AgreementDocumentType.privacyPolicy,
+                        ),
+                        child: const Text('查看《隐私政策》'),
+                      ),
+                    ],
+                  ),
+                  const SizedBox(height: 12),
+                  CheckboxListTile(
+                    value: _consentChecked,
+                    dense: true,
+                    contentPadding: EdgeInsets.zero,
+                    controlAffinity: ListTileControlAffinity.leading,
+                    title: Text.rich(
+                      TextSpan(
+                        style: theme.textTheme.bodySmall?.copyWith(height: 1.5),
+                        children: [
+                          const TextSpan(text: '我已阅读并同意《用户协议》与《隐私政策》，并同意 '),
+                          TextSpan(
+                            text: EnvConfig.appOperatorName,
+                            style: TextStyle(
+                              color: theme.colorScheme.primary,
+                              fontWeight: FontWeight.w600,
+                            ),
+                          ),
+                          const TextSpan(text: ' 按上述规则处理我的个人信息。'),
+                        ],
+                      ),
+                    ),
+                    onChanged: (value) {
+                      if (!mounted) return;
+                      setState(() {
+                        _consentChecked = value ?? false;
+                      });
+                    },
+                  ),
+                  const SizedBox(height: 8),
+                  SizedBox(
+                    width: double.infinity,
+                    child: FilledButton(
+                      onPressed: _consentChecked
+                          ? () => _handleAccept(dialogContext)
+                          : null,
+                      child: const Text('同意并继续'),
+                    ),
+                  ),
+                  const SizedBox(height: 8),
+                  SizedBox(
+                    width: double.infinity,
+                    child: TextButton(
+                      onPressed: _handleReject,
+                      child: const Text('暂不使用'),
+                    ),
+                  ),
+                ],
+              ),
+            ),
+          ),
+        );
+      },
+    );
+    _dialogVisible = false;
+  }
+
+  Future<void> _openAgreementDocument(AgreementDocumentType type) {
+    return NavigatorUtil.push(
+      AgreementDocumentPage(type: type),
+    );
+  }
+
+  Future<void> _handleAccept(BuildContext dialogContext) async {
+    await StorageUtil.setString(
+      StorageKeys.agreementAcceptedVersion,
+      EnvConfig.agreementVersion,
+    );
+    if (!mounted) return;
+    setState(() {
+      _hasAcceptedCurrentVersion = true;
+      _consentChecked = false;
+      _resolved = true;
+    });
+    if (dialogContext.mounted) {
+      Navigator.of(dialogContext).pop();
+    }
+  }
+
+  void _handleReject() {
+    if (kIsWeb) {
+      if (!mounted) return;
+      setState(() {
+        _hasAcceptedCurrentVersion = false;
+      });
+      return;
+    }
+    SystemNavigator.pop();
+  }
+
+  Widget _buildBlockedShell(BuildContext context) {
+    final theme = Theme.of(context);
+    return ColoredBox(
+      color: theme.scaffoldBackgroundColor,
+      child: Center(
+        child: Padding(
+          padding: const EdgeInsets.symmetric(horizontal: 32),
+          child: Column(
+            mainAxisSize: MainAxisSize.min,
+            children: [
+              const SizedBox(
+                width: 32,
+                height: 32,
+                child: CircularProgressIndicator(strokeWidth: 3),
+              ),
+              const SizedBox(height: 16),
+              Text(
+                _resolved ? '等待用户阅读并确认协议...' : '正在准备协议说明...',
+                textAlign: TextAlign.center,
+                style: theme.textTheme.bodyMedium,
+              ),
+            ],
+          ),
+        ),
+      ),
+    );
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    if (!EnvConfig.enableAgreementDialog) return widget.child;
+    if (_hasAcceptedCurrentVersion) return widget.child;
+    return Stack(
+      fit: StackFit.expand,
+      children: [
+        widget.child,
+        _buildBlockedShell(context),
+      ],
+    );
+  }
+}

package/templates/core_files/config/app_config.dart.template

@@ -2,20 +2,20 @@ import 'package:flutter/foundation.dart';
 
 import '../storage/storage_keys.dart';
 import '../storage/storage_util.dart';
+import 'app_env.dart';
 
-/// 应用常量
+/// 应用常量（不随环境变化的固定值）
 class AppConstants {
   AppConstants._();
 
-  static const String appName = '火叶';
-  static const String appVersion = '1.0.0';
+  /// 应用名称 (便捷访问)
+  static String get appName => EnvConfig.appName;
+  static String get appVersion => EnvConfig.appVersion;
 
-  /// 免责声明
-  static const String disclaimer =
-      '本应用仅供学习交流使用，API 数据由第三方提供，本应用不保证数据的准确性、完整性及安全性。如有侵权，请联系删除。';
-
-  /// 国内可直接访问的 API 地址 (示例使用 图虫API)
-  static const String apiBaseUrl = 'https://api.tuchong.com';
+  /// API 基础地址。
+  ///
+  /// 默认值仅作为占位，真实业务项目应通过 env 文件或 dart-define 覆盖。
+  static String get apiBaseUrl => EnvConfig.apiBaseUrl;
 
   static const int apiTimeout = 30000;
   static const int pageSize = 20;
@@ -23,7 +23,7 @@ class AppConstants {
 
 /// 应用配置
 ///
-/// 统一管理应用配置和生命周期状态
+/// 合并编译期环境变量 + 运行时状态，统一对外提供
 ///
 /// 使用示例：
 /// ```dart
@@ -37,23 +37,38 @@ class AppConfig {
   static AppConfig? _instance;
   static AppConfig get I => _instance!;
 
-  // ==================== 配置 ====================
+  // ==================== 环境配置（来自 .env） ====================
+
+  /// 当前运行环境
+  final AppEnv env;
 
   /// API 基础地址
   final String apiBaseUrl;
 
+  /// 是否启用日志
+  final bool enableLog;
+
+  /// 应用名称 (便捷访问)
+  String get appName => EnvConfig.appName;
+
+  // ==================== 运行时配置 ====================
+
   /// 连接超时时间
   final Duration connectTimeout;
 
   /// 接收超时时间
   final Duration receiveTimeout;
 
-  /// 是否启用日志
-  final bool enableLog;
-
-  /// 是否使用 Mock 数据 (用于网络示例演示)
+  /// 是否使用 Mock 数据。
+  ///
+  /// 只有选择示例时，示例服务才会读取该开关。
   final bool useMockData;
 
+  /// 已接受的协议版本。
+  ///
+  /// 空字符串表示尚未接受当前协议。
+  String agreementAcceptedVersion;
+
   // ==================== 生命周期状态 ====================
 
   /// 是否首次启动
@@ -68,7 +83,12 @@ class AppConfig {
   /// 上一个版本号
   final String previousVersion;
 
+  // ==================== 扩展配置 ====================
+
+  final dynamic extra;
+
   AppConfig._({
+    required this.env,
     required this.apiBaseUrl,
     required this.connectTimeout,
     required this.receiveTimeout,
@@ -78,25 +98,26 @@ class AppConfig {
     required this.isFirstLaunchAfterUpdate,
     required this.currentVersion,
     required this.previousVersion,
+    required this.agreementAcceptedVersion,
+    this.extra,
   });
 
   /// 初始化应用配置
   ///
   /// 必须在应用启动时调用（runApp 之前）
   static Future<void> init({
-    String? apiBaseUrl,
     Duration connectTimeout =
         const Duration(milliseconds: AppConstants.apiTimeout),
     Duration receiveTimeout =
         const Duration(milliseconds: AppConstants.apiTimeout),
-    bool? enableLog,
     bool useMockData = false,
+    dynamic extra,
   }) async {
     // 1. 初始化存储
     await StorageUtil.init();
 
     // 2. 获取版本信息
-    const currentVersion = AppConstants.appVersion;
+    final currentVersion = AppConstants.appVersion;
     final previousVersion = StorageUtil.getString(StorageKeys.appVersion) ?? '';
 
     // 3. 判断启动状态
@@ -104,23 +125,33 @@ class AppConfig {
     final isFirstLaunchAfterUpdate =
         previousVersion.isNotEmpty && previousVersion != currentVersion;
 
-    // 4. 更新存储
+    // 4. 获取协议状态。兼容早期只存 bool 的 demo 版本。
+    final legacyPrivacyAgreed =
+        StorageUtil.getBool(StorageKeys.privacyAgreed) ?? false;
+    final agreementAcceptedVersion =
+        StorageUtil.getString(StorageKeys.agreementAcceptedVersion) ??
+            (legacyPrivacyAgreed ? EnvConfig.agreementVersion : '');
+
+    // 5. 更新存储
     if (isFirstLaunch) {
       await StorageUtil.setBool(StorageKeys.isFirstLaunch, false);
     }
     await StorageUtil.setString(StorageKeys.appVersion, currentVersion);
 
-    // 5. 创建实例
+    // 6. 创建实例
     _instance = AppConfig._(
-      apiBaseUrl: apiBaseUrl ?? AppConstants.apiBaseUrl,
+      env: AppEnv.fromString(EnvConfig.env),
+      apiBaseUrl: EnvConfig.apiBaseUrl,
       connectTimeout: connectTimeout,
       receiveTimeout: receiveTimeout,
-      enableLog: enableLog ?? kDebugMode,
+      enableLog: EnvConfig.enableLog,
       useMockData: useMockData,
       isFirstLaunch: isFirstLaunch,
       isFirstLaunchAfterUpdate: isFirstLaunchAfterUpdate,
       currentVersion: currentVersion,
       previousVersion: previousVersion,
+      agreementAcceptedVersion: agreementAcceptedVersion,
+      extra: extra,
     );
 
     _printInitLog();
@@ -130,13 +161,41 @@ class AppConfig {
     if (!_instance!.enableLog) return;
     debugPrint('┌─────────────────────────────────────');
     debugPrint('│ AppConfig 初始化完成');
+    debugPrint('│ 环境: ${_instance!.env.name}');
     debugPrint('│ API: ${_instance!.apiBaseUrl}');
+    debugPrint('│ 应用: ${_instance!.appName}');
     debugPrint('│ 版本: ${_instance!.currentVersion}');
     debugPrint('│ 首次启动: ${_instance!.isFirstLaunch}');
     debugPrint('│ 更新后首次: ${_instance!.isFirstLaunchAfterUpdate}');
+    debugPrint('│ 协议版本: ${EnvConfig.agreementVersion}');
+    debugPrint('│ 协议已同意: ${_instance!.hasAcceptedAgreement}');
+    if (_instance!.extra != null) {
+      debugPrint('│ 扩展配置: ${_instance!.extra}');
+    }
     debugPrint('└─────────────────────────────────────');
   }
 
+  /// 便捷判断
+  bool get isDev => env == AppEnv.dev;
+  bool get isStaging => env == AppEnv.staging;
+  bool get isProduction => env == AppEnv.production;
+
+  bool get hasAcceptedAgreement =>
+      agreementAcceptedVersion == EnvConfig.agreementVersion;
+
+  bool get shouldShowSplash =>
+      EnvConfig.enableAgreementDialog && !hasAcceptedAgreement;
+
+  /// 接受当前协议版本。
+  static Future<void> acceptCurrentAgreement() async {
+    _instance?.agreementAcceptedVersion = EnvConfig.agreementVersion;
+    await StorageUtil.setString(
+      StorageKeys.agreementAcceptedVersion,
+      EnvConfig.agreementVersion,
+    );
+    await StorageUtil.setBool(StorageKeys.privacyAgreed, true);
+  }
+
   /// 是否已初始化
   static bool get isInitialized => _instance != null;
 }

package/templates/core_files/config/app_env.dart.template

@@ -0,0 +1,107 @@
+// 编译期环境变量读取。
+// 所有值都可通过 `--dart-define-from-file` 或 `--dart-define` 覆盖。
+
+/// 运行环境
+enum AppEnv {
+  dev,
+  staging,
+  production;
+
+  /// 从 .env 文件的 APP_ENV 字符串解析
+  static AppEnv fromString(String value) {
+    return AppEnv.values.firstWhere(
+      (e) => e.name == value,
+      orElse: () => AppEnv.dev,
+    );
+  }
+}
+
+class EnvConfig {
+  EnvConfig._();
+
+  /// 当前运行环境
+  static const String env = String.fromEnvironment(
+    'APP_ENV',
+    defaultValue: 'dev',
+  );
+
+  /// 应用名称
+  static const String appName = String.fromEnvironment(
+    'APP_NAME',
+    defaultValue: '{{projectDisplayName}}',
+  );
+
+  /// 应用版本
+  static const String appVersion = String.fromEnvironment(
+    'APP_VERSION',
+    defaultValue: '1.0.0',
+  );
+
+  /// 应用运营商名称
+  static const String appOperatorName = String.fromEnvironment(
+    'APP_OPERATOR_NAME',
+    defaultValue: '{{projectDisplayName}} Team',
+  );
+
+  /// 隐私联系邮箱
+  static const String privacyContactEmail = String.fromEnvironment(
+    'PRIVACY_CONTACT_EMAIL',
+    defaultValue: 'privacy@example.com',
+  );
+
+  /// 隐私协议生效日期
+  static const String agreementEffectiveDate = String.fromEnvironment(
+    'AGREEMENT_EFFECTIVE_DATE',
+    defaultValue: '2026-01-01',
+  );
+
+  /// API 基础地址
+  static const String apiBaseUrl = String.fromEnvironment(
+    'API_BASE_URL',
+    defaultValue: 'https://example.com',
+  );
+
+  /// 是否启用日志
+  static const bool enableLog = bool.fromEnvironment(
+    'ENABLE_LOG',
+    defaultValue: true,
+  );
+
+  /// 是否使用 Mock 数据
+  static const bool useMockData = bool.fromEnvironment(
+    'USE_MOCK_DATA',
+    defaultValue: true,
+  );
+
+  /// 首页样板列表模式。
+  ///
+  /// 仅用于 starter 验收样板；真实网络示例接入时应替换同一首页列表槽位。
+  static const String demoListMode = String.fromEnvironment(
+    'DEMO_LIST_MODE',
+    defaultValue: 'finite',
+  );
+
+  /// 是否启用隐私协议对话框
+  static const bool enableAgreementDialog = bool.fromEnvironment(
+    'ENABLE_AGREEMENT_DIALOG',
+    defaultValue: true,
+  );
+
+  /// 隐私协议版本
+  static const String agreementVersion = String.fromEnvironment(
+    'AGREEMENT_VERSION',
+    defaultValue: '1.0.0',
+  );
+
+  /// 用户协议 URL
+  static const String userAgreementUrl = String.fromEnvironment(
+    'USER_AGREEMENT_URL',
+    defaultValue: 'https://example.com/agreement',
+  );
+
+  /// 隐私政策 URL
+  static const String privacyPolicyUrl = String.fromEnvironment(
+    'PRIVACY_POLICY_URL',
+    defaultValue: 'https://example.com/privacy',
+  );
+}

package/templates/core_files/config/app_initializer.dart.template

@@ -1,11 +1,11 @@
- 
- 
 {{#if_network}}
 import '../network/app_http.dart';
 import '../network/interceptors/index.dart';
 import '../network/response_adapter.dart';
 {{/if_network}}
+
 import 'app_config.dart';
+import 'app_env.dart';
 /// 应用初始化器
 ///
 /// 统一管理应用启动前的所有初始化逻辑
@@ -23,15 +23,13 @@ class AppInitializer {
 
   /// 初始化应用
   static Future<void> init({
-    String? apiBaseUrl,
-    bool? enableLog,
-    bool useMockData = false,
+    dynamic extra,
+    bool? useMockData,
   }) async {
     // 1. 初始化应用配置
     await AppConfig.init(
-      apiBaseUrl: apiBaseUrl,
-      enableLog: enableLog,
-      useMockData: useMockData,
+      useMockData: useMockData ?? EnvConfig.useMockData,
+      extra: extra,
     );
 
     {{#if_network}}
@@ -46,26 +44,21 @@ class AppInitializer {
   /// 初始化网络层配置
   static void _initNetwork() {
     AppHttp.init(
-      // 使用图虫 API 适配器 {result, message, feedList}
-      adapter: TuChongAdapter(),
+      // 默认使用通用 {code, msg/message, data} 响应适配器。
+      adapter: DefaultResponseAdapter(),
 
       // 自动显示错误弹窗 (默认 true)
       autoShowError: true,
-
-      interceptors: [
-        // Token 自动注入
-        AuthInterceptor(
-          getToken: () {
-            // 从本地存储获取 token
-            // return StorageUtil.getString('token') ?? '';
-            return '';
-          },
-        ),
+      globalParams: () => {
+        'appVersion': AppConfig.I.currentVersion,
+        'appEnv': AppConfig.I.env.name,
+      },
+      interceptorBuilder: (dio) => [
+{{AUTH_INTERCEPTOR_BLOCK}}
         // 请求重试
         RetryInterceptor(
-          dio: AppHttp().dio,
-          maxRetries: 3,
-          retryDelay: const Duration(seconds: 1),
+          dio: dio,
+          maxRetries: 2,
         ),
       ],
     );

package/templates/core_files/config/index.dart.template

@@ -1,3 +1,6 @@
 // 导出配置类 (按字母顺序排列)
+export 'agreement_document_page.dart';
 export 'app_config.dart';
-export 'app_initializer.dart';
+export 'app_env.dart';
+export 'app_initializer.dart';
+export 'privacy_dialog.dart';