Watch
1
0
Fork
You've already forked arc
0
forked from hesabix/arc
arc/hesabixUI/hesabix_ui/lib/widgets/data_table/ISOLATION_ANALYSIS.md
2026-04-14 19:34:55 +03:30

4.7 KiB
Executable file

تحلیل جداسازی تنظیمات ستون‌ها

بررسی کد برای اطمینان از جداسازی کامل

1. تولید کلیدهای منحصر به فرد

// در ColumnSettingsService
static const String _keyPrefix = 'data_table_column_settings_';

// در DataTableConfig
String get effectiveTableId {
  return tableId ?? endpoint.replaceAll(RegExp(r'[^a-zA-Z0-9]'), '_');
}

2. مثال‌های عملی کلیدهای تولید شده

جدول endpoint tableId کلید نهایی
جدول کاربران /api/users null data_table_column_settings__api_users
جدول سفارشات /api/orders null data_table_column_settings__api_orders
جدول محصولات /api/products null data_table_column_settings__api_products
جدول سفارشات /api/orders custom_orders data_table_column_settings_custom_orders
جدول کاربران /api/users users_management data_table_column_settings_users_management

3. بررسی کد ذخیره‌سازی

static Future<void> saveColumnSettings(String tableId, ColumnSettings settings) async {
  try {
    final prefs = await SharedPreferences.getInstance();
    final key = '$_keyPrefix$tableId';  // کلید منحصر به فرد
    final jsonString = jsonEncode(settings.toJson());
    await prefs.setString(key, jsonString);
  } catch (e) {
    print('Error saving column settings: $e');
  }
}

4. بررسی کد بارگذاری

static Future<ColumnSettings?> getColumnSettings(String tableId) async {
  try {
    final prefs = await SharedPreferences.getInstance();
    final key = '$_keyPrefix$tableId';  // کلید منحصر به فرد
    final jsonString = prefs.getString(key);
    
    if (jsonString == null) return null;
    
    final json = jsonDecode(jsonString) as Map<String, dynamic>;
    return ColumnSettings.fromJson(json);
  } catch (e) {
    print('Error loading column settings: $e');
    return null;
  }
}

نتیجه‌گیری

✅ جداسازی کامل تضمین شده است:

  1. کلیدهای منحصر به فرد: هر جدول با tableId منحصر به فرد شناسایی می‌شود
  2. پیشوند مخصوص: data_table_column_settings_ فقط برای تنظیمات ستون‌ها استفاده می‌شود
  3. عدم تداخل: تنظیمات هر جدول کاملاً مستقل از دیگری ذخیره می‌شود
  4. تولید خودکار: اگر tableId مشخص نشود، از endpoint تولید می‌شود

مثال عملی استفاده در 5 صفحه مختلف:

// صفحه 1: مدیریت کاربران
DataTableWidget<User>(
  config: DataTableConfig<User>(
    endpoint: '/api/users',
    // کلید: data_table_column_settings__api_users
  ),
  fromJson: (json) => User.fromJson(json),
)

// صفحه 2: مدیریت سفارشات
DataTableWidget<Order>(
  config: DataTableConfig<Order>(
    endpoint: '/api/orders',
    // کلید: data_table_column_settings__api_orders
  ),
  fromJson: (json) => Order.fromJson(json),
)

// صفحه 3: گزارش‌های مالی
DataTableWidget<Report>(
  config: DataTableConfig<Report>(
    endpoint: '/api/reports',
    tableId: 'financial_reports',
    // کلید: data_table_column_settings_financial_reports
  ),
  fromJson: (json) => Report.fromJson(json),
)

// صفحه 4: مدیریت محصولات
DataTableWidget<Product>(
  config: DataTableConfig<Product>(
    endpoint: '/api/products',
    // کلید: data_table_column_settings__api_products
  ),
  fromJson: (json) => Product.fromJson(json),
)

// صفحه 5: لاگ‌های سیستم
DataTableWidget<Log>(
  config: DataTableConfig<Log>(
    endpoint: '/api/logs',
    tableId: 'system_logs',
    // کلید: data_table_column_settings_system_logs
  ),
  fromJson: (json) => Log.fromJson(json),
)

✅ تضمین عدم تداخل:

  • هر جدول تنظیمات مستقل خود را دارد
  • تغییر تنظیمات در یک جدول روی جدول‌های دیگر تأثیر نمی‌گذارد
  • هر جدول می‌تواند ستون‌های مختلفی را مخفی/نمایش دهد
  • ترتیب ستون‌ها در هر جدول مستقل است
  • تنظیمات در SharedPreferences با کلیدهای کاملاً متفاوت ذخیره می‌شود

خلاصه

سیستم به گونه‌ای طراحی شده که هیچ تداخلی بین تنظیمات جدول‌های مختلف وجود ندارد. هر جدول با شناسه منحصر به فرد خود تنظیماتش را ذخیره و بازیابی می‌کند.