# monajemi-arman/simple-clinical-data-processing architecture

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

- Interactive diagram: https://gitdiagram.com/monajemi-arman/simple-clinical-data-processing
- Repository: https://github.com/monajemi-arman/simple-clinical-data-processing

## Overview

The product converts clinical CSVs and narrative text into a shared ClinicalOutput format, validates both result sets, and offers terminal or JSON-file output. Structured processing validates and maps lab/medication rows; narrative processing applies configured medSpaCy target rules and extracts entities and clinical facts. The main workflow is explicit in main.py. Some structured-loader internals are excerpted only partially, so the graph avoids detailing their unshown helper calls.

Main entry points: [`src/simple_clinical_data_processing/main.py`](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/main.py) (Workflow runner), [`src/simple_clinical_data_processing/process_narrative.py`](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/process_narrative.py) (Narrative extraction), [`src/simple_clinical_data_processing/process_structured.py`](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/process_structured.py) (CSV validation and mapping), [`data/structured`](https://github.com/monajemi-arman/simple-clinical-data-processing/tree/main/data/structured) (Lab and medication CSVs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Orchestration"]
  node_runner["Workflow runner<br/>[main.py]"]
end

subgraph group_structured["Structured Data"]
  node_structured_input["Lab and medication CSVs"]
  node_structured_processing["CSV validation and mapping"]
  node_structured_config["Structured schemas<br/>[config.py]"]
end

subgraph group_narrative["Narrative Data"]
  node_narrative_input["Clinical narratives"]
  node_narrative_processing["Narrative extraction"]
  node_target_rules["Target rules<br/>[target-rules.json]"]
  node_medspacy["medSpaCy"]
end

subgraph group_output["Validation and Output"]
  node_output_schema["Output schema<br/>[output-schema.json]"]
  node_validation["Document validation<br/>[main.py]"]
  node_result_docs["Clinical documents<br/>[main.py]"]
  node_presentation["Terminal and file output<br/>[main.py]"]
end

node_user(("User"))

node_user -->|"runs"| node_runner
node_runner -->|"loads CSVs"| node_structured_processing
node_runner -->|"processes text"| node_narrative_processing
node_structured_input -->|"reads rows"| node_structured_processing
node_structured_processing -->|"uses schemas"| node_structured_config
node_narrative_input -->|"reads text"| node_narrative_processing
node_narrative_processing -->|"loads rules"| node_target_rules
node_narrative_processing -->|"processes text"| node_medspacy
node_runner -->|"loads schema"| node_output_schema
node_runner -->|"validates results"| node_validation
node_structured_processing -->|"builds documents"| node_result_docs
node_narrative_processing -->|"builds documents"| node_result_docs
node_validation -->|"offers results"| node_presentation
node_user -->|"chooses output"| node_presentation

click node_runner "https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/main.py"
click node_structured_input "https://github.com/monajemi-arman/simple-clinical-data-processing/tree/main/data/structured"
click node_structured_processing "https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/process_structured.py"
click node_structured_config "https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/config.py"
click node_narrative_input "https://github.com/monajemi-arman/simple-clinical-data-processing/tree/main/data/narrative"
click node_narrative_processing "https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/process_narrative.py"
click node_target_rules "https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/config/target-rules.json"
click node_output_schema "https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/config/output-schema.json"
click node_validation "https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/main.py"
click node_result_docs "https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/main.py"
click node_presentation "https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/main.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_runner,node_user toneBlue
class node_structured_input,node_structured_processing,node_structured_config toneAmber
class node_narrative_input,node_narrative_processing,node_target_rules,node_medspacy toneMint
class node_output_schema,node_validation,node_result_docs,node_presentation toneRose
```

## Components

### Orchestration

- [Workflow runner](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/main.py): `src/simple_clinical_data_processing/main.py`

### Structured Data

- [Lab and medication CSVs](https://github.com/monajemi-arman/simple-clinical-data-processing/tree/main/data/structured): `data/structured`
- [CSV validation and mapping](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/process_structured.py): `src/simple_clinical_data_processing/process_structured.py`
- [Structured schemas](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/config.py): `src/simple_clinical_data_processing/config.py`

### Narrative Data

- [Clinical narratives](https://github.com/monajemi-arman/simple-clinical-data-processing/tree/main/data/narrative): `data/narrative`
- [Narrative extraction](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/process_narrative.py): `src/simple_clinical_data_processing/process_narrative.py`
- [Target rules](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/config/target-rules.json): `config/target-rules.json`
- **medSpaCy**

### Validation and Output

- [Output schema](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/config/output-schema.json): `config/output-schema.json`
- [Document validation](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/main.py): `src/simple_clinical_data_processing/main.py`
- [Clinical documents](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/main.py): `src/simple_clinical_data_processing/main.py`
- [Terminal and file output](https://github.com/monajemi-arman/simple-clinical-data-processing/blob/main/src/simple_clinical_data_processing/main.py): `src/simple_clinical_data_processing/main.py`

### Other components

- **User**

## Connections

- User → Workflow runner: runs (evidence: `README.md`)
- Workflow runner → CSV validation and mapping: loads CSVs (evidence: `src/simple_clinical_data_processing/main.py`)
- Workflow runner → Narrative extraction: processes text (evidence: `src/simple_clinical_data_processing/main.py`)
- Lab and medication CSVs → CSV validation and mapping: reads rows
- CSV validation and mapping → Structured schemas: uses schemas (evidence: `src/simple_clinical_data_processing/process_structured.py`)
- Clinical narratives → Narrative extraction: reads text (evidence: `src/simple_clinical_data_processing/process_narrative.py`)
- Narrative extraction → Target rules: loads rules (evidence: `src/simple_clinical_data_processing/process_narrative.py`)
- Narrative extraction → medSpaCy: processes text (evidence: `src/simple_clinical_data_processing/process_narrative.py`)
- Workflow runner → Output schema: loads schema (evidence: `src/simple_clinical_data_processing/main.py`)
- Workflow runner → Document validation: validates results (evidence: `src/simple_clinical_data_processing/main.py`)
- CSV validation and mapping → Clinical documents: builds documents (evidence: `src/simple_clinical_data_processing/process_structured.py`)
- Narrative extraction → Clinical documents: builds documents (evidence: `src/simple_clinical_data_processing/process_narrative.py`)
- Document validation → Terminal and file output: offers results (evidence: `src/simple_clinical_data_processing/main.py`)
- User → Terminal and file output: chooses output (evidence: `src/simple_clinical_data_processing/main.py`)
