# omi1739/codemri architecture

> Architecture diagram of the GitHub repository omi1739/codemri, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/omi1739/codemri
- Repository: https://github.com/omi1739/codemri

## Overview

CodeMRI scans public GitHub repositories and presents health findings, scores, recommendations, and scan history. The backend accepts scans, fetches repository contents, runs specialized analyzers, scores findings, and exposes scan results; the web tree contains submission, progress, history, and report views. The excerpts establish backend orchestration and persistence links, but do not show the web client’s HTTP calls or all analyzer internals, so those connections are omitted where unverified.

Main entry points: [`services/analyzer/app/worker.py`](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/worker.py) (Scan worker), [`services/analyzer/app/analyzers/base.py`](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/base.py) (Analyzer contracts), [`services/analyzer/app/api/scans.py`](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/api/scans.py) (Scan routes), [`services/analyzer/app/main.py`](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/main.py) (FastAPI application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_scan_page["Scan page<br/>[page.tsx]"]
  node_scan_form["Scan form<br/>[scan-form.tsx]"]
  node_progress_page["Scan status page<br/>[page.tsx]"]
  node_progress_view["Progress view<br/>[scan-progress.tsx]"]
  node_history_page["History page<br/>[page.tsx]"]
  node_history_view["History view<br/>[history-view.tsx]"]
  node_report_page["Report page<br/>[page.tsx]"]
  node_report_view["Report view<br/>[report-view.tsx]"]
  node_web_api["Web API client<br/>[api.ts]"]
end

subgraph group_api["Scan API"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_scan_routes["Scan routes<br/>[scans.py]"]
  node_scan_worker["Scan worker<br/>[worker.py]"]
  node_github_client["GitHub client<br/>[client.py]"]
end

subgraph group_analysis["Analysis and scoring"]
  node_fingerprint["Fingerprint analysis<br/>[analyzer.py]"]
  node_dependencies["Dependency analysis<br/>[analyzer.py]"]
  node_security["Security analysis<br/>[analyzer.py]"]
  node_quality["Quality analysis<br/>[analyzer.py]"]
  node_testing["Testing analysis<br/>[analyzer.py]"]
  node_architecture["Architecture analysis<br/>[analyzer.py]"]
  node_deployment["Deployment analysis<br/>[analyzer.py]"]
  node_git_hygiene["Git hygiene analysis<br/>[analyzer.py]"]
  node_analyzer_base["Analyzer contracts<br/>[base.py]"]
  node_shared_analysis["Analysis helpers<br/>[_shared.py]"]
  node_scoring["Scoring engine<br/>[engine.py]"]
  node_evidence["Evidence normalization<br/>[normalize.py]"]
end

subgraph group_storage["Persistence"]
  node_scan_db[("Scan database<br/>[models.py]")]
  node_db_session["Database sessions<br/>[session.py]"]
end

subgraph group_runtime["Shared runtime"]
  node_config["Configuration<br/>[config.py]"]
  node_logging["Structured logging<br/>[logging.py]"]
end

node_user(("Repository owner"))

node_api_app -->|"registers routes"| node_scan_routes
node_api_app -->|"initializes database"| node_db_session
node_api_app -->|"configures logging"| node_logging
node_scan_routes -->|"schedules scans"| node_scan_worker
node_scan_routes -->|"loads repository metadata"| node_github_client
node_scan_routes -->|"computes comparisons"| node_scoring
node_scan_routes -->|"reads and writes"| node_scan_db
node_scan_worker -->|"resolves commit"| node_github_client
node_scan_worker -->|"runs analyzer"| node_fingerprint
node_scan_worker -->|"runs analyzer"| node_dependencies
node_scan_worker -->|"runs analyzer"| node_security
node_scan_worker -->|"runs analyzer"| node_quality
node_scan_worker -->|"runs analyzer"| node_testing
node_scan_worker -->|"runs analyzer"| node_architecture
node_scan_worker -->|"runs analyzer"| node_deployment
node_scan_worker -->|"runs analyzer"| node_git_hygiene
node_scan_worker -->|"computes scores"| node_scoring
node_scan_worker -->|"normalizes findings"| node_evidence
node_scan_worker -->|"persists scan results"| node_scan_db
node_scan_worker -->|"opens session"| node_db_session
node_fingerprint -->|"implements contract"| node_analyzer_base
node_dependencies -->|"implements contract"| node_analyzer_base
node_security -->|"implements contract"| node_analyzer_base
node_quality -->|"implements contract"| node_analyzer_base
node_testing -->|"implements contract"| node_analyzer_base
node_architecture -->|"implements contract"| node_analyzer_base
node_deployment -->|"implements contract"| node_analyzer_base
node_git_hygiene -->|"implements contract"| node_analyzer_base
node_architecture -->|"uses helpers"| node_shared_analysis
node_quality -->|"uses helpers"| node_shared_analysis
node_security -->|"uses helpers"| node_shared_analysis
node_db_session -->|"creates schema"| node_scan_db
node_db_session -->|"reads database settings"| node_config
node_api_app --> node_user

click node_scan_page "https://github.com/omi1739/codemri/blob/main/apps/web/app/page.tsx"
click node_scan_form "https://github.com/omi1739/codemri/blob/main/apps/web/app/components/scan-form.tsx"
click node_progress_page "https://github.com/omi1739/codemri/blob/main/apps/web/app/scans/%5Bid%5D/page.tsx"
click node_progress_view "https://github.com/omi1739/codemri/blob/main/apps/web/app/components/scan-progress.tsx"
click node_history_page "https://github.com/omi1739/codemri/blob/main/apps/web/app/history/page.tsx"
click node_history_view "https://github.com/omi1739/codemri/blob/main/apps/web/app/components/history-view.tsx"
click node_report_page "https://github.com/omi1739/codemri/blob/main/apps/web/app/scans/%5Bid%5D/report/page.tsx"
click node_report_view "https://github.com/omi1739/codemri/blob/main/apps/web/app/components/report-view.tsx"
click node_web_api "https://github.com/omi1739/codemri/blob/main/apps/web/app/lib/api.ts"
click node_api_app "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/main.py"
click node_scan_routes "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/api/scans.py"
click node_scan_worker "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/worker.py"
click node_github_client "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/github/client.py"
click node_fingerprint "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/fingerprint/analyzer.py"
click node_dependencies "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/dependencies/analyzer.py"
click node_security "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/security/analyzer.py"
click node_quality "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/quality/analyzer.py"
click node_testing "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/testing/analyzer.py"
click node_architecture "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/architecture/analyzer.py"
click node_deployment "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/deployment/analyzer.py"
click node_git_hygiene "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/git_hygiene/analyzer.py"
click node_analyzer_base "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/base.py"
click node_shared_analysis "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/_shared.py"
click node_scoring "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/scoring/engine.py"
click node_evidence "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/evidence/normalize.py"
click node_scan_db "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/db/models.py"
click node_db_session "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/db/session.py"
click node_config "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/core/config.py"
click node_logging "https://github.com/omi1739/codemri/blob/main/services/analyzer/app/core/logging.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_scan_page,node_scan_form,node_progress_page,node_progress_view,node_history_page,node_history_view,node_report_page,node_report_view,node_web_api toneBlue
class node_api_app,node_scan_routes,node_scan_worker,node_github_client toneAmber
class node_fingerprint,node_dependencies,node_security,node_quality,node_testing,node_architecture,node_deployment,node_git_hygiene,node_analyzer_base,node_shared_analysis,node_scoring,node_evidence toneMint
class node_scan_db,node_db_session toneRose
class node_config,node_logging,node_user toneIndigo
```

## Components

### Web interface

- [Scan page](https://github.com/omi1739/codemri/blob/main/apps/web/app/page.tsx): `apps/web/app/page.tsx`
- [Scan form](https://github.com/omi1739/codemri/blob/main/apps/web/app/components/scan-form.tsx): `apps/web/app/components/scan-form.tsx`
- [Scan status page](https://github.com/omi1739/codemri/blob/main/apps/web/app/scans/%5Bid%5D/page.tsx): `apps/web/app/scans/[id]/page.tsx`
- [Progress view](https://github.com/omi1739/codemri/blob/main/apps/web/app/components/scan-progress.tsx): `apps/web/app/components/scan-progress.tsx`
- [History page](https://github.com/omi1739/codemri/blob/main/apps/web/app/history/page.tsx): `apps/web/app/history/page.tsx`
- [History view](https://github.com/omi1739/codemri/blob/main/apps/web/app/components/history-view.tsx): `apps/web/app/components/history-view.tsx`
- [Report page](https://github.com/omi1739/codemri/blob/main/apps/web/app/scans/%5Bid%5D/report/page.tsx): `apps/web/app/scans/[id]/report/page.tsx`
- [Report view](https://github.com/omi1739/codemri/blob/main/apps/web/app/components/report-view.tsx): `apps/web/app/components/report-view.tsx`
- [Web API client](https://github.com/omi1739/codemri/blob/main/apps/web/app/lib/api.ts): `apps/web/app/lib/api.ts`

### Scan API

- [FastAPI application](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/main.py): `services/analyzer/app/main.py`
- [Scan routes](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/api/scans.py): `services/analyzer/app/api/scans.py`
- [Scan worker](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/worker.py): `services/analyzer/app/worker.py`
- [GitHub client](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/github/client.py): `services/analyzer/app/github/client.py`

### Analysis and scoring

- [Fingerprint analysis](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/fingerprint/analyzer.py): `services/analyzer/app/analyzers/fingerprint/analyzer.py`
- [Dependency analysis](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/dependencies/analyzer.py): `services/analyzer/app/analyzers/dependencies/analyzer.py`
- [Security analysis](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/security/analyzer.py): `services/analyzer/app/analyzers/security/analyzer.py`
- [Quality analysis](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/quality/analyzer.py): `services/analyzer/app/analyzers/quality/analyzer.py`
- [Testing analysis](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/testing/analyzer.py): `services/analyzer/app/analyzers/testing/analyzer.py`
- [Architecture analysis](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/architecture/analyzer.py): `services/analyzer/app/analyzers/architecture/analyzer.py`
- [Deployment analysis](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/deployment/analyzer.py): `services/analyzer/app/analyzers/deployment/analyzer.py`
- [Git hygiene analysis](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/git_hygiene/analyzer.py): `services/analyzer/app/analyzers/git_hygiene/analyzer.py`
- [Analyzer contracts](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/base.py): `services/analyzer/app/analyzers/base.py`
- [Analysis helpers](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/analyzers/_shared.py): `services/analyzer/app/analyzers/_shared.py`
- [Scoring engine](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/scoring/engine.py): `services/analyzer/app/scoring/engine.py`
- [Evidence normalization](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/evidence/normalize.py): `services/analyzer/app/evidence/normalize.py`

### Persistence

- [Scan database](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/db/models.py): `services/analyzer/app/db/models.py`
- [Database sessions](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/db/session.py): `services/analyzer/app/db/session.py`

### Shared runtime

- [Configuration](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/core/config.py): `services/analyzer/app/core/config.py`
- [Structured logging](https://github.com/omi1739/codemri/blob/main/services/analyzer/app/core/logging.py): `services/analyzer/app/core/logging.py`

### Other components

- **Repository owner**

## Connections

- FastAPI application → Scan routes: registers routes (evidence: `services/analyzer/app/main.py`)
- FastAPI application → Database sessions: initializes database (evidence: `services/analyzer/app/main.py`)
- FastAPI application → Structured logging: configures logging (evidence: `services/analyzer/app/main.py`)
- Scan routes → Scan worker: schedules scans (evidence: `services/analyzer/app/api/scans.py`)
- Scan routes → GitHub client: loads repository metadata (evidence: `services/analyzer/app/api/scans.py`)
- Scan routes → Scoring engine: computes comparisons (evidence: `services/analyzer/app/api/scans.py`)
- Scan routes → Scan database: reads and writes (evidence: `services/analyzer/app/api/scans.py`)
- Scan worker → GitHub client: resolves commit (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Fingerprint analysis: runs analyzer (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Dependency analysis: runs analyzer (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Security analysis: runs analyzer (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Quality analysis: runs analyzer (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Testing analysis: runs analyzer (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Architecture analysis: runs analyzer (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Deployment analysis: runs analyzer (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Git hygiene analysis: runs analyzer (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Scoring engine: computes scores (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Evidence normalization: normalizes findings (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Scan database: persists scan results (evidence: `services/analyzer/app/worker.py`)
- Scan worker → Database sessions: opens session (evidence: `services/analyzer/app/worker.py`)
- Fingerprint analysis → Analyzer contracts: implements contract (evidence: `services/analyzer/app/analyzers/fingerprint/analyzer.py`)
- Dependency analysis → Analyzer contracts: implements contract (evidence: `services/analyzer/app/analyzers/dependencies/analyzer.py`)
- Security analysis → Analyzer contracts: implements contract (evidence: `services/analyzer/app/analyzers/security/analyzer.py`)
- Quality analysis → Analyzer contracts: implements contract (evidence: `services/analyzer/app/analyzers/quality/analyzer.py`)
- Testing analysis → Analyzer contracts: implements contract (evidence: `services/analyzer/app/analyzers/testing/analyzer.py`)
- Architecture analysis → Analyzer contracts: implements contract (evidence: `services/analyzer/app/analyzers/architecture/analyzer.py`)
- Deployment analysis → Analyzer contracts: implements contract (evidence: `services/analyzer/app/analyzers/deployment/analyzer.py`)
- Git hygiene analysis → Analyzer contracts: implements contract (evidence: `services/analyzer/app/analyzers/git_hygiene/analyzer.py`)
- Architecture analysis → Analysis helpers: uses helpers (evidence: `services/analyzer/app/analyzers/architecture/analyzer.py`)
- Quality analysis → Analysis helpers: uses helpers (evidence: `services/analyzer/app/analyzers/quality/analyzer.py`)
- Security analysis → Analysis helpers: uses helpers (evidence: `services/analyzer/app/analyzers/security/analyzer.py`)
- Database sessions → Scan database: creates schema (evidence: `services/analyzer/app/db/session.py`)
- Database sessions → Configuration: reads database settings (evidence: `services/analyzer/app/db/session.py`)
- FastAPI application → Repository owner
