Add full project structure: backend, frontend, Docker, and CI workflows

- Organize backend into src/ (routes/, services/, db/) per package.json entrypoint - Add migrations/import-mdb.js for one-time .mdb → SQLite migration - Add public/ frontend: check ledger table, slide-in new/edit panel, PDF generation - Add docker/Dockerfile and docker-compose.yml for self-hosted deployment - Add .github/workflows: Docker Hub build+push on main/tags, TODO→Issues scanner - Add GnuMICR font files (GPL-2.0) for MICR E-13B line rendering
2026-03-12 10:29:36 -06:00
parent 9fcb31ba0d
commit e252ddb952
35 changed files with 4112 additions and 1 deletions
@@ -0,0 +1,391 @@
+'use strict';
+
+const state = {
+  checks: [],
+  account: null,
+  filter: '0',        // '' = all, '0' = unprinted, '1' = printed
+  sortCol: 'check_no',
+  sortDir: 'desc',
+  selected: new Set(),
+  editingId: null,
+};
+
+// ── API helpers ──────────────────────────────────────────────────────────────
+
+async function apiFetch(method, path, body) {
+  const opts = { method, headers: { 'Content-Type': 'application/json' } };
+  if (body !== undefined) opts.body = JSON.stringify(body);
+  const res = await fetch(path, opts);
+  if (res.status === 204) return null;
+  const data = await res.json();
+  if (!res.ok) throw new Error(data.error || res.statusText);
+  return data;
+}
+
+// ── Data loading ─────────────────────────────────────────────────────────────
+
+async function loadAccount() {
+  try {
+    state.account = await apiFetch('GET', '/api/account');
+    renderHeader();
+  } catch {
+    // account not configured yet — silently skip
+  }
+}
+
+async function loadChecks() {
+  const tbody = document.getElementById('checks-tbody');
+  tbody.innerHTML = '<tr class="loading-row"><td colspan="8">Loading…</td></tr>';
+  try {
+    const params = new URLSearchParams();
+    if (state.filter !== '') params.set('printed', state.filter);
+    state.checks = await apiFetch('GET', `/api/checks?${params}`);
+    state.selected.clear();
+    renderTable();
+    refreshPdfButton();
+  } catch (err) {
+    tbody.innerHTML = `<tr class="empty-row"><td colspan="8">Error loading checks: ${escHtml(err.message)}</td></tr>`;
+  }
+}
+
+// ── Rendering ────────────────────────────────────────────────────────────────
+
+function renderHeader() {
+  const a = state.account;
+  if (!a) return;
+  document.getElementById('company-name').textContent = a.company1 || 'ezcheck';
+  document.getElementById('current-check-no').textContent = (a.current_check_no + 1).toLocaleString();
+}
+
+function renderTable() {
+  const checks = sortedChecks();
+  const tbody = document.getElementById('checks-tbody');
+
+  if (checks.length === 0) {
+    tbody.innerHTML = '<tr class="empty-row"><td colspan="8">No checks found.</td></tr>';
+    updateSortIndicators();
+    return;
+  }
+
+  tbody.innerHTML = checks.map(renderRow).join('');
+  updateSortIndicators();
+  updateCheckboxStates();
+
+  // Attach row-level event listeners
+  tbody.querySelectorAll('input[type="checkbox"]').forEach(cb => {
+    cb.addEventListener('change', () => onCheckboxChange(cb));
+  });
+  tbody.querySelectorAll('.btn-edit').forEach(btn => {
+    btn.addEventListener('click', () => openPanel(parseInt(btn.dataset.id, 10)));
+  });
+  tbody.querySelectorAll('.btn-delete').forEach(btn => {
+    btn.addEventListener('click', () => deleteCheck(parseInt(btn.dataset.id, 10)));
+  });
+  tbody.querySelectorAll('.btn-reprint').forEach(btn => {
+    btn.addEventListener('click', () => reprintCheck(parseInt(btn.dataset.id, 10)));
+  });
+}
+
+function renderRow(c) {
+  const printed = !!c.printed;
+  const selected = state.selected.has(c.id);
+
+  const fmtAmount = new Intl.NumberFormat('en-US', {
+    style: 'currency', currency: 'USD',
+  }).format(c.amount);
+
+  const fmtDate = c.check_date
+    ? new Date(c.check_date + 'T12:00:00').toLocaleDateString('en-US', {
+        month: 'short', day: 'numeric', year: 'numeric',
+      })
+    : '—';
+
+  const checkbox = printed
+    ? '<td class="col-select"></td>'
+    : `<td class="col-select"><input type="checkbox" data-id="${c.id}"${selected ? ' checked' : ''}></td>`;
+
+  const statusBadge = printed
+    ? '<span class="status-badge status-printed">Printed</span>'
+    : '<span class="status-badge status-unprinted">Unprinted</span>';
+
+  const actions = printed
+    ? `<button class="btn-sm btn-reprint" data-id="${c.id}">Reprint</button>`
+    : `<button class="btn-sm btn-edit" data-id="${c.id}">Edit</button>` +
+      `<button class="btn-sm btn-delete" data-id="${c.id}">Delete</button>`;
+
+  return `<tr class="${printed ? 'printed' : ''}">
+    ${checkbox}
+    <td class="col-no">${c.check_no}</td>
+    <td class="col-date">${fmtDate}</td>
+    <td class="col-payee">${escHtml(c.payee)}</td>
+    <td class="col-amount">${fmtAmount}</td>
+    <td class="col-memo" title="${escHtml(c.memo || '')}">${escHtml(c.memo || '')}</td>
+    <td class="col-status">${statusBadge}</td>
+    <td class="col-actions">${actions}</td>
+  </tr>`;
+}
+
+function sortedChecks() {
+  const col = state.sortCol;
+  const dir = state.sortDir === 'asc' ? 1 : -1;
+  return [...state.checks].sort((a, b) => {
+    let av = a[col];
+    let bv = b[col];
+    if (col === 'amount') { av = parseFloat(av); bv = parseFloat(bv); }
+    if (av == null) return 1;
+    if (bv == null) return -1;
+    if (av < bv) return -dir;
+    if (av > bv) return dir;
+    return 0;
+  });
+}
+
+function updateSortIndicators() {
+  document.querySelectorAll('thead th.sortable').forEach(th => {
+    th.classList.remove('sort-asc', 'sort-desc');
+    if (th.dataset.col === state.sortCol) {
+      th.classList.add(state.sortDir === 'asc' ? 'sort-asc' : 'sort-desc');
+    }
+  });
+}
+
+function updateCheckboxStates() {
+  document.querySelectorAll('#checks-tbody input[type="checkbox"]').forEach(cb => {
+    const id = parseInt(cb.dataset.id, 10);
+    if (!state.selected.has(id)) {
+      cb.disabled = state.selected.size >= 3;
+    }
+  });
+}
+
+function refreshPdfButton() {
+  const n = state.selected.size;
+  const btn = document.getElementById('btn-generate-pdf');
+  btn.disabled = n === 0;
+  document.getElementById('selected-count').textContent = n;
+}
+
+// ── Checkbox handling ────────────────────────────────────────────────────────
+
+function onCheckboxChange(cb) {
+  const id = parseInt(cb.dataset.id, 10);
+  if (cb.checked) {
+    if (state.selected.size >= 3) {
+      cb.checked = false;
+      return;
+    }
+    state.selected.add(id);
+  } else {
+    state.selected.delete(id);
+  }
+  refreshPdfButton();
+  updateCheckboxStates();
+}
+
+// ── Slide-in panel ───────────────────────────────────────────────────────────
+
+function openPanel(id = null) {
+  state.editingId = id;
+  const form = document.getElementById('check-form');
+  const title = document.getElementById('panel-title');
+
+  form.reset();
+  clearFormErrors();
+  document.querySelector('.address-section').removeAttribute('open');
+
+  if (id !== null) {
+    const check = state.checks.find(c => c.id === id);
+    if (!check) return;
+    title.textContent = `Edit Check #${check.check_no}`;
+    form.payee.value = check.payee || '';
+    form.amount.value = check.amount != null ? check.amount : '';
+    form.check_date.value = check.check_date || '';
+    form.memo.value = check.memo || '';
+    form.note1.value = check.note1 || '';
+    form.note2.value = check.note2 || '';
+    form.payee_address1.value = check.payee_address1 || '';
+    form.payee_address2.value = check.payee_address2 || '';
+    form.payee_address3.value = check.payee_address3 || '';
+    form.payee_address4.value = check.payee_address4 || '';
+    if (check.payee_address1) {
+      document.querySelector('.address-section').setAttribute('open', '');
+    }
+  } else {
+    title.textContent = 'New Check';
+    form.check_date.value = new Date().toISOString().slice(0, 10);
+  }
+
+  document.getElementById('panel-overlay').classList.add('open');
+  document.getElementById('check-panel').classList.add('open');
+  form.payee.focus();
+}
+
+function closePanel() {
+  document.getElementById('panel-overlay').classList.remove('open');
+  document.getElementById('check-panel').classList.remove('open');
+  state.editingId = null;
+}
+
+function clearFormErrors() {
+  document.querySelectorAll('#check-form .error').forEach(el => el.classList.remove('error'));
+}
+
+// ── CRUD actions ─────────────────────────────────────────────────────────────
+
+async function saveCheck(e) {
+  e.preventDefault();
+  clearFormErrors();
+
+  const form = e.target;
+  const data = {
+    payee:           form.payee.value.trim(),
+    amount:          parseFloat(form.amount.value),
+    check_date:      form.check_date.value,
+    memo:            form.memo.value.trim() || null,
+    note1:           form.note1.value.trim() || null,
+    note2:           form.note2.value.trim() || null,
+    payee_address1:  form.payee_address1.value.trim() || null,
+    payee_address2:  form.payee_address2.value.trim() || null,
+    payee_address3:  form.payee_address3.value.trim() || null,
+    payee_address4:  form.payee_address4.value.trim() || null,
+  };
+
+  let valid = true;
+  if (!data.payee)                             { form.payee.classList.add('error');      valid = false; }
+  if (!data.amount || isNaN(data.amount) || data.amount <= 0) { form.amount.classList.add('error');     valid = false; }
+  if (!data.check_date)                        { form.check_date.classList.add('error'); valid = false; }
+  if (!valid) return;
+
+  const btn = document.getElementById('btn-save');
+  btn.disabled = true;
+  btn.textContent = 'Saving…';
+
+  try {
+    if (state.editingId !== null) {
+      await apiFetch('PUT', `/api/checks/${state.editingId}`, data);
+    } else {
+      await apiFetch('POST', '/api/checks', data);
+    }
+    closePanel();
+    await Promise.all([loadAccount(), loadChecks()]);
+  } catch (err) {
+    alert(`Error: ${err.message}`);
+  } finally {
+    btn.disabled = false;
+    btn.textContent = 'Save Check';
+  }
+}
+
+async function deleteCheck(id) {
+  const check = state.checks.find(c => c.id === id);
+  if (!check) return;
+  if (!confirm(`Delete check #${check.check_no} payable to "${check.payee}"?`)) return;
+  try {
+    await apiFetch('DELETE', `/api/checks/${id}`);
+    await loadChecks();
+  } catch (err) {
+    alert(`Error: ${err.message}`);
+  }
+}
+
+async function generatePdf() {
+  const ids = [...state.selected];
+  if (ids.length === 0 || ids.length > 3) return;
+
+  const btn = document.getElementById('btn-generate-pdf');
+  btn.disabled = true;
+  btn.textContent = 'Generating…';
+
+  try {
+    const res = await fetch('/api/pdf', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ checkIds: ids }),
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new Error(err.error || res.statusText);
+    }
+    const blob = await res.blob();
+    window.open(URL.createObjectURL(blob), '_blank');
+    await loadChecks(); // refresh to show printed status
+  } catch (err) {
+    alert(`PDF error: ${err.message}`);
+  } finally {
+    refreshPdfButton();
+  }
+}
+
+async function reprintCheck(id) {
+  const check = state.checks.find(c => c.id === id);
+  if (!check) return;
+  if (!confirm(`Reprint check #${check.check_no} to "${check.payee}"?\n(Will not re-mark as printed)`)) return;
+  try {
+    const res = await fetch('/api/pdf?mark_printed=false', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ checkIds: [id] }),
+    });
+    if (!res.ok) {
+      const err = await res.json().catch(() => ({ error: res.statusText }));
+      throw new Error(err.error || res.statusText);
+    }
+    const blob = await res.blob();
+    window.open(URL.createObjectURL(blob), '_blank');
+  } catch (err) {
+    alert(`Reprint error: ${err.message}`);
+  }
+}
+
+// ── Utilities ────────────────────────────────────────────────────────────────
+
+function escHtml(str) {
+  return String(str)
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+
+// ── Initialization ───────────────────────────────────────────────────────────
+
+function init() {
+  // Column sort
+  document.querySelectorAll('thead th.sortable').forEach(th => {
+    th.addEventListener('click', () => {
+      if (state.sortCol === th.dataset.col) {
+        state.sortDir = state.sortDir === 'asc' ? 'desc' : 'asc';
+      } else {
+        state.sortCol = th.dataset.col;
+        state.sortDir = th.dataset.col === 'check_no' ? 'desc' : 'asc';
+      }
+      renderTable();
+    });
+  });
+
+  // Filter dropdown
+  document.getElementById('filter-status').addEventListener('change', e => {
+    state.filter = e.target.value;
+    loadChecks();
+  });
+
+  // New check
+  document.getElementById('btn-new-check').addEventListener('click', () => openPanel());
+
+  // Panel close
+  document.getElementById('btn-close-panel').addEventListener('click', closePanel);
+  document.getElementById('btn-cancel').addEventListener('click', closePanel);
+  document.getElementById('panel-overlay').addEventListener('click', closePanel);
+
+  // Form submit
+  document.getElementById('check-form').addEventListener('submit', saveCheck);
+
+  // Generate PDF
+  document.getElementById('btn-generate-pdf').addEventListener('click', generatePdf);
+
+  // Initial data load
+  loadAccount();
+  loadChecks();
+}
+
+document.addEventListener('DOMContentLoaded', init);