# Upstream notice: Dept-Q-Bank

DrND's Question Bank is built on **Dept-Q-Bank**, an open-source medical question-bank web app.

| | |
|---|---|
| Project | Dept-Q-Bank |
| Source | https://github.com/znu-med/Dept-Q-Bank |
| Imported commit | `95a91e2` ("retry 1") |
| Author named in the app footer | Kareem Farouk ("Made by Kareem Farouk · Questions by Department Heads") |
| Licence as published upstream | "MIT — free to use, modify, and distribute." (last line of the upstream README, kept here in `UPSTREAM-README.md`) |

## What was and was not found

At the imported commit the upstream repository contains **no `LICENSE` file** and states its licence only in that one
README line. No copyright holder or year is given. A full MIT licence text needs both, so none has been written here:
inventing a holder or a year would put words in the author's mouth.

What this folder does instead:

- keeps the upstream README unchanged as `UPSTREAM-README.md` (including its licence statement);
- keeps the upstream question files in `data/` unchanged;
- credits the project and the named author on the About page and in the footer, with a link to the source;
- does not present DrND's Knowledge Hub as the author of the upstream software or its questions.

**Recommended follow-up (not done):** ask the upstream owner to add a `LICENSE` file with the copyright line they want
used, then copy it into this folder as `LICENSE` and link it from the About page.

## Changes made for the DrND integration

Application code (`assets/js/*.js`, `assets/css/styles.css`, `config/modules.json`):

- `storage.js`: added `DQB_BASE` / `dqbUrl()` so data and config load from the folder that holds the app.
- `exam.js`, `app.js`: the five `fetch()` calls go through `dqbUrl()`.
- `app.js`: reset dialog moves focus to Cancel and closes on Escape; answering announces "Correct." / "Incorrect. The
  correct answer is X." through a polite live region (`#sr-status` in `index.html`).
- `app.js`: module, subject and topic cards (focusable `role="button"` divs) now open with Enter or Space; upstream gave
  them no keyboard activation.
- `app.js`: **bug fix.** Upstream, reloading the page during an exam restarted that exam from question 1 and
  overwrote the saved attempt. Now, if a saved attempt exists, a reload continues it (the same path as the dashboard's
  "Continue Exam" banner).
- `ui.js`: toasts carry `role="status"`; dashboard footer now credits the upstream project and links to the About page (the upstream promotion of a
  third-party site was not carried over); three places no longer print the word "undefined" when a question has no
  explanation; the dashboard greeting line (which addressed the upstream school's students) now labels the content as the
  original Dept-Q-Bank medical questions.
- `styles.css`: the `@import` of Google Fonts DM Sans / DM Mono was removed (fonts are linked from `index.html`).
- `modules.json`: `siteTitle` is "DrND's Question Bank".

Everything in `data/` is byte-identical to the upstream commit. DrND-specific files: `index.html`, `about.html`,
`assets/css/drnd-brand.css`, `assets/js/theme-init.js`, `scripts/`, `README.md`, this notice.

The upstream logo files were not copied; the DrND logo is used instead.