Files

T

steve e252ddb952 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

2.3 KiB

Raw Blame History

ezcheck

Self-hosted web app for printing checks on blank check stock. Replaces ezCheckPrinting (Halfpricesoft).

Stack

Runtime: Node.js 20
Framework: Express
Database: SQLite via better-sqlite3
PDF generation: PDFKit with embedded MICR E-13B font
Frontend: Vanilla JS, no framework
Container: Docker Compose

Project Structure

ezcheck/
├── src/
│   ├── routes/
│   │   ├── checks.js       # CRUD for check records
│   │   ├── accounts.js     # Account config (Phase 2)
│   │   └── pdf.js          # PDF generation endpoint
│   ├── services/
│   │   └── pdfService.js   # PDFKit rendering logic
│   ├── db/
│   │   ├── schema.sql      # SQLite schema
│   │   └── database.js     # DB connection + helpers
│   └── app.js              # Express app
├── migrations/
│   └── import-mdb.js       # One-time .mdb import script
├── public/
│   ├── css/style.css
│   ├── js/app.js
│   └── index.html
├── fonts/                  # MICR E-13B TTF goes here
├── docker/
│   └── Dockerfile
├── docker-compose.yml
├── package.json
└── .env.example

Getting Started

Development (local)

npm install
cp .env.example .env
node migrations/import-mdb.js --file /path/to/YourAccount.mdb
npm run dev

Production (Docker)

docker compose up -d

Migration

The import script reads a single .mdb file and populates the SQLite database. It requires mdbtools to be installed on the host or available in the container.

node migrations/import-mdb.js --file "Montana Dinosaur Center.mdb"

Printing

Select 1–3 checks from the ledger
Click "Print PDF"
App generates a 3-up 8.5"×11" PDF (three 3.667" check slots)
PDF opens in browser, user sends to printer
Checks are marked as printed in the ledger

Check Layout Coordinate Space

Coordinates are in inches. Origin is top-left of each check slot. Check slot dimensions: 8.5" wide × 3.667" tall (three per letter page). MICR line is hardcoded at Y = 3.4" (0.267" from bottom of slot).

MICR Font

Place micrenc.ttf or GnuMICR.ttf in the fonts/ directory. Update MICR_FONT_PATH in .env if using a different filename.

2.3 KiB Raw Blame History Unescape Escape