@arcforgelabs/flow 2026.10.26 → 2026.10.29

package/server/ui/jobs.js

@@ -1,24 +1,33 @@
-// Jobs (/jobs): every billable job from the lab system, as a board with one
-// column per billing stage, or as a list. A job's stage follows from its
-// evidence (server/core/ledger.js ledgerView), so cards are not dragged: a
-// job moves when its evidence changes, or when someone drafts its invoice
-// here. Data comes from /api/invoicing/jobs (server/api/invoicing.js).
+// Jobs (/jobs): the work system's jobs, as a board with one column per work
+// system status (its own statuses, one to one), or as a list. Cards are not
+// dragged: a job moves when the work system changes its status. A click on a
+// job opens its detail panel: the job, its lines, its invoice, and what to
+// fix. Data comes from /api/invoicing/board (server/core/job-board.js); the
+// rules are in server/ui/job-board.js.
 
 import { formatCents } from '/assets/ui/invoicing.js';
+import {
+  FINAL_RANK, fixes, INVOICE_STAGES, invoiceStage, matches, NO_STATUS, orderStatuses, problemSummary, statusRank,
+} from '/assets/ui/job-board.js';
 
-// Board columns, left to right. Held jobs sit with the jobs that need review.
-const STAGES = [
-  { id: 'review', label: 'Needs review', views: ['review_required', 'held'], tone: 'warn' },
-  { id: 'pending', label: 'Checking', views: ['pending'], tone: 'mute' },
-  { id: 'ready', label: 'Ready to bill', views: ['ready'], tone: 'info' },
-  { id: 'drafted', label: 'Drafted', views: ['drafted'], tone: 'info' },
-  { id: 'invoiced', label: 'Invoiced', views: ['invoiced'], tone: 'success' },
-  { id: 'paid', label: 'Paid', views: ['paid'], tone: 'success' },
-];
-const STAGE_OF = Object.fromEntries(STAGES.flatMap((stage) => stage.views.map((view) => [view, stage])));
 const LAYOUT_KEY = 'flow_jobs_layout';
+const SYSTEM_NAME = { seazona: 'Seazona', xero: 'Xero' };
+// A job's events (server/core/ledger.js), in plain words.
+const ACTIVITY = {
+  observed: 'Flow read the job', source_changed: 'The job changed in the lab system', ready: 'Marked ready to invoice',
+  in_work: 'Put back in work', drafted: 'Draft invoice made', draft_refused: 'Draft invoice refused',
+  accounting_checked: 'Checked in the accounting system', payment_recorded: 'Payment recorded', paid: 'Paid in full',
+  held: 'Put on hold', review: 'Sent to review', released: 'Hold removed',
+  writeback_sent: 'Status sent to the lab system', writeback_failed: 'Status not sent to the lab system',
+  writeback_not_supported: 'The lab system does not take the status',
+};
+const BY = { person: 'A person', automation: 'An automation' };
 
 const showDate = (iso) => (iso ? new Date(`${iso}T00:00:00`).toLocaleDateString('en-AU', { day: 'numeric', month: 'short' }) : '—');
+const fullDate = (iso) => (iso ? new Date(`${iso}T00:00:00`).toLocaleDateString('en-AU', { day: 'numeric', month: 'short', year: 'numeric' }) : '—');
+const clientOf = (job) => job.clientName ?? 'No client';
+// The one date a card shows: when the job is due, else when it was ordered.
+const dateOf = (job) => (job.dueOn ? `Due ${showDate(job.dueOn)}` : job.orderedOn ? `Ordered ${showDate(job.orderedOn)}` : job.jobDate ? showDate(job.jobDate) : null);
 
 function readLayout() {
   try { return localStorage.getItem(LAYOUT_KEY) === 'list' ? 'list' : 'board'; } catch { return 'board'; }
@@ -28,15 +37,27 @@ function saveLayout(layout) {
   try { localStorage.setItem(LAYOUT_KEY, layout); } catch { /* the choice is only a convenience */ }
 }
 
+// The local calendar day, as yyyy-mm-dd, to mark late jobs.
+const today = () => {
+  const now = new Date();
+  return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
+};
+
+const WARN_ICON = '<svg width="14" height="14" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 1.5 15 14H1z" fill="none" stroke="currentColor" stroke-width="1.4" stroke-linejoin="round"/><path d="M8 6v3.6" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"/><circle cx="8" cy="11.6" r=".9" fill="currentColor"/></svg>';
+const PERSON_ICON = '<svg width="13" height="13" viewBox="0 0 16 16" aria-hidden="true"><circle cx="8" cy="5.5" r="3" fill="none" stroke="currentColor" stroke-width="1.3"/><path d="M2.5 14c.6-2.8 2.8-4.3 5.5-4.3s4.9 1.5 5.5 4.3" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"/></svg>';
+const CALENDAR_ICON = '<svg width="13" height="13" viewBox="0 0 16 16" aria-hidden="true"><rect x="2" y="3" width="12" height="11" rx="1.5" fill="none" stroke="currentColor" stroke-width="1.3"/><path d="M2 6.5h12M5.5 1.5v3M10.5 1.5v3" stroke="currentColor" stroke-width="1.3" stroke-linecap="round"/></svg>';
+
 export async function renderJobs(main, ui) {
   const { h, flow, pageHeader, notice } = ui;
-  const state = { layout: readLayout(), q: '', jobs: [], canDraft: false };
+  // Search (search.js) opens a job with no invoice as /jobs?q=<case>.
+  const asked = new URLSearchParams(location.search).get('q') ?? '';
+  const state = { layout: readLayout(), q: asked.trim().toLowerCase(), jobs: [], statuses: [], accountingName: null, canDraft: false };
   const toggle = h('div', { class: 'fx-seg', role: 'radiogroup', 'aria-label': 'Layout' });
-  const search = h('input', { class: 'fx-input fx-search', type: 'search', placeholder: 'Find a case, client or practitioner', 'aria-label': 'Find a job' });
+  const search = h('input', { class: 'fx-input fx-search', type: 'search', placeholder: 'Find a case, client or practitioner', 'aria-label': 'Find a job', value: asked });
   const host = h('div', { class: 'fx-jobs' }, h('div', { class: 'fx-skeleton' }));
   main.classList.add('fx-main--wide');
   main.append(
-    pageHeader('Jobs', { subtitle: 'Every billable job from the lab system, by billing stage.' }),
+    pageHeader('Jobs', { subtitle: 'Every job in the lab system, by its status there.' }),
     h('div', { class: 'fx-toolbar fx-toolbar--plain' }, search, toggle),
     host);
 
@@ -45,12 +66,9 @@ export async function renderJobs(main, ui) {
     onclick: () => { state.layout = id; saveLayout(id); drawToggle(); draw(); },
   }, label)));
   drawToggle();
-  search.addEventListener('input', () => { state.q = search.value.trim().toLowerCase(); draw(); });
+  search.addEventListener('input', () => { state.q = search.value.trim(); draw(); });
 
-  const visible = () => (state.q
-    ? state.jobs.filter((job) => [job.caseRef, job.sourceJobRef, job.contactName, job.practitioner, job.invoiceNumber]
-      .some((value) => value && String(value).toLowerCase().includes(state.q)))
-    : state.jobs);
+  const problemsOf = (job) => fixes(job.obligation, { accountingName: state.accountingName });
 
   function draw() {
     if (!state.jobs.length) {
@@ -59,13 +77,16 @@ export async function renderJobs(main, ui) {
         h('a', { class: 'fx-btn', href: '/invoices/new', onclick: ui.go }, 'Make an invoice by hand')));
       return;
     }
-    host.replaceChildren(state.layout === 'list' ? list(visible()) : board(visible()));
+    const shown = state.jobs.filter((job) => matches(job, state.q));
+    host.replaceChildren(state.layout === 'list' ? list(shown) : board(shown));
   }
 
   async function load() {
     try {
-      const [{ jobs }, context] = await Promise.all([flow('/api/invoicing/jobs'), flow('/api/invoicing/context')]);
-      state.jobs = jobs;
+      const [body, context] = await Promise.all([flow('/api/invoicing/board'), flow('/api/invoicing/context')]);
+      state.jobs = body.jobs;
+      state.statuses = body.statuses;
+      state.accountingName = body.accountingName;
       state.canDraft = context.canIssue;
     } catch (error) {
       host.replaceChildren(notice(error.message, 'danger'));
@@ -74,80 +95,207 @@ export async function renderJobs(main, ui) {
     draw();
   }
 
-  function action(job) {
-    if (job.invoiceId) {
-      const href = `/invoices/${job.invoiceId}`;
-      return h('a', { class: 'fx-btn fx-btn--ghost fx-btn--sm', href, onclick: ui.go }, job.invoiceNumber ?? 'Open draft');
-    }
-    if (job.view !== 'ready' || !state.canDraft) return null;
+  // The small warning mark of a job with a problem. It opens the job's page
+  // at its Fix box.
+  function problemMark(job) {
+    const found = problemsOf(job);
+    if (!found.length) return null;
+    const label = `Problem: ${problemSummary(found)}. Open to fix.`;
     return h('button', {
-      class: 'fx-btn fx-btn--primary fx-btn--sm', type: 'button',
+      class: 'fx-job__problem', type: 'button', 'aria-label': label, title: label,
+      onclick: (event) => { event.stopPropagation(); openJob(job, { atFix: true }); },
+    }, svg(WARN_ICON));
+  }
+
+  // One card ("Task card"). The card design may change, so its markup stays
+  // here and its CSS in one block of flow.css ("Job card"): client,
+  // practitioner, one date, total, and a warning mark when the job has a
+  // problem. Never the case number. A late job's date shows in red. No
+  // "move to the next stage" tick yet: Flow only reads the lab system.
+  function jobCard(job) {
+    const date = dateOf(job);
+    const day = job.dueOn ?? job.orderedOn ?? job.jobDate;
+    const late = job.dueOn && job.dueOn < today() && statusRank(job.status) < FINAL_RANK;
+    return h('article', {
+      class: 'fx-job', tabindex: '0', role: 'button', 'aria-label': `${clientOf(job)}, open the job`,
+      onclick: () => openJob(job),
+      onkeydown: (event) => { if (event.target === event.currentTarget && (event.key === 'Enter' || event.key === ' ')) { event.preventDefault(); openJob(job); } },
+    },
+    h('div', { class: 'fx-job__client' }, clientOf(job)),
+    job.practitioner ? h('div', { class: 'fx-job__who' }, svg(PERSON_ICON), h('span', {}, job.practitioner)) : null,
+    h('div', { class: 'fx-job__foot' },
+      day ? h('span', { class: `fx-job__date${late ? ' fx-job__date--late' : ''}`, title: late ? `${date}, past due` : date }, svg(CALENDAR_ICON), showDate(day)) : null,
+      h('span', { class: 'fx-job__space' }),
+      problemMark(job),
+      h('span', { class: 'fx-job__amount' }, job.totalCents == null ? '—' : formatCents(job.totalCents))));
+  }
+
+  // A column's label: the status, in its stage colour, and how many jobs.
+  const stagePill = (label, count = null) => h('span', { class: 'fx-stage', 'data-rank': String(statusRank(label)) },
+    h('span', { class: 'fx-stage__label' }, label),
+    count == null ? null : h('span', { class: 'fx-stage__count' }, String(count)));
+
+  function board(jobs) {
+    const columns = orderStatuses(state.statuses, state.jobs);
+    return h('div', { class: 'fx-board' }, columns.map((label) => {
+      const inColumn = jobs.filter((job) => (job.status ?? NO_STATUS) === label);
+      const total = inColumn.reduce((sum, job) => sum + (job.totalCents ?? 0), 0);
+      return h('section', { class: 'fx-board__col', 'aria-label': label },
+        h('header', { class: 'fx-board__head' },
+          stagePill(label, inColumn.length),
+          h('span', { class: 'fx-board__sum' }, inColumn.length ? formatCents(total) : '')),
+        h('div', { class: 'fx-board__cards' }, inColumn.length ? inColumn.map(jobCard) : h('p', { class: 'fx-board__none' }, 'None')));
+    }));
+  }
+
+  function list(jobs) {
+    if (!jobs.length) return h('div', { class: 'fx-panel' }, h('p', { class: 'fx-empty' }, 'No job matches that search.'));
+    return h('div', { class: 'fx-panel' }, h('table', { class: 'fx-table fx-table--jobs' },
+      h('thead', {}, h('tr', {},
+        h('th', {}, 'Client'), h('th', {}, 'Practitioner'), h('th', {}, 'Stage'), h('th', {}, 'Date'),
+        h('th', { class: 'fx-num' }, 'Total'))),
+      h('tbody', {}, jobs.map((job) => h('tr', {
+        class: 'fx-row-link', tabindex: '0',
+        onclick: () => openJob(job),
+        onkeydown: (event) => { if (event.key === 'Enter') openJob(job); },
+      },
+      h('td', {}, h('span', { class: 'fx-job__cell' }, h('span', { class: 'fx-strong' }, clientOf(job)), problemMark(job))),
+      h('td', { class: 'fx-dim' }, job.practitioner ?? '—'),
+      h('td', {}, job.status ?? NO_STATUS),
+      h('td', { class: 'fx-dim' }, dateOf(job) ?? '—'),
+      h('td', { class: 'fx-num fx-strong' }, job.totalCents == null ? '—' : formatCents(job.totalCents)))))));
+  }
+
+  // What a person can do with the job's invoice from here.
+  function actions(job, close) {
+    const o = job.obligation;
+    if (!o) return [];
+    if (o.invoiceId) {
+      const label = o.invoiceStatus === 'draft' ? 'Open draft invoice' : `Open invoice ${o.invoiceNumber ?? ''}`.trim();
+      return [h('a', { class: 'fx-btn', href: `/invoices/${o.invoiceId}`, onclick: (event) => { close(); ui.go(event); } }, label)];
+    }
+    // Flow's own stage: a person marks a job ready to invoice, or an
+    // automation does (Settings, Automations).
+    if (o.view === 'in_work') {
+      return [h('button', {
+        class: 'fx-btn', type: 'button',
+        onclick: async (event) => {
+          event.currentTarget.disabled = true;
+          try {
+            await flow(`/api/invoicing/jobs/${o.id}/ready`, { method: 'POST', body: JSON.stringify({ ready: true }) });
+            ui.toast('Marked ready to invoice.', 'success');
+          } catch (error) {
+            ui.toast(error.message, 'danger');
+          }
+          close();
+          await load();
+        },
+      }, 'Mark ready to invoice')];
+    }
+    if (o.view !== 'ready' || !state.canDraft) return [];
+    return [h('button', {
+      class: 'fx-btn fx-btn--primary', type: 'button',
       onclick: async (event) => {
-        event.stopPropagation();
         const button = event.currentTarget;
         button.disabled = true;
         try {
-          const { invoice } = await flow(`/api/invoicing/jobs/${job.id}/draft`, { method: 'POST', body: '{}' });
+          const { invoice } = await flow(`/api/invoicing/jobs/${o.id}/draft`, { method: 'POST', body: '{}' });
           ui.toast('Draft invoice made.', 'success');
+          close();
           ui.go(`/invoices/${invoice.id}`);
         } catch (error) {
           const reasons = error.details?.reasons;
           ui.toast(reasons?.length ? `Not drafted: ${reasons.join('; ')}.` : error.message, 'danger');
-          button.disabled = false;
+          close();
           await load();
         }
       },
-    }, 'Draft invoice');
+    }, 'Draft invoice')];
   }
 
-  function card(job) {
-    const stage = STAGE_OF[job.view];
-    const reasons = ['review', 'pending'].includes(stage?.id) ? job.reasons?.join('; ') : '';
-    const why = reasons ? reasons[0].toUpperCase() + reasons.slice(1) + '.' : null;
-    return h('article', { class: `fx-job${stage?.id === 'review' ? ' fx-job--flag' : ''}` },
-      h('div', { class: 'fx-job__top' },
-        h('span', { class: 'fx-strong' }, job.caseRef ?? job.sourceJobRef),
-        h('span', { class: 'fx-job__amount' }, formatCents(job.totalCents))),
-      h('div', { class: 'fx-job__client' }, job.contactName ?? 'No client'),
-      h('div', { class: 'fx-job__meta' },
-        job.practitioner ? h('span', {}, job.practitioner) : null,
-        h('span', {}, `Shipped ${showDate(job.shippedOn)}`)),
-      why ? h('p', { class: 'fx-job__why' }, why) : null,
-      action(job));
-  }
-
-  function board(jobs) {
-    return h('div', { class: 'fx-board' }, STAGES.map((stage) => {
-      const inStage = jobs.filter((job) => stage.views.includes(job.view));
-      const total = inStage.reduce((sum, job) => sum + (job.totalCents ?? 0), 0);
-      return h('section', { class: 'fx-board__col', 'aria-label': stage.label },
-        h('header', { class: 'fx-board__head' },
-          h('span', { class: 'fx-board__dot', 'data-tone': stage.tone }),
-          h('span', { class: 'fx-strong' }, stage.label),
-          h('span', { class: 'fx-board__count' }, String(inStage.length)),
-          h('span', { class: 'fx-board__sum' }, inStage.length ? formatCents(total) : '')),
-        h('div', { class: 'fx-board__cards' }, inStage.length ? inStage.map(card) : h('p', { class: 'fx-board__none' }, 'None')));
-    }));
-  }
-
-  function list(jobs) {
-    if (!jobs.length) return h('div', { class: 'fx-panel' }, h('p', { class: 'fx-empty' }, 'No job matches that search.'));
-    return h('div', { class: 'fx-panel' }, h('table', { class: 'fx-table' },
-      h('thead', {}, h('tr', {},
-        h('th', {}, 'Case'), h('th', {}, 'Client'), h('th', {}, 'Practitioner'), h('th', {}, 'Shipped'),
-        h('th', {}, 'Stage'), h('th', { class: 'fx-num' }, 'Total'), h('th', { class: 'fx-table__actions' }, h('span', { class: 'fx-sr' }, 'Action')))),
-      h('tbody', {}, jobs.map((job) => {
-        const stage = STAGE_OF[job.view];
-        return h('tr', {},
-          h('td', { class: 'fx-strong' }, job.caseRef ?? job.sourceJobRef),
-          h('td', {}, job.contactName ?? '—'),
-          h('td', { class: 'fx-dim' }, job.practitioner ?? '—'),
-          h('td', { class: 'fx-dim' }, showDate(job.shippedOn)),
-          h('td', {}, h('span', { class: 'fx-status', 'data-tone': stage?.tone ?? 'mute', title: job.reasons?.join('; ') ?? '' }, stage?.label ?? job.view)),
-          h('td', { class: 'fx-num fx-strong' }, formatCents(job.totalCents)),
-          h('td', { class: 'fx-table__actions' }, action(job)));
-      }))));
+  // The job's page: a large panel over the board, like a task page. A
+  // breadcrumb, the client's name, the stage, the job's fields, what to fix
+  // and its lines; its activity at the side (below on a phone). Esc, the X
+  // or a click outside closes it. `atFix` scrolls to what to fix. Nothing is
+  // edited here yet: Flow only reads the lab system.
+  function openJob(job, { atFix = false } = {}) {
+    const o = job.obligation;
+    const stage = invoiceStage(o);
+    const found = problemsOf(job);
+    const system = SYSTEM_NAME[job.sourceSystem] ?? job.sourceSystem;
+    const status = job.status ?? NO_STATUS;
+    const late = job.dueOn && job.dueOn < today() && statusRank(job.status) < FINAL_RANK;
+    const field = (term, value, attrs = {}) => (value == null || value === '' ? null
+      : h('div', {}, h('dt', {}, term), h('dd', attrs, value)));
+    const link = (attrs, text) => h('a', { class: 'fx-task__link', ...attrs }, text);
+    const element = h('dialog', { class: 'fx-dialog fx-task', 'aria-label': clientOf(job) });
+    const close = () => element.close();
+    const invoiceText = o?.invoiceId
+      ? link({ href: `/invoices/${o.invoiceId}`, onclick: (event) => { close(); ui.go(event); } },
+        `${o.invoiceStatus === 'draft' ? 'Draft' : 'Invoice'} ${o.invoiceNumber ?? ''}`.trim() + (stage ? ` · ${INVOICE_STAGES[stage]}` : ''))
+      : stage ? INVOICE_STAGES[stage] : o ? 'Not ready to invoice' : 'No invoice yet';
+    const fixBox = found.length ? h('section', { class: 'fx-task__fix', 'aria-label': 'Fix' },
+      h('h3', {}, 'Fix'),
+      found.map((f) => h('div', { class: 'fx-task__fixrow' }, h('span', {}, `${f.text} ${f.todo}`)))) : null;
+    const lines = job.lines ?? [];
+    const activity = h('ol', {}, h('li', { class: 'fx-dim' }, 'Loading…'));
+    element.append(h('div', { class: 'fx-task__grid' },
+      h('div', { class: 'fx-task__main' },
+        h('header', { class: 'fx-task__head' },
+          h('nav', { class: 'fx-task__crumb', 'aria-label': 'Breadcrumb' },
+            h('span', {}, 'Jobs'), h('span', { class: 'fx-task__slash', 'aria-hidden': 'true' }, '/'), h('span', {}, status)),
+          h('button', { class: 'fx-btn fx-btn--ghost fx-btn--icon', type: 'button', 'aria-label': 'Close', onclick: close }, '✕')),
+        h('h2', { class: 'fx-task__title' }, clientOf(job)),
+        h('div', { class: 'fx-task__stage' }, stagePill(status)),
+        h('dl', { class: 'fx-task__fields' },
+          field('Practitioner', job.practitioner),
+          field(job.dueOn ? 'Due' : 'Ordered', job.dueOn ? fullDate(job.dueOn) : job.orderedOn ? fullDate(job.orderedOn) : null, late ? { class: 'fx-task__late' } : {}),
+          job.dueOn ? field('Ordered', job.orderedOn ? fullDate(job.orderedOn) : null) : null,
+          field('Total', job.totalCents == null ? null : formatCents(job.totalCents)),
+          field('Case number', job.caseRef ?? job.sourceJobRef, { class: 'fx-mono' }),
+          field(`${system} status`, job.status),
+          field(`${system} client`, job.workClientName && job.workClientName !== job.clientName ? job.workClientName : null),
+          field('Department', job.department),
+          field('Invoice', invoiceText),
+          o?.accountingUrl ? field(state.accountingName ?? 'Accounting', link({ href: o.accountingUrl, target: '_blank', rel: 'noopener' }, `Open in ${state.accountingName ?? 'the accounting system'}`)) : null),
+        fixBox,
+        h('section', { class: 'fx-task__lines' },
+          h('h3', {}, 'Lines'),
+          lines.length ? h('table', {},
+            h('colgroup', {}, h('col', {}), h('col', { class: 'fx-task__col-code' }), h('col', { class: 'fx-task__col-amount' })),
+            h('thead', {}, h('tr', {}, h('th', {}, 'Item'), h('th', {}, 'Price code'), h('th', { class: 'fx-num' }, 'Amount'))),
+            h('tbody', {}, lines.map((line) => h('tr', {},
+              h('td', {}, line.description),
+              line.code && line.mapped ? h('td', { class: 'fx-mono' }, line.code)
+                : h('td', { class: 'fx-task__miss', title: line.code ? `${line.code} is not in the price list` : null }, line.code ? `${line.code}: not in the price list` : 'No price code'),
+              h('td', { class: 'fx-num' }, line.amountCents == null ? '—' : formatCents(line.amountCents))))),
+            h('tfoot', {}, h('tr', {}, h('td', {}, 'Total'), h('td', {}),
+              h('td', { class: 'fx-num' }, job.totalCents == null ? '—' : formatCents(job.totalCents)))))
+            : h('p', { class: 'fx-dim' }, 'No lines.')),
+        h('div', { class: 'fx-task__actions' }, actions(job, close))),
+      h('aside', { class: 'fx-task__activity', 'aria-label': 'Activity' },
+        h('h3', {}, 'Activity'),
+        o ? activity : h('p', { class: 'fx-dim' }, `Flow has no invoice record for this job yet. It makes one when ${system} reports the job complete.`))));
+    element.addEventListener('click', (event) => { if (event.target === element) close(); });
+    element.addEventListener('close', () => element.remove());
+    document.body.append(element);
+    element.showModal();
+    if (atFix && fixBox) fixBox.scrollIntoView({ block: 'start' });
+    if (!o) return;
+    const when = (iso) => new Date(iso).toLocaleString('en-AU', { day: 'numeric', month: 'short', hour: 'numeric', minute: '2-digit' });
+    flow(`/api/invoicing/jobs/${o.id}/activity`).then(({ events }) => {
+      activity.replaceChildren(...(events.length ? events.map((e) => h('li', {},
+        `${ACTIVITY[e.kind] ?? e.kind.replaceAll('_', ' ')} (${BY[e.by] ?? SYSTEM_NAME[e.by] ?? e.by})`,
+        h('time', { datetime: e.createdAt }, when(e.createdAt))))
+        : [h('li', {}, 'Nothing yet.')]));
+    }).catch(() => activity.replaceChildren(h('li', {}, 'Flow could not read the activity.')));
   }
 
   await load();
 }
+
+function svg(markup) {
+  const span = document.createElement('span');
+  span.innerHTML = markup;
+  return span.firstChild;
+}

package/server/ui/line-mappings.js

@@ -0,0 +1,60 @@
+// Settings, Invoicing, "Price codes" (server/core/line-mapping.js,
+// /api/invoicing/line-labels and /line-mappings). Each work system line label
+// that found no price item is one row: its text, its price, the jobs it holds
+// back, and a menu of the lab's price items. A choice saves at once as a saved
+// mapping for that label at that price, and the next pipeline run maps every
+// job that has it. Everyone can read them; an owner or admin chooses. The
+// caller passes in app.js's shared pieces as `ui`.
+
+const money = (cents) => (cents === null || cents === undefined ? '' : `$${(cents / 100).toFixed(2)}`);
+
+export function lineMappingSection(ui) {
+  const { h, flow, toast, notice, me } = ui;
+  const disabled = !['owner', 'admin'].includes(me?.person.role);
+  const body = h('div', {}, h('div', { class: 'fx-skeleton' }));
+  const section = h('section', { class: 'fx-set' }, h('h2', { class: 'fx-set__title' }, 'Price codes'), body);
+
+  const row = (name, hint, control) => h('div', { class: 'fx-set__row' },
+    h('div', { class: 'fx-set__text' }, h('span', { class: 'fx-set__name' }, name), h('span', { class: 'fx-set__hint' }, hint)),
+    h('div', { class: 'fx-set__control' }, control));
+
+  async function load() {
+    let labels;
+    let items;
+    try {
+      [{ labels }, { priceItems: items }] = await Promise.all([flow('/api/invoicing/line-labels'), flow('/api/invoicing/price-items')]);
+    } catch (error) {
+      body.replaceChildren(notice(error.message, 'danger'));
+      return;
+    }
+    const waiting = labels.filter((l) => l.unmapped > 0);
+    if (!waiting.length) {
+      body.replaceChildren(row('Every line has a price code', 'Lines from Seazona find their price item by themselves.', h('span', { class: 'fx-dim' }, '')));
+      return;
+    }
+    const options = [h('option', { value: '' }, 'Choose a price item…'),
+      ...items.map((i) => h('option', { value: i.code }, `${i.code} · ${i.name} · ${money(i.unitAmountCents)}`))];
+    body.replaceChildren(...waiting.map((label) => {
+      const select = h('select', { class: 'fx-select', 'aria-label': `Price item for ${label.sample}`, disabled }, options.map((o) => o.cloneNode(true)));
+      select.addEventListener('change', async () => {
+        if (!select.value) return;
+        select.disabled = true;
+        try {
+          await flow('/api/invoicing/line-mappings', {
+            method: 'POST',
+            body: JSON.stringify({ kind: 'saved', label: label.label, unitAmountCents: label.unitAmountCents ?? 0, itemCode: select.value }),
+          });
+          toast('Saved. Jobs with this line update in a few minutes.', 'success');
+          await load();
+        } catch (error) {
+          toast(error.message, 'danger');
+          select.disabled = disabled;
+        }
+      });
+      const lines = label.unmapped === 1 ? '1 line waits' : `${label.unmapped} lines wait`;
+      return row(label.sample, `${money(label.unitAmountCents)} · ${lines}`, select);
+    }));
+  }
+  load();
+  return section;
+}

package/server/ui/logos/sentry.svg

@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg" fill="#362D59"><title>Sentry</title><path d="M13.91 2.505c-.873-1.448-2.972-1.448-3.844 0L6.904 7.92a15.478 15.478 0 0 1 8.53 12.811h-2.221A13.301 13.301 0 0 0 5.784 9.814l-2.926 5.06a7.65 7.65 0 0 1 4.435 5.848H2.194a.365.365 0 0 1-.298-.534l1.413-2.402a5.16 5.16 0 0 0-1.614-.913L.296 19.275a2.182 2.182 0 0 0 .812 2.999 2.24 2.24 0 0 0 1.086.288h6.983a9.322 9.322 0 0 0-3.845-8.318l1.11-1.922a11.47 11.47 0 0 1 4.95 10.24h5.915a17.242 17.242 0 0 0-7.885-15.28l2.244-3.845a.37.37 0 0 1 .504-.13c.255.14 9.75 16.708 9.928 16.9a.365.365 0 0 1-.327.543h-2.287c.029.612.029 1.223 0 1.831h2.297a2.206 2.206 0 0 0 1.922-3.31z"/></svg>

package/server/ui/monitoring.js

@@ -0,0 +1,61 @@
+// Errors and problem reports from the browser, to the installation's own
+// Sentry project (docs/SENTRY.md). Only while the Sentry integration is on:
+// GET /api/monitoring says so and gives the project's public DSN. The SDK
+// comes from Sentry's CDN, pinned and checked against its integrity hash.
+// With the integration off, nothing loads and there is no "Report a problem".
+
+function loadScript({ src, integrity }) {
+  return new Promise((resolve, reject) => {
+    const script = document.createElement('script');
+    script.src = src;
+    script.integrity = integrity;
+    script.crossOrigin = 'anonymous';
+    script.onload = resolve;
+    script.onerror = () => reject(new Error('The Sentry SDK could not load.'));
+    document.head.append(script);
+  });
+}
+
+/** Resolves to a function that opens the "Report a problem" form, or null. */
+export async function startMonitoring({ flow, person }) {
+  const config = await flow('/api/monitoring');
+  if (!config.on || config.service !== 'sentry') return null;
+  await loadScript(config.script);
+  const Sentry = window.Sentry;
+  const integrations = config.feedback ? [Sentry.feedbackIntegration({
+    autoInject: false,
+    // The form's colours and font come from flow.css (#sentry-feedback), so
+    // it follows each person's theme and mode, even when they change it.
+    colorScheme: 'light',
+    showBranding: false,
+    // Flow already knows who is signed in (setUser below).
+    showName: false,
+    enableScreenshot: true,
+    triggerLabel: 'Report a problem',
+    formTitle: 'Report a problem',
+    messageLabel: 'What went wrong?',
+    messagePlaceholder: 'What you did, what you expected, and what happened.',
+    submitButtonLabel: 'Send report',
+    successMessageText: 'Thank you. Your report is sent.',
+  })] : [];
+  Sentry.init({
+    dsn: config.dsn,
+    environment: config.environment,
+    release: config.release ?? undefined,
+    sendDefaultPii: false,
+    integrations,
+  });
+  // Who reported or met the error, so the lab can follow up.
+  Sentry.setUser({ id: person.id, email: person.email });
+  const feedback = config.feedback ? Sentry.getFeedback() : null;
+  if (!feedback) return null;
+  // One form, made on first use and opened again after that.
+  let form = null;
+  return async () => {
+    if (!form) {
+      form = await feedback.createForm();
+      form.appendToDom();
+    }
+    form.open();
+  };
+}

package/server/ui/routes.js

@@ -18,9 +18,9 @@ const require = createRequire(import.meta.url);
 const here = dirname(fileURLToPath(import.meta.url));
 const themeDir = join(here, '..', 'theme');
 const logoDir = join(here, 'logos');
-const LOGO_FILES = new Set(['xero.svg', 'seazona.svg']);
+const LOGO_FILES = new Set(['xero.svg', 'seazona.svg', 'sentry.svg']);
 const THEME_FILES = new Set(['themes.js', 'color-contrast.js', 'openclaw-palettes.js', 'font-families.js']);
-const UI_FILES = new Set(['flow.css', 'appearance.js', 'clerk-appearance.js', 'app.js', 'invoicing.js', 'jobs.js', 'flow-mark.svg']);
+const UI_FILES = new Set(['flow.css', 'appearance.js', 'clerk-appearance.js', 'app.js', 'invoicing.js', 'invoicing-settings.js', 'automations.js', 'invoice-rules.js', 'line-mappings.js', 'jobs.js', 'job-board.js', 'monitoring.js', 'search.js', 'flow-mark.svg']);
 const MAX_AGE = '1h';
 
 // Send one named file from dir. Passing dir as root limits the dotfile check