# sasidhar1370/publichealth-platform architecture

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

- Interactive diagram: https://gitdiagram.com/sasidhar1370/publichealth-platform
- Repository: https://github.com/sasidhar1370/publichealth-platform

## Overview

This is a local-first public-health competency assessment and learning platform. Candidates use a browser cockpit for timed multiple-choice exams and branching incident simulations; the API evaluates submissions, produces readiness analytics and accreditation transcripts, and serves remediation. Faculty can manage question banks and curriculum ingestion. The retrieval path chunks textbook material into a local ChromaDB index, which the RAG engine searches for cited remediation. The README documents several capabilities whose implementation was not fully sampled, so those links rely on its descriptions rather than inspected endpoint code.

Main entry points: [`frontend/app.js`](https://github.com/sasidhar1370/publichealth-platform/blob/main/frontend/app.js) (Platform interface), [`backend/main.py`](https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py) (Faculty administration), [`src/ingest.py`](https://github.com/sasidhar1370/publichealth-platform/blob/main/src/ingest.py) (Curriculum ingestion), [`src/rag_engine.py`](https://github.com/sasidhar1370/publichealth-platform/blob/main/src/rag_engine.py) (Citation retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_browser["Platform interface<br/>[app.js]"]
end

subgraph group_assessment["Assessment services"]
  node_exam["Board examination<br/>[main.py]"]
  node_incident["Incident simulation<br/>[main.py]"]
  node_evaluation["Scoring and analytics<br/>[main.py]"]
  node_transcripts["Audit transcripts<br/>[main.py]"]
  node_admin["Faculty administration<br/>[main.py]"]
end

subgraph group_retrieval["Knowledge retrieval"]
  node_ingestion["Curriculum ingestion<br/>[ingest.py]"]
  node_retrieval_engine["Citation retrieval<br/>[rag_engine.py]"]
end

subgraph group_content["Local content and data"]
  node_question_banks["Question banks"]
  node_textbooks["Reference texts"]
  node_vector_store[("ChromaDB index")]
end

node_candidate(("Candidate"))
node_faculty(("Faculty"))

node_candidate -->|"uses"| node_browser
node_faculty -->|"uses"| node_browser
node_browser -.->|"requests exam"| node_exam
node_browser -.->|"submits choices"| node_incident
node_browser -->|"posts evaluation"| node_evaluation
node_browser -.->|"requests remediation"| node_retrieval_engine
node_exam -->|"loads questions"| node_question_banks
node_evaluation -.->|"produces audit"| node_transcripts
node_faculty -->|"manages content"| node_admin
node_admin -->|"updates bank"| node_question_banks
node_admin -->|"indexes uploads"| node_ingestion
node_textbooks -->|"chunks text"| node_ingestion
node_ingestion -->|"writes chunks"| node_vector_store
node_retrieval_engine -->|"queries passages"| node_vector_store
node_admin -.->|"checks status"| node_retrieval_engine

click node_browser "https://github.com/sasidhar1370/publichealth-platform/blob/main/frontend/app.js"
click node_exam "https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py"
click node_incident "https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py"
click node_evaluation "https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py"
click node_transcripts "https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py"
click node_question_banks "https://github.com/sasidhar1370/publichealth-platform/tree/main/data/question_banks"
click node_admin "https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py"
click node_ingestion "https://github.com/sasidhar1370/publichealth-platform/blob/main/src/ingest.py"
click node_textbooks "https://github.com/sasidhar1370/publichealth-platform/blob/main/textbooks/public_health_core_reference.txt"
click node_retrieval_engine "https://github.com/sasidhar1370/publichealth-platform/blob/main/src/rag_engine.py"
click node_vector_store "https://github.com/sasidhar1370/publichealth-platform/tree/main/data/chroma"

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_browser toneBlue
class node_exam,node_incident,node_evaluation,node_transcripts,node_admin toneAmber
class node_ingestion,node_retrieval_engine toneMint
class node_question_banks,node_textbooks,node_vector_store toneRose
class node_candidate,node_faculty toneIndigo
```

## Components

### User experience

- [Platform interface](https://github.com/sasidhar1370/publichealth-platform/blob/main/frontend/app.js): `frontend/app.js`

### Assessment services

- [Board examination](https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py): `backend/main.py`
- [Incident simulation](https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py): `backend/main.py`
- [Scoring and analytics](https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py): `backend/main.py`
- [Audit transcripts](https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py): `backend/main.py`
- [Faculty administration](https://github.com/sasidhar1370/publichealth-platform/blob/main/backend/main.py): `backend/main.py`

### Knowledge retrieval

- [Curriculum ingestion](https://github.com/sasidhar1370/publichealth-platform/blob/main/src/ingest.py): `src/ingest.py`
- [Citation retrieval](https://github.com/sasidhar1370/publichealth-platform/blob/main/src/rag_engine.py): `src/rag_engine.py`

### Local content and data

- [Question banks](https://github.com/sasidhar1370/publichealth-platform/tree/main/data/question_banks): `data/question_banks`
- [Reference texts](https://github.com/sasidhar1370/publichealth-platform/blob/main/textbooks/public_health_core_reference.txt): `textbooks/public_health_core_reference.txt`
- [ChromaDB index](https://github.com/sasidhar1370/publichealth-platform/tree/main/data/chroma): `data/chroma`

### Other components

- **Candidate**
- **Faculty**

## Connections

- Candidate → Platform interface: uses (evidence: `README.md`)
- Faculty → Platform interface: uses (evidence: `README.md`)
- Platform interface → Board examination: requests exam
- Platform interface → Incident simulation: submits choices
- Platform interface → Scoring and analytics: posts evaluation (evidence: `frontend/app.js`)
- Platform interface → Citation retrieval: requests remediation
- Board examination → Question banks: loads questions (evidence: `backend/main.py`)
- Scoring and analytics → Audit transcripts: produces audit (evidence: `README.md`)
- Faculty → Faculty administration: manages content (evidence: `README.md`)
- Faculty administration → Question banks: updates bank (evidence: `backend/main.py`)
- Faculty administration → Curriculum ingestion: indexes uploads (evidence: `README.md`)
- Reference texts → Curriculum ingestion: chunks text (evidence: `src/ingest.py`)
- Curriculum ingestion → ChromaDB index: writes chunks (evidence: `src/ingest.py`)
- Citation retrieval → ChromaDB index: queries passages (evidence: `src/rag_engine.py`)
- Faculty administration → Citation retrieval: checks status (evidence: `backend/main.py`)
