Add database migration handling and image migration use case

Co-authored-by: abdallahmehiz <54363735+abdallahmehiz@users.noreply.github.com>

Author: Copilot

domain/data/src/androidMain/kotlin/mehiz/abdallah/progres/data/database/DatabaseModule.android.kt

@@ -19,6 +19,26 @@ actual val ProgresDatabaseModule = module {
           override fun onOpen(db: SupportSQLiteDatabase) {
             db.setForeignKeyConstraintsEnabled(true)
           }
+          
+          override fun onUpgrade(
+            db: SupportSQLiteDatabase,
+            oldVersion: Int,
+            newVersion: Int
+          ) {
+            // Handle migration from BLOB to file storage
+            // Clear affected tables to force fresh sync with new schema
+            if (oldVersion < newVersion) {
+              try {
+                db.execSQL("DROP TABLE IF EXISTS IndividualInfoTable")
+                db.execSQL("DROP TABLE IF EXISTS StudentCardTable")
+                // Recreate tables with new schema
+                onCreate(db)
+              } catch (e: Exception) {
+                // If migration fails, recreate database
+                super.onUpgrade(db, oldVersion, newVersion)
+              }
+            }
+          }
         }
       ),
     )

domain/data/src/commonMain/sqldelight/mehiz/abdallah/progres/data/db/IndividualInfoTable.sq

@@ -1,4 +1,4 @@
-CREATE TABLE IndividualInfoTable(
+CREATE TABLE IF NOT EXISTS IndividualInfoTable(
 id INTEGER NOT NULL PRIMARY KEY,
 firstNameArabic TEXT NOT NULL,
 firstNameLatin TEXT NOT NULL,

domain/src/commonMain/kotlin/mehiz/abdallah/progres/domain/ImageMigrationUseCase.kt

@@ -0,0 +1,55 @@
+package mehiz.abdallah.progres.domain
+
+import mehiz.abdallah.progres.data.daos.IndividualInfoDao
+import mehiz.abdallah.progres.data.daos.StudentCardDao
+import utils.FileStorageManager
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+
+/**
+ * Handles migration of image data from database BLOBs to file storage
+ * This is used during the transition period to ensure compatibility
+ */
+class ImageMigrationUseCase(
+  private val individualInfoDao: IndividualInfoDao,
+  private val studentCardDao: StudentCardDao,
+  private val fileStorageManager: FileStorageManager
+) {
+  
+  /**
+   * Checks if migration is needed and suggests a refresh
+   * Since this is a significant change, we recommend users refresh their data
+   * to get images stored in the new file format
+   */
+  suspend fun isMigrationNeeded(): Boolean = withContext(Dispatchers.IO) {
+    // Check if there are any records that might have old BLOB data
+    // Since we changed schema, old data will be cleaned during refresh
+    val individualInfo = individualInfoDao.getIndividualInfo()
+    val studentCards = studentCardDao.getAllStudentCards()
+    
+    // If no data exists, no migration needed
+    if (individualInfo == null && studentCards.isEmpty()) {
+      return@withContext false
+    }
+    
+    // Check if we have photo paths (new format) or if they're missing (needs refresh)
+    val needsPhotoMigration = individualInfo?.photoPath == null
+    val needsLogoMigration = studentCards.any { it.establishmentLogoPath == null }
+    
+    needsPhotoMigration || needsLogoMigration
+  }
+  
+  /**
+   * Clears all data to force a fresh sync with the new file storage format
+   * This is the safest migration approach for this type of schema change
+   */
+  suspend fun forceFreshSync() = withContext(Dispatchers.IO) {
+    // Clean up any existing files
+    fileStorageManager.deleteAllProfilePictures()
+    fileStorageManager.deleteAllUniversityLogos()
+    
+    // Clear database to force fresh sync
+    individualInfoDao.deleteAllIndividualInfo()
+    studentCardDao.deleteAllCards()
+  }
+}

domain/src/commonMain/kotlin/mehiz/abdallah/progres/domain/di/DomainModule.kt

@@ -11,6 +11,7 @@ import mehiz.abdallah.progres.domain.DischargeUseCase
 import mehiz.abdallah.progres.domain.ExamGradeUseCase
 import mehiz.abdallah.progres.domain.ExamScheduleUseCase
 import mehiz.abdallah.progres.domain.GroupUseCase
+import mehiz.abdallah.progres.domain.ImageMigrationUseCase
 import mehiz.abdallah.progres.domain.StudentCardUseCase
 import mehiz.abdallah.progres.domain.SubjectScheduleUseCase
 import mehiz.abdallah.progres.domain.SubjectUseCase
@@ -39,4 +40,5 @@ val DomainModule = module {
   singleOf(::UserAuthUseCase)
   singleOf(::DischargeUseCase)
   singleOf(::AccommodationUseCase)
+  singleOf(::ImageMigrationUseCase)
 }