Quick Start
Get the app running in minutes with Docker or local Python
Businesses
Add, search, and manage your business registry
Risk Evaluation
Understand how risk scores are calculated and what they mean
API Reference
Explore every endpoint with parameters and response shapes
How it works
Start the application
Run the app with Docker or uvicorn. It seeds 50 sample businesses automatically on first launch.
Browse the business registry
Open your browser to
http://localhost:8000. You’ll see a paginated list of businesses you can filter by name, industry, country, and date range.Run a risk evaluation
Click any business and hit Evaluate Risk. The engine calculates a score from 0–100 based on industry and country modifiers, returning a risk level of low, medium, high, or critical.
Key capabilities
Filtering & sorting
Filter by name, industry, country, or date range. Sort by any column including latest risk score.
Architecture overview
FastAPI + HTMX + SQLite — how the pieces fit together
Risk engine
How scores are computed with industry and country modifiers
Testing
Run the full pytest suite in-browser at
/test or from the CLI