# ayushranjan-17/skinscan-ai architecture

> Architecture diagram of the GitHub repository ayushranjan-17/skinscan-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ayushranjan-17/skinscan-ai
- Repository: https://github.com/ayushranjan-17/skinscan-ai

## Overview

SkinScan.AI is a point-of-care dermatology triage and explainable-AI application, not an autonomous diagnostic system. A clinician supplies a lesion image and patient context through the web app; the app requests backend analysis, which preprocesses the image, runs multimodal inference, and returns risk stratification and visual explanations. The interface presents findings and supports reports, scan history, and biopsy feedback. Training and evaluation are a separate supporting capability. Edges reflect sampled imports/calls or README workflow statements; unsampled details are not inferred.

Main entry points: [`src/App.jsx`](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/App.jsx) (Scan Workflow), [`src/utils/api.js`](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/utils/api.js) (Backend Client), [`backend/app.py`](https://github.com/ayushranjan-17/skinscan-ai/blob/main/backend/app.py) (Analysis API), [`backend/inference.py`](https://github.com/ayushranjan-17/skinscan-ai/blob/main/backend/inference.py) (Inference Engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Clinician Web App"]
  node_app["Scan Workflow<br/>[App.jsx]"]
  node_workbench["Image &amp; Context"]
  node_api["Backend Client<br/>[api.js]"]
  node_fallback["Demo Processing<br/>[imageProcessing.js]"]
  node_benchmarks["Demo Cases<br/>[benchmarks.js]"]
  node_onboarding["Guided Onboarding"]
end

subgraph group_service["Inference Service"]
  node_serviceapi["Analysis API<br/>[app.py]"]
  node_inference["Inference Engine<br/>[inference.py]"]
  node_preprocess["Image Preprocessing<br/>[dullrazor.py]"]
  node_database[("Accounts &amp; Scans<br/>[database.py]")]
end

subgraph group_clinical["Clinical Decision Support"]
  node_risk["Risk Stratification"]
  node_riskui["Risk Summary<br/>[RiskGaugeCard.jsx]"]
  node_verification["Verification Workflow"]
  node_explain["Visual Explanation"]
  node_abcd["ABCD Analysis"]
  node_report["Clinical Report"]
  node_history["Scan History"]
  node_feedback["Biopsy Feedback"]
  node_metricsui["Research Metrics"]
end

subgraph group_ml["Model Development"]
  node_training["Hybrid Model Training"]
  node_evaluation["Model Evaluation"]
  node_holdout["Holdout Preparation<br/>[holdout_common.py]"]
end

node_clinician(("Clinician"))

node_clinician -->|"starts scan"| node_app
node_app -->|"collects input"| node_workbench
node_app -->|"requests analysis"| node_api
node_app -->|"uses demo fallback"| node_fallback
node_workbench -->|"offers demo cases"| node_benchmarks
node_api -->|"calls analysis API"| node_serviceapi
node_serviceapi -->|"runs inference"| node_inference
node_serviceapi -->|"persists scans"| node_database
node_inference -->|"preprocesses image"| node_preprocess
node_inference -->|"stratifies risk"| node_risk
node_app -->|"renders findings"| node_riskui
node_app -->|"renders workflow"| node_verification
node_app -->|"renders explanation"| node_explain
node_app -->|"renders analysis"| node_abcd
node_app -->|"offers report"| node_report
node_app -->|"offers history"| node_history
node_app -->|"offers feedback"| node_feedback
node_api -.->|"retrieves history"| node_database
node_onboarding -.->|"guides use"| node_clinician
node_metricsui -.->|"shows measured results"| node_evaluation
node_training -.->|"evaluates model"| node_evaluation
node_holdout -->|"supplies evaluation data"| node_evaluation

click node_app "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/App.jsx"
click node_workbench "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/DiagnosticWorkbench.jsx"
click node_api "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/utils/api.js"
click node_fallback "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/utils/imageProcessing.js"
click node_benchmarks "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/data/benchmarks.js"
click node_serviceapi "https://github.com/ayushranjan-17/skinscan-ai/blob/main/backend/app.py"
click node_inference "https://github.com/ayushranjan-17/skinscan-ai/blob/main/backend/inference.py"
click node_preprocess "https://github.com/ayushranjan-17/skinscan-ai/blob/main/ml_pipeline/dullrazor.py"
click node_risk "https://github.com/ayushranjan-17/skinscan-ai/blob/main/ml_pipeline/risk_stratification.py"
click node_riskui "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/RiskGaugeCard.jsx"
click node_verification "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/VerificationWorkflowCard.jsx"
click node_explain "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/GradCamVisualizer.jsx"
click node_abcd "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/AbcdAnalysisCard.jsx"
click node_report "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/ClinicalReportModal.jsx"
click node_history "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/ScanHistoryDrawer.jsx"
click node_feedback "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/HitlFeedbackPanel.jsx"
click node_database "https://github.com/ayushranjan-17/skinscan-ai/blob/main/backend/database.py"
click node_onboarding "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/GuidedOnboarding.jsx"
click node_metricsui "https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/ResearchMetricsDashboard.jsx"
click node_training "https://github.com/ayushranjan-17/skinscan-ai/blob/main/ml_pipeline/train_hybrid_model.py"
click node_evaluation "https://github.com/ayushranjan-17/skinscan-ai/blob/main/ml_pipeline/evaluate_metrics.py"
click node_holdout "https://github.com/ayushranjan-17/skinscan-ai/blob/main/ml_pipeline/holdout_common.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_app,node_workbench,node_api,node_fallback,node_benchmarks,node_onboarding toneBlue
class node_serviceapi,node_inference,node_preprocess,node_database toneAmber
class node_risk,node_riskui,node_verification,node_explain,node_abcd,node_report,node_history,node_feedback,node_metricsui toneMint
class node_training,node_evaluation,node_holdout toneRose
class node_clinician toneIndigo
```

## Components

### Clinician Web App

- [Scan Workflow](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/App.jsx): `src/App.jsx`
- [Image & Context](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/DiagnosticWorkbench.jsx): `src/components/DiagnosticWorkbench.jsx`
- [Backend Client](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/utils/api.js): `src/utils/api.js`
- [Demo Processing](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/utils/imageProcessing.js): `src/utils/imageProcessing.js`
- [Demo Cases](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/data/benchmarks.js): `src/data/benchmarks.js`
- [Guided Onboarding](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/GuidedOnboarding.jsx): `src/components/GuidedOnboarding.jsx`

### Inference Service

- [Analysis API](https://github.com/ayushranjan-17/skinscan-ai/blob/main/backend/app.py): `backend/app.py`
- [Inference Engine](https://github.com/ayushranjan-17/skinscan-ai/blob/main/backend/inference.py): `backend/inference.py`
- [Image Preprocessing](https://github.com/ayushranjan-17/skinscan-ai/blob/main/ml_pipeline/dullrazor.py): `ml_pipeline/dullrazor.py`
- [Accounts & Scans](https://github.com/ayushranjan-17/skinscan-ai/blob/main/backend/database.py): `backend/database.py`

### Clinical Decision Support

- [Risk Stratification](https://github.com/ayushranjan-17/skinscan-ai/blob/main/ml_pipeline/risk_stratification.py): `ml_pipeline/risk_stratification.py`
- [Risk Summary](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/RiskGaugeCard.jsx): `src/components/RiskGaugeCard.jsx`
- [Verification Workflow](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/VerificationWorkflowCard.jsx): `src/components/VerificationWorkflowCard.jsx`
- [Visual Explanation](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/GradCamVisualizer.jsx): `src/components/GradCamVisualizer.jsx`
- [ABCD Analysis](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/AbcdAnalysisCard.jsx): `src/components/AbcdAnalysisCard.jsx`
- [Clinical Report](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/ClinicalReportModal.jsx): `src/components/ClinicalReportModal.jsx`
- [Scan History](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/ScanHistoryDrawer.jsx): `src/components/ScanHistoryDrawer.jsx`
- [Biopsy Feedback](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/HitlFeedbackPanel.jsx): `src/components/HitlFeedbackPanel.jsx`
- [Research Metrics](https://github.com/ayushranjan-17/skinscan-ai/blob/main/src/components/ResearchMetricsDashboard.jsx): `src/components/ResearchMetricsDashboard.jsx`

### Model Development

- [Hybrid Model Training](https://github.com/ayushranjan-17/skinscan-ai/blob/main/ml_pipeline/train_hybrid_model.py): `ml_pipeline/train_hybrid_model.py`
- [Model Evaluation](https://github.com/ayushranjan-17/skinscan-ai/blob/main/ml_pipeline/evaluate_metrics.py): `ml_pipeline/evaluate_metrics.py`
- [Holdout Preparation](https://github.com/ayushranjan-17/skinscan-ai/blob/main/ml_pipeline/holdout_common.py): `ml_pipeline/holdout_common.py`

### Other components

- **Clinician**

## Connections

- Clinician → Scan Workflow: starts scan (evidence: `README.md`)
- Scan Workflow → Image & Context: collects input (evidence: `src/App.jsx`)
- Scan Workflow → Backend Client: requests analysis (evidence: `src/App.jsx`)
- Scan Workflow → Demo Processing: uses demo fallback (evidence: `src/App.jsx`)
- Image & Context → Demo Cases: offers demo cases (evidence: `src/components/DiagnosticWorkbench.jsx`)
- Backend Client → Analysis API: calls analysis API (evidence: `src/utils/api.js`)
- Analysis API → Inference Engine: runs inference (evidence: `backend/app.py`)
- Analysis API → Accounts & Scans: persists scans (evidence: `backend/app.py`)
- Inference Engine → Image Preprocessing: preprocesses image (evidence: `backend/inference.py`)
- Inference Engine → Risk Stratification: stratifies risk (evidence: `backend/inference.py`)
- Scan Workflow → Risk Summary: renders findings (evidence: `src/App.jsx`)
- Scan Workflow → Verification Workflow: renders workflow (evidence: `src/App.jsx`)
- Scan Workflow → Visual Explanation: renders explanation (evidence: `src/App.jsx`)
- Scan Workflow → ABCD Analysis: renders analysis (evidence: `src/App.jsx`)
- Scan Workflow → Clinical Report: offers report (evidence: `src/App.jsx`)
- Scan Workflow → Scan History: offers history (evidence: `src/App.jsx`)
- Scan Workflow → Biopsy Feedback: offers feedback (evidence: `src/App.jsx`)
- Backend Client → Accounts & Scans: retrieves history
- Guided Onboarding → Clinician: guides use
- Research Metrics → Model Evaluation: shows measured results (evidence: `README.md`)
- Hybrid Model Training → Model Evaluation: evaluates model (evidence: `ml_pipeline/train_hybrid_model.py`)
- Holdout Preparation → Model Evaluation: supplies evaluation data (evidence: `ml_pipeline/evaluate_v4_holdout.py`)
