778 lines
37 KiB
Swift
778 lines
37 KiB
Swift
// Sync/SyncManager.swift
|
|
// ----------------------
|
|
// Manages connectivity monitoring, reference data sync (Phase A),
|
|
// the outbox queue for offline inspection/issue submission (Phase B),
|
|
// and notification polling (Phase C).
|
|
|
|
import Foundation
|
|
import Network
|
|
import SwiftData
|
|
import SwiftUI
|
|
import Combine
|
|
import UserNotifications
|
|
|
|
@MainActor
|
|
class SyncManager: ObservableObject {
|
|
|
|
// ── Published State ───────────────────────────────────────────────────
|
|
|
|
@Published var isOnline = false
|
|
@Published var isSyncing = false
|
|
@Published var lastSyncAt: Date?
|
|
@Published var syncError: String?
|
|
@Published var pendingCount = 0
|
|
/// Dashboard KPI stats fetched from the server. Nil until first successful fetch.
|
|
@Published var dashboardStats: APIDashboardStats?
|
|
/// Count of notifications received since last resetNotificationPoller().
|
|
/// Incremented on each poll that returns new items; reset to 0 on logout.
|
|
@Published var unreadNotificationCount = 0
|
|
/// The most recent batch of notifications (up to 50) for the in-app inbox.
|
|
/// Replaced entirely on each successful poll; empty until first fetch.
|
|
@Published var recentNotifications: [APINotification] = []
|
|
|
|
// ── Dependencies ──────────────────────────────────────────────────────
|
|
|
|
private let monitor = NWPathMonitor()
|
|
private let monitorQueue = DispatchQueue(label: "com.jqc.networkmonitor")
|
|
var modelContext: ModelContext?
|
|
|
|
// ── Notification polling state ────────────────────────────────────────
|
|
// Tracks the timestamp of the most recently fetched notification so each
|
|
// poll only retrieves newer records. Nil on first launch → server returns
|
|
// last 50 unread. Reset to nil on logout.
|
|
private var lastNotificationFetch: Date?
|
|
private var pollTask: Task<Void, Never>? // replaces Timer — Task.sleep works correctly
|
|
private let pollInterval: UInt64 = 60_000_000_000 // 60 seconds in nanoseconds
|
|
|
|
// ── Shared date formatters ────────────────────────────────────────────
|
|
// DateFormatter init is expensive — allocating one per poll call or per
|
|
// issue would add measurable overhead at sync time. These are created
|
|
// once and reused across all calls. Both are nonisolated statics so they
|
|
// can be read from any context without actor-hopping.
|
|
//
|
|
// isoFormatter — parses/formats ISO 8601 strings from the server API
|
|
// e.g. "2026-05-01T14:30:00"
|
|
// notifFormatter — same format, used to advance the notification poll cursor
|
|
nonisolated static let isoFormatter: DateFormatter = {
|
|
let f = DateFormatter()
|
|
f.locale = Locale(identifier: "en_US_POSIX")
|
|
f.dateFormat = "yyyy-MM-dd'T'HH:mm:ss"
|
|
return f
|
|
}()
|
|
|
|
static let shared = SyncManager()
|
|
private init() {}
|
|
|
|
// ── Start Monitoring ──────────────────────────────────────────────────
|
|
|
|
func startMonitoring() {
|
|
monitor.pathUpdateHandler = { [weak self] path in
|
|
Task { @MainActor [weak self] in
|
|
guard let self else { return }
|
|
let wasOffline = !self.isOnline
|
|
self.isOnline = path.status == .satisfied
|
|
if self.isOnline {
|
|
if wasOffline {
|
|
await self.triggerSync()
|
|
}
|
|
self.startPollTask()
|
|
} else {
|
|
self.stopPollTask()
|
|
}
|
|
}
|
|
}
|
|
monitor.start(queue: monitorQueue)
|
|
}
|
|
|
|
// ── Notification poll task ────────────────────────────────────────────
|
|
// Timer.scheduledTimer requires RunLoop.main to be ticking. When called
|
|
// from inside a Swift Concurrency Task { @MainActor } the current RunLoop
|
|
// is NOT RunLoop.main — the timer is added to a runloop that never runs,
|
|
// so it silently fires never. Task + Task.sleep has no such dependency.
|
|
|
|
private func startPollTask() {
|
|
guard pollTask == nil else { return } // already running
|
|
pollTask = Task { [weak self] in
|
|
while !Task.isCancelled {
|
|
try? await Task.sleep(nanoseconds: 60_000_000_000)
|
|
guard !Task.isCancelled else { break }
|
|
await MainActor.run { [weak self] in
|
|
guard let self, self.isOnline,
|
|
AuthManager.shared.isAuthenticated else { return }
|
|
Task { await self.pollNotifications() }
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
private func stopPollTask() {
|
|
pollTask?.cancel()
|
|
pollTask = nil
|
|
}
|
|
|
|
/// Called on logout so the next login starts a clean fetch.
|
|
func resetNotificationPoller() {
|
|
lastNotificationFetch = nil
|
|
unreadNotificationCount = 0
|
|
recentNotifications = []
|
|
stopPollTask()
|
|
}
|
|
|
|
/// Call when the user opens the NotificationsView to clear the badge.
|
|
func markNotificationsViewed() {
|
|
unreadNotificationCount = 0
|
|
}
|
|
|
|
// ── Notification polling ──────────────────────────────────────────────
|
|
|
|
func pollNotifications() async {
|
|
guard isOnline, AuthManager.shared.isAuthenticated else { return }
|
|
do {
|
|
let notifications = try await APIClient.shared.fetchNotifications(since: lastNotificationFetch)
|
|
guard !notifications.isEmpty else { return }
|
|
|
|
// Deliver a local notification for each new item
|
|
for n in notifications {
|
|
deliverLocalNotification(n)
|
|
}
|
|
|
|
// Update in-app inbox state
|
|
recentNotifications = notifications + recentNotifications.prefix(50 - notifications.count)
|
|
unreadNotificationCount += notifications.count
|
|
|
|
// Update the cursor to the newest notification's timestamp so the
|
|
// next poll only fetches newer items — do NOT mark notifications as
|
|
// read on the server. Read state is a deliberate user action managed
|
|
// via the web app; marking read here would cause the web badge count
|
|
// to always show zero when the iPad has polled before the user checks.
|
|
let dates = notifications.compactMap { Self.isoFormatter.date(from: $0.createdAt) }
|
|
if let newest = dates.max() {
|
|
lastNotificationFetch = newest
|
|
}
|
|
|
|
} catch APIError.notAuthenticated {
|
|
// Token expired and refresh failed — let AuthManager handle it
|
|
} catch {
|
|
// Network errors are silent; next poll will retry
|
|
}
|
|
}
|
|
|
|
// ── Local notification delivery ───────────────────────────────────────
|
|
|
|
private func deliverLocalNotification(_ n: APINotification) {
|
|
let content = UNMutableNotificationContent()
|
|
content.title = n.title
|
|
content.body = n.body
|
|
content.sound = .default
|
|
|
|
// Use the server notification ID as the identifier so duplicate
|
|
// deliveries (if the same record is fetched twice) replace rather
|
|
// than stack.
|
|
let identifier = "jqc-notif-\(n.id)"
|
|
let request = UNNotificationRequest(
|
|
identifier: identifier,
|
|
content: content,
|
|
trigger: nil // nil = deliver immediately
|
|
)
|
|
UNUserNotificationCenter.current().add(request) { error in
|
|
if let error {
|
|
print("[JQC] Local notification delivery failed: \(error)")
|
|
}
|
|
}
|
|
}
|
|
|
|
// ── Full Sync ─────────────────────────────────────────────────────────
|
|
|
|
func triggerSync() async {
|
|
// Do not sync unless authenticated — avoids 401 loops before
|
|
// restoreSession() completes on first launch.
|
|
guard isOnline, let context = modelContext, AuthManager.shared.isAuthenticated else { return }
|
|
|
|
// Re-entrancy guard. triggerSync() has many independent call sites
|
|
// (issue submit, inspection submit, manual "Sync Now", NWPathMonitor
|
|
// reconnect, the 60s poll timer, app-foreground). Although this class
|
|
// is @MainActor, the `await` points inside processPhotoQueue/etc.
|
|
// yield the actor, so a second triggerSync() call can interleave
|
|
// between those awaits and run concurrently with the first.
|
|
//
|
|
// Without this guard, two overlapping passes both fetch the same
|
|
// "pending" PendingPhoto records (neither has flipped uploadStatus
|
|
// yet), both upload the same local file, and each appends its own
|
|
// distinct server-generated filename to LocalIssue.photoServerPaths.
|
|
// The `!paths.contains(serverPath)` dedup check in processPhotoQueue
|
|
// never catches this because the two server paths are different
|
|
// strings for the same photo content — producing duplicated photos
|
|
// in the issue's evidence (and therefore in the exported PDF).
|
|
//
|
|
// Guarding re-entrancy here closes the race at its source rather
|
|
// than trying to dedupe by content downstream.
|
|
guard !isSyncing else { return }
|
|
|
|
isSyncing = true
|
|
syncError = nil
|
|
defer { isSyncing = false }
|
|
|
|
await processPhotoQueue(context: context)
|
|
await processInspectionQueue(context: context)
|
|
await processIssueQueue(context: context)
|
|
await pullReferenceData()
|
|
await pullAssignedIssues(context: context)
|
|
|
|
// Poll notifications immediately on every sync rather than waiting
|
|
// for the 60-second timer — ensures the inspector sees assignments
|
|
// and follow-up requests as soon as the app goes online.
|
|
await pollNotifications()
|
|
|
|
// Fetch dashboard KPIs — best-effort, non-fatal on failure.
|
|
await fetchDashboardStats()
|
|
|
|
// Periodically remove local photo files that are no longer needed.
|
|
// Runs at most once per hour to avoid repeated FileManager calls on
|
|
// every 60-second sync cycle.
|
|
cleanupOrphanedPhotos(context: context)
|
|
|
|
updatePendingCount(context: context)
|
|
lastSyncAt = Date()
|
|
}
|
|
|
|
// ── Outbox: Photos ────────────────────────────────────────────────────
|
|
|
|
private func processPhotoQueue(context: ModelContext) async {
|
|
// Fetch all then filter in Swift — #Predicate cannot reference
|
|
// string literals against PendingPhoto.uploadStatus reliably
|
|
// when the predicate type is inferred across model boundaries.
|
|
guard let allPhotos = try? context.fetch(FetchDescriptor<PendingPhoto>()) else { return }
|
|
var pending = allPhotos
|
|
.filter { $0.uploadStatus == "pending" }
|
|
.sorted { $0.createdAt < $1.createdAt }
|
|
|
|
// Defense-in-depth: if two PendingPhoto rows somehow reference the
|
|
// exact same local file (e.g. a future call site re-submitting the
|
|
// same photo array), only upload it once. The primary fix for photo
|
|
// duplication is the re-entrancy guard in triggerSync(), but this
|
|
// keeps processPhotoQueue itself safe even if it's ever invoked
|
|
// outside that guard.
|
|
var seenPaths = Set<String>()
|
|
var duplicates: [PendingPhoto] = []
|
|
pending = pending.filter { photo in
|
|
if seenPaths.contains(photo.localFilePath) {
|
|
duplicates.append(photo)
|
|
return false
|
|
}
|
|
seenPaths.insert(photo.localFilePath)
|
|
return true
|
|
}
|
|
for dup in duplicates {
|
|
// Mark the duplicate row as uploaded without re-uploading — the
|
|
// first row for this file will populate serverPath/photoServerPaths.
|
|
dup.uploadStatus = "uploaded"
|
|
}
|
|
|
|
// Pre-fetch parent records ONCE before the loop.
|
|
// Without this, every successful photo upload fetched ALL LocalInspection
|
|
// and ALL LocalIssue records from SwiftData to find the parent —
|
|
// N photos → 2N full-table fetches. Pre-fetching here reduces that
|
|
// to 2 fetches regardless of how many photos are in the queue.
|
|
// Fetch-all + filter in Swift — #Predicate with a captured String variable
|
|
// causes "LocalInspection is ambiguous" under Xcode 26 (CLAUDE.md rule 3).
|
|
let allInspections = (try? context.fetch(FetchDescriptor<LocalInspection>())) ?? []
|
|
let allIssues = (try? context.fetch(FetchDescriptor<LocalIssue>())) ?? []
|
|
|
|
for photo in pending {
|
|
do {
|
|
let serverPath = try await APIClient.shared.uploadPhoto(
|
|
localPath: photo.localFilePath,
|
|
entityType: photo.entityType
|
|
)
|
|
photo.serverPath = serverPath
|
|
photo.uploadStatus = "uploaded"
|
|
|
|
// Update parent inspection form field value.
|
|
// Pre-fetched before the loop — not repeated per photo.
|
|
if photo.entityType == "inspection", let fieldId = photo.fieldId {
|
|
let entityId = photo.entityLocalId
|
|
allInspections.first(where: { $0.localId == entityId })?
|
|
.setValue(serverPath, forFieldId: fieldId)
|
|
}
|
|
|
|
// Update parent issue photo paths array.
|
|
// Pre-fetched before the loop — not repeated per photo.
|
|
if photo.entityType == "issue" {
|
|
let entityId = photo.entityLocalId
|
|
if let issue = allIssues.first(where: { $0.localId == entityId }) {
|
|
var paths = issue.photoServerPaths
|
|
if !paths.contains(serverPath) { paths.append(serverPath) }
|
|
issue.photoServerPaths = paths
|
|
}
|
|
}
|
|
|
|
try? context.save()
|
|
|
|
} catch {
|
|
photo.uploadStatus = "failed"
|
|
try? context.save()
|
|
}
|
|
}
|
|
}
|
|
|
|
// ── Outbox: Inspections ───────────────────────────────────────────────
|
|
|
|
private func processInspectionQueue(context: ModelContext) async {
|
|
guard let all = try? context.fetch(FetchDescriptor<LocalInspection>()) else { return }
|
|
let pending = all
|
|
.filter { $0.status == "completed" && $0.syncStatus == "pending" }
|
|
.sorted { $0.createdAt < $1.createdAt }
|
|
|
|
for inspection in pending {
|
|
let photosReady = inspection.pendingPhotos.allSatisfy {
|
|
$0.uploadStatus == "uploaded" || $0.uploadStatus == "failed"
|
|
}
|
|
guard photosReady else { continue }
|
|
|
|
do {
|
|
let inspectionId = try await APIClient.shared.submitInspection(inspection)
|
|
inspection.serverId = inspectionId
|
|
inspection.syncStatus = "synced"
|
|
inspection.status = "synced"
|
|
|
|
// Clear follow-up flag on parent.
|
|
// Reuses the `all` array already fetched at the top of this
|
|
// function — avoids a redundant full-table fetch per inspection.
|
|
if let parentLocalId = inspection.parentLocalId,
|
|
let parent = all.first(where: { $0.localId == parentLocalId }) {
|
|
parent.followUpRequired = false
|
|
parent.followUpNote = nil
|
|
}
|
|
|
|
try? context.save()
|
|
|
|
} catch {
|
|
inspection.syncRetryCount += 1
|
|
inspection.syncErrorMessage = error.localizedDescription
|
|
if inspection.syncRetryCount >= 5 {
|
|
inspection.syncStatus = "failed"
|
|
}
|
|
syncError = "Failed to sync inspection: \(error.localizedDescription)"
|
|
try? context.save()
|
|
}
|
|
}
|
|
}
|
|
|
|
// ── Outbox: Issues ────────────────────────────────────────────────────
|
|
|
|
private func processIssueQueue(context: ModelContext) async {
|
|
guard let all = try? context.fetch(FetchDescriptor<LocalIssue>()) else { return }
|
|
let pending = all
|
|
.filter { $0.syncStatus == "pending" }
|
|
.sorted { $0.createdAt < $1.createdAt }
|
|
|
|
// Pre-fetch all inspections to check parent sync status AND to resolve
|
|
// the parent's serverId. The allInspections array is the same set of
|
|
// objects that processInspectionQueue updated (serverId written in-memory
|
|
// this same triggerSync pass), so looking up serverId here is reliable.
|
|
// issue.inspection?.serverId is NOT reliable — it navigates a @Relationship
|
|
// that SwiftData may have loaded as a separate object instance before
|
|
// processInspectionQueue wrote the serverId back, leaving it nil even
|
|
// when the parent inspection already synced successfully this same pass.
|
|
let allInspections = (try? context.fetch(FetchDescriptor<LocalInspection>())) ?? []
|
|
|
|
for issue in pending {
|
|
let parentLocalId = issue.inspectionLocalId
|
|
let parent = allInspections.first(where: { $0.localId == parentLocalId })
|
|
|
|
// ── Parent inspection status guards ───────────────────────────
|
|
if let parent {
|
|
switch parent.syncStatus {
|
|
case "failed":
|
|
// Parent permanently failed — this issue can never be linked.
|
|
// Mark it failed immediately rather than creating an orphaned
|
|
// server record with no inspection_id.
|
|
issue.syncStatus = "failed"
|
|
issue.syncErrorMessage = "Parent inspection failed to sync — issue cannot be submitted."
|
|
try? context.save()
|
|
syncError = "Issue \(issue.localId.prefix(8))\u{2026} blocked: parent inspection did not sync."
|
|
continue
|
|
|
|
case "synced":
|
|
// Parent has a serverId — proceed and link correctly.
|
|
break
|
|
|
|
default:
|
|
// Parent is still "pending" (draft or awaiting submission).
|
|
// Submitting now would create a server issue with no
|
|
// inspection_id — the issue and inspection appear unlinked
|
|
// on the web. Defer until the next triggerSync() pass, by
|
|
// which point processInspectionQueue will have synced the
|
|
// parent and assigned it a serverId.
|
|
continue
|
|
}
|
|
}
|
|
// parent == nil means inspectionLocalId == "" (standalone issue) — submit without inspection_id.
|
|
|
|
// Resolve the parent's server ID. Safe to force-unwrap serverId
|
|
// here — the switch above guarantees parent.syncStatus == "synced"
|
|
// when parent is non-nil, so serverId is always set at this point.
|
|
let inspectionServerId = parent?.serverId
|
|
|
|
do {
|
|
let issueId = try await APIClient.shared.submitIssue(issue, inspectionServerId: inspectionServerId)
|
|
issue.serverId = issueId
|
|
issue.syncStatus = "synced"
|
|
// Photos are now represented by photoServerPaths on the server.
|
|
// Clear the local file paths so IssueDetailView doesn't render
|
|
// a duplicate "local photos" section alongside the server section.
|
|
issue.photoLocalPaths = []
|
|
try? context.save()
|
|
|
|
// If there are additional photos beyond the first (which was sent
|
|
// as photo_path on create), PATCH them to result_photos now.
|
|
// The server create endpoint only stores photo_path; result_photos
|
|
// must be set via a separate PATCH call.
|
|
let extras = Array(issue.photoServerPaths.dropFirst())
|
|
if !extras.isEmpty {
|
|
try? await APIClient.shared.updateIssuePhotos(
|
|
issueId: issueId, resultPhotos: extras
|
|
)
|
|
}
|
|
|
|
} catch {
|
|
issue.syncRetryCount += 1
|
|
issue.syncErrorMessage = error.localizedDescription
|
|
if issue.syncRetryCount >= 5 {
|
|
issue.syncStatus = "failed"
|
|
}
|
|
try? context.save()
|
|
}
|
|
}
|
|
}
|
|
|
|
// ── Reference Data ────────────────────────────────────────────────────
|
|
|
|
func pullReferenceData() async {
|
|
guard isOnline, let context = modelContext else { return }
|
|
|
|
do {
|
|
let facilitiesData: FacilitiesResponseData =
|
|
try await APIClient.shared.request("/api/v1/facilities")
|
|
let templatesData: TemplatesResponseData =
|
|
try await APIClient.shared.request("/api/v1/templates")
|
|
|
|
let existingFacilities = try context.fetch(FetchDescriptor<LocalFacility>())
|
|
let facilityMap = Dictionary(
|
|
existingFacilities.map { ($0.serverId, $0) },
|
|
uniquingKeysWith: { a, _ in a }
|
|
)
|
|
|
|
// Deduplicate the server response by id before upserting.
|
|
// The server may return the same facility id more than once
|
|
// (e.g. one row per contract assignment), which would insert
|
|
// duplicate LocalFacility records and show buildings twice in
|
|
// every picker. Keep only the first occurrence of each id.
|
|
var seenFacilityIds = Set<Int>()
|
|
let uniqueFacilities = facilitiesData.facilities.filter {
|
|
seenFacilityIds.insert($0.id).inserted
|
|
}
|
|
|
|
for apiFacility in uniqueFacilities {
|
|
let localFacility: LocalFacility
|
|
if let existing = facilityMap[apiFacility.id] {
|
|
existing.update(from: apiFacility)
|
|
localFacility = existing
|
|
} else {
|
|
let newFacility = LocalFacility(from: apiFacility)
|
|
context.insert(newFacility)
|
|
localFacility = newFacility
|
|
}
|
|
try await upsertAreas(for: apiFacility.id, facility: localFacility, context: context)
|
|
}
|
|
|
|
let existingTemplates = try context.fetch(FetchDescriptor<LocalTemplate>())
|
|
let templateMap = Dictionary(
|
|
existingTemplates.map { ($0.serverId, $0) },
|
|
uniquingKeysWith: { a, _ in a }
|
|
)
|
|
|
|
for apiSummary in templatesData.templates {
|
|
if let existing = templateMap[apiSummary.id] {
|
|
existing.updateSummary(from: apiSummary)
|
|
} else {
|
|
context.insert(LocalTemplate(from: apiSummary))
|
|
}
|
|
try await upsertTemplateSchema(
|
|
id: apiSummary.id, context: context, templateMap: templateMap
|
|
)
|
|
}
|
|
|
|
// Delete any cached templates the server no longer returns.
|
|
// The server endpoint now only returns active templates, so any
|
|
// locally cached template not in the response was deactivated.
|
|
// Deleting ensures they never appear in the picker even offline.
|
|
let returnedTemplateIds = Set(templatesData.templates.map { $0.id })
|
|
for existing in existingTemplates {
|
|
if !returnedTemplateIds.contains(existing.serverId) {
|
|
context.delete(existing)
|
|
}
|
|
}
|
|
|
|
try context.save()
|
|
|
|
} catch APIError.notAuthenticated {
|
|
syncError = "Session expired. Please log in again."
|
|
} catch {
|
|
syncError = "Sync failed: \(error.localizedDescription)"
|
|
}
|
|
}
|
|
|
|
// ── Pending Count ─────────────────────────────────────────────────────
|
|
|
|
// ── Orphaned Photo Cleanup ────────────────────────────────────────────
|
|
// Removes local JPEG files from Documents/JQCPhotos/ that are no longer
|
|
// referenced by any LocalInspection, LocalIssue, or PendingPhoto record.
|
|
// Once an inspection or issue is fully synced its local photos are no
|
|
// longer needed — the server holds the canonical copies. Without this,
|
|
// weeks of inspections accumulate hundreds of MBs of orphaned files.
|
|
//
|
|
// Throttled to once per hour via UserDefaults to avoid redundant
|
|
// FileManager enumeration on every 60-second sync cycle.
|
|
|
|
private static let lastCleanupKey = "jqc.photoCleanup.lastRunAt"
|
|
private static let cleanupInterval: TimeInterval = 3600 // 1 hour
|
|
|
|
private func cleanupOrphanedPhotos(context: ModelContext) {
|
|
let last = UserDefaults.standard.object(forKey: Self.lastCleanupKey) as? Date
|
|
guard last == nil || Date().timeIntervalSince(last!) >= Self.cleanupInterval else { return }
|
|
UserDefaults.standard.set(Date(), forKey: Self.lastCleanupKey)
|
|
|
|
let fm = FileManager.default
|
|
guard let docsDir = fm.urls(for: .documentDirectory, in: .userDomainMask).first else { return }
|
|
let photosDir = docsDir.appendingPathComponent("JQCPhotos")
|
|
guard let diskFiles = try? fm.contentsOfDirectory(
|
|
at: photosDir, includingPropertiesForKeys: nil
|
|
) else { return }
|
|
|
|
// Collect all local paths that are still in use.
|
|
var referencedPaths = Set<String>()
|
|
|
|
// PendingPhoto — not yet uploaded
|
|
if let pendingPhotos = try? context.fetch(FetchDescriptor<PendingPhoto>()) {
|
|
for p in pendingPhotos where p.uploadStatus != "uploaded" {
|
|
referencedPaths.insert(p.localFilePath)
|
|
}
|
|
}
|
|
// LocalInspection — draft photos (formData values starting with "local://")
|
|
if let inspections = try? context.fetch(FetchDescriptor<LocalInspection>()) {
|
|
for insp in inspections where insp.status == "draft" {
|
|
for val in insp.formData.values {
|
|
if let s = val as? String, s.hasPrefix("local://") {
|
|
referencedPaths.insert(String(s.dropFirst("local://".count)))
|
|
}
|
|
}
|
|
}
|
|
}
|
|
// LocalIssue — unsync'd issue photos
|
|
if let issues = try? context.fetch(FetchDescriptor<LocalIssue>()) {
|
|
for issue in issues where issue.syncStatus != "synced" {
|
|
for path in issue.photoLocalPaths { referencedPaths.insert(path) }
|
|
}
|
|
}
|
|
|
|
// Delete any disk file not in referencedPaths
|
|
var deletedCount = 0
|
|
for fileURL in diskFiles {
|
|
let path = fileURL.path
|
|
if !referencedPaths.contains(path) {
|
|
try? fm.removeItem(at: fileURL)
|
|
deletedCount += 1
|
|
}
|
|
}
|
|
if deletedCount > 0 {
|
|
print("[JQC] Sync | cleanupOrphanedPhotos | removed \(deletedCount) file(s)")
|
|
}
|
|
}
|
|
|
|
func updatePendingCount(context: ModelContext) {
|
|
// Fetch-all + filter in Swift — #Predicate with string literals is
|
|
// banned under Xcode 26 SWIFT_DEFAULT_ACTOR_ISOLATION (CLAUDE.md rule 3).
|
|
// These fetches are lightweight (no relationships loaded) and run once
|
|
// per sync cycle at the very end, not in a hot loop.
|
|
let inspCount = (try? context.fetch(FetchDescriptor<LocalInspection>()))?
|
|
.filter { $0.syncStatus == "pending" }.count ?? 0
|
|
let issueCount = (try? context.fetch(FetchDescriptor<LocalIssue>()))?
|
|
.filter { $0.syncStatus == "pending" }.count ?? 0
|
|
pendingCount = inspCount + issueCount
|
|
}
|
|
|
|
// ── Private Helpers ───────────────────────────────────────────────────
|
|
|
|
private func upsertAreas(for facilityId: Int, facility: LocalFacility, context: ModelContext) async throws {
|
|
let areasData: AreasResponseData = try await APIClient.shared.request(
|
|
"/api/v1/facilities/\(facilityId)/areas"
|
|
)
|
|
let existing = (try? context.fetch(FetchDescriptor<LocalArea>()))?
|
|
.filter { $0.facilityServerId == facilityId } ?? []
|
|
let areaMap = Dictionary(existing.map { ($0.serverId, $0) },
|
|
uniquingKeysWith: { a, _ in a })
|
|
for apiArea in areasData.areas {
|
|
if let ex = areaMap[apiArea.id] {
|
|
ex.update(from: apiArea)
|
|
// Re-wire relationship in case it was lost (e.g. cache clear)
|
|
if ex.facility == nil { ex.facility = facility }
|
|
} else {
|
|
let newArea = LocalArea(from: apiArea)
|
|
// Wire the inverse relationship so LocalFacility.areas is populated.
|
|
// Without this assignment SwiftData never links the area into the
|
|
// facility's areas array and selectedFacility?.areas returns [].
|
|
newArea.facility = facility
|
|
context.insert(newArea)
|
|
}
|
|
}
|
|
}
|
|
|
|
private func upsertTemplateSchema(
|
|
id: Int,
|
|
context: ModelContext,
|
|
templateMap: [Int: LocalTemplate]
|
|
) async throws {
|
|
let detailData: TemplateDetailResponseData = try await APIClient.shared.request(
|
|
"/api/v1/templates/\(id)"
|
|
)
|
|
if let existing = templateMap[id] {
|
|
existing.updateSchema(from: detailData.template)
|
|
} else {
|
|
(try? context.fetch(FetchDescriptor<LocalTemplate>()))?
|
|
.first { $0.serverId == id }?
|
|
.updateSchema(from: detailData.template)
|
|
}
|
|
}
|
|
|
|
// ── Pull server-assigned issues ───────────────────────────────────────
|
|
// Fetches issues assigned to the current user on the server and upserts
|
|
// them into SwiftData so IssuesListView shows them alongside device-created issues.
|
|
// Keyed by serverId — existing records are updated in-place, new ones inserted.
|
|
// These records carry syncStatus = "synced" and a generated localId so they
|
|
// are never re-submitted to the server by processIssueQueue.
|
|
|
|
func pullAssignedIssues(context: ModelContext) async {
|
|
guard isOnline, AuthManager.shared.isAuthenticated else { return }
|
|
do {
|
|
let apiIssues = try await APIClient.shared.fetchAssignedIssues()
|
|
// Do not return early on empty — deletion still needs to run
|
|
// to remove issues that were unassigned from this inspector.
|
|
|
|
// Build a map of existing LocalIssues by serverId for upsert
|
|
let allLocal = (try? context.fetch(FetchDescriptor<LocalIssue>())) ?? []
|
|
var serverIdMap: [Int: LocalIssue] = [:]
|
|
for local in allLocal {
|
|
if let sid = local.serverId { serverIdMap[sid] = local }
|
|
}
|
|
|
|
for api in apiIssues {
|
|
if let existing = serverIdMap[api.id] {
|
|
// Update mutable fields on existing record
|
|
existing.issueStatus = api.status
|
|
existing.severity = api.severity
|
|
existing.issueDescription = api.description
|
|
if let fid = api.facilityId { existing.facilityServerId = fid }
|
|
// Cache facility name so IssueDetailView works when local
|
|
// facility reference cache has been cleared (Settings → Clear Cache).
|
|
if let fn = api.facilityName, !fn.isEmpty {
|
|
existing.facilityNameCache = fn
|
|
}
|
|
// Phase A — resolution details from web staff
|
|
existing.resultNotes = api.resultNotes
|
|
existing.verificationNote = api.verificationNote
|
|
existing.reportedByName = api.reportedByName
|
|
existing.areaNameCache = api.areaName
|
|
existing.assignedToName = api.assignedToName
|
|
if let vts = api.verifiedAt,
|
|
let date = Self.isoFormatter.date(from: vts) {
|
|
existing.verifiedAt = date
|
|
}
|
|
// Refresh photos in case they were added after first pull
|
|
// photoServerPaths = evidence photos only (photo_path + mobile_photo_paths).
|
|
// result_photos are resolution photos — shown separately on the web,
|
|
// not displayed on the iPad issues list.
|
|
var serverPaths: [String] = []
|
|
if let p = api.photoPath, !p.isEmpty { serverPaths.append(p) }
|
|
serverPaths.append(contentsOf: api.mobilePhotoPaths)
|
|
existing.photoServerPaths = serverPaths
|
|
} else {
|
|
// Insert new server-pulled issue
|
|
let local = LocalIssue(
|
|
inspectionLocalId: "",
|
|
facilityServerId: api.facilityId ?? 0,
|
|
severity: api.severity,
|
|
description: api.description
|
|
)
|
|
local.serverId = api.id
|
|
local.issueStatus = api.status
|
|
local.syncStatus = "synced" // never re-submit
|
|
// Cache facility name for offline display
|
|
local.facilityNameCache = api.facilityName
|
|
// Phase A — resolution details from web staff
|
|
local.resultNotes = api.resultNotes
|
|
local.verificationNote = api.verificationNote
|
|
local.reportedByName = api.reportedByName
|
|
local.areaNameCache = api.areaName
|
|
local.assignedToName = api.assignedToName
|
|
if let vts = api.verifiedAt,
|
|
let date = Self.isoFormatter.date(from: vts) {
|
|
local.verifiedAt = date
|
|
}
|
|
// Store server photos so IssueDetailView can show them
|
|
// photoServerPaths = evidence photos only (photo_path + mobile_photo_paths).
|
|
var serverPaths: [String] = []
|
|
if let p = api.photoPath, !p.isEmpty { serverPaths.append(p) }
|
|
serverPaths.append(contentsOf: api.mobilePhotoPaths)
|
|
local.photoServerPaths = serverPaths
|
|
if let ts = api.reportedAt,
|
|
let date = Self.isoFormatter.date(from: ts) {
|
|
local.createdAt = date
|
|
local.serverReportedAt = date // accurate server timestamp
|
|
}
|
|
context.insert(local)
|
|
}
|
|
}
|
|
|
|
// Remove server-pulled records that are no longer in the response.
|
|
// This happens when an issue is reassigned to a different inspector —
|
|
// the server stops returning it for this user, so the local copy must
|
|
// be deleted. Only remove records that were pulled from the server
|
|
// (syncStatus == "synced" AND serverId != nil AND inspectionLocalId == "").
|
|
// Device-created issues (inspectionLocalId != "") are never touched.
|
|
let returnedServerIds = Set(apiIssues.map { $0.id })
|
|
for local in allLocal {
|
|
guard let sid = local.serverId,
|
|
local.syncStatus == "synced",
|
|
local.inspectionLocalId == ""
|
|
else { continue }
|
|
if !returnedServerIds.contains(sid) {
|
|
context.delete(local)
|
|
}
|
|
}
|
|
|
|
try? context.save()
|
|
|
|
} catch APIError.notAuthenticated {
|
|
// Let AuthManager handle session expiry
|
|
} catch {
|
|
// Non-fatal — IssuesListView still shows device-created issues
|
|
}
|
|
}
|
|
|
|
// ── Dashboard Stats ───────────────────────────────────────────────────
|
|
// Best-effort fetch — a network failure silently leaves dashboardStats nil
|
|
// so the UI falls back to a placeholder card. Never blocks the sync pipeline.
|
|
|
|
func fetchDashboardStats() async {
|
|
guard isOnline, AuthManager.shared.isAuthenticated else { return }
|
|
do {
|
|
dashboardStats = try await APIClient.shared.fetchDashboardStats()
|
|
} catch APIError.notAuthenticated {
|
|
// Let AuthManager handle session expiry
|
|
} catch {
|
|
// Non-fatal — stale stats stay visible until next successful fetch
|
|
}
|
|
}
|
|
}
|