SQLite مع sqflite: إعداد قاعدة البيانات وتصميم المخطط

dependencies:
  sqflite: ^2.3.3          # ربط SQLite مع Flutter
  path: ^1.9.0             # أدوات مسارات متعددة الأنظمة

import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';

Future<Database> openMyDatabase() async {
  // تحديد دليل قواعد البيانات الخاص بالنظام
  final dbPath = await getDatabasesPath();

  // join ينتج مثلاً: /data/user/0/com.example.app/databases/app.db
  final path = join(dbPath, 'app.db');

  return openDatabase(
    path,
    version: 1,
    onCreate: (Database db, int version) async {
      // يُستدعى فقط عند عدم وجود ملف قاعدة البيانات بعد
      await db.execute('''
        CREATE TABLE notes (
          id      INTEGER PRIMARY KEY AUTOINCREMENT,
          title   TEXT    NOT NULL,
          body    TEXT    NOT NULL DEFAULT '',
          color   INTEGER NOT NULL DEFAULT 0,
          created_at INTEGER NOT NULL
        )
      ''');
    },
  );
}

import 'package:sqflite/sqflite.dart';
import 'package:path/path.dart';

class DatabaseHelper {
  // المُنشئ الخاص يمنع الإنشاء الخارجي
  DatabaseHelper._internal();

  // النسخة الوحيدة، مخزنة كحقل ثابت
  static final DatabaseHelper instance = DatabaseHelper._internal();

  // حقل احتياطي قابل للإفراغ؛ null تعني "لم تُفتح بعد"
  Database? _database;

  // getter العام — يفتح قاعدة البيانات في أول استدعاء، ويُعيد المقبض المخزن مؤقتاً بعدها
  Future<Database> get database async {
    _database ??= await _initDatabase();
    return _database!;
  }

  Future<Database> _initDatabase() async {
    final dbPath = await getDatabasesPath();
    final path = join(dbPath, 'notes_app.db');

    return openDatabase(
      path,
      version: 2,
      onCreate: _onCreate,
      onUpgrade: _onUpgrade,
      // تفعيل تطبيق المفاتيح الخارجية لكل اتصال
      onConfigure: (db) async => await db.execute('PRAGMA foreign_keys = ON'),
    );
  }

  Future<void> _onCreate(Database db, int version) async {
    // استخدام Batch لجمل DDL متعددة — تُنفَّذ بشكل ذري
    final batch = db.batch();

    batch.execute('''
      CREATE TABLE categories (
        id    INTEGER PRIMARY KEY AUTOINCREMENT,
        name  TEXT NOT NULL UNIQUE
      )
    ''');

    batch.execute('''
      CREATE TABLE notes (
        id          INTEGER PRIMARY KEY AUTOINCREMENT,
        title       TEXT    NOT NULL,
        body        TEXT    NOT NULL DEFAULT '',
        is_pinned   INTEGER NOT NULL DEFAULT 0,
        category_id INTEGER REFERENCES categories(id) ON DELETE SET NULL,
        created_at  INTEGER NOT NULL,
        updated_at  INTEGER NOT NULL
      )
    ''');

    // يُسرّع عمليات البحث التي تصفّي أو ترتّب حسب الفئة
    batch.execute(
      'CREATE INDEX idx_notes_category ON notes(category_id)',
    );

    await batch.commit(noResult: true);
  }

  Future<void> _onUpgrade(Database db, int oldVersion, int newVersion) async {
    if (oldVersion < 2) {
      // ترحيل المخطط: إضافة عمود جديد في الإصدار 2
      await db.execute(
        'ALTER TABLE notes ADD COLUMN updated_at INTEGER NOT NULL DEFAULT 0',
      );
    }
  }
}

// إدراج صف
Future<int> insertNote(Map<String, dynamic> note) async {
  final db = await DatabaseHelper.instance.database;
  return db.insert('notes', note, conflictAlgorithm: ConflictAlgorithm.replace);
}

// الاستعلام عن جميع الصفوف
Future<List<Map<String, dynamic>>> getAllNotes() async {
  final db = await DatabaseHelper.instance.database;
  return db.query('notes', orderBy: 'created_at DESC');
}