Add migration description and tests

Author: RafaelKayumov

Modules/Sources/Storage/Model/MIGRATIONS.md

@@ -2,6 +2,10 @@
 
 This file documents changes in the WCiOS Storage data model. Please explain any changes to the data model as well as any custom migrations.
 
+## Model 129 (Release X.X.X.X)
+- @rafaelkayumov 2025-10-17
+  - Added `attendanceStatusKey` attribute to `Booking` entity.
+
 ## Model 128 (Release 23.5.0.0)
 - @itsmeichigo 2025-10-14
   - Added `BookingOrderInfo` entity.

Modules/Tests/StorageTests/CoreData/MigrationTests.swift

@@ -2281,6 +2281,37 @@ final class MigrationTests: XCTestCase {
         let insertedResource = try XCTUnwrap(targetContext.first(entityName: "BookingResource"))
         XCTAssertEqual(insertedResource, resource)
     }
+
+    func test_migrating_from_128_to_129_adds_new_attendanceStatusKey_attribute_to_booking() throws {
+        // Given
+        let sourceContainer = try startPersistentContainer("Model 128")
+        let sourceContext = sourceContainer.viewContext
+
+        let booking = insertBooking(to: sourceContext)
+        try sourceContext.save()
+
+        XCTAssertNil(booking.entity.attributesByName["attendanceStatusKey"], "Precondition. Attribute does not exist.")
+
+        // When
+        let targetContainer = try migrate(sourceContainer, to: "Model 129")
+
+        // Then
+        let targetContext = targetContainer.viewContext
+        let migratedBooking = try XCTUnwrap(targetContext.first(entityName: "Booking"))
+
+        // `attendanceStatusKey` should be present in `migratedBooking`
+        XCTAssertNotNil(migratedBooking.entity.attributesByName["attendanceStatusKey"])
+
+        // `attendanceStatusKey` value should default as nil in model 129
+        let value = migratedBooking.value(forKey: "attendanceStatusKey") as? String
+        XCTAssertNil(value)
+
+        // `attendanceStatusKey` must be settable
+        migratedBooking.setValue("checked_in", forKey: "attendanceStatusKey")
+        try targetContext.save()
+        let updatedValue = migratedBooking.value(forKey: "attendanceStatusKey") as? String
+        XCTAssertEqual(updatedValue, "checked_in")
+    }
 }
 
 // MARK: - Persistent Store Setup and Migrations