Files
accounts/Dockerfile
T
jimmyandClaude Opus 5.5 4b3e5f0932 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>
2026-10-24 22:43:18 +13:00

41 lines
1.5 KiB
Docker

FROM debian:bookworm-slim
# LibreOffice (headless Calc) + its Python bridge for spreadsheet export,
# pdftotext for PDF statements
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
python3 python3-venv python3-uno libreoffice-calc-nogui poppler-utils fonts-dejavu-core \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /app
# a venv that can still see the system python3-uno
COPY Pipfile Pipfile.lock ./
RUN python3 -m venv --system-site-packages /opt/venv \
&& /opt/venv/bin/pip install --no-cache-dir pipenv \
&& /opt/venv/bin/pipenv requirements > /tmp/requirements.txt \
&& /opt/venv/bin/pip install --no-cache-dir -r /tmp/requirements.txt \
&& /opt/venv/bin/pip uninstall -y pipenv \
&& rm /tmp/requirements.txt
COPY src ./src
# LibreOffice needs a writable home; /tmp is the only writable place besides /data
ENV PATH=/opt/venv/bin:$PATH \
HOME=/tmp \
CASHBOOK_DATA=/data \
CASHBOOK_STATEMENTS=/statements \
PYTHONDONTWRITEBYTECODE=1 \
PYTHONUNBUFFERED=1
# run unprivileged by default (compose can override with `user:`)
USER 1000:1000
EXPOSE 8765
HEALTHCHECK --interval=30s --timeout=5s --start-period=30s --retries=3 \
CMD ["python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8765/healthz', timeout=3)"]
# --proxy-headers: trust X-Forwarded-Proto from the hosts in FORWARDED_ALLOW_IPS
# (so cookies are marked Secure behind an HTTPS proxy)
CMD ["uvicorn", "app:app", "--app-dir", "src", "--host", "0.0.0.0", "--port", "8765", "--proxy-headers"]