/* ============================================================ CurrencyDesk OS — Reports One-touch report generation off the live ledger. Pick a period, tap a report, and a formatted, print-ready document is built instantly: Period Summary, the desk's large-cash compliance pack, Revenue & Earnings, Transaction Register, Client & KYC Register. Print / Save-PDF and CSV export on every report. THESE ARE DOCUMENTS SOMEBODY SIGNS. The rule they follow is written down in docs/GENERATED_DOCUMENTS.md and it is short: every figure on a generated document comes from the ledger, is labelled in the desk's own currency, and is shown as absent when the book has no answer. A printed 0.00 becomes evidence. ============================================================ */ (function () { const { useState, useMemo, useEffect, useRef } = React; const HKEY = 'cdos_report_history_v1'; const AKEY = 'cdos_report_access_v1'; const { CD, Ic, TYPES, crossRate, perCadLive, fmt, num, dDiff, dealMargin, CCY, businessDate, businessDayWindow, reportingLimit, useDeskFacts, deskPack, Absent } = window.CDOS; /* The desk's own reporting line, in the desk's own currency. This file used to print `THRESHOLD` — a hardcoded 10,000 Canadian dollars — in four places, including the sentence claiming what the law requires, while the rest of the product honoured the owner's setting. */ const limitOf = (settings) => reportingLimit(settings); /* WHO REGULATES THIS DESK, AND WHAT THE FORM IS CALLED. This file printed "Prepared for FINTRAC record-keeping under the PCMLTFA" on a compliance pack regardless of which country installed the product. The regulator, the report's name and the country are facts about the jurisdiction pack the entity points at, and the pack carries all three (`regulator`, `reportName`, `name`). getRegime() is deliberately NOT the first source here. It is the browser's own two-country table and it falls back to FINTRAC when `settings.regime` is unset — which is exactly how a London desk came to print a Canadian regulator's name. The server's pack is what the entity was actually created with, so it wins; the regime engine is a fallback for a desk that has not reached the server yet, and where neither can answer the document says "the regulator" rather than naming one. */ function authorityOf(settings) { const pack = deskPack(); const regime = (window.CDOS.getRegime ? window.CDOS.getRegime(settings) : null) || {}; return { /* null, not a guess — a sentence claiming what a named regulator requires is not a sentence to fill in with a default. */ authority: (pack && pack.regulator) || regime.authority || null, country: (pack && pack.name) || regime.country || null, largeCode: (pack && pack.reportName) || regime.largeCode || null, largeLabel: regime.largeLabel || ((pack && pack.reportName) ? pack.reportName + ' report' : null), aggHours: regime.aggHours || null, }; } // ---- role-based report access ---- const ROLES = ['Owner', 'Manager', 'Compliance', 'Senior teller', 'Cashier']; const DEFAULT_ACCESS = { 'Owner': ['endofday', 'summary', 'pnl', 'revenue', 'fintrac', 'register', 'kyc'], 'Manager': ['endofday', 'summary', 'pnl', 'revenue', 'fintrac', 'register', 'kyc'], 'Compliance': ['endofday', 'fintrac', 'register', 'kyc'], 'Senior teller': ['endofday', 'summary', 'register'], 'Cashier': ['endofday', 'register'] }; const roleOf = (me) => (me && me.role) || 'Cashier'; function loadAccess() { try { const saved = JSON.parse(localStorage.getItem(AKEY) || 'null'); return saved && typeof saved === 'object' ? { ...DEFAULT_ACCESS, ...saved } : { ...DEFAULT_ACCESS }; } catch (e) { return { ...DEFAULT_ACCESS }; } } const allowedFor = (me, access) => (access[roleOf(me)] || DEFAULT_ACCESS[roleOf(me)] || []); /* A foreign amount expressed in the desk's own money, or null. This was `cadOf`, and it divided by `crossRate('CAD', ccy)` on every desk in the world. The browser's rate board is quoted in units per CANADIAN dollar — that is what `PER_CAD` means — so on a London or Dubai entity this produced a Canadian-dollar figure and printed a pound sign in front of it. Same reasoning as the server's own `unitHome` in reporting.ts, which also refuses to value anything when the home currency is not the one the board is quoted against. Returns null rather than a number the reader cannot check. Every call site has to decide what to do with that, which is the point — see docs/ABSENT_FIGURES.md. */ const homeEquiv = (amt, ccy, home) => { if (!home) return null; if (ccy === home) return +amt || 0; if (home !== 'CAD') return null; const rate = crossRate('CAD', ccy); return rate ? (+amt || 0) / rate : null; }; // booked spread per deal — exact when two-side priced, else the live-mid estimate const spreadOf = (r) => dealMargin(r); const stampNow = () => new Date().toLocaleString('en-CA', { hour12: false }).replace(',', ''); /* The ledger records WHO posted a deal as a principal id, tenant-scoped ("tnt-yorkfx:a.singh"). Earnings by teller is the book's answer, so the id is the book's; turning it back into a person is presentation, and it is done from whatever staff list the desk actually has. An id with nobody behind it prints as the id rather than as a blank — a row of earnings attributed to nothing is a thing somebody needs to notice. */ const principalOf = (id) => String(id == null ? '' : id).split(':').pop() || ''; function tellerName(actorId, settings) { const staffId = principalOf(actorId); if (!staffId) return '—'; const roster = (settings && Array.isArray(settings.employees) && settings.employees.length) ? settings.employees : (window.CDOS.STAFF || []); const found = roster.find(s => s && (s.staffId === staffId || s.name === staffId)); return (found && found.name) || staffId; } /* A money field the ledger sent, or a dash and a reason. Inline rather than , because these appear inside table cells and KPI tiles that are cloned into a print window — the printed page has no React. */ const orDash = (value, currency, why) => value == null ? {why ? '— ' + why : '—'} : fmt(value, currency); const RANGES = [ ['today', 'Today', 0], ['7d', 'Past 7 days', 7], ['30d', 'Past 30 days', 30], ['90d', 'This quarter', 90], ['365d', 'This year', 365], ['all', 'All time', null] ]; const REPORTS = [ { id: 'endofday', title: 'End-of-Day Sign-Off', icon: 'receipt', desc: 'Signed close-out: day totals, cash on hand and compliance — the artifact to file.', tone: CD.green, signed: true }, { id: 'summary', title: 'Period Summary', icon: 'bars', desc: 'Volume, fees, earnings and cash movement at a glance.', tone: CD.ink }, { id: 'pnl', title: 'Profit & Loss', icon: 'coins', desc: 'Revenue, estimated GST/HST on commission and net profit.', tone: CD.green }, /* Named by the desk's own pack — see titleOf() below. The launcher card said "FINTRAC / LCTR Pack" on every desk in every country, which is the same defect as the document it opens. */ { id: 'fintrac', title: 'Large-Cash Compliance Pack', icon: 'shield', desc: 'Reportable deals, structuring watches and KYC gaps.', tone: CD.flag }, { id: 'revenue', title: 'Revenue & Earnings', icon: 'coins', desc: 'Fees plus FX spread, broken down by teller and type.', tone: CD.green }, { id: 'register', title: 'Transaction Register', icon: 'scroll', desc: 'The full book for the period — every posted record.', tone: CD.ink }, { id: 'kyc', title: 'Client & KYC Register', icon: 'id', desc: 'Every client, ID status and period activity.', tone: CD.ink } ]; /* What to call a report on this desk. Only the compliance pack changes with the jurisdiction; everything else is the desk's own document and is named the same everywhere. */ function titleOf(report) { if (report.id !== 'fintrac') return report.title; const pack = deskPack(); return (pack && pack.regulator && pack.reportName) ? `${pack.regulator} / ${pack.reportName} Pack` : report.title; } /* ---------- print: clone the report node into a clean window ---------- */ function printReport(title) { const node = document.getElementById('cdos-report-doc'); if (!node) return; const w = window.open('', '_blank', 'width=900,height=1100'); if (!w) return; w.document.write(`${title} ${node.outerHTML}`); w.document.close(); setTimeout(() => { w.focus(); w.print(); }, 350); } function downloadCsv(name, rows) { const csv = rows.map(r => r.map(c => `"${String(c == null ? '' : c).replace(/"/g, '""')}"`).join(',')).join('\n'); const a = document.createElement('a'); a.href = URL.createObjectURL(new Blob([csv], { type: 'text/csv' })); a.download = name; a.click(); } /* ---------- shared document atoms (inline-styled so they print) ---------- Reports are branded as the EXCHANGE HOUSE's own document. CurrencyDesk is a small credit in the footer only. DOC_BIZ is set by each render. */ let DOC_BIZ = { name: 'York Currency Exchange', logo: null, line2: 'Registered Money Services Business' }; let DOC_SCOPE = ''; function DocHead({ title, subtitle, rangeLabel }) { const biz = DOC_BIZ; return (
{biz.logo ? :
{biz.name}
}
{biz.logo &&
{biz.name}
}
{title}
{subtitle &&
{subtitle}
} {DOC_SCOPE &&
Filtered — {DOC_SCOPE}
}
{rangeLabel}
Generated {stampNow()}
{biz.line2}
); } function DocFoot() { return (
CD Generated by CurrencyDesk OS
); } function KpiRow({ items }) { return (
{items.map((k, i) => (
{k.label}
{k.value}
{k.sub &&
{k.sub}
}
))}
); } function SecTitle({ children, n }) { return (
{children}
{n != null &&
{n}
}
); } function Bars({ data, fmtV, accent }) { if (!data.length) return
No data in this period.
; const max = Math.max(1, ...data.map(d => d[1])); return (
{data.map(([k, v]) => (
{k}{fmtV(v)}
0 ? 3 : 0 }} />
))}
); } const thS = { textAlign: 'left', fontSize: 10, textTransform: 'uppercase', letterSpacing: '0.05em', color: CD.mute, padding: '8px 10px', background: 'var(--cd-chip)', borderBottom: `1px solid ${CD.line}`, fontWeight: 600 }; const tdS = { fontSize: 12, padding: '7px 10px', borderBottom: `1px solid ${CD.lineSoft}`, color: CD.ink }; function Card({ children, pad }) { return
{children}
; } function Cols({ children }) { return
{children}
; } /* ============================================================ The report builder ============================================================ */ function Reports({ rows, clients, settings, me, baseline, receipts, day, station, branches, openSignal }) { const [range, setRange] = useState('today'); /* The trading day and the jurisdiction pack, from the server. Reports print, get signed and get filed, so both of these being right is not cosmetic: a close-out sheet headed with the wrong date and a threshold sentence quoting the wrong country's number is a document somebody keeps for five years. */ const deskFacts = useDeskFacts(); const limit = useMemo(() => limitOf(settings), [settings, deskFacts]); const regime = useMemo(() => authorityOf(settings), [settings, deskFacts]); /* WHAT THE DESK IS HOLDING AT CLOSE — the ledger's figure. The End-of-Day Sign-Off used to fill this column by DERIVING each currency from a demo opening baseline plus the browser's records, which is how a sign-off sheet came to be printed and signed over nine currencies the desk did not have. A report whose cash column cannot be sourced prints "—", which is the honest thing for a document that gets filed. */ const [held, setHeld] = useState({ loading: true, position: null, error: '' }); /* And what the desk earned over the trading day this till is in. The close-out sheet is the document that gets signed and filed, so its headline has to be the book's figure: fees plus the realized margin the disposal booked, not a spread re-estimated against a market mid. See docs/COST_BASIS.md. */ const [dayBook, setDayBook] = useState({ loading: true, summary: null, error: '' }); /* THE PHYSICAL COUNT, AS THE LEDGER RECORDED IT. The sign-off sheet used to read its "Counted" column out of localStorage — `cdos_till_history_v2` — which the Cash Drawer seeded with a YEAR of invented daily counts on first open. That is where the sheet's CAD variance of −249,270.79 came from, on a day the reconcile screen it was generated from said "Drawers off 0 · Total variance 0". Two books, disagreeing by a third of a million dollars, on the page with the signature lines. `GET /api/ledger/till-session` carries `latestCounts`: what was counted, what was expected AT COUNT TIME, and the variance the server computed from the two. That is the count that exists; a count taken on a machine and never sent is not one. */ const [tillDay, setTillDay] = useState({ loading: true, session: null, counts: {}, error: '' }); useEffect(() => { const backend = window.CDOS.Backend; if (!backend) { setHeld({ loading: false, position: null, error: 'not signed in to the ledger' }); setDayBook({ loading: false, summary: null, error: 'not signed in to the ledger' }); setTillDay({ loading: false, session: null, counts: {}, error: 'not signed in to the ledger' }); return; } let live = true; backend.loadLedgerPosition() .then(position => { if (live) setHeld({ loading: false, position, error: '' }); }) .catch(error => { if (live) setHeld({ loading: false, position: null, error: (error && error.message) || 'the ledger could not be reached' }); }); backend.loadLedgerSummary(window.CDOS.businessDayWindow(1)) .then(summary => { if (live) setDayBook({ loading: false, summary, error: '' }); }) .catch(error => { if (live) setDayBook({ loading: false, summary: null, error: (error && error.message) || 'the ledger could not be reached' }); }); backend.loadTillSession() .then(answer => { if (live) setTillDay({ loading: false, session: (answer && answer.session) || null, counts: (answer && answer.latestCounts) || {}, error: '' }); }) .catch(error => { if (live) setTillDay({ loading: false, session: null, counts: {}, error: (error && error.message) || 'the ledger could not be reached' }); }); return () => { live = false; }; }, [deskFacts]); const [active, setActive] = useState(null); /* THE PERIOD'S OWN BOOK. Volume, fees and earnings on every other report were summed here in the browser, over `rows` — a copy of the last hundred ledger transactions, re-priced against a live market mid. Two things were wrong with that on a printed document. The margin was an ESTIMATE (docs/COST_BASIS.md: the desk earns what the disposal booked, not what a mid says it should have), and the copy is capped at a hundred records, so a busy quarter silently reported a fraction of itself. So the headline figures come from GET /api/ledger/summary over the same window the report is scoped to. The row-by-row tables still render `rows`, because those rows ARE ledger transactions and a register is a list, not a total. */ const [periodBook, setPeriodBook] = useState({ loading: true, summary: null, error: '' }); const [menu, setMenu] = useState(false); const [access, setAccess] = useState(loadAccess); const [manageAccess, setManageAccess] = useState(false); const [scope, setScope] = useState({ customers: [], tellers: [], types: [], from: '', to: '' }); const [filterOpen, setFilterOpen] = useState(false); const myRole = roleOf(me); const canManage = myRole === 'Owner' || myRole === 'Manager'; const allowed = allowedFor(me, access); const canGen = (id) => allowed.includes(id); // open a specific report on request (e.g. the Till's End-of-Day Sign-Off button) useEffect(() => { if (openSignal && openSignal.id && canGen(openSignal.id)) { if (openSignal.id === 'endofday') { setRange('today'); setScope({ customers: [], tellers: [], types: [], from: '', to: '' }); } setActive(openSignal.id); } }, [openSignal && openSignal.n]); // brand every report as the exchange house's own document DOC_BIZ = { name: (settings && (settings.operatingName || settings.bizName)) || 'York Currency Exchange', logo: (settings && settings.logo) || null, line2: (settings && settings.reportFootLine) || 'Registered Money Services Business' }; const rangeLabel = (RANGES.find(r => r[0] === range) || [, 'All time'])[1]; const inRange = (date) => { const days = (RANGES.find(r => r[0] === range) || [])[2]; if (days == null) return range === 'all'; const ago = dDiff(date, businessDate()); return ago >= -0.0001 && ago <= days + 0.0001; }; const allRange = range === 'all'; const within = (d) => allRange ? true : inRange(d); /* The window to ask the book for, as two instants. A custom date range the user typed is honoured; "All time" is an omitted window, which the server reads as everything this till has ever posted. */ const bookWindow = useMemo(() => { if (scope.from || scope.to) { const at = (d, plusDay) => { const t = new Date(d + 'T00:00:00'); if (plusDay) t.setDate(t.getDate() + 1); return t.toISOString(); }; return { from: scope.from ? at(scope.from) : undefined, to: scope.to ? at(scope.to, true) : undefined }; } const days = (RANGES.find(r => r[0] === range) || [])[2]; return days == null ? {} : businessDayWindow(Math.max(1, days || 1)); }, [range, scope.from, scope.to, deskFacts]); useEffect(() => { const backend = window.CDOS.Backend; if (!backend) { setPeriodBook({ loading: false, summary: null, error: 'not signed in to the ledger' }); return; } let live = true; setPeriodBook(b => ({ ...b, loading: true })); backend.loadLedgerSummary(bookWindow) .then(summary => { if (live) setPeriodBook({ loading: false, summary, error: '' }); }) .catch(error => { if (live) setPeriodBook({ loading: false, summary: null, error: (error && error.message) || 'the ledger could not be reached' }); }); return () => { live = false; }; }, [bookWindow]); // ---- report scope (the “select a person / teller / type / custom dates” filters) ---- const customersList = useMemo(() => Array.from(new Set(rows.map(r => r.customer).filter(Boolean))).sort(), [rows]); const tellersList = useMemo(() => Array.from(new Set(rows.map(r => r.teller).filter(Boolean))).sort(), [rows]); const useCustomDates = !!(scope.from || scope.to); const inWindow = (d) => { if (useCustomDates) { if (scope.from && d < scope.from) return false; if (scope.to && d > scope.to) return false; return true; } return within(d); }; const matchesScope = (r) => (!scope.customers.length || scope.customers.includes(r.customer)) && (!scope.tellers.length || scope.tellers.includes(r.teller)) && (!scope.types.length || scope.types.includes(r.type)); const summarize = (arr, noun) => !arr.length ? null : (arr.length <= 2 ? arr.join(', ') : `${arr.length} ${noun}`); const activeFilters = [ summarize(scope.customers, 'clients') && `Clients: ${summarize(scope.customers, 'clients')}`, summarize(scope.tellers, 'tellers') && `Tellers: ${summarize(scope.tellers, 'tellers')}`, summarize(scope.types, 'types') && summarize(scope.types, 'types'), useCustomDates && `${scope.from || '…'} → ${scope.to || '…'}` ].filter(Boolean); DOC_SCOPE = activeFilters.join(' · '); const effRangeLabel = useCustomDates ? `${scope.from || 'start'} → ${scope.to || businessDate()}` : rangeLabel; /* The currency this desk keeps its books in, as the pack states it — not a "CAD" literal. */ const homeCcy = (held.position && held.position.homeCurrency) || limit.currency || 'CAD'; const flags = useMemo(() => window.CDOS.computeFlags(rows, clients, settings), [rows, clients, settings, deskFacts]); const data = useMemo(() => { const inP = rows.filter(r => inWindow(r.date) && matchesScope(r)); const live = inP.filter(r => r.status !== 'void'); let vol = 0, fees = 0, spread = 0; const byCcy = {}, byType = {}, feeTeller = {}, feeType = {}, drawerIn = {}, drawerOut = {}; live.forEach(r => { const v = homeEquiv(r.inAmt, r.inCcy, homeCcy), fee = +r.fee || 0, sp = spreadOf(r); vol += (v || 0); fees += fee; spread += sp; if (v != null) { byCcy[r.inCcy] = (byCcy[r.inCcy] || 0) + v; byType[r.type] = (byType[r.type] || 0) + v; } feeTeller[r.teller] = (feeTeller[r.teller] || 0) + fee + sp; feeType[r.type] = (feeType[r.type] || 0) + fee + sp; drawerIn[r.inCcy] = (drawerIn[r.inCcy] || 0) + (+r.inAmt || 0); drawerOut[r.outCcy] = (drawerOut[r.outCcy] || 0) + (+r.outAmt || 0); }); const reportable = live.filter(r => (flags[r.id] || {}).single); const stru = []; const seen = new Set(); live.forEach(r => { const f = flags[r.id] || {}; if (f.str && !seen.has(r.customer)) { seen.add(r.customer); stru.push({ customer: r.customer, agg: f.agg, ack: r.ackStr }); } }); const kycGaps = []; const seenK = new Set(); live.forEach(r => { const f = flags[r.id] || {}; if (f.kyc && f.kyc !== 'ok' && f.idNeeded && !seenK.has(r.customer)) { seenK.add(r.customer); kycGaps.push({ customer: r.customer, issue: f.kyc }); } }); const sortE = o => Object.entries(o).sort((a, b) => b[1] - a[1]); const ccySet = Array.from(new Set([...Object.keys(drawerIn), ...Object.keys(drawerOut)])); const drawer = ccySet.map(c => ({ ccy: c, inA: drawerIn[c] || 0, outA: drawerOut[c] || 0, net: (drawerIn[c] || 0) - (drawerOut[c] || 0) })) .sort((a, b) => Math.abs(b.net) - Math.abs(a.net)); const perTx = live.map(r => ({ r, fee: +r.fee || 0, sp: spreadOf(r), vol: homeEquiv(r.inAmt, r.inCcy, homeCcy) })) .map(o => ({ ...o, earned: o.fee + o.sp })).sort((a, b) => b.earned - a.earned); return { inP, live, vol, fees, spread, rev: fees + spread, n: live.length, byCcy: sortE(byCcy), byType: sortE(byType), feeTeller: sortE(feeTeller), feeType: sortE(feeType), reportable, stru, kycGaps, drawer, perTx, filed: reportable.filter(r => r.filed).length, /* CASH ON HAND AT CLOSE — the drawer, and the count of the drawer. This table used to put the branch's WHOLE position — drawer plus strong room, which is what position().currencies totals — in a column headed "On the ledger", and subtract from it a count of the DRAWER. Those are two different boxes. The reconcile screen the sheet was generated from compares the drawer against the drawer and said every currency balanced; the sheet compared the drawer against the drawer plus the safe and printed a CAD variance of −249,270.79 above the signature lines. Nobody had lost anything. The sheet was subtracting a safe. So the ledger column is `row.till` — the box that was counted — and the safe is reported separately, as its own line, because an owner signing a close-out is entitled to see it and it must never be netted into a variance. */ cash: (() => { const position = held.position; if (!position) return []; const counts = tillDay.counts || {}; return (position.currencies || []).map(row => { const till = row.till; const record = counts[row.currency]; /* The variance the SERVER computed when the count was taken, against the expected balance AT THAT MOMENT. Recomputing it here against the balance now would silently fold in every movement since the count — which is a different number with the same name. */ return { ccy: row.currency, /* null, not zero: a currency held only in the safe has no drawer balance, and a drawer line of 0.00 against a counted figure would read as a variance. */ units: till ? Number(till.quantity) : null, home: till && till.marketValueHome != null ? Number(till.marketValueHome) : null, vaultUnits: row.vault ? Number(row.vault.quantity) : null, counted: record && record.counted != null ? Number(record.counted) : null, countedExpected: record && record.expected != null ? Number(record.expected) : null, variance: record && record.variance != null ? Number(record.variance) : null, countedAt: record ? record.countedAt : null, }; }).filter(x => x.units != null || x.counted != null || x.vaultUnits != null); })() }; }, [rows, clients, settings, range, flags, scope, held.position, tillDay.counts, homeCcy]); // Every freshly generated report is snapshotted (rendered HTML frozen) into an // immutable history log — surfaced in the Compliance ▸ History tab, never silently changing. useEffect(() => { if (!active) return; const t = setTimeout(() => { const node = document.getElementById('cdos-report-doc'); if (!node) return; let hist = []; try { hist = JSON.parse(localStorage.getItem(HKEY) || '[]') || []; } catch (e) {} const last = hist[0]; const nowMs = Date.now(); if (last && last.type === active && last.range === range && (nowMs - (last.ms || 0)) < 1500) return; // dedupe re-renders const meta = REPORTS.find(r => r.id === active); const entry = { key: 'R' + nowMs.toString(36) + Math.random().toString(36).slice(2, 5), ms: nowMs, type: active, title: titleOf(meta), icon: meta.icon, tone: meta.tone, range, rangeLabel, at: stampNow(), n: data.n, html: node.innerHTML }; try { localStorage.setItem(HKEY, JSON.stringify([entry, ...hist].slice(0, 500))); } catch (e) {} }, 140); return () => clearTimeout(t); }, [active, range]); /* A CSV cell for a figure the ledger has no answer for. Blank, never "0.00" — a spreadsheet is where an absent figure most easily becomes a confident one, because SUM() treats a blank and a zero identically but a reader does not. */ const csvMoney = (v) => v == null ? '' : Number(v).toFixed(2); const csvFor = (id) => { const s = periodBook.summary; if (id === 'endofday') { const d = dayBook.summary; return [['Currency', 'In the drawer · ledger', `${homeCcy} value`, 'Counted', 'Variance', 'In the safe · ledger'], ...data.cash.map(x => [x.ccy, csvMoney(x.units), csvMoney(x.home), csvMoney(x.counted), csvMoney(x.variance), csvMoney(x.vaultUnits)]), [], ['Transactions', d ? d.posted : ''], ['Voided', d ? d.reversed : ''], [`Pay-in volume ${homeCcy}`, d ? csvMoney(d.volumeHome) : ''], [`Fees ${homeCcy}`, d ? csvMoney(d.feesHome) : ''], [`Realized margin ${homeCcy}`, d ? csvMoney(d.realizedPnlHome) : ''], [`Earned ${homeCcy}`, d ? csvMoney(d.earningsHome) : ''], ['Reportable', data.reportable.length], [`Open ${regime.largeCode || 'reports'}`, data.reportable.length - data.filed]]; } if (id === 'pnl') { const hstRate = (settings && settings.hstRate != null) ? +settings.hstRate : 13; return [['Line', homeCcy], ['Commission & fees', s ? csvMoney(s.feesHome) : ''], ['Realized FX margin', s ? csvMoney(s.realizedPnlHome) : ''], ['Gross revenue', s ? csvMoney(s.earningsHome) : ''], [`Sales tax on commission (${hstRate}%)`, s && s.feesHome != null ? (Number(s.feesHome) * hstRate / 100).toFixed(2) : ''], ['Net revenue to business', s ? csvMoney(s.earningsHome) : '']]; } if (id === 'summary') return [['Currency', 'Sold to customers', `Realized margin ${homeCcy}`], ...((s && s.byCurrency) || []).map(c => [c.currency, csvMoney(c.sold), csvMoney(c.realizedPnlHome)])]; if (id === 'fintrac') return [['Ref', 'Date', 'Customer', 'Amount', 'Currency', `${homeCcy} equiv`, 'Filed', `${regime.largeCode || 'Report'} ref`], ...data.reportable.map(r => [r.ref, r.date, r.customer, r.inAmt, r.inCcy, csvMoney(homeEquiv(r.inAmt, r.inCcy, homeCcy)), r.filed ? 'yes' : 'NO', r.filedInfo && r.filedInfo.ref || ''])]; if (id === 'revenue') return [['Teller', 'Deals', `Fees ${homeCcy}`, `Realized margin ${homeCcy}`, `Earned ${homeCcy}`, 'Deals with a cost basis'], ...((s && s.byActor) || []).map(a => [tellerName(a.actorId, settings), a.deals, csvMoney(a.feesHome), csvMoney(a.realizedPnlHome), csvMoney(a.earningsHome), a.pricedDeals])]; if (id === 'register') return [['Ref', 'Date', 'Time', 'Customer', 'Type', 'In', 'InCcy', 'Out', 'OutCcy', 'Fee', 'Teller', 'Status'], ...data.inP.map(r => [r.ref, r.date, r.time, r.customer, r.type, r.inAmt, r.inCcy, r.outAmt, r.outCcy, r.fee, r.teller, r.status])]; if (id === 'kyc') { const names = Array.from(new Set([...Object.keys(clients), ...data.live.map(r => r.customer)])); return [['Client', 'ID type', 'ID number', 'Expiry', 'Status', 'Tx in period', `Volume ${homeCcy}`], ...names.map(n => { const c = clients[n] || {}; const tx = data.live.filter(r => r.customer === n); const parts = tx.map(r => homeEquiv(r.inAmt, r.inCcy, homeCcy)); const v = parts.some(p => p == null) ? null : parts.reduce((sum, p) => sum + p, 0); const st = (!c.idType || !c.idNum) ? 'missing ID' : (c.idExpiry && c.idExpiry < businessDate() ? 'ID expired' : 'verified'); return [n, c.idType || '', c.idNum || '', c.idExpiry || '', st, tx.length, csvMoney(v)]; })]; } return []; }; /* ---------- the five documents ---------- */ const renderDoc = (id) => { const book = periodBook.summary; /* Why a figure on this document is a dash, in one short line. The order matters: "we could not reach the book" and "the book has nothing for this period" are different answers and a reader acting on them does different things. */ const noBook = periodBook.error || (periodBook.loading ? 'reading the ledger…' : 'nothing posted in this period'); const sub = book ? `${book.posted} posted transaction${book.posted === 1 ? '' : 's'}${book.reversed ? ` · ${book.reversed} voided` : ''} · valued in ${homeCcy}` : `the ledger has no figures for this period — ${noBook}`; const branchName = (station && branches && (branches.find(b => b.id === station.branchId) || {}).name) || (settings && (settings.operatingName || settings.bizName)) || 'York Currency Exchange'; const tillName = (station && station.tillId) ? (((branches || []).find(b => b.id === station.branchId) || {}).tills || []).find(t => t.id === station.tillId)?.name : null; if (id === 'endofday') { const d = dayBook.summary; /* Why the day's money reads "—", said once and reused. "Nothing was posted" and "we could not reach the book" are different facts and a manager signing the sheet acts differently on each. */ const whyNoDay = dayBook.error || (dayBook.loading ? 'reading the ledger…' : 'nothing posted on this trading day'); /* A total is only a total when every line has a figure. Where one currency in the drawer could not be valued the sheet prints a dash and names the reason rather than a sum that quietly omits it. */ const drawerRows = data.cash.filter(x => x.units != null); const cashComplete = drawerRows.length > 0 && drawerRows.every(x => x.home != null); const totalCashHome = cashComplete ? drawerRows.reduce((s, x) => s + x.home, 0) : null; const unvalued = drawerRows.filter(x => x.home == null).map(x => x.ccy); const openRpt = data.reportable.length - data.filed; /* Earnings by teller, from the book — GET /api/ledger/summary's byActor block. This panel used to be summed in the browser and on the desk that was audited it named three tellers with money beside them, on a day one person had traded once and voided it. */ const earners = (d && d.byActor) || []; /* The day the sheet is FOR. The business date the till session carries, not the wall clock — a session opened before midnight is still on yesterday's trading day at 00:05, and the sheet has to agree with the movements filed under it. The session's own number replaces "Day 1", which was a counter kept in the browser. */ const sheetDate = (tillDay.session && tillDay.session.businessDate) || businessDate(); const dayLabel = tillDay.session ? `Session #${tillDay.session.sessionNumber}` : 'no till session'; const longDate = (() => { try { return new Date(sheetDate + 'T00:00:00').toLocaleDateString('en-CA', { weekday: 'long', month: 'long', day: 'numeric', year: 'numeric' }); } catch (e) { return sheetDate; } })(); const closed = tillDay.session && tillDay.session.status === 'closed'; return (
{closed ? '✓' : '·'}
{closed ? <>Closed and counted — every figure below is the ledger's, for the trading day named above. Review, then sign. : <>This till is not closed. The figures below are the ledger's as of now; the counts are whatever has been recorded so far. A sign-off sheet for a day still trading is a snapshot, not a close-out.}
{/* THE CLOSE-OUT FIGURES, FROM THE BOOK. These used to be summed in the browser over a demo seed — the sheet read "Earned today $223.00 · Transactions 10" for a desk that had posted one deal and voided it. A dash here is correct and signable; a wrong number is not. */}
This drawer at close — the ledger vs. the count
{!data.cash.length ? (
{held.loading ? 'Reading the ledger…' : `This till has no cash balances on the ledger${held.error ? ' — ' + held.error : ''}. Nothing is printed here rather than a figure from somewhere else.`}
) : (<> {data.cash.map(x => { const off = x.variance != null && Math.abs(x.variance) > 0.005; return (); })} {(() => { /* The counted and variance totals are only offered in the desk's own money when every counted line can BE valued in it. Summing a home value the board cannot produce is how the old sheet reached a total; where it cannot, the column still totals the per-currency variances it does have, and says which currencies it could not price. */ const counted = data.cash.filter(x => x.counted != null); const ctParts = counted.map(x => homeEquiv(x.counted, x.ccy, homeCcy)); const vParts = counted.map(x => homeEquiv(x.variance == null ? 0 : x.variance, x.ccy, homeCcy)); const ctTot = ctParts.length && ctParts.every(p => p != null) ? ctParts.reduce((s, p) => s + p, 0) : null; const vTot = vParts.length && vParts.every(p => p != null) ? vParts.reduce((s, p) => s + p, 0) : null; const off = vTot != null && Math.abs(vTot) > 0.005; return ( ); })()}
CurrencyIn the drawer{homeCcy} valueCountedVarianceIn the safe
{x.ccy} {x.units == null ? '— not in this drawer' : num(x.units)} {x.home == null ? '— no board rate' : fmt(x.home, homeCcy)} {x.counted == null ? '— not counted' : num(x.counted)} {x.variance == null ? '—' : (Math.abs(x.variance) < 0.005 ? '✓ balanced' : (x.variance > 0 ? '+' : '') + num(x.variance))} {x.vaultUnits == null ? '—' : num(x.vaultUnits)}
{`Total · ${homeCcy}`} {totalCashHome == null ? '—' : fmt(totalCashHome, homeCcy)} {ctTot == null ? '—' : fmt(ctTot, homeCcy)} {vTot == null ? '—' : (Math.abs(vTot) < 0.005 ? '✓ balanced' : (vTot > 0 ? '+' : '') + fmt(vTot, homeCcy))}
{/* The note the reader gets says what the columns ARE. It does NOT recount how they were once wrong: a filed document is not the place for a changelog, and printing the old six-figure discrepancy on the page put a number on the sheet that belongs to no transaction. The history lives in docs/GENERATED_DOCUMENTS.md and in the comment above. */}
Every figure in this table is the server ledger's. In the drawer is this till's own balance — not the branch's, which would also include the safe. Counted and variance are what the ledger recorded when the count was taken, measured against the expected balance at that moment. A currency not counted says so; a currency the branch has never published a rate for cannot be valued and says so. In the safe is shown for information and is never netted into a variance.
)}
Earnings by teller — from the ledger
{!earners.length ? (
{d ? 'Nobody posted a deal at this till on this trading day. No earnings are attributed rather than a table of zeros.' : `The ledger has no answer — ${whyNoDay}.`}
) : ({earners.map(a => ())}
TellerDealsCommissionRealized marginEarned
{tellerName(a.actorId, settings)} {a.deals} {orDash(a.feesHome, homeCcy, 'no fee recorded')} {orDash(a.realizedPnlHome, homeCcy, a.pricedDeals ? 'not priced' : 'nothing sold')} {orDash(a.earningsHome, homeCcy, 'nothing to attribute')}
)} {earners.some(a => a.pricedDeals < a.deals) &&
Some deals here carry no cost basis, so the margin beside them covers fewer deals than the count. See docs/COST_BASIS.md — the desk earns what the disposal booked, and a deal the book never priced has no margin to report.
} Compliance at close
0 ? CD.flag : CD.green} />
Sign-off
{[['Teller on duty', (tillDay.session && tillDay.session.closedBy && principalOf(tillDay.session.closedBy)) || (me ? me.name : '')], ['Manager / owner', '']].map(([r, nm]) => (
{nm}
{r}Date
))}
Prepared by {me ? `${me.name} · ${me.role}` : '—'} · generated {stampNow()} for trading day {sheetDate}. Every figure above is read from the server ledger; nothing on this sheet is computed in the browser. A figure the book cannot source is printed as “—” with the reason beside it, and is never a zero.
); } if (id === 'pnl') { const hstRate = (settings && settings.hstRate != null) ? +settings.hstRate : 13; /* THE MONEY ON A P&L IS THE BOOK'S. Commission is the fee column the ledger stored. The other half of revenue is the REALIZED margin the disposal booked — what the stock actually cost against what it sold for — and not a "spread" re-derived here by comparing the rate quoted against a live market mid. Those two numbers disagree by whatever the market did between buying the notes and selling them, which on a currency desk is the whole business. See docs/COST_BASIS.md. */ const fees = book && book.feesHome != null ? Number(book.feesHome) : null; const realized = book && book.realizedPnlHome != null ? Number(book.realizedPnlHome) : null; const gross = book && book.earningsHome != null ? Number(book.earningsHome) : null; const volume = book && book.volumeHome != null ? Number(book.volumeHome) : null; const hstOnFees = fees == null ? null : fees * (hstRate / 100); const margin = gross != null && volume != null && volume > 0 ? (gross / volume) * 100 : null; const taxAuthority = (settings && settings.taxAuthority) || null; return (
Profit & loss statement · {homeCcy}
Commission & service fees{orDash(fees, homeCcy, noBook)}
Realized FX margin — what the stock sold for, less what it cost{orDash(realized, homeCcy, book ? 'nothing sold' : noBook)}
Gross revenue{orDash(gross, homeCcy, noBook)}
Sales tax collected on commission ({hstRate}%) — remitted{taxAuthority ? ` to ${taxAuthority}` : ''}, not income{orDash(hstOnFees, homeCcy, 'no commission to tax')}
Net revenue to business{orDash(gross, homeCcy, noBook)}
Revenue by teller — from the ledger
{!((book && book.byActor) || []).length ?
{book ? 'Nobody posted a deal at this till in this period.' : `The ledger has no answer — ${noBook}.`}
: {book.byActor.map(a => ())}
TellerDealsCommissionRealized marginEarned
{tellerName(a.actorId, settings)} {a.deals} {orDash(a.feesHome, homeCcy, 'no fee')} {orDash(a.realizedPnlHome, homeCcy, 'nothing sold')} {orDash(a.earningsHome, homeCcy, 'nothing to attribute')}
}
Realized margin is the figure the disposal booked against the stock's own cost — not a markup measured against a market mid, which is a different number and one the desk never earned. Sales tax is estimated on commission income at {hstRate}%; confirm your registration and rate. This is a management P&L, not a filed financial statement.
); } if (id === 'summary') { const volume = book && book.volumeHome != null ? Number(book.volumeHome) : null; const posted = book ? book.posted : null; const avg = volume != null && posted ? volume / posted : null; const revenue = book && book.earningsHome != null ? Number(book.earningsHome) : null; return (
Where the margin came from — by currency sold
{!((book && book.byCurrency) || []).length ?
{book ? 'No foreign currency left this till in the period.' : `The ledger has no answer — ${noBook}.`}
: {book.byCurrency.map(c => ())}
CurrencyDealsUnits soldRealized margin
{c.currency} {c.deals} {num(c.sold)} {orDash(c.realizedPnlHome, homeCcy, c.pricedDeals ? 'partly priced' : 'no cost basis recorded')}
} Pay-in volume by currency fmt(v, homeCcy)} /> Volume by transaction type fmt(v, homeCcy)} /> {/* Units in and units out, not a home valuation — these are counts of notes that crossed the counter and they are exact. The home-currency headline above is the ledger's; this table deliberately does not restate it at a rate. */}
Cash drawer movement · in units
{data.drawer.map(d => ())} {data.drawer.length === 0 && }
CurrencyReceived (in)Paid outNet position
{d.ccy} {num(d.inA)} {num(d.outA)} = 0 ? CD.green : CD.flag }}>{d.net >= 0 ? '+' : ''}{num(d.net)}
No movement in this period.
 Compliance snapshot
0 ? CD.flag : CD.green} />
); } if (id === 'fintrac') { /* The pack names this document, because "FINTRAC / LCTR" is a Canadian answer and this product is sold in six jurisdictions. A desk whose pack has not arrived gets a neutral title rather than somebody else's regulator on the letterhead. */ const packTitle = regime.authority && regime.largeCode ? `${regime.authority} / ${regime.largeCode} Compliance Pack` : 'Large-Cash Compliance Pack'; return (
Reportable transactions — {limit.code} ≥ {limit.label}
{data.reportable.map(r => ())} {data.reportable.length === 0 && }
RefDateCustomerAmount{homeCcy} equivStatus
{r.ref} {r.date}{r.customer} {num(r.inAmt)} {r.inCcy} {orDash(homeEquiv(r.inAmt, r.inCcy, homeCcy), homeCcy, `no ${homeCcy} rate`)} {r.filed ? {r.filedInfo && r.filedInfo.ref || 'FILED'} : UNFILED}
No reportable transactions in this period.
 Structuring watch {data.stru.length === 0 ?
No clients aggregating to the threshold.
: data.stru.map(s => (
{s.customer}
{settings.structuringDays}-day total {orDash(s.agg, homeCcy, 'not valued')}
{s.ack ? 'REVIEWED' : 'REVIEW'}
))} KYC / ID exceptions {data.kycGaps.length === 0 ?
All active clients verified.
: data.kycGaps.map(k => (
{k.customer}
{k.issue.toUpperCase()}
))} {/* The sentence that claims what the law requires. It used to read "Prepared for FINTRAC record-keeping under the PCMLTFA" on every desk in every country. The regulator, the form's name and the aggregation window belong to the jurisdiction pack, and where the pack cannot state one the sentence does not invent it — naming the wrong country's regulator on a compliance pack is worse than naming none. */}
{regime.authority ? <>Prepared for {regime.authority} record-keeping{regime.country ? ` (${regime.country})` : ''}.{' '} : <>Prepared for record-keeping. This desk's regulator is not stated on its jurisdiction pack, so none is named here.{' '}} {limit.amount == null ? <>No reporting line has been established for this desk, so no deal on this pack is flagged as reportable. Set one in Settings, or install the jurisdiction pack for the country you operate in. : <>{regime.largeLabel || 'Large-cash reports'} are required for single cash amounts of {limit.label} or more{regime.aggHours ? `, with ${regime.aggHours}-hour aggregation` : ''} — this desk's own line, from its jurisdiction pack.} {' '}This pack is a working summary; verify each filing in the official portal.
); } if (id === 'revenue') { /* This document exists to answer "who earned what", and it used to answer it from the browser's copy of the day's deals, with the margin re-estimated against a live market mid. Both halves are now the book's: GET /api/ledger/summary's byActor block, grouped by the principal the ledger recorded against each posting. */ const fees = book && book.feesHome != null ? Number(book.feesHome) : null; const realized = book && book.realizedPnlHome != null ? Number(book.realizedPnlHome) : null; const total = book && book.earningsHome != null ? Number(book.earningsHome) : null; const volume = book && book.volumeHome != null ? Number(book.volumeHome) : null; const margin = total != null && volume != null && volume > 0 ? (total / volume) * 100 : null; const earners = (book && book.byActor) || []; return (
Earnings by teller
{!earners.length ?
{book ? 'Nobody posted a deal at this till in this period. No earnings are attributed rather than a table of zeros.' : `The ledger has no answer — ${noBook}.`}
: {earners.map(a => ())}
TellerDealsVolumeCommissionRealized marginEarned
{tellerName(a.actorId, settings)} {a.deals} {orDash(a.volumeHome, homeCcy, `no ${homeCcy} leg`)} {orDash(a.feesHome, homeCcy, 'no fee')} {orDash(a.realizedPnlHome, homeCcy, 'nothing sold')} {orDash(a.earningsHome, homeCcy, 'nothing to attribute')}
}
Earnings by currency sold
{!((book && book.byCurrency) || []).length ?
{book ? 'No foreign currency left this till in the period.' : `The ledger has no answer — ${noBook}.`}
: {book.byCurrency.map(c => ())}
CurrencyDealsUnits soldRealized margin
{c.currency} {c.deals} {num(c.sold)} {orDash(c.realizedPnlHome, homeCcy, c.pricedDeals ? 'partly priced' : 'no cost basis recorded')}
}
{book && book.pricedDeals < book.posted ? <>{book.posted - book.pricedDeals} of {book.posted} deal(s) in this period carry no cost basis, so no margin is reported for them — see docs/COST_BASIS.md. A deal the book never priced has no margin, which is not the same as a margin of nothing. : <>Realized margin is the figure each disposal booked against the stock's own cost, under the desk's costing method. It is not a markup measured against a market mid.}
); } if (id === 'register') { return (
{data.inP.map(r => { const f = flags[r.id] || {}; const isVoid = r.status === 'void'; return (); })} {data.inP.length === 0 && }
RefDate / timeCustomerType Pay-inPay-outFeeTellerFlags
{r.ref} {r.date} {r.time} {r.customer} {r.type} {num(r.inAmt)} {r.inCcy} {r.outAmt === '' ? '—' : num(r.outAmt)} {r.outCcy} {fmt(r.fee, homeCcy)} {tellerName(r.teller, settings)} {isVoid ? VOID : {[f.single ? 'RPT' : '', f.str ? 'STR' : '', (f.kyc && f.kyc !== 'ok') ? 'ID' : ''].filter(Boolean).join(' ') || '—'}}
No records in this period.
{limit.amount == null ? 'RPT = reportable — no reporting line is set for this desk, so nothing is flagged' : <>RPT = reportable ≥ {limit.label}} · STR = structuring watch · ID = KYC exception. Fees are shown in {homeCcy}. Voided records are retained, struck through, and never deleted.
); } if (id === 'kyc') { const names = Array.from(new Set([...Object.keys(clients), ...data.live.map(r => r.customer)])).sort(); const stat = (n) => { const c = clients[n] || {}; if (!c.idType || !c.idNum) return ['missing ID', CD.flag, CD.flagSoft]; if (c.idExpiry && c.idExpiry < businessDate()) return ['ID expired', CD.flag, CD.flagSoft]; return ['verified', CD.green, CD.greenSoft]; }; return (
{names.map(n => { const c = clients[n] || {}; const [st, col, bg] = stat(n); const tx = data.live.filter(r => r.customer === n); /* A client's volume in the desk's own money, or nothing. One leg this board cannot price makes the whole total unknown — a sum quietly missing a currency is worse than a dash, because it looks complete. */ const parts = tx.map(r => homeEquiv(r.inAmt, r.inCcy, homeCcy)); const v = !parts.length || parts.some(p => p == null) ? null : parts.reduce((s, p) => s + p, 0); return (); })}
ClientID typeID numberExpiryStatusTxVolume
{n} {c.idType || '—'} {c.idNum || '—'} {c.idExpiry || '—'} {st.toUpperCase()} {tx.length} {orDash(v, homeCcy, tx.length ? `no ${homeCcy} rate` : 'nothing in this period')}
Volumes are shown in {homeCcy}, this desk's own currency as its jurisdiction pack states it. A client whose deals include a currency this branch has never published a rate for has no total to show, and says so.
); } return null; }; /* ---------- shells ---------- */ function Mini({ label, value, sub, tone }) { return (
{label}
{value}
{sub &&
{sub}
}
); } function Attest() { return (
{['Prepared by', 'Compliance officer'].map(r => (
{r}Date
))}
); } const RangePicker = (
{menu && (
{RANGES.map(([id, label]) => { const on = range === id; return (); })}
)}
); const filterCount = activeFilters.length; const clearScope = () => setScope({ customers: [], tellers: [], types: [], from: '', to: '' }); const addTo = (key, val) => setScope(s => s[key].includes(val) ? s : ({ ...s, [key]: [...s[key], val] })); const removeFrom = (key, val) => setScope(s => ({ ...s, [key]: s[key].filter(x => x !== val) })); const selSty = { width: '100%', fontSize: 13, padding: '8px 10px', border: `1px solid ${CD.line}`, borderRadius: 8, background: 'var(--cd-panel)', color: CD.ink, outline: 'none' }; function ScopeRow({ label, scopeKey, options, placeholder }) { const [val, setVal] = useState(''); const items = scope[scopeKey]; const listId = 'scope-' + scopeKey; const tryAdd = (v) => { const t = (v || '').trim(); if (t && options.includes(t)) { addTo(scopeKey, t); setVal(''); return true; } return false; }; return (
{label}{items.length > 0 && · {items.length} selected}
{items.length > 0 &&
{items.map(it => ( {it} ))}
}
{ if (!tryAdd(e.target.value)) setVal(e.target.value); }} onKeyDown={e => { if (e.key === 'Enter') { e.preventDefault(); tryAdd(val); } }} placeholder={items.length ? 'Add another…' : placeholder} style={{ ...selSty, paddingRight: 26 }} /> {options.filter(o => !items.includes(o)).map(o =>
); } const FilterControl = (
{filterOpen && (
Scope this report {filterCount > 0 ? : everything}
Custom date range · overrides the period
setScope(s => ({ ...s, from: e.target.value }))} style={selSty} /> setScope(s => ({ ...s, to: e.target.value }))} style={selSty} />
{filterCount ? `${filterCount} filter${filterCount > 1 ? 's' : ''} active` : 'No filters'}
)}
); // ---- access manager (Owner / Manager): role × report matrix ---- const toggleAccess = (role, id) => { setAccess(prev => { const cur = prev[role] || DEFAULT_ACCESS[role] || []; const has = cur.includes(id); const nx = { ...prev, [role]: has ? cur.filter(x => x !== id) : [...cur, id] }; try { localStorage.setItem(AKEY, JSON.stringify(nx)); } catch (e) {} return nx; }); }; const resetAccess = () => { try { localStorage.removeItem(AKEY); } catch (e) {} setAccess({ ...DEFAULT_ACCESS }); }; if (manageAccess && canManage) { return (
Report access by role

Tick which reports each role can generate. Staff only see and generate the sheets allowed for their role; everything else is locked.

{ROLES.map(role => )} {REPORTS.map(rep => ( {ROLES.map(role => { const on = (access[role] || DEFAULT_ACCESS[role] || []).includes(rep.id); const locked = role === 'Owner'; return ( ); })} ))}
Report{role}
{titleOf(rep)}
); } // ---- launcher: reports to generate, gated by the signed-in user's role ---- if (!active) { const visible = REPORTS; const openReport = (id) => { if (!canGen(id)) return; if (id === 'endofday') { setRange('today'); setScope({ customers: [], tellers: [], types: [], from: '', to: '' }); } setActive(id); }; return (
Signed in as {me ? me.name : '—'} · {myRole} — you can generate {allowed.length} of {REPORTS.length} reports
{canManage && }
{visible.map(r => { const ok = canGen(r.id); return ( ); })}

Reports read the live, immutable ledger. Every generated report is saved to History as a frozen snapshot — print / Save-PDF ready and exportable to CSV.{canManage ? ' Access is configurable per role via Manage access.' : ''}

); } // ---- document view ---- const meta = REPORTS.find(r => r.id === active); return (
{titleOf(meta)}
{active !== 'endofday' && FilterControl} {RangePicker}
{renderDoc(active)}
); } /* ============================================================ Report history — every generated report, frozen as an immutable snapshot. Its own Compliance tab: filter by type, re-open, re-print. ============================================================ */ function ReportHistory() { const [history, setHistory] = useState(() => { try { return JSON.parse(localStorage.getItem(HKEY) || '[]') || []; } catch (e) { return []; } }); const [histFilter, setHistFilter] = useState('all'); const [period, setPeriod] = useState('all'); const [search, setSearch] = useState(''); const [viewing, setViewing] = useState(null); const persist = (h) => { const cap = h.slice(0, 500); setHistory(cap); try { localStorage.setItem(HKEY, JSON.stringify(cap)); } catch (e) {} }; const remove = (key) => persist(history.filter(e => e.key !== key)); const metaFor = (type) => { const r = REPORTS.find(x => x.id === type); return r ? { label: titleOf(r), icon: r.icon, tone: r.tone } : { label: type, icon: 'lock', tone: CD.flag }; }; const openWindow = (html, title) => { const w = window.open('', '_blank', 'width=900,height=1100'); if (!w) return; w.document.write(html); w.document.close(); setTimeout(() => w.focus(), 200); }; // saved-snapshot viewer (generated business/compliance reports render inline) if (viewing) { return (
{viewing.title} SAVED · {viewing.at}
); } const q = search.trim().toLowerCase(); const matchesQ = (e) => !q || [e.title, e.ref, e.ack, e.subject, e.rangeLabel, e.at, metaFor(e.type).label].filter(Boolean).some(s => String(s).toLowerCase().includes(q)); const PERIODS = [['all', 'All time'], ['today', 'Today'], ['7d', 'Last 7 days'], ['30d', 'Last 30 days'], ['90d', 'Last 90 days'], ['365d', 'This year']]; const matchesPeriod = (e) => { if (period === 'all' || !e.ms) return true; const age = (Date.now() - e.ms) / 86400000; if (period === 'today') return age < 1; return age <= ({ '7d': 7, '30d': 30, '90d': 90, '365d': 365 }[period] || 1e9); }; const typeCount = (id) => history.filter(e => e.type === id).length; const typesPresent = Array.from(new Set(history.map(e => e.type))); const filtered = history.filter(e => (histFilter === 'all' || e.type === histFilter) && matchesPeriod(e) && matchesQ(e)); const openEntry = (e) => { if (e.filing && e.fullHTML) openWindow(e.fullHTML, e.title); else setViewing(e); }; return (
{history.length === 0 ? (
Nothing in history yet
Every report generated and every compliance filing sealed is saved here automatically — permanently, and searchable.
) : (<>
setSearch(e.target.value)} placeholder="Search by name, reference, FWR receipt…" className="outline-none text-sm bg-transparent flex-1" style={{ color: CD.ink, minWidth: 60 }} /> {search && }
{filtered.map((e, i) => (
{e.title}{e.filing && {e.badge || 'FILED'}}
{e.filing ? <>FWR {e.ack}·{e.ref} : <>{e.rangeLabel}·{e.n} tx} ·{e.at}
))} {filtered.length === 0 &&
{q ? `No results for “${search}”.` : 'No reports match these filters.'}
}
)}
); } /* ============================================================ THE DEMO HISTORY IS GONE, AND THIS IS ITS HEADSTONE `seedFakeHistory()` stood here and ran on module load. It wrote nine entries into the report history, and four of them were SEALED COMPLIANCE FILINGS: a Large Cash Transaction Report for "Brooke Lawson" with acknowledgement number FIN-4471, an EFTR for "Jakob Miller" with FIN-6093, each rendered as a full print-ready document headed "YORK CURRENCY EXCHANGE · MSB", stamped ● SEALED, and footed "Immutable record retained under the PCMLTFA." No such report was ever filed. No such acknowledgement was ever issued. They were props, and they sat in the same list, with the same print button, as the ones a desk actually files — on the screen an examiner is shown. A fabricated business figure is a bug. A fabricated regulatory filing with an invented receipt number is a different category of thing, and it does not belong in a shipped product at any stage of its life. The tab now opens empty for a desk that has generated nothing, and says so, which is the truth about that desk. If a populated history is ever wanted for a sales demo, it belongs behind an explicit demo-tenant flag on the server, generated from that tenant's own ledger — never compiled into the browser where the only thing separating it from a real record is a key in localStorage. See docs/GENERATED_DOCUMENTS.md. ============================================================ */ window.CDOS = Object.assign(window.CDOS || {}, { Reports, ReportHistory }); })();