Scaffold custom reports app (LXC 122 · /reports)

Framework for categorised custom reports pulling from NewBook, ResOS,
SambaPOS, and internal data. Report tree with collapsible categories
and subcategories; date-range params; run-audit log in reports_db.

Initial reports: NewBook arrivals/departures/stayovers/bookings-by-source,
ResOS covers/revenue, SambaPOS sales-summary/top-products, internal run-history.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
jtricerolph 2026-07-06 12:58:19 +00:00
commit 0511ac8d82
31 changed files with 1818 additions and 0 deletions

13
frontend/Dockerfile Normal file
View file

@ -0,0 +1,13 @@
FROM node:22-alpine AS build
WORKDIR /app
COPY package.json .
RUN npm install
COPY . .
ARG VITE_HOTEL_NAME
ENV VITE_HOTEL_NAME=$VITE_HOTEL_NAME
RUN npm run build
FROM nginx:alpine
COPY --from=build /app/dist /usr/share/nginx/html/reports
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80

39
frontend/nginx.conf Normal file
View file

@ -0,0 +1,39 @@
server {
listen 80;
server_name localhost;
root /usr/share/nginx/html;
location /reports/api/auth/ {
proxy_pass http://10.10.10.101:3001/api/auth/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
location /reports/api/ {
proxy_pass http://backend:3001/api/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
add_header Cache-Control "no-store";
}
location /reports/health {
proxy_pass http://backend:3001/health;
}
location ~* /reports/.*\.(js|css|png|ico|svg|woff2?)$ {
expires 1y;
add_header Cache-Control "public, immutable";
try_files $uri =404;
}
location /reports/ {
add_header Cache-Control "no-cache" always;
try_files $uri $uri/ /reports/index.html;
}
location = / {
return 301 /reports/;
}
}

23
frontend/package.json Normal file
View file

@ -0,0 +1,23 @@
{
"name": "hnf-reports-frontend",
"version": "1.0.0",
"private": true,
"type": "module",
"scripts": {
"dev": "vite",
"build": "tsc && vite build",
"preview": "vite preview"
},
"dependencies": {
"lucide-react": "^0.468.0",
"react": "^18.3.1",
"react-dom": "^18.3.1"
},
"devDependencies": {
"@types/react": "^18.3.1",
"@types/react-dom": "^18.3.1",
"@vitejs/plugin-react": "^4.3.4",
"typescript": "^5.7.2",
"vite": "^6.0.5"
}
}

10
frontend/src/App.tsx Normal file
View file

@ -0,0 +1,10 @@
import AuthGate from './components/AuthGate'
import ReportsPage from './pages/ReportsPage'
export default function App() {
return (
<AuthGate>
<ReportsPage />
</AuthGate>
)
}

27
frontend/src/api.ts Normal file
View file

@ -0,0 +1,27 @@
import type { ReportMeta, ReportResult } from './types'
const BASE = '/reports/api'
async function request<T>(path: string, opts: RequestInit = {}): Promise<T> {
const res = await fetch(`${BASE}${path}`, {
credentials: 'include',
headers: { 'Content-Type': 'application/json', ...opts.headers },
...opts,
})
if (!res.ok) {
const err = await res.json().catch(() => ({ error: res.statusText }))
throw new Error((err as { error?: string }).error || `Request failed: ${res.status}`)
}
return res.json()
}
export function fetchReports(): Promise<ReportMeta[]> {
return request('/reports')
}
export function runReport(id: string, dateFrom: string, dateTo: string): Promise<ReportResult> {
return request(`/reports/${encodeURIComponent(id)}/run`, {
method: 'POST',
body: JSON.stringify({ dateFrom, dateTo }),
})
}

View file

@ -0,0 +1,51 @@
import { useEffect, useState, createContext, useContext } from 'react'
import type { User } from '../types'
interface AuthCtx { user: User }
const Ctx = createContext<AuthCtx | null>(null)
export function useAuth() {
const ctx = useContext(Ctx)
if (!ctx) throw new Error('useAuth must be used inside AuthGate')
return ctx
}
export default function AuthGate({ children }: { children: React.ReactNode }) {
const [user, setUser] = useState<User | null>(null)
const [error, setError] = useState<string | null>(null)
useEffect(() => {
fetch('/reports/api/auth/verify?app=reports', { credentials: 'include' })
.then(r => {
if (r.status === 401 || r.status === 403) {
window.location.href = `/portal?redirect=${encodeURIComponent(window.location.href)}`
return null
}
if (!r.ok) throw new Error(`Auth check failed: ${r.status}`)
return r.json()
})
.then(data => { if (data) setUser(data) })
.catch(err => setError(err.message))
}, [])
if (error) {
return (
<div style={{ padding: 32, color: '#991b1b', fontFamily: 'sans-serif' }}>
Authentication error: {error}
</div>
)
}
if (!user) {
return (
<div style={{
display: 'flex', alignItems: 'center', justifyContent: 'center',
height: '100vh', fontFamily: 'sans-serif', color: '#6b7280',
}}>
Loading
</div>
)
}
return <Ctx.Provider value={{ user }}>{children}</Ctx.Provider>
}

397
frontend/src/index.css Normal file
View file

@ -0,0 +1,397 @@
/* Stack design system tokens */
:root {
--navy: #1a1a2e;
--gold: #c9a84c;
--body-bg: #f4f5f7;
--card-bg: #ffffff;
--text-primary: #1a1a2e;
--text-muted: #6b7280;
--border: #e5e7eb;
--radius: 8px;
--shadow-sm: 0 1px 3px rgba(0,0,0,0.08);
--shadow-md: 0 4px 12px rgba(0,0,0,0.12);
/* App theme */
--app-primary: #1d4ed8;
--app-primary-light: #3b82f6;
--app-primary-dark: #1e40af;
/* Layout */
--sidebar-w: 220px;
--topbar-h: 56px;
}
*, *::before, *::after { box-sizing: border-box; }
html, body, #root {
height: 100%;
margin: 0;
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
background: var(--body-bg);
color: var(--text-primary);
font-size: 14px;
}
::-webkit-scrollbar { width: 4px; height: 4px; }
::-webkit-scrollbar-track { background: transparent; }
::-webkit-scrollbar-thumb { background: var(--border); border-radius: 2px; }
/* ── App shell ──────────────────────────────────────────────────── */
.app-shell {
display: flex;
height: 100vh;
overflow: hidden;
}
/* ── Sidebar ────────────────────────────────────────────────────── */
.sidebar {
width: var(--sidebar-w);
background: var(--navy);
display: flex;
flex-direction: column;
flex-shrink: 0;
overflow-y: auto;
}
.sidebar-logo {
padding: 20px 16px 12px;
color: var(--gold);
font-size: 13px;
font-weight: 600;
letter-spacing: .05em;
text-transform: uppercase;
display: flex;
align-items: center;
gap: 8px;
flex-shrink: 0;
}
.sidebar-nav {
flex: 1;
overflow-y: auto;
}
.sidebar-user {
padding: 12px 16px;
border-top: 1px solid rgba(255,255,255,.08);
color: rgba(255,255,255,.4);
font-size: 12px;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
flex-shrink: 0;
}
/* ── Report tree ────────────────────────────────────────────────── */
.report-category {
border-bottom: 1px solid rgba(255,255,255,.05);
}
.report-cat-header {
width: 100%;
display: flex;
align-items: center;
gap: 8px;
padding: 9px 14px;
background: none;
border: none;
cursor: pointer;
color: rgba(255,255,255,.8);
font-size: 12.5px;
font-weight: 600;
letter-spacing: .03em;
text-transform: uppercase;
text-align: left;
transition: background .12s;
}
.report-cat-header:hover { background: rgba(255,255,255,.06); }
.report-cat-icon { opacity: .7; display: flex; }
.report-cat-label { flex: 1; }
.report-cat-body {
padding-bottom: 4px;
}
.report-sub-header {
width: 100%;
display: flex;
align-items: center;
gap: 6px;
padding: 7px 14px 7px 22px;
background: none;
border: none;
cursor: pointer;
color: rgba(255,255,255,.55);
font-size: 11.5px;
font-weight: 600;
text-transform: uppercase;
letter-spacing: .04em;
text-align: left;
transition: color .12s;
}
.report-sub-header:hover { color: rgba(255,255,255,.8); }
.report-item {
width: 100%;
display: block;
padding: 7px 14px 7px 32px;
background: none;
border: none;
cursor: pointer;
color: rgba(255,255,255,.6);
font-size: 13px;
text-align: left;
transition: background .12s, color .12s;
}
.report-item:hover { background: rgba(255,255,255,.05); color: #fff; }
.report-item.active { background: rgba(201,168,76,.12); color: var(--gold); }
/* ── Mobile top bar ─────────────────────────────────────────────── */
.top-bar {
display: none;
height: var(--topbar-h);
background: var(--navy);
color: #fff;
align-items: center;
padding: 0 14px;
gap: 10px;
flex-shrink: 0;
}
.top-bar-title {
flex: 1;
font-size: 15px;
font-weight: 600;
color: var(--gold);
}
/* ── Page content ───────────────────────────────────────────────── */
.page-content {
flex: 1;
display: flex;
flex-direction: column;
overflow: hidden;
}
/* ── Welcome / empty states ─────────────────────────────────────── */
.welcome-state {
flex: 1;
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
text-align: center;
color: var(--text-muted);
padding: 40px;
}
.welcome-state h2 { margin: 0 0 8px; color: var(--text-primary); font-size: 20px; font-weight: 600; }
.welcome-state p { margin: 0; font-size: 14px; }
.empty-state {
display: flex;
flex-direction: column;
align-items: center;
justify-content: center;
padding: 60px 20px;
color: var(--text-muted);
font-size: 14px;
}
/* ── Report view ────────────────────────────────────────────────── */
.report-view {
flex: 1;
display: flex;
flex-direction: column;
overflow: hidden;
padding: 24px 28px;
gap: 16px;
}
.report-header {
display: flex;
align-items: flex-start;
gap: 16px;
}
.report-title {
margin: 0 0 4px;
font-size: 20px;
font-weight: 600;
color: var(--text-primary);
}
.report-description {
margin: 0;
font-size: 13px;
color: var(--text-muted);
max-width: 640px;
}
/* ── Controls bar ───────────────────────────────────────────────── */
.report-controls {
display: flex;
align-items: flex-end;
gap: 12px;
flex-wrap: wrap;
background: var(--card-bg);
border: 1px solid var(--border);
border-radius: var(--radius);
padding: 14px 16px;
}
.date-group {
display: flex;
flex-direction: column;
gap: 4px;
}
.date-group label {
font-size: 11px;
font-weight: 600;
color: var(--text-muted);
text-transform: uppercase;
letter-spacing: .04em;
}
.date-input {
height: 34px;
padding: 0 10px;
border: 1px solid var(--border);
border-radius: 6px;
font-size: 13px;
color: var(--text-primary);
background: var(--body-bg);
cursor: pointer;
}
.date-input:focus { outline: 2px solid var(--app-primary); outline-offset: -1px; }
.btn-run {
display: flex;
align-items: center;
gap: 6px;
height: 34px;
padding: 0 16px;
background: var(--app-primary);
color: #fff;
border: none;
border-radius: 6px;
font-size: 13px;
font-weight: 500;
cursor: pointer;
transition: background .15s;
white-space: nowrap;
}
.btn-run:hover:not(:disabled) { background: var(--app-primary-dark); }
.btn-run:disabled { opacity: .65; cursor: not-allowed; }
.btn-export {
display: flex;
align-items: center;
gap: 6px;
height: 34px;
padding: 0 14px;
background: none;
color: var(--text-muted);
border: 1px solid var(--border);
border-radius: 6px;
font-size: 13px;
cursor: pointer;
transition: border-color .15s, color .15s;
white-space: nowrap;
}
.btn-export:hover { border-color: var(--text-muted); color: var(--text-primary); }
/* ── Summary bar ────────────────────────────────────────────────── */
.summary-bar {
display: flex;
gap: 20px;
flex-wrap: wrap;
}
.summary-stat {
display: flex;
flex-direction: column;
gap: 2px;
background: var(--card-bg);
border: 1px solid var(--border);
border-radius: var(--radius);
padding: 10px 16px;
min-width: 110px;
}
.summary-label {
font-size: 11px;
font-weight: 600;
text-transform: uppercase;
letter-spacing: .04em;
color: var(--text-muted);
}
.summary-value {
font-size: 20px;
font-weight: 600;
color: var(--text-primary);
}
/* ── Error ──────────────────────────────────────────────────────── */
.report-error {
display: flex;
align-items: flex-start;
gap: 8px;
background: #fef2f2;
border: 1px solid #fecaca;
border-radius: var(--radius);
color: #991b1b;
padding: 12px 14px;
font-size: 13px;
line-height: 1.5;
}
.report-error svg { flex-shrink: 0; margin-top: 1px; }
/* ── Results table ──────────────────────────────────────────────── */
.results-table-wrap {
flex: 1;
overflow: auto;
background: var(--card-bg);
border: 1px solid var(--border);
border-radius: var(--radius);
}
.results-table {
width: 100%;
border-collapse: collapse;
font-size: 13px;
white-space: nowrap;
}
.results-table thead {
position: sticky;
top: 0;
z-index: 1;
}
.results-table th {
background: #f8f9fb;
border-bottom: 1px solid var(--border);
padding: 9px 12px;
text-align: left;
font-size: 11px;
font-weight: 600;
text-transform: uppercase;
letter-spacing: .04em;
color: var(--text-muted);
white-space: nowrap;
}
.results-table td {
padding: 8px 12px;
border-bottom: 1px solid var(--border);
color: var(--text-primary);
}
.results-table tr:last-child td { border-bottom: none; }
.results-table tr:hover td { background: #f9fafb; }
.results-table td.num { text-align: right; font-variant-numeric: tabular-nums; }
.results-table th:has(+ .num) { text-align: right; }
/* ── Spinner ────────────────────────────────────────────────────── */
@keyframes spin { to { transform: rotate(360deg); } }
.spin { animation: spin .8s linear infinite; }
/* ── Mobile ─────────────────────────────────────────────────────── */
@media (max-width: 700px) {
.sidebar { display: none; }
.page-content { flex-direction: column; }
.top-bar { display: flex; }
.report-view { padding: 16px; }
.report-controls { gap: 8px; }
}

10
frontend/src/main.tsx Normal file
View file

@ -0,0 +1,10 @@
import React from 'react'
import ReactDOM from 'react-dom/client'
import App from './App'
import './index.css'
ReactDOM.createRoot(document.getElementById('root')!).render(
<React.StrictMode>
<App />
</React.StrictMode>
)

View file

@ -0,0 +1,343 @@
import { useEffect, useState, useCallback } from 'react'
import {
BarChart2, Building2, UtensilsCrossed, ShoppingCart, Database,
ChevronRight, ChevronDown, Play, Download, Loader2, AlertCircle,
FileBarChart,
} from 'lucide-react'
import { useAuth } from '../components/AuthGate'
import { fetchReports, runReport } from '../api'
import type { ReportMeta, ReportResult } from '../types'
// ── helpers ───────────────────────────────────────────────────────────────────
const CATEGORY_ICONS: Record<string, React.ReactNode> = {
newbook: <Building2 size={14} strokeWidth={1.75} />,
resos: <UtensilsCrossed size={14} strokeWidth={1.75} />,
samba: <ShoppingCart size={14} strokeWidth={1.75} />,
internal: <Database size={14} strokeWidth={1.75} />,
}
function today(): string {
return new Date().toISOString().split('T')[0]
}
function daysAgo(n: number): string {
const d = new Date()
d.setDate(d.getDate() - n)
return d.toISOString().split('T')[0]
}
function exportCsv(result: ReportResult, reportName: string) {
const header = result.columns.map(c => `"${c.label}"`).join(',')
const dataRows = result.rows.map(row =>
result.columns.map(c => {
const val = row[c.key]
if (val === null || val === undefined) return ''
return `"${String(val).replace(/"/g, '""')}"`
}).join(',')
)
const csv = [header, ...dataRows].join('\n')
const blob = new Blob([csv], { type: 'text/csv' })
const url = URL.createObjectURL(blob)
const a = document.createElement('a')
a.href = url
a.download = `${reportName.toLowerCase().replace(/\s+/g, '-')}-${today()}.csv`
a.click()
URL.revokeObjectURL(url)
}
function formatCell(value: unknown, type?: string): string {
if (value === null || value === undefined || value === '') return '—'
if (type === 'currency') return `£${parseFloat(String(value)).toLocaleString('en-GB', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`
return String(value)
}
// ── category tree ─────────────────────────────────────────────────────────────
interface TreeNode {
label: string
category: string
subcategories: { label: string; reports: ReportMeta[] }[]
flatReports: ReportMeta[]
}
function buildTree(reports: ReportMeta[]): TreeNode[] {
const catMap = new Map<string, TreeNode>()
for (const r of reports) {
if (!catMap.has(r.category)) {
catMap.set(r.category, {
label: r.categoryLabel,
category: r.category,
subcategories: [],
flatReports: [],
})
}
const cat = catMap.get(r.category)!
if (r.subcategory) {
let sub = cat.subcategories.find(s => s.label === r.subcategory)
if (!sub) { sub = { label: r.subcategory, reports: [] }; cat.subcategories.push(sub) }
sub.reports.push(r)
} else {
cat.flatReports.push(r)
}
}
return Array.from(catMap.values())
}
// ── sidebar ───────────────────────────────────────────────────────────────────
interface SidebarProps {
tree: TreeNode[]
selectedId: string | null
onSelect: (r: ReportMeta) => void
}
function Sidebar({ tree, selectedId, onSelect }: SidebarProps) {
const { user } = useAuth()
const [openCats, setOpenCats] = useState<Set<string>>(new Set(tree.map(t => t.category)))
const [openSubs, setOpenSubs] = useState<Set<string>>(new Set())
const toggleCat = (key: string) =>
setOpenCats(prev => { const n = new Set(prev); n.has(key) ? n.delete(key) : n.add(key); return n })
const toggleSub = (key: string) =>
setOpenSubs(prev => { const n = new Set(prev); n.has(key) ? n.delete(key) : n.add(key); return n })
return (
<aside className="sidebar">
<div className="sidebar-logo">
<BarChart2 size={18} strokeWidth={1.75} />
Reports
</div>
<nav className="sidebar-nav" style={{ padding: 0 }}>
{tree.map(cat => {
const isOpen = openCats.has(cat.category)
return (
<div key={cat.category} className="report-category">
<button className="report-cat-header" onClick={() => toggleCat(cat.category)}>
<span className="report-cat-icon">{CATEGORY_ICONS[cat.category] ?? <FileBarChart size={14} strokeWidth={1.75} />}</span>
<span className="report-cat-label">{cat.label}</span>
{isOpen
? <ChevronDown size={12} strokeWidth={2} />
: <ChevronRight size={12} strokeWidth={2} />}
</button>
{isOpen && (
<div className="report-cat-body">
{cat.subcategories.map(sub => {
const subKey = `${cat.category}:${sub.label}`
const subOpen = openSubs.has(subKey)
return (
<div key={sub.label}>
<button className="report-sub-header" onClick={() => toggleSub(subKey)}>
{subOpen
? <ChevronDown size={11} strokeWidth={2} />
: <ChevronRight size={11} strokeWidth={2} />}
{sub.label}
</button>
{subOpen && sub.reports.map(r => (
<button
key={r.id}
className={`report-item${selectedId === r.id ? ' active' : ''}`}
onClick={() => onSelect(r)}
>
{r.name}
</button>
))}
</div>
)
})}
{cat.flatReports.map(r => (
<button
key={r.id}
className={`report-item${selectedId === r.id ? ' active' : ''}`}
onClick={() => onSelect(r)}
>
{r.name}
</button>
))}
</div>
)}
</div>
)
})}
</nav>
<div className="sidebar-user">{user.name}</div>
</aside>
)
}
// ── results table ─────────────────────────────────────────────────────────────
function ResultsTable({ result }: { result: ReportResult }) {
if (result.rows.length === 0) {
return (
<div className="empty-state">
<FileBarChart size={32} strokeWidth={1} style={{ opacity: 0.3, marginBottom: 8 }} />
No data found for this date range
</div>
)
}
return (
<div className="results-table-wrap">
<table className="results-table">
<thead>
<tr>
{result.columns.map(c => <th key={c.key}>{c.label}</th>)}
</tr>
</thead>
<tbody>
{result.rows.map((row, i) => (
<tr key={i}>
{result.columns.map(c => (
<td
key={c.key}
className={c.type === 'number' || c.type === 'currency' ? 'num' : ''}
>
{formatCell(row[c.key], c.type)}
</td>
))}
</tr>
))}
</tbody>
</table>
</div>
)
}
// ── main page ─────────────────────────────────────────────────────────────────
export default function ReportsPage() {
const [reports, setReports] = useState<ReportMeta[]>([])
const [selected, setSelected] = useState<ReportMeta | null>(null)
const [dateFrom, setDateFrom] = useState(daysAgo(7))
const [dateTo, setDateTo] = useState(today())
const [result, setResult] = useState<ReportResult | null>(null)
const [loading, setLoading] = useState(false)
const [error, setError] = useState<string | null>(null)
useEffect(() => {
fetchReports().then(setReports).catch(err => setError(err.message))
}, [])
const tree = buildTree(reports)
const handleSelect = useCallback((r: ReportMeta) => {
setSelected(r)
setResult(null)
setError(null)
}, [])
const handleRun = async () => {
if (!selected) return
setLoading(true)
setError(null)
setResult(null)
try {
const res = await runReport(selected.id, dateFrom, dateTo)
setResult(res)
} catch (err) {
setError((err as Error).message)
} finally {
setLoading(false)
}
}
return (
<div className="app-shell">
<Sidebar tree={tree} selectedId={selected?.id ?? null} onSelect={handleSelect} />
{/* Mobile top bar */}
<div className="top-bar">
<BarChart2 size={18} strokeWidth={1.75} color="var(--gold)" />
<span className="top-bar-title">Reports</span>
</div>
<main className="page-content">
{!selected ? (
<div className="welcome-state">
<BarChart2 size={48} strokeWidth={1} style={{ color: 'var(--border)', marginBottom: 16 }} />
<h2>Custom Reports</h2>
<p>Select a report from the sidebar to get started.</p>
</div>
) : (
<div className="report-view">
<div className="report-header">
<div>
<h1 className="report-title">{selected.name}</h1>
<p className="report-description">{selected.description}</p>
</div>
</div>
<div className="report-controls">
<div className="date-group">
<label>From</label>
<input
type="date"
className="date-input"
value={dateFrom}
max={dateTo}
onChange={e => setDateFrom(e.target.value)}
/>
</div>
<div className="date-group">
<label>To</label>
<input
type="date"
className="date-input"
value={dateTo}
min={dateFrom}
onChange={e => setDateTo(e.target.value)}
/>
</div>
<button className="btn-run" onClick={handleRun} disabled={loading}>
{loading
? <><Loader2 size={14} strokeWidth={2} className="spin" /> Running</>
: <><Play size={14} strokeWidth={2} /> Run Report</>}
</button>
{result && (
<button className="btn-export" onClick={() => exportCsv(result, selected.name)}>
<Download size={14} strokeWidth={2} /> Export CSV
</button>
)}
</div>
{error && (
<div className="report-error">
<AlertCircle size={16} strokeWidth={1.75} />
{error}
</div>
)}
{result && (
<>
{result.summary && result.summary.length > 0 && (
<div className="summary-bar">
{result.summary.map((s, i) => (
<div key={i} className="summary-stat">
<span className="summary-label">{s.label}</span>
<span className="summary-value">{s.value}</span>
</div>
))}
<div className="summary-stat">
<span className="summary-label">Rows</span>
<span className="summary-value">{result.rows.length.toLocaleString()}</span>
</div>
</div>
)}
<ResultsTable result={result} />
</>
)}
</div>
)}
</main>
</div>
)
}

31
frontend/src/types.ts Normal file
View file

@ -0,0 +1,31 @@
export interface User {
email: string
name: string
is_admin: boolean
caps: string[]
}
export function can(user: User, cap: string): boolean {
return user.is_admin || user.caps.includes(cap)
}
export interface ReportMeta {
id: string
name: string
category: string
categoryLabel: string
subcategory: string | null
description: string
}
export interface ReportColumn {
key: string
label: string
type?: 'text' | 'number' | 'currency' | 'date' | 'datetime'
}
export interface ReportResult {
columns: ReportColumn[]
rows: Record<string, unknown>[]
summary?: { label: string; value: string }[]
}

19
frontend/tsconfig.json Normal file
View file

@ -0,0 +1,19 @@
{
"compilerOptions": {
"target": "ES2020",
"useDefineForClassFields": true,
"lib": ["ES2020", "DOM", "DOM.Iterable"],
"module": "ESNext",
"skipLibCheck": true,
"moduleResolution": "bundler",
"allowImportingTsExtensions": true,
"resolveJsonModule": true,
"isolatedModules": true,
"noEmit": true,
"jsx": "react-jsx",
"strict": true,
"noUnusedLocals": false,
"noUnusedParameters": false
},
"include": ["src"]
}

7
frontend/vite.config.ts Normal file
View file

@ -0,0 +1,7 @@
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
export default defineConfig({
base: '/reports/',
plugins: [react()],
})