المزامنة أولوياً دون اتصال والتعارضات

data class PendingEdit(
    val operationId: String, val accountId: String,
    val bookId: String, val title: String, val baseVersion: Long
)

suspend fun renameOffline(
    db: RoomDatabase, books: BooksDao, outbox: OutboxDao, edit: PendingEdit
) {
    db.withTransaction {
        books.rename(edit.bookId, edit.title)
        outbox.insert(edit)
    }
}

استخدم RoomDatabase وwithTransaction المتوافقين من androidx.room. تمثل BooksDao وOutboxDao عقود DAO معلقة يعرّفها التطبيق وتحتاج PendingEdit تحويل كيان موافقاً. تحقق من ملكية الحساب والعنوان قبل الحد ولا تجدوِل إلا بعد التثبيت الناجح.

sealed interface UploadOutcome {
    data class Accepted(val serverVersion: Long) : UploadOutcome
    data class Conflict(val serverTitle: String, val serverVersion: Long) : UploadOutcome
    data object RetryLater : UploadOutcome
    data object SignInRequired : UploadOutcome
}

fun needsUserAction(outcome: UploadOutcome): Boolean = when (outcome) {
    is UploadOutcome.Conflict, UploadOutcome.SignInRequired -> true
    is UploadOutcome.Accepted, UploadOutcome.RetryLater -> false
}

يستخدم نموذج Kotlin صياغة data object المدعومة بالأدوات الحديثة. تحول الخدمة نتائج البروتوكول لهذه الحالات ويحفظ المستودع آثارها. تحتاج RetryLater تراجعاً محدوداً، بينما يحتاج التعارض والدخول مسار حل منفصلاً.