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

README.md

@@ -1 +1,86 @@
-# check-printing
+# 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)
+
+```bash
+npm install
+cp .env.example .env
+node migrations/import-mdb.js --file /path/to/YourAccount.mdb
+npm run dev
+```
+
+### Production (Docker)
+
+```bash
+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.
+
+```bash
+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.