# adam-123456789/checkora architecture

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

- Interactive diagram: https://gitdiagram.com/adam-123456789/checkora
- Repository: https://github.com/adam-123456789/checkora

## Overview

Checkora is a compliance assistant that compares statutory rules with organizational evidence, surfaces gaps and risks, and supports remediation and reporting. The main workflow runs from document upload through backend analysis to an executive dashboard and gap detail; chat, visual evidence, and printable reporting are additional capabilities. Backend ingestion, retrieval, and evaluation are represented together because the sampled implementation is one RAG engine. Several frontend components and backend internals were not sampled, so only documented or directly visible relationships are drawn.

Main entry points: [`src/App.jsx`](https://github.com/adam-123456789/checkora/blob/main/src/App.jsx) (App workflow), [`src/components/AnalysisScreen.jsx`](https://github.com/adam-123456789/checkora/blob/main/src/components/AnalysisScreen.jsx) (Analysis progress), [`src/components/UploadPage.jsx`](https://github.com/adam-123456789/checkora/blob/main/src/components/UploadPage.jsx) (Document upload), [`backend/rag_engine.py`](https://github.com/adam-123456789/checkora/blob/main/backend/rag_engine.py) (RAG analysis engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_app["App workflow<br/>[App.jsx]"]
  node_upload["Document upload<br/>[UploadPage.jsx]"]
  node_analysis_screen["Analysis progress<br/>[AnalysisScreen.jsx]"]
  node_dashboard["Executive dashboard<br/>[Dashboard.jsx]"]
  node_gap_detail["Gap detail"]
  node_compliance_table["Requirements table"]
  node_chat["AI chat<br/>[AiChat.jsx]"]
  node_visual["Visual evidence<br/>[VisualEvidence.jsx]"]
  node_report["Executive report<br/>[ReportView.jsx]"]
  node_risk["Risk analysis view<br/>[RiskAnalysis.jsx]"]
end

subgraph group_analysis["Compliance analysis"]
  node_rag["RAG analysis engine<br/>[rag_engine.py]"]
end

subgraph group_content["Compliance content"]
  node_compliance_data["Demo compliance data<br/>[complianceData.js]"]
  node_localized["Localized requirements"]
  node_language["Language context"]
  node_translations["UI translations<br/>[translations.js]"]
end

subgraph group_platform["Backend services"]
  node_api["FastAPI service<br/>[main.py]"]
end

node_user(("Compliance user"))

node_user -->|"uploads evidence"| node_upload
node_upload -->|"starts analysis"| node_analysis_screen
node_analysis_screen -->|"posts documents"| node_api
node_api -->|"delegates analysis"| node_rag
node_rag -.->|"returns findings"| node_analysis_screen
node_analysis_screen -->|"completes analysis"| node_app
node_app -->|"renders results"| node_dashboard
node_app -->|"opens gap detail"| node_gap_detail
node_app -->|"renders requirements"| node_compliance_table
node_app -->|"renders chat"| node_chat
node_app -->|"renders scanner"| node_visual
node_app -->|"renders report"| node_report
node_app -.->|"renders risk view"| node_risk
node_app -->|"loads localized data"| node_localized
node_app -->|"loads demo data"| node_compliance_data
node_language -->|"reads translations"| node_translations
node_user -->|"asks questions"| node_chat
node_user -->|"submits photos"| node_visual
node_user -->|"prints report"| node_report

click node_app "https://github.com/adam-123456789/checkora/blob/main/src/App.jsx"
click node_upload "https://github.com/adam-123456789/checkora/blob/main/src/components/UploadPage.jsx"
click node_analysis_screen "https://github.com/adam-123456789/checkora/blob/main/src/components/AnalysisScreen.jsx"
click node_dashboard "https://github.com/adam-123456789/checkora/blob/main/src/components/Dashboard.jsx"
click node_gap_detail "https://github.com/adam-123456789/checkora/blob/main/src/components/GapAnalysisModal.jsx"
click node_compliance_table "https://github.com/adam-123456789/checkora/blob/main/src/components/ComplianceTable.jsx"
click node_chat "https://github.com/adam-123456789/checkora/blob/main/src/components/AiChat.jsx"
click node_visual "https://github.com/adam-123456789/checkora/blob/main/src/components/VisualEvidence.jsx"
click node_report "https://github.com/adam-123456789/checkora/blob/main/src/components/ReportView.jsx"
click node_risk "https://github.com/adam-123456789/checkora/blob/main/src/components/RiskAnalysis.jsx"
click node_api "https://github.com/adam-123456789/checkora/blob/main/backend/main.py"
click node_rag "https://github.com/adam-123456789/checkora/blob/main/backend/rag_engine.py"
click node_compliance_data "https://github.com/adam-123456789/checkora/blob/main/src/data/complianceData.js"
click node_localized "https://github.com/adam-123456789/checkora/blob/main/src/data/localizedRequirements.js"
click node_language "https://github.com/adam-123456789/checkora/blob/main/src/context/LanguageContext.jsx"
click node_translations "https://github.com/adam-123456789/checkora/blob/main/src/data/translations.js"

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_app,node_upload,node_analysis_screen,node_dashboard,node_gap_detail,node_compliance_table,node_chat,node_visual,node_report,node_risk,node_user toneBlue
class node_rag toneAmber
class node_compliance_data,node_localized,node_language,node_translations toneMint
class node_api toneRose
```

## Components

### User experience

- [App workflow](https://github.com/adam-123456789/checkora/blob/main/src/App.jsx): `src/App.jsx`
- [Document upload](https://github.com/adam-123456789/checkora/blob/main/src/components/UploadPage.jsx): `src/components/UploadPage.jsx`
- [Analysis progress](https://github.com/adam-123456789/checkora/blob/main/src/components/AnalysisScreen.jsx): `src/components/AnalysisScreen.jsx`
- [Executive dashboard](https://github.com/adam-123456789/checkora/blob/main/src/components/Dashboard.jsx): `src/components/Dashboard.jsx`
- [Gap detail](https://github.com/adam-123456789/checkora/blob/main/src/components/GapAnalysisModal.jsx): `src/components/GapAnalysisModal.jsx`
- [Requirements table](https://github.com/adam-123456789/checkora/blob/main/src/components/ComplianceTable.jsx): `src/components/ComplianceTable.jsx`
- [AI chat](https://github.com/adam-123456789/checkora/blob/main/src/components/AiChat.jsx): `src/components/AiChat.jsx`
- [Visual evidence](https://github.com/adam-123456789/checkora/blob/main/src/components/VisualEvidence.jsx): `src/components/VisualEvidence.jsx`
- [Executive report](https://github.com/adam-123456789/checkora/blob/main/src/components/ReportView.jsx): `src/components/ReportView.jsx`
- [Risk analysis view](https://github.com/adam-123456789/checkora/blob/main/src/components/RiskAnalysis.jsx): `src/components/RiskAnalysis.jsx`

### Compliance analysis

- [RAG analysis engine](https://github.com/adam-123456789/checkora/blob/main/backend/rag_engine.py): `backend/rag_engine.py`

### Compliance content

- [Demo compliance data](https://github.com/adam-123456789/checkora/blob/main/src/data/complianceData.js): `src/data/complianceData.js`
- [Localized requirements](https://github.com/adam-123456789/checkora/blob/main/src/data/localizedRequirements.js): `src/data/localizedRequirements.js`
- [Language context](https://github.com/adam-123456789/checkora/blob/main/src/context/LanguageContext.jsx): `src/context/LanguageContext.jsx`
- [UI translations](https://github.com/adam-123456789/checkora/blob/main/src/data/translations.js): `src/data/translations.js`

### Backend services

- [FastAPI service](https://github.com/adam-123456789/checkora/blob/main/backend/main.py): `backend/main.py`

### Other components

- **Compliance user**

## Connections

- Compliance user → Document upload: uploads evidence (evidence: `README.md`)
- Document upload → Analysis progress: starts analysis (evidence: `README.md`)
- Analysis progress → FastAPI service: posts documents (evidence: `src/components/AnalysisScreen.jsx`)
- FastAPI service → RAG analysis engine: delegates analysis (evidence: `backend/main.py`)
- RAG analysis engine → Analysis progress: returns findings
- Analysis progress → App workflow: completes analysis (evidence: `src/App.jsx`)
- App workflow → Executive dashboard: renders results (evidence: `src/App.jsx`)
- App workflow → Gap detail: opens gap detail (evidence: `src/App.jsx`)
- App workflow → Requirements table: renders requirements (evidence: `src/App.jsx`)
- App workflow → AI chat: renders chat (evidence: `src/App.jsx`)
- App workflow → Visual evidence: renders scanner (evidence: `src/App.jsx`)
- App workflow → Executive report: renders report (evidence: `src/App.jsx`)
- App workflow → Risk analysis view: renders risk view
- App workflow → Localized requirements: loads localized data (evidence: `src/App.jsx`)
- App workflow → Demo compliance data: loads demo data (evidence: `src/App.jsx`)
- Language context → UI translations: reads translations (evidence: `src/context/LanguageContext.jsx`)
- Compliance user → AI chat: asks questions (evidence: `README.md`)
- Compliance user → Visual evidence: submits photos (evidence: `README.md`)
- Compliance user → Executive report: prints report (evidence: `README.md`)
