chore: release client-v1.0.61

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

client/lib/core/api/api_client.dart

@@ -3,6 +3,7 @@ import 'package:flutter/foundation.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../auth/auth_state.dart';
 import '../config/app_config.dart';
+import '../config/app_constants.dart';
 import '../config/license_copy.dart';
 import '../errors/error_reporter.dart';
 import '../../providers/connectivity_provider.dart';
@@ -15,8 +16,8 @@ final _publicDio = _buildPublicDio();
 Dio _buildPublicDio() {
   final dio = Dio(BaseOptions(
     baseUrl: AppConfig.apiBaseUrl,
-    connectTimeout: const Duration(seconds: 8),
-    receiveTimeout: const Duration(seconds: 15),
+    connectTimeout: AppConstants.publicConnectTimeout,
+    receiveTimeout: AppConstants.publicReceiveTimeout,
   ));
   dio.interceptors.add(RetryInterceptor(dio));
   return dio;
@@ -102,8 +103,8 @@ class ApiClient {
     _onAuthFailed = onAuthFailed;
     _dio = Dio(BaseOptions(
       baseUrl: AppConfig.apiBaseUrl,
-      connectTimeout: const Duration(seconds: 8),
-      receiveTimeout: const Duration(seconds: 15),
+      connectTimeout: AppConstants.publicConnectTimeout,
+      receiveTimeout: AppConstants.publicReceiveTimeout,
       headers: {
         if (token != null) 'Authorization': 'Bearer $token',
       },

client/lib/core/api/retry_interceptor.dart

@@ -1,4 +1,5 @@
 import 'package:dio/dio.dart';
+import '../config/app_constants.dart';
 
 /// 网络层错误自动重试拦截器。
 ///
@@ -16,11 +17,7 @@ class RetryInterceptor extends Interceptor {
 
   RetryInterceptor(
     this.dio, {
-    this.delays = const [
-      Duration(seconds: 1),
-      Duration(seconds: 2),
-      Duration(seconds: 4),
-    ],
+    this.delays = AppConstants.retryBackoffs,
   });
 
   static const _attemptKey = 'retry_attempt';

client/lib/core/auth/auth_state.dart

@@ -3,6 +3,7 @@ import 'package:flutter/foundation.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 import '../config/app_config.dart';
+import '../config/app_constants.dart';
 
 const _kAccessToken = 'access_token';
 const _kRefreshToken = 'refresh_token';
@@ -153,8 +154,8 @@ class AuthNotifier extends StateNotifier<AuthState> {
       try {
         await Dio(BaseOptions(
           baseUrl: AppConfig.apiBaseUrl,
-          connectTimeout: const Duration(seconds: 4),
-          receiveTimeout: const Duration(seconds: 4),
+          connectTimeout: AppConstants.authProbeTimeout,
+          receiveTimeout: AppConstants.authProbeTimeout,
           headers: {'Authorization': 'Bearer $token'},
         )).post('/auth/logout');
       } catch (_) {

client/lib/core/config/app_constants.dart

@@ -0,0 +1,97 @@
+/// 全局业务常量集中地。
+///
+/// 收口此前散落在各处的「业务魔数」：网络超时、轮询间隔、重试退避、输入防抖、
+/// 分页大小、业务上限等可调参数。**不**收 UI 尺寸/间距/字号等纯样式常量
+/// （那些保留在各自 widget / 主题里，离使用点最近更易维护）。
+///
+/// 新增需要复用或可能调整的业务数值时，统一加到这里，避免再写裸字面量。
+abstract final class AppConstants {
+  // ── 网络超时 ──
+  /// 未登录公共 Dio（登录/刷新）连接超时
+  static const Duration publicConnectTimeout = Duration(seconds: 8);
+
+  /// 未登录公共 Dio 读取超时
+  static const Duration publicReceiveTimeout = Duration(seconds: 15);
+
+  /// 登录态探测/轻量请求超时
+  static const Duration authProbeTimeout = Duration(seconds: 4);
+
+  /// 异常上报请求超时
+  static const Duration errorReportTimeout = Duration(seconds: 5);
+
+  /// 检查更新请求超时
+  static const Duration updateCheckTimeout = Duration(seconds: 5);
+
+  /// 连通性探测请求超时
+  static const Duration connectivityTimeout = Duration(seconds: 15);
+
+  /// 批量导入（Excel 上传）发送超时
+  static const Duration importSendTimeout = Duration(seconds: 120);
+
+  /// 批量导入（Excel 解析入库）读取超时
+  static const Duration importReceiveTimeout = Duration(seconds: 300);
+
+  // ── 重试 / 退避 ──
+  /// 网络层错误自动重试的递增间隔（1s → 2s → 4s）
+  static const List<Duration> retryBackoffs = [
+    Duration(seconds: 1),
+    Duration(seconds: 2),
+    Duration(seconds: 4),
+  ];
+
+  /// 连通性探测的多轮预算（4s → 8s → 12s）
+  static const List<Duration> connectivityBudgets = [
+    Duration(seconds: 4),
+    Duration(seconds: 8),
+    Duration(seconds: 12),
+  ];
+
+  /// 连通性探测单轮（不重试）预算
+  static const List<Duration> connectivitySingleBudget = [Duration(seconds: 4)];
+
+  /// 连通性探测每轮失败后的退避步长（600ms × 轮次）
+  static const Duration connectivityRetryStep = Duration(milliseconds: 600);
+
+  // ── 轮询间隔 ──
+  /// 会话心跳上报间隔
+  static const Duration heartbeatInterval = Duration(seconds: 30);
+
+  /// 在线时连通性轮询间隔
+  static const Duration connectivityOnlinePoll = Duration(seconds: 30);
+
+  /// 离线时连通性轮询间隔
+  static const Duration connectivityOfflinePoll = Duration(minutes: 1);
+
+  /// 后台检查更新轮询间隔
+  static const Duration updatePollInterval = Duration(hours: 1);
+
+  /// 启动后首次检查更新前的延迟
+  static const Duration updateInitialDelay = Duration(seconds: 3);
+
+  // ── 输入防抖 / 交互延迟 ──
+  /// 下拉框失焦自动收起延迟
+  static const Duration dropdownCloseDelay = Duration(milliseconds: 150);
+
+  /// 搜索输入防抖
+  static const Duration searchDebounce = Duration(milliseconds: 300);
+
+  /// 自更新流程各步骤间的过渡延迟
+  static const Duration updaterStepDelay = Duration(milliseconds: 400);
+
+  // ── 分页 ──
+  /// 列表默认每页条数
+  static const int defaultPageSize = 20;
+
+  /// 入库选货弹窗一次性拉取的库存条数
+  static const int stockInPickerPageSize = 500;
+
+  /// 出库选货弹窗一次性拉取的库存条数
+  static const int stockOutPickerPageSize = 1000;
+
+  /// 盘点拉取库存的每页条数
+  static const int inventoryCheckPageSize = 200;
+
+  // ── 业务上限 ──
+  /// 授权未返回时的默认设备上限
+  static const int defaultMaxDevices = 3;
+}

client/lib/core/errors/error_reporter.dart

@@ -7,6 +7,7 @@ import 'package:package_info_plus/package_info_plus.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 
 import '../config/app_config.dart';
+import '../config/app_constants.dart';
 
 class ErrorType {
   static const flutterError = 'flutter_error';
@@ -29,8 +30,8 @@ class ErrorReporter {
   Dio get _client {
     _dio ??= Dio(BaseOptions(
       baseUrl: AppConfig.apiBaseUrl,
-      connectTimeout: const Duration(seconds: 5),
-      receiveTimeout: const Duration(seconds: 5),
+      connectTimeout: AppConstants.errorReportTimeout,
+      receiveTimeout: AppConstants.errorReportTimeout,
     ));
     return _dio!;
   }

client/lib/core/update/app_updater_io.dart

@@ -1,6 +1,7 @@
 import 'dart:io';
 import 'package:dio/dio.dart';
 import 'package:path_provider/path_provider.dart';
+import '../config/app_constants.dart';
 
 // 桌面/原生平台的应用内更新实现。Web 版见 app_updater_web.dart。
 
@@ -34,7 +35,7 @@ Future<void> downloadAndInstall(
     await dio.download(url, exe, onReceiveProgress: prog);
     // 启动 Inno Setup 安装包后退出本应用，让其覆盖安装。
     await Process.start(exe, const [], mode: ProcessStartMode.detached);
-    await Future<void>.delayed(const Duration(milliseconds: 400));
+    await Future<void>.delayed(AppConstants.updaterStepDelay);
     exit(0);
   }
 
@@ -75,7 +76,7 @@ else
 fi
 ''');
     await Process.start('/bin/sh', [script], mode: ProcessStartMode.detached);
-    await Future<void>.delayed(const Duration(milliseconds: 400));
+    await Future<void>.delayed(AppConstants.updaterStepDelay);
     exit(0);
   }
 

client/lib/models/license.dart

@@ -1,3 +1,5 @@
+import '../core/config/app_constants.dart';
+
 class LicenseInfo {
   final int id;
   final String type; // trial | monthly | annual | lifetime
@@ -20,7 +22,8 @@ class LicenseInfo {
       id: (json['id'] as num?)?.toInt() ?? 0,
       type: json['type'] as String? ?? 'trial',
       isActive: json['is_active'] as bool? ?? false,
-      maxDevices: (json['max_devices'] as num?)?.toInt() ?? 3,
+      maxDevices:
+          (json['max_devices'] as num?)?.toInt() ?? AppConstants.defaultMaxDevices,
       expiresAt: json['expires_at'] != null
           ? DateTime.tryParse(json['expires_at'] as String)
           : null,

client/lib/providers/connectivity_provider.dart

@@ -2,6 +2,7 @@ import 'dart:async';
 import 'package:dio/dio.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../core/config/app_config.dart';
+import '../core/config/app_constants.dart';
 
 /// 每次从离线恢复到在线时自增。
 /// 数据 provider 通过 watch 此值实现网络恢复后自动刷新。
@@ -44,27 +45,25 @@ class ConnectivityNotifier extends StateNotifier<bool> {
   // 独立轻量 Dio：无拦截器。连接预算用 Future.timeout 逐次控制，
   // 故 BaseOptions 超时放宽到 15s 作为兜底。
   final _dio = Dio(BaseOptions(
-    connectTimeout: const Duration(seconds: 15),
-    receiveTimeout: const Duration(seconds: 15),
+    connectTimeout: AppConstants.connectivityTimeout,
+    receiveTimeout: AppConstants.connectivityTimeout,
   ));
 
   /// 每次尝试的超时预算，逐次拉长（越来越长）。
-  static const _budgets = <Duration>[
-    Duration(seconds: 4),
-    Duration(seconds: 8),
-    Duration(seconds: 12),
-  ];
+  static const _budgets = AppConstants.connectivityBudgets;
 
-  /// 在线时：每 30 秒轻量检测一次（单次，不重试）
+  /// 在线时：轻量检测一次（单次，不重试）
   void _startOnlineTimer() {
     _timer?.cancel();
-    _timer = Timer.periodic(const Duration(seconds: 30), (_) => _check());
+    _timer =
+        Timer.periodic(AppConstants.connectivityOnlinePoll, (_) => _check());
   }
 
-  /// 离线时：每 1 分钟嗅探一次，降低频率节省资源
+  /// 离线时：降低频率嗅探，节省资源
   void _startOfflineTimer() {
     _timer?.cancel();
-    _timer = Timer.periodic(const Duration(minutes: 1), (_) => _check());
+    _timer =
+        Timer.periodic(AppConstants.connectivityOfflinePoll, (_) => _check());
   }
 
   /// 立即触发一次检测（供外部调用，如 API 请求失败 / 启动时）。单次，不重试。
@@ -92,14 +91,14 @@ class ConnectivityNotifier extends StateNotifier<bool> {
 
   /// 连通性检测。[withRetry]=true 时按 [_budgets] 退避重试，间隔递增。
   Future<bool> _check({bool withRetry = false}) async {
-    final budgets = withRetry ? _budgets : const [Duration(seconds: 4)];
+    final budgets = withRetry ? _budgets : AppConstants.connectivitySingleBudget;
     var ok = false;
     for (var i = 0; i < budgets.length; i++) {
       ok = await _ping(budgets[i]);
       if (ok) break;
       // 最后一次失败后不再等待；中间失败按递增间隔退避（0.6s, 1.2s…）
       if (i < budgets.length - 1) {
-        await Future.delayed(Duration(milliseconds: 600 * (i + 1)));
+        await Future.delayed(AppConstants.connectivityRetryStep * (i + 1));
       }
     }
 

client/lib/providers/finance_provider.dart

@@ -1,6 +1,7 @@
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../core/api/api_client.dart';
 import '../core/auth/auth_state.dart';
+import '../core/config/app_constants.dart';
 import '../core/models/page_result.dart';
 import '../models/finance.dart';
 import '../repositories/finance_repository.dart';
@@ -16,7 +17,7 @@ final financeListProvider =
 
 class FinanceListNotifier extends AsyncNotifier<PageResult<FinanceRecord>> {
   int _page = 1;
-  int _pageSize = 20;
+  int _pageSize = AppConstants.defaultPageSize;
   String _type = '';
   String _month = '';
 

client/lib/providers/inventory_provider.dart

@@ -1,6 +1,7 @@
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../core/api/api_client.dart';
 import '../core/auth/auth_state.dart';
+import '../core/config/app_constants.dart';
 import '../core/models/page_result.dart';
 import '../models/inventory.dart';
 import '../repositories/inventory_repository.dart';
@@ -17,7 +18,7 @@ final inventoryListProvider =
 
 class InventoryListNotifier extends AsyncNotifier<PageResult<Inventory>> {
   int _page = 1;
-  int _pageSize = 20;
+  int _pageSize = AppConstants.defaultPageSize;
   int? _warehouseId;
   String _keyword = '';
   List<String> _series = [];
@@ -106,7 +107,7 @@ final inventoryLogProvider =
 
 class InventoryLogNotifier extends AsyncNotifier<PageResult<InventoryLog>> {
   int _page = 1;
-  int _pageSize = 20;
+  int _pageSize = AppConstants.defaultPageSize;
   PageResult<InventoryLog>? _cache;
 
   @override

client/lib/providers/partner_provider.dart

@@ -1,6 +1,7 @@
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../core/api/api_client.dart';
 import '../core/auth/auth_state.dart';
+import '../core/config/app_constants.dart';
 import '../core/models/page_result.dart';
 import '../models/partner.dart';
 import '../repositories/partner_repository.dart';
@@ -25,7 +26,7 @@ final customerListProvider =
 class PartnerListNotifier extends AsyncNotifier<PageResult<Partner>> {
   final String? type;
   int _page = 1;
-  int _pageSize = 20;
+  int _pageSize = AppConstants.defaultPageSize;
   String _keyword = '';
   PageResult<Partner>? _cache;
 

client/lib/providers/product_provider.dart

@@ -1,6 +1,7 @@
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../core/api/api_client.dart';
 import '../core/auth/auth_state.dart';
+import '../core/config/app_constants.dart';
 import '../core/models/page_result.dart';
 import '../models/product.dart';
 import '../repositories/product_repository.dart';
@@ -17,7 +18,7 @@ final productListProvider =
 
 class ProductListNotifier extends AsyncNotifier<PageResult<Product>> {
   int _page = 1;
-  int _pageSize = 20;
+  int _pageSize = AppConstants.defaultPageSize;
   String _keyword = '';
   int? _categoryId;
   PageResult<Product>? _cache;

client/lib/providers/session_heartbeat.dart

@@ -3,6 +3,7 @@ import 'package:flutter/foundation.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../core/api/api_client.dart';
 import '../core/auth/auth_state.dart';
+import '../core/config/app_constants.dart';
 import 'license_provider.dart';
 
 /// 登录态心跳：已登录时每 30s 执行一次 **单个** POST /auth/ping：
@@ -27,7 +28,7 @@ class SessionHeartbeat {
 
   void start() {
     _timer?.cancel();
-    _timer = Timer.periodic(const Duration(seconds: 30), (_) => _ping());
+    _timer = Timer.periodic(AppConstants.heartbeatInterval, (_) => _ping());
   }
 
   Future<void> _ping() async {

client/lib/providers/stock_in_provider.dart

@@ -1,6 +1,7 @@
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../core/api/api_client.dart';
 import '../core/auth/auth_state.dart';
+import '../core/config/app_constants.dart';
 import '../core/models/page_result.dart';
 import '../models/stock_in.dart';
 import '../repositories/stock_in_repository.dart';
@@ -18,7 +19,7 @@ final stockInListProvider =
 
 class StockInListNotifier extends AsyncNotifier<PageResult<StockInOrder>> {
   int _page = 1;
-  int _pageSize = 20;
+  int _pageSize = AppConstants.defaultPageSize;
   String _status = '';
   String? _startDate;
   String? _endDate;

client/lib/providers/stock_out_provider.dart

@@ -1,6 +1,7 @@
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../core/api/api_client.dart';
 import '../core/auth/auth_state.dart';
+import '../core/config/app_constants.dart';
 import '../core/models/page_result.dart';
 import '../models/stock_out.dart';
 import '../repositories/stock_out_repository.dart';
@@ -18,7 +19,7 @@ final stockOutListProvider =
 
 class StockOutListNotifier extends AsyncNotifier<PageResult<StockOutOrder>> {
   int _page = 1;
-  int _pageSize = 20;
+  int _pageSize = AppConstants.defaultPageSize;
   String _status = '';
   String? _startDate;
   String? _endDate;

client/lib/providers/update_provider.dart

@@ -7,6 +7,7 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:package_info_plus/package_info_plus.dart';
 import 'package:url_launcher/url_launcher.dart';
 import '../core/config/app_config.dart';
+import '../core/config/app_constants.dart';
 
 // ── 数据模型 ────────────────────────────────────────────────
 class AppUpdateInfo {
@@ -40,8 +41,8 @@ class UpdateNotifier extends AsyncNotifier<AppUpdateInfo?> {
   bool _dismissed = false; // 用户已手动关闭非强制更新提示
 
   final _dio = Dio(BaseOptions(
-    connectTimeout: const Duration(seconds: 5),
-    receiveTimeout: const Duration(seconds: 5),
+    connectTimeout: AppConstants.updateCheckTimeout,
+    receiveTimeout: AppConstants.updateCheckTimeout,
   ));
 
   @override
@@ -51,12 +52,12 @@ class UpdateNotifier extends AsyncNotifier<AppUpdateInfo?> {
       _dio.close(force: true);
     });
 
-    // 启动后 3 秒延迟首次检查（避免与登录请求竞争）
-    await Future.delayed(const Duration(seconds: 3));
+    // 启动后延迟首次检查（避免与登录请求竞争）
+    await Future.delayed(AppConstants.updateInitialDelay);
     final result = await _check();
 
-    // 每小时检查一次
-    _timer = Timer.periodic(const Duration(hours: 1), (_) async {
+    // 定期检查更新
+    _timer = Timer.periodic(AppConstants.updatePollInterval, (_) async {
       _dismissed = false;
       final r = await _check();
       state = AsyncValue.data(r);

client/lib/screens/auth/login_screen.dart

@@ -8,6 +8,7 @@ import 'package:go_router/go_router.dart';
 import 'package:url_launcher/url_launcher.dart';
 import '../../core/auth/auth_state.dart';
 import '../../core/config/app_config.dart';
+import '../../core/config/app_constants.dart';
 import '../../core/theme/app_theme.dart';
 import '../../core/storage/login_history.dart';
 import '../../providers/connectivity_provider.dart';
@@ -73,7 +74,8 @@ class _LoginScreenState extends ConsumerState<LoginScreen> {
       } else {
         // 延迟关闭：让候选词的 onTap（pointer-up）先执行，再关闭下拉框
         _closeHotelTimer?.cancel();
-        _closeHotelTimer = Timer(const Duration(milliseconds: 150), _closeHotel);
+        _closeHotelTimer =
+            Timer(AppConstants.dropdownCloseDelay, _closeHotel);
       }
     });
     _usernameFocus.addListener(() {
@@ -88,7 +90,8 @@ class _LoginScreenState extends ConsumerState<LoginScreen> {
         });
       } else {
         _closeUsernameTimer?.cancel();
-        _closeUsernameTimer = Timer(const Duration(milliseconds: 150), _closeUsername);
+        _closeUsernameTimer =
+            Timer(AppConstants.dropdownCloseDelay, _closeUsername);
       }
     });
   }

client/lib/screens/finance/finance_screen.dart

@@ -1,6 +1,7 @@
 import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../../core/responsive/responsive.dart';
+import '../../core/config/app_constants.dart';
 import '../../core/theme/app_theme.dart';
 import '../../models/finance.dart';
 import '../../providers/finance_provider.dart';
@@ -49,7 +50,7 @@ class _FinanceTab extends ConsumerStatefulWidget {
 class _FinanceTabState extends ConsumerState<_FinanceTab> {
   late String _month;
   int _page = 1;
-  int _pageSize = 20;
+  int _pageSize = AppConstants.defaultPageSize;
 
   late Future<List<FinanceRecord>> _future;
   List<FinanceRecord> _allRecords = [];

client/lib/screens/inventory/inventory_check_screen.dart

@@ -5,6 +5,7 @@ import 'package:go_router/go_router.dart';
 import '../../core/theme/app_theme.dart';
 import '../../models/inventory.dart';
 import '../../models/warehouse.dart';
+import '../../core/config/app_constants.dart';
 import '../../providers/inventory_provider.dart';
 import '../../providers/warehouse_provider.dart';
 
@@ -51,7 +52,8 @@ class _InventoryCheckScreenState extends ConsumerState<InventoryCheckScreen> {
     try {
       final result = await ref
           .read(inventoryRepositoryProvider)
-          .listInventory(warehouseId: wh.id, pageSize: 200);
+          .listInventory(
+              warehouseId: wh.id, pageSize: AppConstants.inventoryCheckPageSize);
       final items = result.data
           .where((inv) => inv.productId != null)
           .map((inv) => _CheckItem(inventory: inv))

client/lib/screens/inventory/inventory_list_screen.dart

@@ -5,6 +5,7 @@ import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import 'package:go_router/go_router.dart';
 import '../../core/config/app_config.dart';
+import '../../core/config/app_constants.dart';
 import '../../core/responsive/responsive.dart';
 import '../../core/theme/app_theme.dart';
 import '../../models/inventory.dart';
@@ -165,8 +166,8 @@ class _InventoryListScreenState extends ConsumerState<InventoryListScreen> {
     final token = ref.read(authStateProvider).user?.accessToken ?? '';
     final dio = Dio(BaseOptions(
       baseUrl: AppConfig.apiBaseUrl,
-      sendTimeout: const Duration(seconds: 120),
-      receiveTimeout: const Duration(seconds: 300),
+      sendTimeout: AppConstants.importSendTimeout,
+      receiveTimeout: AppConstants.importReceiveTimeout,
     ));
     dio.options.headers['Authorization'] = 'Bearer $token';
 

client/lib/screens/partners/partners_screen.dart

@@ -4,6 +4,7 @@ import 'package:flutter/material.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../../core/models/page_result.dart';
 import '../../core/responsive/responsive.dart';
+import '../../core/config/app_constants.dart';
 import '../../core/theme/app_theme.dart';
 import '../../models/partner.dart';
 import '../../providers/partner_provider.dart';
@@ -77,7 +78,7 @@ class _PartnersScreenState extends ConsumerState<PartnersScreen> {
         searchCtrl: _supplierSearchCtrl,
         onSearchChanged: (v) {
           _supplierDebounce?.cancel();
-          _supplierDebounce = Timer(const Duration(milliseconds: 300), () {
+          _supplierDebounce = Timer(AppConstants.searchDebounce, () {
             ref.read(supplierListProvider.notifier).setKeyword(v);
           });
         },
@@ -120,7 +121,7 @@ class _PartnersScreenState extends ConsumerState<PartnersScreen> {
         searchCtrl: _customerSearchCtrl,
         onSearchChanged: (v) {
           _customerDebounce?.cancel();
-          _customerDebounce = Timer(const Duration(milliseconds: 300), () {
+          _customerDebounce = Timer(AppConstants.searchDebounce, () {
             ref.read(customerListProvider.notifier).setKeyword(v);
           });
         },

client/lib/screens/settings/settings_screen.dart

@@ -11,6 +11,7 @@ import 'package:flutter_riverpod/flutter_riverpod.dart';
 import '../../core/auth/auth_state.dart';
 import '../../widgets/write_guard.dart';
 import '../../core/config/app_config.dart';
+import '../../core/config/app_constants.dart';
 import '../../core/config/app_info.dart';
 import '../../core/config/license_copy.dart';
 import '../../core/responsive/responsive.dart';
@@ -1375,8 +1376,8 @@ class _BatchImportWidgetState extends ConsumerState<_BatchImportWidget> {
 
     final dio = Dio(BaseOptions(
       baseUrl: AppConfig.apiBaseUrl,
-      sendTimeout: const Duration(seconds: 120),
-      receiveTimeout: const Duration(seconds: 300),
+      sendTimeout: AppConstants.importSendTimeout,
+      receiveTimeout: AppConstants.importReceiveTimeout,
     ));
     dio.options.headers['Authorization'] = 'Bearer $token';
 

client/lib/screens/stock_in/stock_in_form_screen.dart

@@ -8,6 +8,7 @@ import '../../core/auth/auth_state.dart';
 import '../../core/utils/print_util.dart';
 import '../../core/utils/date_util.dart';
 import '../../models/stock_in.dart';
+import '../../core/config/app_constants.dart';
 import '../../providers/partner_provider.dart';
 import '../../providers/product_option_provider.dart';
 import '../../providers/product_provider.dart';
@@ -196,7 +197,9 @@ class _StockInFormScreenState extends ConsumerState<StockInFormScreen> {
     try {
       final result = await ref
           .read(inventoryRepositoryProvider)
-          .listInventory(warehouseId: warehouseId, pageSize: 500);
+          .listInventory(
+              warehouseId: warehouseId,
+              pageSize: AppConstants.stockInPickerPageSize);
       setState(() {
         _inventoryMap = {
           for (final inv in result.data.where((inv) => inv.productId != null))

client/lib/screens/stock_out/stock_out_form_screen.dart

@@ -9,6 +9,7 @@ import '../../core/utils/print_util.dart';
 import '../../core/utils/date_util.dart';
 import '../../models/stock_out.dart';
 import '../../widgets/date_picker_field.dart';
+import '../../core/config/app_constants.dart';
 import '../../providers/inventory_provider.dart';
 import '../../providers/partner_provider.dart';
 import '../../providers/stock_out_provider.dart';
@@ -153,7 +154,9 @@ class _StockOutFormScreenState extends ConsumerState<StockOutFormScreen> {
     try {
       final result = await ref
           .read(inventoryRepositoryProvider)
-          .listInventory(warehouseId: warehouseId, pageSize: 1000);
+          .listInventory(
+              warehouseId: warehouseId,
+              pageSize: AppConstants.stockOutPickerPageSize);
       final Map<int, _PickerItem> productMap = {};
       for (final inv in result.data.where((inv) => inv.productId != null)) {
         final pid = inv.productId!;