How mjangra356/clearview-backend works
ClearView is a FastAPI service for live UK company fraud and AML compliance assessments. A user searches Companies House or requests a company assessment; the API fetches and normalizes company, officer, appointment, and PSC data, then produces statutory checks, risk scoring, ownership views, and an executive summary for the UI. The main internal layers are the Companies House client, dossier aggregator, compliance rules, and response projections. The README is empty; links reflect the shown excerpts and source index, so unsampled subsystem details are not inferred.
Main entry points: routes.py Company Routes · ch_client.py Companies House Client · aggregator.py Dossier Aggregator · llm_service.py Summary Generator
Components 15
API
- FastAPI App
app/main.py - Company Routes
app/api/routes.py - Service Settings
app/core/config.py
Company Data
- Companies House Client
app/services/ch_client.py - API Schemas
app/models/raw_companies_house.py - Dossier Aggregator
app/services/aggregator.py - Company Dossier
app/models/domain.py
Risk Assessment
- Risk Reference Data
app/core/reference_data.py - Compliance Rules
app/services/rules_engine.py - Ownership Analysis
app/services/ownership_builder.py - Summary Generator
app/services/llm_service.py
Investigation Output
- UI Response Models
app/models/dto.py
Other components
- Analyst
- Companies House
- LLM Providers
Connections 26
- Analyst → FastAPI App: requests assessment
app/main.py - FastAPI App → Company Routes: mounts routes
app/main.py - FastAPI App → Service Settings: loads settings
app/main.py - FastAPI App → Companies House Client: closes client
app/main.py - Company Routes → Companies House Client: searches companies
app/api/routes.py - Company Routes → Dossier Aggregator: builds dossier
app/api/routes.py - Company Routes → Compliance Rules: evaluates risk
app/api/routes.py - Company Routes → Ownership Analysis: builds ownership views
app/api/routes.py - Company Routes → Summary Generator: generates summary
app/api/routes.py - Company Routes → UI Response Models: returns UI payload
app/api/routes.py - Companies House Client → Companies House: fetches company data
app/services/ch_client.py - Companies House Client → Service Settings: reads API settings
app/services/ch_client.py - Companies House Client → API Schemas: returns API schemas
app/services/ch_client.py - Dossier Aggregator → Companies House Client: fetches company records
app/services/aggregator.py - Dossier Aggregator → API Schemas: normalizes API data
app/services/aggregator.py - Dossier Aggregator → Risk Reference Data: uses risk classifications
app/services/aggregator.py - Dossier Aggregator → Company Dossier: builds dossier
app/services/aggregator.py - Compliance Rules → Company Dossier: evaluates dossier
app/services/rules_engine.py - Compliance Rules → Risk Reference Data: uses rule indicators
app/services/rules_engine.py - Compliance Rules → UI Response Models: produces findings
app/services/rules_engine.py - Ownership Analysis → Company Dossier: projects ownership
app/services/ownership_builder.py - Ownership Analysis → UI Response Models: builds ownership DTOs
app/services/ownership_builder.py - Summary Generator → Company Dossier: summarizes dossier
app/services/llm_service.py - Summary Generator → UI Response Models: uses risk flags
app/services/llm_service.py - Summary Generator → Service Settings: reads provider keys
app/services/llm_service.py - Summary Generator → LLM Providers: requests generated text
app/services/llm_service.py