SPB Git

Repository Public

MaintenanceCommon.swift 10.4 KB 223 lines swift

1import MCCCore2import SwiftUI34/// Permission the server requires for windows and notes (UI hint only; the server enforces).5enum MaintenancePermission {6    static let write = "maintenance.write"7}89/// Content of an occurrence row: title, when (window's zone, and local when different), category, status, scope,10/// notes, flags. State is always text + symbol.11struct OccurrenceSummary: View {12    @Environment(\.mccTheme) private var theme13    @Environment(\.dynamicTypeSize) private var size14    @Session private var session15    let occurrence: API.MaintenanceOccurrence1617    var body: some View {18        let w = occurrence.window19        let range = MaintenanceLogic.timeRange(start: occurrence.occurrenceStart, end: occurrence.occurrenceEnd, zoneID: w.timezone)20        let active = occurrence.active == true21        VStack(alignment: .leading, spacing: Tokens.Space.s2) {22            Label(w.title, systemImage: w.category.symbol).font(.body.weight(.medium)).foregroundStyle(theme.textPrimary)23            Text(range.zone).font(.footnote).foregroundStyle(theme.textSecondary)24            if let local = range.local {25                Text(tr("maintenance.local_time", local)).font(.footnote).foregroundStyle(theme.textTertiary)26            }27            let badges = Group {28                StatusLabel(active ? API.MaintenanceStatus.inProgress.label : w.status.label, tone: active ? .maintenance : w.status.tone)29                Text(w.category.label).font(.footnote).foregroundStyle(theme.textSecondary)30                if w.recurrence != .none {31                    Label(w.recurrence.label, systemImage: "repeat").font(.footnote).foregroundStyle(theme.textSecondary)32                }33            }34            if size.isAccessibilitySize {35                VStack(alignment: .leading, spacing: Tokens.Space.s1) { badges }36            } else {37                HStack(spacing: Tokens.Space.s4) { badges }38            }39            Label(MaintenanceLogic.scopeSummary(nodeIDs: w.scope.nodeIds) { session.nodes.alias($0) }, systemImage: "desktopcomputer")40                .font(.footnote).foregroundStyle(theme.textSecondary)41            let flags = Group {42                if occurrence.noteCount > 0 {43                    Label(tr("maintenance.note_count", occurrence.noteCount), systemImage: "note.text")44                }45                if w.setMaintenanceMode { Label(tr("maintenance.flag.mode.short"), systemImage: "wrench.and.screwdriver") }46                if w.silenceAlerts { Label(tr("maintenance.flag.silence.short"), systemImage: "bell.slash") }47            }48            .font(.footnote).foregroundStyle(theme.textTertiary)49            if size.isAccessibilitySize {50                VStack(alignment: .leading, spacing: Tokens.Space.s1) { flags }51            } else {52                HStack(spacing: Tokens.Space.s4) { flags }53            }54        }55        .frame(maxWidth: .infinity, alignment: .leading)56        .accessibilityElement(children: .combine)57    }58}5960struct OccurrenceRow: View {61    let occurrence: API.MaintenanceOccurrence62    var body: some View {63        RouteRow(route: .maintenanceWindow(id: occurrence.window.id, occurrence: occurrence.occurrenceStart), identifier: "occurrence-row") {64            OccurrenceSummary(occurrence: occurrence)65        }66    }67}6869/// One note with its actions (edit, pin, delete). Mutations go through the screen's `MutationRunner`.70struct NoteCard: View {71    @Environment(Navigator.self) private var nav72    @Environment(\.mccTheme) private var theme73    @Session private var session74    let note: API.MaintenanceNote75    let runner: MutationRunner76    /// Shows what the note is attached to (search results, node notes).77    var showsContext = false78    @State private var confirmDelete = false7980    private var canWrite: Bool { session.canMutate && session.can(MaintenancePermission.write) }8182    var body: some View {83        Card(padding: Tokens.Space.s4) {84            VStack(alignment: .leading, spacing: Tokens.Space.s3) {85                HStack(alignment: .firstTextBaseline) {86                    if note.pinned {87                        Label(tr("notes.pinned"), systemImage: "pin.fill").font(.footnote.weight(.semibold)).foregroundStyle(theme.accent)88                            .accessibilityIdentifier("note-pinned-flag")89                    }90                    Spacer(minLength: Tokens.Space.s3)91                    menu92                }93                Text(note.body).font(.body).foregroundStyle(theme.textPrimary).textSelection(.enabled)94                    .frame(maxWidth: .infinity, alignment: .leading)95                    .accessibilityIdentifier("note-row")96                Text(byline).font(.footnote).foregroundStyle(theme.textSecondary)97                if showsContext { context }98            }99        }100        .confirmationDialog(tr("notes.delete.title"), isPresented: $confirmDelete, titleVisibility: .visible) {101            Button(tr("common.delete"), role: .destructive) {102                Task { await runner.run { try await session.maintenance.deleteNote(id: note.id) } }103            }104            .accessibilityIdentifier("note-delete-confirm")105            Button(tr("common.cancel"), role: .cancel) {}106        } message: {107            Text(tr("notes.delete.message"))108        }109    }110111    private var byline: String {112        var parts = [note.authorDisplayName, Format.dateTime(note.createdAt)]113        if let e = note.editedAt { parts.append(tr("notes.edited", Format.dateTime(e))) }114        return parts.joined(separator: " · ")115    }116117    @ViewBuilder private var context: some View {118        VStack(alignment: .leading, spacing: Tokens.Space.s1) {119            if let alias = note.nodeAlias ?? note.nodeId.flatMap({ session.nodes.alias($0) }) {120                Label(alias, systemImage: "desktopcomputer").font(.footnote).foregroundStyle(theme.textSecondary)121            }122            if let o = note.occurrence {123                Label(tr("notes.occurrence_of", Format.dateTime(o)), systemImage: "calendar").font(.footnote).foregroundStyle(theme.textSecondary)124            }125            if let id = note.windowId {126                Button { nav.open(.maintenanceWindow(id: id, occurrence: note.occurrence)) } label: {127                    Label(tr("notes.open_window"), systemImage: "calendar.badge.clock").frame(minHeight: Tokens.Size.touchMin)128                }129                .font(.callout)130                .accessibilityIdentifier("note-open-window")131            }132        }133    }134135    private var menu: some View {136        Menu {137            Button {138                nav.sheet = .noteEditor(NoteContext(noteID: note.id, windowID: note.windowId, nodeID: note.nodeId, occurrence: note.occurrence, body: note.body, pinned: note.pinned))139            } label: { Label(tr("common.edit"), systemImage: "pencil") }140                .accessibilityIdentifier("note-edit")141            Button {142                Task { await runner.run { try await session.maintenance.updateNote(id: note.id, pinned: !note.pinned) } }143            } label: { Label(tr(note.pinned ? "notes.unpin" : "notes.pin"), systemImage: note.pinned ? "pin.slash" : "pin") }144                .accessibilityIdentifier("note-pin")145            Button(role: .destructive) { confirmDelete = true } label: { Label(tr("common.delete"), systemImage: "trash") }146                .accessibilityIdentifier("note-delete")147        } label: {148            Image(systemName: "ellipsis.circle").font(.title3).touchTarget().contentShape(Rectangle())149        }150        .disabled(!canWrite || runner.isRunning)151        .accessibilityLabel(tr("notes.actions"))152        .accessibilityHint(canWrite ? "" : tr(session.canMutate ? "mutation.denied_hint" : "mutation.offline_hint"))153        .accessibilityIdentifier("note-menu")154    }155}156157/// Notes of a query, pinned first, with their explicit states and timestamp.158struct NotesBlock: View {159    @Environment(\.mccTheme) private var theme160    @Session private var session161    let query: NotesQuery162    let runner: MutationRunner163    var showsContext = false164    var emptyText: String = tr("notes.empty")165166    var body: some View {167        let resource = session.maintenance.notes[query]168        ResourceSection(resource: resource) { notes in169            if notes.isEmpty {170                Text(emptyText).font(.callout).foregroundStyle(theme.textSecondary).accessibilityIdentifier("notes-empty")171            } else {172                ForEach(MaintenanceLogic.sorted(notes), id: \.id) { NoteCard(note: $0, runner: runner, showsContext: showsContext) }173            }174        }175        .loads(resource)176    }177}178179/// Notes kept on a node (not tied to a window) and the node's upcoming windows.180struct NodeNotesScreen: View {181    @Environment(Navigator.self) private var nav182    @Environment(\.mccTheme) private var theme183    @Session private var session184    let nodeID: String185    @State private var runner = MutationRunner()186187    private var query: NotesQuery { NotesQuery(nodeID: nodeID) }188189    var body: some View {190        let alias = session.nodes.alias(nodeID)191        ScreenStack {192            SectionCard(tr("notes.node.title")) {193                MutationButton(title: tr("notes.add"), systemImage: "square.and.pencil", permission: MaintenancePermission.write, identifier: "note-add") {194                    nav.sheet = .noteEditor(NoteContext(nodeID: nodeID))195                }196            } content: {197                NotesBlock(query: query, runner: runner, emptyText: tr("notes.node.empty"))198            }199            SectionCard(tr("notes.node.upcoming")) {200                ResourceSection(resource: session.maintenance.upcoming) { list in201                    let mine = list.items.filter { $0.window.scope.nodeIds.contains(nodeID) }202                    if mine.isEmpty {203                        Text(tr("overview.maintenance.none")).font(.callout).foregroundStyle(theme.textSecondary)204                    } else {205                        ForEach(mine, id: \.occurrenceID) { OccurrenceRow(occurrence: $0) }206                    }207                }208            }209        }210        .screen("node-notes", title: alias.map { tr("notes.node.screen_title", $0) } ?? tr("notes.node.title"), load: {211            async let a: Void = session.nodes.list.loadIfNeeded(maxAge: 60)212            async let b: Void = session.maintenance.upcoming.loadIfNeeded(maxAge: 60)213            _ = await (a, b)214        }, reload: {215            async let a: Void = session.maintenance.notes[query].load()216            async let b: Void = session.maintenance.upcoming.load()217            _ = await (a, b)218        })219        .navigationBarTitleDisplayMode(.inline)220        .mutationError(runner)221    }222}223
Files main
Menu

Theme