Spaces:
Sleeping
Sleeping
Download api_server.py from Coeinterns/bank-statement-api: direct link, hf CLI and curl.
- Browser
- Download file 5.62 kB
-
https://huggingface.co/spaces/Coeinterns/bank-statement-api/resolve/main/api_server.py
- Command line
-
hf download hf://spaces/Coeinterns/bank-statement-api/api_server.py
-
curl -L -o api_server.py https://huggingface.co/spaces/Coeinterns/bank-statement-api/resolve/main/api_server.py
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 ===== | |
| 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 | |
| async def add_request_id(request: Request, call_next): | |
| return await add_request_id_handler(request, call_next) | |
| async def audit_logging_middleware(request: Request, call_next): | |
| return await audit_logging_handler(request, call_next) | |
| 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 ===== | |
| async def health(): | |
| """Health check.""" | |
| return {"status": "ok"} | |
| 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) | |