Move to FastAPI with accounts, SQLite books, export and tax returns

Storage and export
- Keep books and transactions in SQLite (data/cashbook.db) instead of
  .ods files; existing .ods books are migrated once at startup
- Export a book as the cashbook spreadsheet (.xlsx/.ods, built from the
  template via LibreOffice) or as CSV
- GST rounded per transaction to match the spreadsheet

Tax
- GST return page with IRD GST101A boxes 5-15 per six-monthly,
  two-monthly or monthly period, due dates, and a Zero-rated GST type
- Income tax page with IR10 (financial statements summary) and IR4
  (company return) boxes, from the cashbook plus year-end amounts typed
  in and saved per book

FastAPI and accounts (following led-editor)
- Replace the stdlib server with a FastAPI app (src/cashbook_app) run by
  uvicorn; dependencies in Pipfile
- Cookie sessions with bcrypt passwords, first-run admin setup or
  BOOTSTRAP_ADMIN_*, invites (link or email), sign-in throttling,
  password change that signs out other sessions
- Users page for administrators: rename, reset password, promote or
  demote, delete, list and revoke invites; last admin is protected
- Replaces the shared CASHBOOK_PASSWORD basic auth; AUTH_* settings in
  .env (see .env.example)
- Docker image uses a venv with system site packages for python3-uno
- pytest suite for auth, user management, imports, GST and tax figures

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
jimmyandClaude Opus 5.5 committed 2026-10-24 22:43:18 +13:00
1 parent 17b48f25e8
commit 4b3e5f0932
47 files changed
+4189 -862

No files matched your search

+20 -9
View File
@@ -6,25 +6,36 @@ services:
restart: unless-stopped
stop_grace_period: 20s
# Run as the owner of ./data so saved books stay owned by them on the host.
# Run as the owner of ./data so saved files stay owned by them on the host.
# Rootless Docker maps container root to you instead: set CASHBOOK_USER=0:0.
user: "${CASHBOOK_USER:-1000:1000}"
# Only published on localhost by default; put a TLS reverse proxy in front
# to reach it from elsewhere (set CASHBOOK_BIND=0.0.0.0 only behind a firewall).
# Only published on localhost by default; put an HTTPS reverse proxy in front
# to reach it from elsewhere (set CASHBOOK_BIND=0.0.0.0 only on a trusted network).
ports:
- "${CASHBOOK_BIND:-127.0.0.1}:${CASHBOOK_PORT:-8765}:8765"
# Browser login (HTTP Basic): set CASHBOOK_PASSWORD in .env. Leave it unset to turn
# the login off; then anyone who can reach the port can see and change your books.
# Settings come from .env next to this file; see .env.example
environment:
CASHBOOK_USERNAME: "${CASHBOOK_USERNAME:-cashbook}"
CASHBOOK_PASSWORD: "${CASHBOOK_PASSWORD:-}"
# other host names you reach it by, if the proxy doesn't pass Host through
AUTH_ENABLED: "${AUTH_ENABLED:-true}"
AUTH_REGISTER_OPEN: "${AUTH_REGISTER_OPEN:-true}"
AUTH_INVITE_ONLY: "${AUTH_INVITE_ONLY:-true}"
AUTH_SESSION_DAYS: "${AUTH_SESSION_DAYS:-14}"
BOOTSTRAP_ADMIN_USERNAME: "${BOOTSTRAP_ADMIN_USERNAME:-}"
BOOTSTRAP_ADMIN_PASSWORD: "${BOOTSTRAP_ADMIN_PASSWORD:-}"
PUBLIC_BASE_URL: "${PUBLIC_BASE_URL:-}"
SMTP_HOST: "${SMTP_HOST:-}"
SMTP_PORT: "${SMTP_PORT:-587}"
SMTP_USER: "${SMTP_USER:-}"
SMTP_PASSWORD: "${SMTP_PASSWORD:-}"
SMTP_FROM: "${SMTP_FROM:-}"
SMTP_TLS: "${SMTP_TLS:-true}"
CASHBOOK_ALLOWED_HOSTS: "${CASHBOOK_ALLOWED_HOSTS:-}"
# proxies trusted for X-Forwarded-Proto (e.g. your reverse proxy's address)
FORWARDED_ALLOW_IPS: "${FORWARDED_ALLOW_IPS:-127.0.0.1}"
volumes:
# cashbooks and statements/ (uploads go there too)
# cashbook.db (books and accounts) and statements/ (uploads go there too)
- ./data:/data
# optional: a folder of ANZ exports to pick from, read-only
# - /path/to/anz:/statements:ro