How itevolution-usc/gastro-sim works
GASTRO-SIM is an academic web-based 3D simulator for practicing human–AI decision-making in gastrointestinal endoscopy. The documented learner flow requests an AI-generated case, explores anatomy and captures a finding, records an initial decision, reviews a vision-AI recommendation and optional tutor guidance, then submits a final decision and receives feedback; attempts support evaluation of learner behavior. The checked-in runtime is currently an API scaffold: it starts FastAPI, configures connections and errors, and exposes health and public catalog endpoints. The broader workflow is documented in the README, not implemented in the sampled source.
Main entry points: main.py FastAPI API · db.py Connection pool · salud.py Health and catalogs · README.md AI case generation
Components 17
API Runtime
- FastAPI API
api/app/main.py - Configuration
api/app/config.py - Error handlers
api/app/errores.py - Health and catalogs
api/app/routers/salud.py
Clinical Simulation
- AI case generation
README.md - Public endoscopy image
README.md - 3D endoscopy
README.md - Finding capture
README.md
Decision Training
- Initial decision
README.md - Vision recommendation
README.md - AI tutor
README.md - Final decision
README.md - Learning feedback
README.md - Attempt tracking
README.md
Platform Data
- Connection pool
api/app/db.py - PostgreSQL schema
db/migraciones/001_esquema_inicial.sql
Other components
- Student
Connections 16
- Student → AI case generation: requests case
README.md - AI case generation → Public endoscopy image: uses image
README.md - Student → 3D endoscopy: explores anatomy
README.md - 3D endoscopy → Finding capture: captures finding
README.md - Student → Initial decision: records decision
README.md - Initial decision → Vision recommendation: reviews recommendation
README.md - Student → AI tutor: may consult
README.md - Student → Final decision: records decision
README.md - Final decision → Learning feedback: receives feedback
README.md - Attempt tracking → Learning feedback: supports evaluation
README.md - FastAPI API → Configuration: loads settings
api/app/main.py - FastAPI API → Connection pool: opens and closes
api/app/main.py - FastAPI API → Error handlers: registers handlers
api/app/main.py - FastAPI API → Health and catalogs: mounts router
api/app/main.py - Health and catalogs → Connection pool: queries through
api/app/routers/salud.py - Connection pool → PostgreSQL schema: connects to