@open-mercato/core 0.10.1-develop.7717.1.2befe9c634 → 0.10.1-develop.7721.1.b5c4a00a68

package/src/modules/staff/lib/time-tracking-ui/projectDefaultAssignee.ts

@@ -0,0 +1,117 @@
+import { resolveAssignmentState } from './projectTeamAssignment'
+
+export const DEFAULT_ASSIGNEE_PAGE_SIZE = 100
+export const DEFAULT_ASSIGNEE_MAX_PAGES = 20
+
+export type ProjectMemberRow = {
+  id?: unknown
+  staffMemberId?: unknown
+  staff_member_id?: unknown
+  status?: unknown
+  assigned_start_date?: unknown
+  assignedStartDate?: unknown
+  assigned_end_date?: unknown
+  assignedEndDate?: unknown
+}
+
+export type ProjectMembershipPage = {
+  items: ProjectMemberRow[]
+  totalPages: number | null
+}
+
+export type ProjectMembershipCollection = {
+  rows: ProjectMemberRow[]
+  truncated: boolean
+}
+
+export type DefaultAssigneeCandidate = {
+  staffMemberId: string
+  active: boolean
+}
+
+function readString(value: unknown): string | null {
+  return typeof value === 'string' && value.trim().length > 0 ? value.trim() : null
+}
+
+export function readMembershipStaffMemberId(row: ProjectMemberRow): string | null {
+  return readString(row.staffMemberId) ?? readString(row.staff_member_id)
+}
+
+/**
+ * Whether a membership can still receive a portal ticket as the default assignee —
+ * the browser twin of `resolveUsableDefaultAssignee`: an `active` membership inside
+ * its assignment window plus the tenant's grace days.
+ */
+export function isUsableDefaultAssigneeMembership(row: ProjectMemberRow, graceDays: number, now: Date = new Date()): boolean {
+  if (readString(row.status) !== 'active') return false
+  const startDate = readString(row.assignedStartDate) ?? readString(row.assigned_start_date)
+  const endDate = readString(row.assignedEndDate) ?? readString(row.assigned_end_date)
+  return resolveAssignmentState({ startDate, endDate }, graceDays, now) === 'active'
+}
+
+export type ProjectMembershipPageResponse = {
+  ok: boolean
+  result?: { items?: unknown; totalPages?: unknown } | null
+}
+
+/**
+ * Reads one employees page, refusing anything but a successful response with a
+ * row list: an error page carries no rows and no total, and reading it as an empty
+ * last page would mark every member beyond it as gone.
+ */
+export function readProjectMembershipPage(response: ProjectMembershipPageResponse): ProjectMembershipPage {
+  if (!response.ok) throw new Error('[internal] project membership page request failed')
+  const items = response.result?.items
+  if (!Array.isArray(items)) throw new Error('[internal] project membership page has no rows')
+  const totalPages = typeof response.result?.totalPages === 'number' ? response.result.totalPages : null
+  const rows = items.filter((item): item is ProjectMemberRow => typeof item === 'object' && item !== null)
+  return { items: rows, totalPages }
+}
+
+export async function collectProjectMemberships(
+  fetchPage: (page: number) => Promise<ProjectMembershipPage>,
+  options: { pageSize?: number; maxPages?: number } = {},
+): Promise<ProjectMembershipCollection> {
+  const pageSize = options.pageSize ?? DEFAULT_ASSIGNEE_PAGE_SIZE
+  const maxPages = options.maxPages ?? DEFAULT_ASSIGNEE_MAX_PAGES
+  const rows: ProjectMemberRow[] = []
+  for (let page = 1; page <= maxPages; page += 1) {
+    const result = await fetchPage(page)
+    rows.push(...result.items)
+    const lastPage = result.totalPages !== null ? page >= result.totalPages : result.items.length < pageSize
+    if (lastPage || result.items.length === 0) return { rows, truncated: false }
+  }
+  return { rows, truncated: true }
+}
+
+export function classifyDefaultAssigneeCandidates(
+  rows: ProjectMemberRow[],
+  graceDays: number,
+  now: Date = new Date(),
+): DefaultAssigneeCandidate[] {
+  const byMember = new Map<string, boolean>()
+  for (const row of rows) {
+    const staffMemberId = readMembershipStaffMemberId(row)
+    if (!staffMemberId) continue
+    const active = isUsableDefaultAssigneeMembership(row, graceDays, now)
+    byMember.set(staffMemberId, (byMember.get(staffMemberId) ?? false) || active)
+  }
+  return Array.from(byMember, ([staffMemberId, active]) => ({ staffMemberId, active }))
+}
+
+export function chunkIds(ids: string[], size: number = DEFAULT_ASSIGNEE_PAGE_SIZE): string[][] {
+  const batches: string[][] = []
+  for (let index = 0; index < ids.length; index += size) batches.push(ids.slice(index, index + size))
+  return batches
+}
+
+export function resolveSelectedDefaultAssignee(
+  candidates: DefaultAssigneeCandidate[],
+  value: string | null,
+  truncated: boolean,
+): { candidate: DefaultAssigneeCandidate | null; unusable: boolean } {
+  if (!value) return { candidate: null, unusable: false }
+  const candidate = candidates.find((entry) => entry.staffMemberId === value) ?? null
+  if (candidate) return { candidate, unusable: !candidate.active }
+  return { candidate: null, unusable: !truncated }
+}

package/src/modules/staff/lib/time-tracking-ui/settingsTabs.ts

@@ -0,0 +1,17 @@
+import type { TimeTrackingSettings } from '../time-tracking/settings'
+
+export const TIME_TRACKING_SETTINGS_GENERAL_TAB = 'general'
+export const TIME_TRACKING_SETTINGS_TAB_PARAM = 'tab'
+
+/**
+ * Context of the `staff.time_tracking.settings:tabs` spot. A tab owns its saves and does
+ * not sit under the page's Save bar. When it writes the settings record itself it builds
+ * the body from `settings` (the last saved record, never the page's unsaved draft) and
+ * hands the response to `onSettingsSaved`, which rebases the page draft onto it.
+ */
+export type TimeTrackingSettingsTabContext = {
+  moduleId: string
+  canManage: boolean
+  settings: TimeTrackingSettings
+  onSettingsSaved: (settings: TimeTrackingSettings) => void
+}

package/src/modules/staff/lib/time-tracking-ui/supportTicketData.ts

@@ -0,0 +1,71 @@
+import type { StatusBadgeVariant } from '@open-mercato/ui/primitives/status-badge'
+import type { BoardApiRow } from './kanbanBoardData'
+
+export type SupportPortalStatus = 'received' | 'in_progress' | 'resolved'
+
+export type SupportTicketView = {
+  id: string
+  supportReference: string
+  categoryValue: string
+  categoryLabel: string
+  routedVia: 'category' | 'fallback'
+  portalStatus: SupportPortalStatus
+  customerName: string | null
+  customerKind: string | null
+  reporterName: string | null
+  reportedByCustomerUserId: string | null
+  unnotifiedAt: string | null
+  requestSubject: string | null
+  requestBody: string | null
+}
+
+export const SUPPORT_PORTAL_STATUS_VARIANT: Record<SupportPortalStatus, StatusBadgeVariant> = {
+  received: 'info',
+  in_progress: 'warning',
+  resolved: 'success',
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+}
+
+function readText(source: Record<string, unknown> | null | undefined, key: string): string | null {
+  const value = source?.[key]
+  return typeof value === 'string' && value.length > 0 ? value : null
+}
+
+function readPortalStatus(value: unknown): SupportPortalStatus {
+  return value === 'resolved' || value === 'in_progress' ? value : 'received'
+}
+
+/** Reads the `_staffSupport.ticket` enrichment off a tasks API row. Internal tasks answer `null`. */
+export function readSupportTicket(row: BoardApiRow | null | undefined): SupportTicketView | null {
+  if (!row) return null
+  const enrichment = (row as Record<string, unknown>)._staffSupport
+  if (!isRecord(enrichment)) return null
+  const ticket = enrichment.ticket
+  if (!isRecord(ticket)) return null
+  const id = readText(ticket, 'id')
+  const supportReference = readText(ticket, 'supportReference')
+  if (!id || !supportReference) return null
+  const category = isRecord(ticket.category) ? ticket.category : null
+  const customer = isRecord(ticket.customerSnapshot) ? ticket.customerSnapshot : null
+  const request = isRecord(ticket.customerRequest) ? ticket.customerRequest : null
+  return {
+    id,
+    supportReference,
+    categoryValue: readText(category, 'value') ?? '',
+    categoryLabel: readText(category, 'label') ?? readText(category, 'value') ?? '',
+    routedVia: ticket.routedVia === 'category' ? 'category' : 'fallback',
+    portalStatus: readPortalStatus(ticket.portalStatus),
+    customerName: readText(customer, 'displayName'),
+    customerKind: readText(customer, 'kind'),
+    reporterName: readText(customer, 'reporterDisplayName'),
+    reportedByCustomerUserId: readText(ticket, 'reportedByCustomerUserId'),
+    unnotifiedAt: readText(ticket, 'unnotifiedAt'),
+    requestSubject: readText(request, 'subject'),
+    requestBody: typeof request?.body === 'string' ? (request.body as string) : null,
+  }
+}
+
+export const SUPPORT_ACTIVITY_EVENT = 'staff.support_ticket.activity_recorded'

package/src/modules/staff/lib/time-tracking-ui/taskDrawerData.ts

@@ -15,6 +15,8 @@
 import { formatDuration } from '../time-tracking/duration'
 import { readNumber, readString, type BoardApiRow, type BoardStatus } from './kanbanBoardData'
 
+export const TASK_DRAWER_QUERY_ROOT = ['staff', 'time-tracking', 'task-drawer'] as const
+
 export type DrawerComment = {
   id: string
   body: string
@@ -22,6 +24,9 @@ export type DrawerComment = {
   authorName: string | null
   authorEmail: string | null
   createdAt: string | null
+  visibility: 'internal' | 'customer'
+  authorKind: 'staff' | 'customer'
+  updatedAt: string | null
 }
 
 export type DrawerEntry = {
@@ -57,6 +62,9 @@ export function toDrawerComment(row: BoardApiRow): DrawerComment | null {
     authorName: readString(row, 'authorName', 'author_name'),
     authorEmail: readString(row, 'authorEmail', 'author_email'),
     createdAt: readString(row, 'createdAt', 'created_at'),
+    visibility: readString(row, 'visibility') === 'customer' ? 'customer' : 'internal',
+    authorKind: readString(row, 'authorKind', 'author_kind') === 'customer' ? 'customer' : 'staff',
+    updatedAt: readString(row, 'updatedAt', 'updated_at'),
   }
 }
 
@@ -192,3 +200,10 @@ export function buildEntryClocks({ date, startClock, endClock, minutes }: EntryC
     endedAt: `${date}T${minutesToClock(resolvedEnd)}`,
   }
 }
+
+export const TASK_ASSIGNMENT_CHANGED_EVENT = 'staff.timesheets.time_task.assignee_changed'
+
+export function isAssignmentEventForTask(payload: unknown, taskId: string): boolean {
+  if (!taskId || typeof payload !== 'object' || payload === null) return false
+  return (payload as { id?: unknown }).id === taskId
+}

package/src/modules/staff/lib/time-tracking-ui/timeTrackingSettingsForm.ts

@@ -16,7 +16,7 @@
 
 import { formatDuration } from '../time-tracking/duration'
 import { roundMinutes, type RoundingSettings, type RoundingUnitMinutes } from '../time-tracking/rounding'
-import { contributedTimeTrackingSettingKeys } from '../time-tracking/settingKeys'
+import { DEFAULT_SUPPORT_REFERENCE_PREFIX, contributedTimeTrackingSettingKeys } from '../time-tracking/settingKeys'
 import { readTimeTrackingSettingValue, type TimeTrackingSettings } from '../time-tracking/settings'
 
 export const ROUNDING_UNIT_OPTIONS: readonly RoundingUnitMinutes[] = [0, 5, 10, 15]
@@ -65,6 +65,8 @@ export type TimeTrackingSettingsDraft = {
   warningsOverlap: boolean
   warningsRunningTimer: boolean
   assignmentGraceDaysText: string
+  /** Edited on the Support settings tab; carried through so this page's Save never resets it. */
+  supportReferencePrefix: string
   /**
    * EP-42 — every contributed setting key, by its `<group>.<key>` id, carried through
    * the draft untouched so the page's own Save round-trips a contribution it knows
@@ -86,6 +88,7 @@ export function toSettingsDraft(settings: TimeTrackingSettings): TimeTrackingSet
     warningsOverlap: settings.warnings.overlap,
     warningsRunningTimer: settings.warnings.runningTimer,
     assignmentGraceDaysText: String(settings.access.assignmentGraceDays),
+    supportReferencePrefix: settings.support?.referencePrefix ?? DEFAULT_SUPPORT_REFERENCE_PREFIX,
     contributed: Object.fromEntries(
       contributedTimeTrackingSettingKeys().map((entry) => [
         entry.id,
@@ -139,6 +142,7 @@ export function toSettingsPayload(draft: TimeTrackingSettingsDraft): TimeTrackin
     targets: { dailyHours },
     warnings: { overlap: draft.warningsOverlap, runningTimer: draft.warningsRunningTimer },
     access: { assignmentGraceDays },
+    support: { referencePrefix: draft.supportReferencePrefix },
   }
   for (const entry of contributedTimeTrackingSettingKeys()) {
     const group = (payload[entry.group] ?? {}) as Record<string, unknown>
@@ -148,6 +152,49 @@ export function toSettingsPayload(draft: TimeTrackingSettingsDraft): TimeTrackin
   return payload
 }
 
+/**
+ * A settings tab that saves the record itself moves the stored baseline under the
+ * page's draft. Rebase the draft onto the new record: a field the user has not touched
+ * takes the saved value, an edited field keeps the edit, so the page's Save neither
+ * reverts the tab's write nor drops pending changes.
+ */
+export function rebaseSettingsDraft(
+  draft: TimeTrackingSettingsDraft,
+  previousBaseline: TimeTrackingSettingsDraft,
+  nextBaseline: TimeTrackingSettingsDraft,
+): TimeTrackingSettingsDraft {
+  const pick = <TValue>(current: TValue, previous: TValue, next: TValue): TValue =>
+    Object.is(current, previous) ? next : current
+  const contributed: Record<string, unknown> = { ...nextBaseline.contributed }
+  for (const [id, value] of Object.entries(draft.contributed)) {
+    contributed[id] = pick(value, previousBaseline.contributed[id], nextBaseline.contributed[id])
+  }
+  return {
+    roundingUnitMinutes: pick(draft.roundingUnitMinutes, previousBaseline.roundingUnitMinutes, nextBaseline.roundingUnitMinutes),
+    roundingDirection: pick(draft.roundingDirection, previousBaseline.roundingDirection, nextBaseline.roundingDirection),
+    defaultsBillable: pick(draft.defaultsBillable, previousBaseline.defaultsBillable, nextBaseline.defaultsBillable),
+    defaultsChainStartFromPreviousEnd: pick(
+      draft.defaultsChainStartFromPreviousEnd,
+      previousBaseline.defaultsChainStartFromPreviousEnd,
+      nextBaseline.defaultsChainStartFromPreviousEnd,
+    ),
+    dailyHoursText: pick(draft.dailyHoursText, previousBaseline.dailyHoursText, nextBaseline.dailyHoursText),
+    warningsOverlap: pick(draft.warningsOverlap, previousBaseline.warningsOverlap, nextBaseline.warningsOverlap),
+    warningsRunningTimer: pick(draft.warningsRunningTimer, previousBaseline.warningsRunningTimer, nextBaseline.warningsRunningTimer),
+    assignmentGraceDaysText: pick(
+      draft.assignmentGraceDaysText,
+      previousBaseline.assignmentGraceDaysText,
+      nextBaseline.assignmentGraceDaysText,
+    ),
+    supportReferencePrefix: pick(
+      draft.supportReferencePrefix,
+      previousBaseline.supportReferencePrefix,
+      nextBaseline.supportReferencePrefix,
+    ),
+    contributed,
+  }
+}
+
 export function isSettingsDraftDirty(
   draft: TimeTrackingSettingsDraft,
   baseline: TimeTrackingSettingsDraft,