Skip to main content
The business registry is the central list of companies you track for risk purposes. Each entry stores identifying details — name, industry, and country — and links to every risk evaluation run against that business.

Business fields

FieldTypeRequiredDescription
namestringYesCompany name. Maximum 255 characters.
industrystringNoSector the business operates in (e.g. crypto, banking).
countrystringNoCountry of operation (e.g. USA, Germany).
created_atdatetimeNoTimestamp set automatically when the business is created.
name is the only required field. It must be non-empty and no longer than 255 characters. Submitting a blank name or one that exceeds the limit returns a 422 validation error.

Adding a business

The form at the top of the businesses list lets you register a new company immediately.
1

Open the businesses list

Navigate to http://localhost:8000/businesses. The add-business form appears at the top of the page.
2

Fill in the form

Enter the company Name (required). Optionally add an Industry and Country. Both optional fields can be left blank.
3

Submit

Click Add Business. HTMX submits the form and refreshes the table in place — no full page reload. The new business appears at the top of the list, sorted by most recently created.

Viewing a business

Click any business name in the list to open its detail page at /businesses/{id}. The detail page shows:

Latest risk score

The numeric score (0–100) from the most recent evaluation, along with its risk level: low, medium, high, or critical.

Factor breakdown

The individual components that produced the score: base_score, industry_modifier, country_modifier, noise, and final_score.

Evaluate Risk button

Triggers a new risk evaluation immediately. The result updates the page without a full reload.

Risk History link

Opens the full evaluation history for the business, showing every score ever recorded.
If no evaluation has been run yet, the score and factor breakdown are not shown until you click Evaluate Risk.

Pagination

The businesses list shows 15 businesses per page. Use the pagination controls at the bottom of the table to move between pages. Any active filters apply across all pages.

Seeded data

On first launch the app automatically loads 50 sample businesses covering a range of industries and countries. Each sample business starts with three pre-run evaluations, so risk scores and history are available immediately without any manual setup.
The seed data includes deliberately high-risk entries — such as businesses in sanctioned countries or high-risk industries — so you can see the full range of risk levels straight away.

Build docs developers (and LLMs) love