bank-statement-api / api_server.py
pratik-befree's picture
practices added for the classification
c58f0d0
Raw History Blame Contribute Delete
5.62 kB
"""
BeFree REST API Backend
Bridges the frontend with bank-extractor and bank-hitl packages.
Implements the API contract defined in web/API_CONTRACT.md
"""
import os
import logging
from dotenv import load_dotenv
# ===== Load Environment Variables =====
load_dotenv()
from contextlib import asynccontextmanager
from fastapi import FastAPI, Request
from fastapi.middleware.cors import CORSMiddleware
# Auth database imports
from auth.database import engine, Base
import auth.rule_models
from core.state import _uploads_dir, _output_dir, discover_and_load_statements
# Loggers
logger = logging.getLogger("befree")
# ===== Lifespan =====
@asynccontextmanager
async def lifespan(app: FastAPI):
# Startup
print("BeFree API Server starting...")
# Auto-create auth DB tables (safe to run every startup — no-op if tables exist)
Base.metadata.create_all(bind=engine)
logger.info("Auth database tables created/verified")
_uploads_dir().mkdir(parents=True, exist_ok=True)
_output_dir().mkdir(parents=True, exist_ok=True)
# Run dynamic recovery search to repopulate the in-memory cache
try:
discover_and_load_statements()
logger.info("Initial statement discovery sweep complete")
except Exception as e:
logger.error(f"Error during initial statement discovery: {e}")
# Initialise Overwatch store (creates DB file, WAL, tables, starts cleanup thread)
try:
from overwatch.store import get_store as _get_overwatch_store
_get_overwatch_store()
logger.info("Overwatch store initialised")
except Exception as _ow_err:
logger.warning("Overwatch store init failed (non-fatal): %s", _ow_err)
yield
# Shutdown
print("BeFree API Server shutting down...")
# ===== Create FastAPI App =====
_is_production = os.environ.get("ENVIRONMENT", "development") == "production"
app = FastAPI(
title="BeFree Bank Statement Processor API",
description="REST API for bank statement extraction and review",
version="1.0.0",
lifespan=lifespan,
docs_url=None if _is_production else "/docs",
redoc_url=None if _is_production else "/redoc",
)
# CORS
_cors_origins_env = os.environ.get("CORS_ORIGINS", "")
_cors_origins = [o.strip() for o in _cors_origins_env.split(",") if o.strip()] if _cors_origins_env else ["*"]
app.add_middleware(
CORSMiddleware,
allow_origins=_cors_origins,
allow_credentials=True,
allow_methods=["*"],
allow_headers=["*"],
)
# ===== Middlewares =====
from core.middleware import add_request_id_handler, audit_logging_handler, global_exception_handler_fn
@app.middleware("http")
async def add_request_id(request: Request, call_next):
return await add_request_id_handler(request, call_next)
@app.middleware("http")
async def audit_logging_middleware(request: Request, call_next):
return await audit_logging_handler(request, call_next)
@app.exception_handler(Exception)
async def global_exception_handler(request: Request, exc: Exception):
return await global_exception_handler_fn(request, exc)
# ===== Mount Routers =====
# 1. Overwatch Router
from overwatch.router import router as overwatch_router
app.include_router(overwatch_router)
# 2. Auth Router
from routers.auth import router as auth_router
app.include_router(auth_router)
# 3. Settings Router
from routers.settings_router import router as settings_router
app.include_router(settings_router)
# 4. PDF Router
from routers.pdf import router as pdf_router
app.include_router(pdf_router)
# 5. History Router
from routers.history import router as history_router
app.include_router(history_router)
# 6. Flagged Router
from routers.flagged import router as flagged_router
app.include_router(flagged_router)
# 7. Dashboard Router
from routers.dashboard import router as dashboard_router
app.include_router(dashboard_router)
# 8. Upload Router
from routers.upload import router as upload_router
app.include_router(upload_router)
# 9. Layout Router
from routers.layout import router as layout_router
app.include_router(layout_router)
# 10. Processing Router
from routers.processing import router as processing_router
app.include_router(processing_router)
# 11. Classification Router
from routers.classification import router as classification_router
app.include_router(classification_router)
# 12. Review Router
from routers.review import router as review_router
app.include_router(review_router)
# 13. Transactions Router
from routers.transactions import router as transactions_router
app.include_router(transactions_router)
# 14. Export Router
from routers.export import router as export_router
app.include_router(export_router)
# 15. Admin Router
from routers.admin import router as admin_router
app.include_router(admin_router)
# 16. Admin Rules Router
from routers.admin_rules import router as admin_rules_router
app.include_router(admin_rules_router)
# 17. Rule Requests Router
from routers.rule_requests import router as rule_requests_router
app.include_router(rule_requests_router)
# 18. Practices Router
from routers.practices import router as practices_router
app.include_router(practices_router)
# ===== Health & Info =====
@app.get("/health")
async def health():
"""Health check."""
return {"status": "ok"}
@app.get("/")
async def root():
"""API info."""
return {
"name": "BeFree Bank Statement Processor API",
"version": "1.0.0",
"docs": "/docs" if not _is_production else None,
"health": "/health",
}
if __name__ == "__main__":
import uvicorn
uvicorn.run(app, host="0.0.0.0", port=8000)