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,139 @@
+'use strict';
+
+const express = require('express');
+const router = express.Router();
+const db = require('../db/database');
+
+// GET /api/checks - list all checks, newest first
+router.get('/', (req, res) => {
+  const { after, printed } = req.query;
+  let query = 'SELECT * FROM checks';
+  const params = [];
+  const conditions = [];
+
+  if (after) {
+    conditions.push('check_date >= ?');
+    params.push(after);
+  }
+  if (printed !== undefined) {
+    conditions.push('printed = ?');
+    params.push(printed === 'true' || printed === '1' ? 1 : 0);
+  }
+
+  if (conditions.length) {
+    query += ' WHERE ' + conditions.join(' AND ');
+  }
+  query += ' ORDER BY check_no DESC';
+
+  const checks = db.prepare(query).all(...params);
+  res.json(checks);
+});
+
+// GET /api/checks/:id
+router.get('/:id', (req, res) => {
+  const check = db.prepare('SELECT * FROM checks WHERE id = ?').get(req.params.id);
+  if (!check) return res.status(404).json({ error: 'Check not found' });
+  res.json(check);
+});
+
+// POST /api/checks - create a new check
+router.post('/', (req, res) => {
+  const { payee, amount, check_date, memo, note1, note2,
+          payee_address1, payee_address2, payee_address3, payee_address4 } = req.body;
+
+  if (!payee || !amount || !check_date) {
+    return res.status(400).json({ error: 'payee, amount, and check_date are required' });
+  }
+
+  // Get next check number from account
+  const account = db.prepare('SELECT current_check_no FROM account WHERE id = 1').get();
+  if (!account) return res.status(500).json({ error: 'No account configured. Run migration first.' });
+
+  const checkNo = account.current_check_no + 1;
+
+  const insertCheck = db.prepare(`
+    INSERT INTO checks (check_no, payee, amount, check_date, memo, note1, note2,
+      payee_address1, payee_address2, payee_address3, payee_address4)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+
+  const updateAccountCheckNo = db.prepare(
+    'UPDATE account SET current_check_no = ?, updated_at = datetime(\'now\') WHERE id = 1'
+  );
+
+  const transaction = db.transaction(() => {
+    const result = insertCheck.run(
+      checkNo, payee, parseFloat(amount), check_date,
+      memo || null, note1 || null, note2 || null,
+      payee_address1 || null, payee_address2 || null,
+      payee_address3 || null, payee_address4 || null
+    );
+    updateAccountCheckNo.run(checkNo);
+    return result.lastInsertRowid;
+  });
+
+  const newId = transaction();
+  const newCheck = db.prepare('SELECT * FROM checks WHERE id = ?').get(newId);
+  res.status(201).json(newCheck);
+});
+
+// PUT /api/checks/:id - update a check
+router.put('/:id', (req, res) => {
+  const check = db.prepare('SELECT * FROM checks WHERE id = ?').get(req.params.id);
+  if (!check) return res.status(404).json({ error: 'Check not found' });
+
+  if (check.printed) {
+    return res.status(409).json({ error: 'Cannot edit a check that has been printed.' });
+  }
+
+  const { payee, amount, check_date, memo, note1, note2,
+          payee_address1, payee_address2, payee_address3, payee_address4 } = req.body;
+
+  db.prepare(`
+    UPDATE checks SET
+      payee = ?, amount = ?, check_date = ?, memo = ?, note1 = ?, note2 = ?,
+      payee_address1 = ?, payee_address2 = ?, payee_address3 = ?, payee_address4 = ?
+    WHERE id = ?
+  `).run(
+    payee ?? check.payee,
+    amount !== undefined ? parseFloat(amount) : check.amount,
+    check_date ?? check.check_date,
+    memo ?? check.memo,
+    note1 ?? check.note1,
+    note2 ?? check.note2,
+    payee_address1 ?? check.payee_address1,
+    payee_address2 ?? check.payee_address2,
+    payee_address3 ?? check.payee_address3,
+    payee_address4 ?? check.payee_address4,
+    req.params.id
+  );
+
+  res.json(db.prepare('SELECT * FROM checks WHERE id = ?').get(req.params.id));
+});
+
+// DELETE /api/checks/:id
+router.delete('/:id', (req, res) => {
+  const check = db.prepare('SELECT * FROM checks WHERE id = ?').get(req.params.id);
+  if (!check) return res.status(404).json({ error: 'Check not found' });
+
+  if (check.printed) {
+    return res.status(409).json({ error: 'Cannot delete a check that has been printed.' });
+  }
+
+  db.prepare('DELETE FROM checks WHERE id = ?').run(req.params.id);
+  res.status(204).send();
+});
+
+// POST /api/checks/mark-printed - mark checks as printed
+router.post('/mark-printed', (req, res) => {
+  const { ids } = req.body;
+  if (!Array.isArray(ids) || ids.length === 0) {
+    return res.status(400).json({ error: 'ids array required' });
+  }
+
+  const placeholders = ids.map(() => '?').join(',');
+  db.prepare(`UPDATE checks SET printed = 1 WHERE id IN (${placeholders})`).run(...ids);
+  res.json({ updated: ids.length });
+});
+
+module.exports = router;
@@ -0,0 +1,62 @@
+'use strict';
+
+const express = require('express');
+const router = express.Router();
+const db = require('../db/database');
+const { generateCheckPdf } = require('../services/pdfService');
+
+/**
+ * POST /api/pdf
+ * Body: { checkIds: [1, 2, 3] }  -- 1 to 3 check IDs
+ *
+ * Returns a PDF with 1–3 checks in a 3-up layout.
+ * After successful generation, marks all checks as printed.
+ *
+ * Query param: ?mark_printed=false to suppress auto-marking (for reprints).
+ */
+router.post('/', async (req, res) => {
+  const { checkIds } = req.body;
+
+  if (!Array.isArray(checkIds) || checkIds.length === 0 || checkIds.length > 3) {
+    return res.status(400).json({ error: 'checkIds must be an array of 1–3 IDs' });
+  }
+
+  // Fetch account
+  const account = db.prepare('SELECT * FROM account WHERE id = 1').get();
+  if (!account) {
+    return res.status(500).json({ error: 'No account configured. Run migration first.' });
+  }
+
+  // Fetch checks in the order provided
+  const checks = checkIds.map(id => {
+    const check = db.prepare('SELECT * FROM checks WHERE id = ?').get(id);
+    if (!check) throw new Error(`Check ID ${id} not found`);
+    return check;
+  });
+
+  // Fetch layout fields (all visible fields)
+  const fields = db.prepare('SELECT * FROM layout_fields WHERE visible = 1').all();
+
+  try {
+    const pdfBuffer = await generateCheckPdf(account, checks, fields);
+
+    // Mark as printed unless explicitly suppressed (e.g., reprint)
+    const markPrinted = req.query.mark_printed !== 'false';
+    if (markPrinted) {
+      const placeholders = checkIds.map(() => '?').join(',');
+      db.prepare(`UPDATE checks SET printed = 1 WHERE id IN (${placeholders})`).run(...checkIds);
+    }
+
+    res.set({
+      'Content-Type': 'application/pdf',
+      'Content-Disposition': `inline; filename="checks-${checkIds.join('-')}.pdf"`,
+      'Content-Length': pdfBuffer.length,
+    });
+    res.send(pdfBuffer);
+  } catch (err) {
+    console.error('PDF generation error:', err);
+    res.status(500).json({ error: 'PDF generation failed', detail: err.message });
+  }
+});
+
+module.exports = router;