Who it’s for
Fintech Risk Monitor is built for developers and fintech teams who need a self-hosted tool to maintain a business registry and produce risk scores based on industry and country exposure. It is intentionally lightweight: no external services, no infrastructure beyond a single container, and no JavaScript build step.Key capabilities
- Business registry — create and manage a list of businesses with name, industry, and country. On first launch, 50 sample businesses are seeded automatically.
- Risk evaluation engine — run on-demand evaluations that return a score from 0–100 and a risk level of low, medium, high, or critical.
- Filtering and sorting — filter the business list by name, industry, country, or date range. Sort by any column, including latest risk score.
- In-browser test runner — navigate to
/testto execute the full pytest suite and view results without leaving the browser.
Tech stack
| Technology | Role |
|---|---|
| FastAPI | Async-capable Python web framework. Handles routing, request validation via Pydantic, and serves the built-in OpenAPI docs at /docs. |
| HTMX | Adds interactivity to HTML via attributes. Filtering, sorting, and partial page updates happen without a JavaScript framework or build step. |
| SQLite + SQLAlchemy | Embedded zero-configuration database with an ORM layer. No separate database server is required. |
| Jinja2 | Server-side HTML templating. Pairs with HTMX’s partial-swap model so routes can return full pages or HTML fragments from the same templates. |
| Docker | Single-container deployment. The included Dockerfile runs the app with uvicorn on port 8000. |
The risk engine is simulated. Scores are derived from a random base value (10–70) combined with deterministic industry and country modifiers, plus a small noise factor (±5). This produces realistic variation and is statistically testable, but it is not a real compliance or AML tool. Do not use it for actual risk decisions.
Explore the docs
Quick start
Get the app running with Docker or local Python in under five minutes.
Businesses
Add, search, and manage businesses in the registry.
Risk evaluation
Understand how scores are calculated and what risk levels mean.
API reference
Explore every endpoint with parameters and response shapes.