# vukkumlakshmibhaskar/question_bank architecture

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

- Interactive diagram: https://gitdiagram.com/vukkumlakshmibhaskar/question_bank
- Repository: https://github.com/vukkumlakshmibhaskar/question_bank

## Overview

Question Bank is an education-content platform for building and managing question banks, reviewing extracted questions, and creating assessments. Its principal workflow runs from question or document intake through extraction, human review and normalization, then into approved question-bank content; assessment and evaluation tools support downstream use. The repository also contains standalone Python question-crafting and parsing tools alongside the Vue application. The README gives no product overview, so several capabilities are identified from the tree and route registrations; connections to unsampled modules are not asserted.

Main entry points: [`frontend/src/services/api.js`](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/services/api.js) (API client), [`backend/src/controllers/review.controller.js`](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/controllers/review.controller.js) (Review handlers), [`backend/src/services/review.service.js`](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/review.service.js) (Review workflow), [`backend/src/services/extractionReviewImport.service.js`](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/extractionReviewImport.service.js) (Extraction import)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web clients"]
  node_vue_app["Vue application<br/>[App.vue]"]
  node_vue_boot["Vue startup<br/>[main.js]"]
  node_vue_api["API client<br/>[api.js]"]
  node_vue_auth["Auth state<br/>[auth.js]"]
  node_vue_review["Review screens<br/>[ReviewDetail.vue]"]
  node_vue_admin["Admin and content screens"]
  node_settings["Settings controls<br/>[GlassSettings.vue]"]
end

subgraph group_api["Question Bank API"]
  node_api_server["Express API<br/>[app.js]"]
  node_auth_mw["Authentication and permissions<br/>[auth.middleware.js]"]
  node_domain_api["Content and assessment endpoints"]
  node_question_tools["Question-bank services"]
  node_database[("Application database<br/>[prisma.js]")]
  node_audit["Audit logging<br/>[audit.service.js]"]
end

subgraph group_review["Extraction review"]
  node_review_routes["Review routes<br/>[review.routes.js]"]
  node_review_controller["Review handlers"]
  node_review_service["Review workflow<br/>[review.service.js]"]
  node_import_service["Extraction import"]
  node_section_normalizer["Section normalization"]
  node_workbook_service["Review workbook export"]
  node_review_repo["Review records"]
end

subgraph group_tools["Question tools"]
  node_python_tools["Python question tools<br/>[question_engine.py]"]
  node_bulletproof["Bulletproof extraction pipeline<br/>[pipeline.py]"]
  node_react_tools["React parsing tools<br/>[parser.jsx]"]
  node_legacy_crafter["Question Crafter UI"]
end

node_user(("Staff user"))

node_user -->|"uses"| node_vue_app
node_vue_boot -->|"mounts"| node_vue_app
node_vue_boot -.->|"installs telemetry via"| node_vue_api
node_vue_app -->|"renders"| node_settings
node_vue_review -->|"uses"| node_vue_api
node_vue_auth -->|"uses"| node_vue_api
node_vue_app -.->|"routes to"| node_vue_admin
node_vue_api -.->|"HTTP requests"| node_api_server
node_api_server -->|"registers routes"| node_domain_api
node_api_server -->|"mounts reviews"| node_review_routes
node_review_routes -->|"authenticates"| node_auth_mw
node_review_routes -->|"dispatches to"| node_review_controller
node_review_controller -->|"delegates to"| node_review_service
node_review_controller -->|"imports extraction"| node_import_service
node_review_controller -->|"builds workbook"| node_workbook_service
node_review_service -->|"reads and updates"| node_review_repo
node_review_service -->|"normalizes sections"| node_section_normalizer
node_review_service -->|"records actions"| node_audit
node_workbook_service -->|"normalizes data"| node_section_normalizer
node_review_repo -->|"queries"| node_database
node_import_service -->|"uses"| node_review_repo
node_import_service -->|"uses"| node_section_normalizer
node_import_service -->|"uses"| node_audit
node_user -.->|"crafts questions"| node_python_tools
node_bulletproof -.->|"supports extraction"| node_python_tools
node_bulletproof -.->|"imports reviewed questions"| node_section_normalizer
node_react_tools -->|"uses API"| node_vue_api
node_user -.->|"creates questions"| node_legacy_crafter

click node_vue_app "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/App.vue"
click node_vue_boot "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/main.js"
click node_vue_api "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/services/api.js"
click node_vue_auth "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/stores/auth.js"
click node_vue_review "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/views/ReviewDetail.vue"
click node_vue_admin "https://github.com/vukkumlakshmibhaskar/question_bank/tree/main/frontend/src/views"
click node_settings "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/components/GlassSettings.vue"
click node_api_server "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/app.js"
click node_auth_mw "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/middleware/auth.middleware.js"
click node_domain_api "https://github.com/vukkumlakshmibhaskar/question_bank/tree/main/backend/src/routes"
click node_question_tools "https://github.com/vukkumlakshmibhaskar/question_bank/tree/main/backend/src/services"
click node_review_routes "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/routes/review.routes.js"
click node_review_controller "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/controllers/review.controller.js"
click node_review_service "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/review.service.js"
click node_import_service "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/extractionReviewImport.service.js"
click node_section_normalizer "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/sectionNormalizer.service.js"
click node_workbook_service "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/sectionReviewWorkbook.service.js"
click node_review_repo "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/repositories/review.repository.js"
click node_database "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/config/prisma.js"
click node_audit "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/audit.service.js"
click node_python_tools "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/LB/question_crafter/question_engine.py"
click node_bulletproof "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/LB/bulletproof/pipeline.py"
click node_react_tools "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/external/lb-react/src/pages/parser.jsx"
click node_legacy_crafter "https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/LB/my-app/src/pages/QuestionCrafter.jsx"

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_vue_app,node_vue_boot,node_vue_api,node_vue_auth,node_vue_review,node_vue_admin,node_settings,node_user toneBlue
class node_api_server,node_auth_mw,node_domain_api,node_question_tools,node_database,node_audit toneAmber
class node_review_routes,node_review_controller,node_review_service,node_import_service,node_section_normalizer,node_workbook_service,node_review_repo toneMint
class node_python_tools,node_bulletproof,node_react_tools,node_legacy_crafter toneRose
```

## Components

### Web clients

- [Vue application](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [Vue startup](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/main.js): `frontend/src/main.js`
- [API client](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Auth state](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/stores/auth.js): `frontend/src/stores/auth.js`
- [Review screens](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/views/ReviewDetail.vue): `frontend/src/views/ReviewDetail.vue`
- [Admin and content screens](https://github.com/vukkumlakshmibhaskar/question_bank/tree/main/frontend/src/views): `frontend/src/views`
- [Settings controls](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/src/components/GlassSettings.vue): `frontend/src/components/GlassSettings.vue`

### Question Bank API

- [Express API](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/app.js): `backend/src/app.js`
- [Authentication and permissions](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/middleware/auth.middleware.js): `backend/src/middleware/auth.middleware.js`
- [Content and assessment endpoints](https://github.com/vukkumlakshmibhaskar/question_bank/tree/main/backend/src/routes): `backend/src/routes`
- [Question-bank services](https://github.com/vukkumlakshmibhaskar/question_bank/tree/main/backend/src/services): `backend/src/services`
- [Application database](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/config/prisma.js): `backend/src/config/prisma.js`
- [Audit logging](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/audit.service.js): `backend/src/services/audit.service.js`

### Extraction review

- [Review routes](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/routes/review.routes.js): `backend/src/routes/review.routes.js`
- [Review handlers](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/controllers/review.controller.js): `backend/src/controllers/review.controller.js`
- [Review workflow](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/review.service.js): `backend/src/services/review.service.js`
- [Extraction import](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/extractionReviewImport.service.js): `backend/src/services/extractionReviewImport.service.js`
- [Section normalization](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/sectionNormalizer.service.js): `backend/src/services/sectionNormalizer.service.js`
- [Review workbook export](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/services/sectionReviewWorkbook.service.js): `backend/src/services/sectionReviewWorkbook.service.js`
- [Review records](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/backend/src/repositories/review.repository.js): `backend/src/repositories/review.repository.js`

### Question tools

- [Python question tools](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/LB/question_crafter/question_engine.py): `LB/question_crafter/question_engine.py`
- [Bulletproof extraction pipeline](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/LB/bulletproof/pipeline.py): `LB/bulletproof/pipeline.py`
- [React parsing tools](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/frontend/external/lb-react/src/pages/parser.jsx): `frontend/external/lb-react/src/pages/parser.jsx`
- [Question Crafter UI](https://github.com/vukkumlakshmibhaskar/question_bank/blob/main/LB/my-app/src/pages/QuestionCrafter.jsx): `LB/my-app/src/pages/QuestionCrafter.jsx`

### Other components

- **Staff user**

## Connections

- Staff user → Vue application: uses
- Vue startup → Vue application: mounts (evidence: `frontend/src/main.js`)
- Vue startup → API client: installs telemetry via
- Vue application → Settings controls: renders (evidence: `frontend/src/App.vue`)
- Review screens → API client: uses (evidence: `frontend/src/views/ReviewDetail.vue`)
- Auth state → API client: uses (evidence: `frontend/src/stores/auth.js`)
- Vue application → Admin and content screens: routes to
- API client → Express API: HTTP requests
- Express API → Content and assessment endpoints: registers routes (evidence: `backend/src/app.js`)
- Express API → Review routes: mounts reviews (evidence: `backend/src/app.js`)
- Review routes → Authentication and permissions: authenticates (evidence: `backend/src/routes/review.routes.js`)
- Review routes → Review handlers: dispatches to (evidence: `backend/src/routes/review.routes.js`)
- Review handlers → Review workflow: delegates to (evidence: `backend/src/controllers/review.controller.js`)
- Review handlers → Extraction import: imports extraction (evidence: `backend/src/controllers/review.controller.js`)
- Review handlers → Review workbook export: builds workbook (evidence: `backend/src/controllers/review.controller.js`)
- Review workflow → Review records: reads and updates (evidence: `backend/src/services/review.service.js`)
- Review workflow → Section normalization: normalizes sections (evidence: `backend/src/services/review.service.js`)
- Review workflow → Audit logging: records actions (evidence: `backend/src/services/review.service.js`)
- Review workbook export → Section normalization: normalizes data (evidence: `backend/src/services/sectionReviewWorkbook.service.js`)
- Review records → Application database: queries (evidence: `backend/src/repositories/review.repository.js`)
- Extraction import → Review records: uses (evidence: `backend/src/services/extractionReviewImport.service.js`)
- Extraction import → Section normalization: uses (evidence: `backend/src/services/extractionReviewImport.service.js`)
- Extraction import → Audit logging: uses (evidence: `backend/src/services/extractionReviewImport.service.js`)
- Staff user → Python question tools: crafts questions
- Bulletproof extraction pipeline → Python question tools: supports extraction
- Bulletproof extraction pipeline → Section normalization: imports reviewed questions
- React parsing tools → API client: uses API (evidence: `frontend/external/lb-react/src/pages/parser.jsx`)
- Staff user → Question Crafter UI: creates questions
