Share Testing Checklist

Comprehensive checklist for testing CloudKit sharing functionality in TheCompanyApp.

Test Setup

Required Resources

Devices/Users:

• ✅ User A (Owner): iPhone/iPad with iCloud account A

• ✅ User B (Participant): iPhone/iPad with iCloud account B (different Apple ID)

• ✅ User C (Participant 2): Optional, for multi-participant testing

• ✅ Network: Wi-Fi connection for both devices

Preparation:

• Sign in to iCloud on both devices

• Install TheCompanyApp (TestFlight or Debug)

• Enable iCloud for TheCompanyApp in Settings

• Verify internet connectivity

Sharing Flow Tests

Test 1: Create and Share Company

User A (Owner):

• Create new company: "Test Company Alpha"

• Add company details (name, business type, etc.)

• Navigate to Settings → Share Company

• Tap "Share" button

• iOS share sheet appears

• Select "Messages" or "Mail"

• Send share link to User B

• Expected: Share URL copied successfully

User B (Participant):

• Receive message with share link

• Tap share URL

• Safari opens → Redirects to TheCompanyApp

• "Accept Share" prompt appears

• Tap "Accept"

• Wait 10-30 seconds

• Company appears in companies list (marked "Shared")

• Expected: Company accessible to User B

Test 2: Verify Shared Data

User A (Owner):

• Before sharing: Add 3 inventory items

• Add 2 orders

• Add 1 contact

• Share company to User B

• Wait 30 seconds after User B accepts

User B (Participant):

• After accepting share

• Open "Test Company Alpha"

• Navigate to Inventory

• Expected: See all 3 inventory items

• Navigate to Orders

• Expected: See both orders

• Navigate to Contacts

• Expected: See 1 contact

Result: All data synced correctly.

Test 3: Participant Creates Data

User B (Participant):

• Open shared company

• Create new inventory item: "Participant Widget"

• Create new order: Order #B001

• Wait 10 seconds

User A (Owner):

• Refresh or wait 30 seconds

• Navigate to Inventory

• Expected: "Participant Widget" appears

• Navigate to Orders

• Expected: Order #B001 appears

Result: Participant edits sync to owner.

Test 4: Owner Creates Data (Post-Share)

User A (Owner):

• Create new inventory item: "Owner Widget"

• Create new order: Order #A002

• Wait 10 seconds

User B (Participant):

• Refresh or wait 30 seconds

• Navigate to Inventory

• Expected: "Owner Widget" appears

• Navigate to Orders

• Expected: Order #A002 appears

Result: Owner edits sync to participant.

Test 5: Concurrent Edits

Setup: Both users edit same order at the same time (offline).

User A (Owner):

• Disable Wi-Fi

• Edit Order #A001: Set status = "Shipped"

• Save

User B (Participant):

• Disable Wi-Fi

• Edit same Order #A001: Set quantity = 50

• Save

Both Users:

• Re-enable Wi-Fi

• Wait 60 seconds for sync

Verify:

• User A sees: status = "Shipped", quantity = 50

• User B sees: status = "Shipped", quantity = 50

• Expected: Both edits preserved (property-level merge)

Test 6: Delete Shared Object

User A (Owner):

• Delete inventory item: "Participant Widget"

• Confirm deletion

• Wait 30 seconds

User B (Participant):

• Refresh inventory list

• Expected: "Participant Widget" no longer appears

User B (Participant):

• Delete order: Order #A002

• Confirm deletion

• Wait 30 seconds

User A (Owner):

• Refresh orders list

• Expected: Order #A002 no longer appears

Result: Deletions sync bidirectionally.

Permission Tests

Test 7: Read-Only Permission

User A (Owner):

• Create new company: "ReadOnly Test Co"

• Add inventory item: "Protected Item"

• Share company to User B

• In share settings: Set permission = "View Only"

User B (Participant):

• Accept share

• Open company

• Attempt to edit "Protected Item"

• Expected: Edit blocked (UI disabled or error message)

• Attempt to create new item

• Expected: Create blocked

Result: Read-only permission enforced.

Test 8: Read-Write Permission

User A (Owner):

• Update share permission to "Can Edit"

• Save

User B (Participant):

• Wait 30 seconds for permission sync

• Attempt to edit "Protected Item"

• Expected: Edit succeeds

• Create new item: "New Participant Item"

• Expected: Create succeeds

Result: Read-write permission works.

Test 9: AccessControl Integration

User A (Owner):

• Create AccessControl for User B

• Set: canViewInventory = true, canEditInventory = false

• Set: canViewOrders = true, canEditOrders = true

• Save

User B (Participant):

• Wait 30 seconds

• Navigate to Inventory

• Expected: Can view items

• Attempt to edit item

• Expected: Edit button disabled

• Navigate to Orders

• Expected: Can view and edit orders

Result: AccessControl permissions enforced.

Multi-Device Tests

Test 10: Owner Multi-Device Sync

User A - iPhone:

• Create company: "MultiDevice Co"

• Add inventory item: "iPhone Item"

• Wait 30 seconds

User A - iPad (same Apple ID):

• Open TheCompanyApp

• Expected: "MultiDevice Co" appears

• Expected: "iPhone Item" appears

User A - iPad:

• Add order: Order #iPad1

• Wait 30 seconds

User A - iPhone:

• Expected: Order #iPad1 appears

Result: Owner's data syncs across their devices.

Test 11: Participant Multi-Device Sync

User B - iPhone:

• Accept share for "MultiDevice Co"

• Add item: "iPhone Participant Item"

• Wait 30 seconds

User B - iPad (same Apple ID as User B iPhone):

• Open TheCompanyApp

• Expected: "MultiDevice Co" appears (shared)

• Expected: "iPhone Participant Item" appears

Result: Participant's data syncs across their devices.

Removal Tests

Test 12: Remove Participant

User A (Owner):

• Settings → Sharing → Participants

• Select User B

• Tap "Remove"

• Confirm

User B (Participant):

• Wait 60 seconds

• Refresh companies list

• Expected: "MultiDevice Co" removed from list

• Attempt to access company (if still cached)

• Expected: Error or "Access Denied"

Result: Participant removed successfully.

Test 13: Stop Sharing

User A (Owner):

• Share company to User B again

• User B accepts

• User A: Settings → Stop Sharing

• Confirm

User B (Participant):

• Wait 60 seconds

• Expected: Company removed from list

User A (Owner):

• Expected: Company still accessible (now private)

• Expected: All data intact

Result: Share stopped, company reverts to owner-only.

Test 14: Delete Shared Company

User A (Owner):

• Delete shared company (with participants)

• Confirm deletion

User B (Participant):

• Wait 60 seconds

• Expected: Company removed from list

User A (Owner):

• Expected: Company no longer in list

• Expected: All data deleted from iCloud

Result: Deletion cascades to all participants.

Edge Cases

Test 15: Offline Share Acceptance

User B (Participant):

• Disable Wi-Fi and cellular

• Tap share link

• Attempt to accept

• Expected: Error: "No internet connection"

User B (Participant):

• Re-enable connectivity

• Retry accept

• Expected: Acceptance succeeds

Result: Offline handling works.

Test 16: UserPass Isolation

User A (Owner):

• Create company: "Credential Test Co"

• Create UserPass: username="owneruser", password="ownerpass"

• Share company to User B

User B (Participant):

• Accept share

• Navigate to Login (if company requires login)

• Create UserPass: username="participantuser", password="participantpass"

Verify Isolation:

• User A: Settings → Users/Passwords

• Expected: See only "owneruser" (their own)

• User B: Settings → Users/Passwords

• Expected: See only "participantuser" (their own)

Result: UserPass not shared, each user has private credentials.

Test 17: Large Data Sync

User A (Owner):

• Create company

• Import 500 inventory items (via CSV or script)

• Share to User B

User B (Participant):

• Accept share

• Wait 2-5 minutes for full sync

• Expected: All 500 items synced

Performance:

• Check CloudKit logs for errors

• Verify no data loss

Result: Large datasets sync correctly.

Result Summary

Pass Criteria: All checkboxes checked with expected results.

Failure Handling:

• Document failed test case

• Capture screenshots

• Check CloudKit logs (see Debugging Logs)

• Report issue with details

---

Related: Troubleshooting, Debugging Logs, TestFlight Flow