Files
accounts/src/cashbook_app/main.py
T
jimmyandClaude Opus 5.5 708ce8352e Add receipts, suppliers and a top navigation bar
Receipts and invoices: attach photos and PDFs to transactions, read the
supplier, date, total, GST and line items with Tesseract OCR, and match
them to bank transactions by amount and date. Receipts can have several
pages, and hand corrections survive re-reading.

Suppliers: saved suppliers that uploads are linked to by GST number or
name.

The sections (cashbook, receipts, invoices, customers, suppliers,
mileage, statements) move to a top bar, with the book controls in a row
beneath it, and the layout works on phones.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-25 19:05:44 +13:00

134 lines
5.2 KiB
Python

import logging
import os
from contextlib import asynccontextmanager
from urllib.parse import urlparse
from fastapi import FastAPI, Request
from fastapi.responses import JSONResponse
from fastapi.staticfiles import StaticFiles
import ledger
from cashbook_app import config
from cashbook_app.db.models import Base
from cashbook_app.db.session import get_engine, get_session_factory
from cashbook_app.routers.attachments import router as attachments_router
from cashbook_app.routers.auth_routes import router as auth_router
from cashbook_app.routers.books import router as books_router
from cashbook_app.routers.frontend import router as frontend_router
from cashbook_app.routers.invoices import router as invoices_router
from cashbook_app.routers.mileage import router as mileage_router
from cashbook_app.routers.statements import router as statements_router
from cashbook_app.routers.suppliers import router as suppliers_router
from cashbook_app.routers.users_admin import router as users_router
from cashbook_app.services import accounts, spreadsheets
log = logging.getLogger("cashbook")
class _SkipHealthChecks(logging.Filter):
def filter(self, record: logging.LogRecord) -> bool:
return "/healthz" not in record.getMessage()
logging.getLogger("uvicorn.access").addFilter(_SkipHealthChecks())
SECURITY_HEADERS = {
"X-Content-Type-Options": "nosniff",
"X-Frame-Options": "DENY",
"Referrer-Policy": "no-referrer",
"Content-Security-Policy": "default-src 'self'; script-src 'self' 'unsafe-inline'; "
"style-src 'self' 'unsafe-inline'; img-src 'self' data:; frame-ancestors 'none'",
}
def _bootstrap_admin() -> None:
"""First run: create an admin from BOOTSTRAP_ADMIN_USERNAME/PASSWORD if there are no users."""
username = os.environ.get("BOOTSTRAP_ADMIN_USERNAME", "").strip()
password = os.environ.get("BOOTSTRAP_ADMIN_PASSWORD", "").strip()
if not (accounts.auth_enabled() and username and password):
return
db = get_session_factory()()
try:
if accounts.count_users(db) == 0:
accounts.create_user(db, username, password, is_superuser=True)
log.warning("Created administrator %r from BOOTSTRAP_ADMIN_USERNAME", username)
finally:
db.close()
def _migrate_spreadsheets() -> None:
"""Copy any .ods cashbooks left in the data folder into the database (once each)."""
if not any(f.endswith(".ods") and f != "template.ods" for f in os.listdir(config.data_dir())):
return
from migrate import migrate_folder
conn = ledger.connect(config.database_path())
try:
for message in migrate_folder(conn, str(config.data_dir()), spreadsheets.office().open):
log.warning(message)
finally:
conn.close()
@asynccontextmanager
async def lifespan(_app: FastAPI):
Base.metadata.create_all(bind=get_engine())
ledger.connect(config.database_path()).close() # create / upgrade the books tables
_bootstrap_admin()
_migrate_spreadsheets()
if not accounts.auth_enabled():
log.warning("AUTH_ENABLED=false: anyone who can reach this server can see and change the books")
yield
spreadsheets.stop()
def _same_origin(request: Request) -> bool:
"""Refuse state-changing requests made from other websites.
Compares the Origin's host name (ports differ behind Docker and proxies) with Host,
X-Forwarded-Host and CASHBOOK_ALLOWED_HOSTS.
"""
origin = request.headers.get("origin")
if not origin:
return True
host_of = lambda h: urlparse("//" + h.strip()).hostname
allowed = {"localhost", "127.0.0.1", "::1"} | config.allowed_hosts()
for h in [request.headers.get("host", "")] + request.headers.get("x-forwarded-host", "").split(","):
if h.strip():
allowed.add(host_of(h))
if urlparse(origin).hostname in allowed:
return True
log.warning("Refused %s %s: Origin %s is not one of %s; add it to CASHBOOK_ALLOWED_HOSTS if it's yours",
request.method, request.url.path, origin, sorted(allowed))
return False
def create_app() -> FastAPI:
app = FastAPI(title="Cashbook", lifespan=lifespan, docs_url=None, redoc_url=None)
@app.middleware("http")
async def security(request: Request, call_next):
if request.method not in ("GET", "HEAD", "OPTIONS") and not _same_origin(request):
return JSONResponse({"detail": "Refused: this page's address doesn't match the server's. "
"See the server log, or set CASHBOOK_ALLOWED_HOSTS."}, status_code=403)
response = await call_next(request)
for k, v in SECURITY_HEADERS.items():
response.headers.setdefault(k, v)
if request.url.path.startswith("/api/"):
response.headers.setdefault("Cache-Control", "no-store")
return response
app.mount("/static", StaticFiles(directory=str(config.STATIC_DIR)), name="static")
app.include_router(frontend_router)
app.include_router(auth_router)
app.include_router(users_router)
app.include_router(books_router)
app.include_router(statements_router)
app.include_router(attachments_router)
app.include_router(invoices_router)
app.include_router(mileage_router)
app.include_router(suppliers_router)
return app
app = create_app()