How sasidhar1370/publichealth-platform works
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: app.js Platform interface · main.py Faculty administration · ingest.py Curriculum ingestion · rag_engine.py Citation retrieval
Components 13
User experience
- Platform interface
frontend/app.js
Assessment services
- Board examination
backend/main.py - Incident simulation
backend/main.py - Scoring and analytics
backend/main.py - Audit transcripts
backend/main.py - Faculty administration
backend/main.py
Knowledge retrieval
- Curriculum ingestion
src/ingest.py - Citation retrieval
src/rag_engine.py
Local content and data
- Question banks
data/question_banks - Reference texts
textbooks/public_health_core_reference.txt - ChromaDB index
data/chroma
Other components
- Candidate
- Faculty
Connections 15
- Candidate → Platform interface: uses
README.md - Faculty → Platform interface: uses
README.md - Platform interface → Board examination: requests exam
- Platform interface → Incident simulation: submits choices
- Platform interface → Scoring and analytics: posts evaluation
frontend/app.js - Platform interface → Citation retrieval: requests remediation
- Board examination → Question banks: loads questions
backend/main.py - Scoring and analytics → Audit transcripts: produces audit
README.md - Faculty → Faculty administration: manages content
README.md - Faculty administration → Question banks: updates bank
backend/main.py - Faculty administration → Curriculum ingestion: indexes uploads
README.md - Reference texts → Curriculum ingestion: chunks text
src/ingest.py - Curriculum ingestion → ChromaDB index: writes chunks
src/ingest.py - Citation retrieval → ChromaDB index: queries passages
src/rag_engine.py - Faculty administration → Citation retrieval: checks status
backend/main.py