From 91860964a381ba28c197788ff32802f3ce135783 Mon Sep 17 00:00:00 2001
From: Mirko Dietrich <dietrich@math.tu-berlin.de>
Date: Wed, 27 Aug 2025 15:25:07 +0200
Subject: [PATCH 1/5] chore(frontend): consistently re-export composables from
 parent module

---
 frontend/src/components/question/QuestionCard.vue | 2 +-
 frontend/src/composables/question/index.ts        | 2 ++
 frontend/src/pages/index.vue                      | 2 +-
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/frontend/src/components/question/QuestionCard.vue b/frontend/src/components/question/QuestionCard.vue
index 1da2209c..d694461a 100644
--- a/frontend/src/components/question/QuestionCard.vue
+++ b/frontend/src/components/question/QuestionCard.vue
@@ -47,7 +47,7 @@ import { storeToRefs } from 'pinia'
 import { computed } from 'vue'
 import { useLink } from 'vue-router'
 
-import useDeleteQuestion from '@/composables/question/useDeleteQuestion'
+import { useDeleteQuestion } from '@/composables/question'
 import useAppStateStore from '@/stores/useAppStateStore'
 import type { OptionsFormData } from '@/types'
 
diff --git a/frontend/src/composables/question/index.ts b/frontend/src/composables/question/index.ts
index 71059d6b..7f02d803 100644
--- a/frontend/src/composables/question/index.ts
+++ b/frontend/src/composables/question/index.ts
@@ -4,5 +4,7 @@
  * (c) Technische Universität Berlin, innoCampus <info@isis.tu-berlin.de>
  */
 
+export { default as useCreateQuestion } from './useCreateQuestion'
+export { default as useDeleteQuestion } from './useDeleteQuestion'
 export { default as useFormDataState } from './useFormDataState'
 export { default as useRepetitions } from './useRepetitions'
diff --git a/frontend/src/pages/index.vue b/frontend/src/pages/index.vue
index 80bdf20d..8643c8b1 100644
--- a/frontend/src/pages/index.vue
+++ b/frontend/src/pages/index.vue
@@ -17,7 +17,7 @@
 import IMdiAdd from '~icons/mdi/add'
 import IMdiImport from '~icons/mdi/import'
 
-import useCreateQuestion from '@/composables/question/useCreateQuestion'
+import { useCreateQuestion } from '@/composables/question'
 
 const createQuestion = useCreateQuestion()
 

From 86dd39354e91a1b3c2180f1b5370511ebc34953b Mon Sep 17 00:00:00 2001
From: Mirko Dietrich <dietrich@math.tu-berlin.de>
Date: Wed, 27 Aug 2025 17:03:26 +0200
Subject: [PATCH 2/5] feat: delete question states on
 `InvalidQuestionStateError`

Closes #212
---
 .../components/common/error/ErrorDisplay.vue  |   2 +
 .../error/InvalidQuestionStateError.vue       |  25 +++++
 frontend/src/composables/question/index.ts    |   1 +
 .../question/useDeleteAllQuestions.ts         |  45 ++++++++
 frontend/src/queries/index.ts                 |   1 +
 frontend/src/queries/question.ts              |  21 ++++
 .../controllers/question/controller.py        |   3 +
 questionpy_sdk/webserver/routes/question.py   |   5 +
 questionpy_sdk/webserver/state.py             | 105 ++++++++++--------
 .../webserver/routes/test_question.py         |   7 ++
 tests/questionpy_sdk/webserver/test_state.py  |  13 +++
 11 files changed, 182 insertions(+), 46 deletions(-)
 create mode 100644 frontend/src/components/common/error/InvalidQuestionStateError.vue
 create mode 100644 frontend/src/composables/question/useDeleteAllQuestions.ts

diff --git a/frontend/src/components/common/error/ErrorDisplay.vue b/frontend/src/components/common/error/ErrorDisplay.vue
index 909d61bf..20c37ba8 100644
--- a/frontend/src/components/common/error/ErrorDisplay.vue
+++ b/frontend/src/components/common/error/ErrorDisplay.vue
@@ -6,6 +6,8 @@
 
 <template>
     <h5>{{ fetchError.message }} ({{ fetchError.status }}: {{ fetchError.statusText }})</h5>
+    <InvalidQuestionStateError v-if="fetchError.message === 'InvalidQuestionStateError'" />
+    <h6>Stacktrace</h6>
     <code v-if="typeof fetchError.details === 'string'">
         <pre>{{ fetchError.details }}</pre>
     </code>
diff --git a/frontend/src/components/common/error/InvalidQuestionStateError.vue b/frontend/src/components/common/error/InvalidQuestionStateError.vue
new file mode 100644
index 00000000..c5efeb2a
--- /dev/null
+++ b/frontend/src/components/common/error/InvalidQuestionStateError.vue
@@ -0,0 +1,25 @@
+<!--
+  This file is part of the QuestionPy SDK. (https://questionpy.org)
+  The QuestionPy SDK is free software released under terms of the MIT license. See LICENSE.md.
+  (c) Technische Universität Berlin, innoCampus <info@isis.tu-berlin.de>
+-->
+
+<template>
+    <BAlert :model-value="true" variant="warning">
+        The package could not parse one or more question states. If you renamed or added required fields, delete the
+        existing states and create a new question. Otherwise, this may be a bug in the package.
+    </BAlert>
+    <ButtonGroup>
+        <IconButton @click="deleteQuestionStates" :icon-component="IMdiDelete" variant="danger" size="sm"
+            >Delete question states</IconButton
+        ></ButtonGroup
+    >
+</template>
+
+<script lang="ts" setup>
+import IMdiDelete from '~icons/mdi/delete'
+
+import { useDeleteAllQuestions } from '@/composables/question'
+
+const deleteQuestionStates = useDeleteAllQuestions()
+</script>
diff --git a/frontend/src/composables/question/index.ts b/frontend/src/composables/question/index.ts
index 7f02d803..b011c6a4 100644
--- a/frontend/src/composables/question/index.ts
+++ b/frontend/src/composables/question/index.ts
@@ -5,6 +5,7 @@
  */
 
 export { default as useCreateQuestion } from './useCreateQuestion'
+export { default as useDeleteAllQuestions } from './useDeleteAllQuestions'
 export { default as useDeleteQuestion } from './useDeleteQuestion'
 export { default as useFormDataState } from './useFormDataState'
 export { default as useRepetitions } from './useRepetitions'
diff --git a/frontend/src/composables/question/useDeleteAllQuestions.ts b/frontend/src/composables/question/useDeleteAllQuestions.ts
new file mode 100644
index 00000000..72eb1e92
--- /dev/null
+++ b/frontend/src/composables/question/useDeleteAllQuestions.ts
@@ -0,0 +1,45 @@
+/*
+ * This file is part of the QuestionPy SDK. (https://questionpy.org)
+ * The QuestionPy SDK is free software released under terms of the MIT license. See LICENSE.md.
+ * (c) Technische Universität Berlin, innoCampus <info@isis.tu-berlin.de>
+ */
+
+import { useRouter } from 'vue-router'
+
+import { useConfirmModal } from '@/composables/common'
+import { useDeleteAllOptionsFormDataMutation } from '@/queries'
+import useAppStateStore from '@/stores/useAppStateStore'
+
+/**
+ * Composable that returns a function to delete all question states after displaying a confirmation modal.
+ *
+ * @returns A function that, when called, shows a confirmation modal and deletes all questions if confirmed.
+ */
+function useDeleteAllQuestions() {
+    const router = useRouter()
+    const { mutateAsync } = useDeleteAllOptionsFormDataMutation()
+    const { setError } = useAppStateStore()
+    const confirmModal = useConfirmModal({
+        title: 'Delete All Questions',
+        body: 'Are you sure you want to delete all question states?',
+        okTitle: 'Delete All Questions',
+    })
+
+    return async () => {
+        if (await confirmModal()) {
+            try {
+                await mutateAsync()
+            } catch (err) {
+                setError(err)
+                return
+            }
+
+            // Next, navigate to the index page, because the old route may not exist anymore
+            if (router.currentRoute.value.name !== 'index') {
+                await router.push({ name: 'index' })
+            }
+        }
+    }
+}
+
+export default useDeleteAllQuestions
diff --git a/frontend/src/queries/index.ts b/frontend/src/queries/index.ts
index 988fb86d..c7cc2141 100644
--- a/frontend/src/queries/index.ts
+++ b/frontend/src/queries/index.ts
@@ -14,6 +14,7 @@ export {
 export { FetchError } from './fetch'
 export { useManifestQuery } from './package'
 export {
+    useDeleteAllOptionsFormDataMutation,
     useDeleteOptionsFormDataMutation,
     useOptionsFormDataQuery,
     useOptionsFormDefinitionQuery,
diff --git a/frontend/src/queries/question.ts b/frontend/src/queries/question.ts
index e6921dd0..059a0879 100644
--- a/frontend/src/queries/question.ts
+++ b/frontend/src/queries/question.ts
@@ -22,6 +22,26 @@ const useQuestionStatesQuery = () =>
         query: () => get<Record<string, OptionsFormData>>('questions'),
     })
 
+/**
+ * Delete all question options form data.
+ *
+ * @returns A mutation return object.
+ */
+function useDeleteAllOptionsFormDataMutation() {
+    const { invalidateQueries } = useQueryCache()
+
+    const invalidateKeys = [QUERY_KEYS.question.root, QUERY_KEYS.attempt.root]
+
+    return useMutation({
+        mutation: () => delete_('questions'),
+        onSettled: () => {
+            for (const key of invalidateKeys) {
+                invalidateQueries({ key })
+            }
+        },
+    })
+}
+
 /**
  * Get question form data by question ID.
  *
@@ -98,6 +118,7 @@ function useDeleteOptionsFormDataMutation(questionId: string) {
 }
 
 export {
+    useDeleteAllOptionsFormDataMutation,
     useDeleteOptionsFormDataMutation,
     useOptionsFormDataQuery,
     useOptionsFormDefinitionQuery,
diff --git a/questionpy_sdk/webserver/controllers/question/controller.py b/questionpy_sdk/webserver/controllers/question/controller.py
index e88e2e8e..ae30ea58 100644
--- a/questionpy_sdk/webserver/controllers/question/controller.py
+++ b/questionpy_sdk/webserver/controllers/question/controller.py
@@ -81,6 +81,9 @@ async def save_options_state(self, question_id: str, data: OptionsFormData) -> N
     async def delete_question(self, question_id: str) -> None:
         await self._state_manager.delete_question(question_id)
 
+    async def delete_all_questions(self) -> None:
+        await self._state_manager.delete_all_questions()
+
     @staticmethod
     def _section_names_from_definition(form_definition: OptionsFormDefinition) -> list[str]:
         return [section.name for section in form_definition.sections]
diff --git a/questionpy_sdk/webserver/routes/question.py b/questionpy_sdk/webserver/routes/question.py
index d5f063e0..0c622552 100644
--- a/questionpy_sdk/webserver/routes/question.py
+++ b/questionpy_sdk/webserver/routes/question.py
@@ -44,6 +44,11 @@ async def get(self) -> web.Response:
         """Gets a list of all saved questions for the current package."""
         return web.json_response(await self.controller.get_questions())
 
+    async def delete(self) -> web.Response:
+        """Deletes all questions and its attempts from the state storage."""
+        await self.controller.delete_all_questions()
+        return web.json_response()
+
 
 @routes.view(f"/question/{{question_id:{ID_RE}}}/state", name="question.state")
 class QuestionStateView(QuestionBaseView):
diff --git a/questionpy_sdk/webserver/state.py b/questionpy_sdk/webserver/state.py
index e20afa1b..735ac470 100644
--- a/questionpy_sdk/webserver/state.py
+++ b/questionpy_sdk/webserver/state.py
@@ -35,6 +35,7 @@ async def read_question_state(self, question_id: str) -> str: ...
     async def write_question_state(self, question_id: str, question_state: str) -> None: ...
 
     async def delete_question(self, question_id: str) -> None: ...
+    async def delete_all_questions(self) -> None: ...
 
     async def read_attempts(self, question_id: str) -> dict[str, Attempt]: ...
     async def read_attempt_state(self, question_id: str, attempt_id: str) -> str: ...
@@ -75,51 +76,53 @@ def __init__(self, package_state_dir: Path) -> None:
     async def read_question_states(self) -> dict[str, str]:
         def _read_question_states() -> dict[str, str]:
             try:
-                dir_entries = list(self._package_state_dir.iterdir())
-            except FileNotFoundError:
-                # Package dir might not have been created yet
-                return {}
-
-            return {
-                path.name: (path / self.StateFilename.QUESTION_STATE).read_text()
-                for path in dir_entries
-                if path.is_dir() and re.match(ID_RE, path.name)
-            }
+                return {
+                    path.name: (path / self.StateFilename.QUESTION_STATE).read_text()
+                    for path in self._get_question_state_paths()
+                }
+            except FileNotFoundError as err:
+                raise webserver_errors.MissingQuestionStateError from err
 
         return await asyncio.to_thread(_read_question_states)
 
     async def read_question_state(self, question_id: str) -> str:
         try:
-            return await self._read_state_file(self._question_path(question_id), self.StateFilename.QUESTION_STATE)
+            return await self._read_state_file(self._get_question_path(question_id), self.StateFilename.QUESTION_STATE)
         except FileNotFoundError as err:
             raise webserver_errors.MissingQuestionStateError from err
 
     async def write_question_state(self, question_id: str, question_state: str) -> None:
-        path = self._question_path(question_id)
+        path = self._get_question_path(question_id)
         await self._write_state_file(path, self.StateFilename.QUESTION_STATE, question_state)
 
     async def delete_question(self, question_id: str) -> None:
-        def _delete_question() -> None:
-            question_path = self._question_path(question_id)
-            try:
-                (question_path / self.StateFilename.QUESTION_STATE).unlink()
-            except FileNotFoundError as err:
-                raise webserver_errors.MissingQuestionStateError from err
+        await asyncio.to_thread(self._delete_question_sync, question_id)
 
-            try:
-                dir_entries = list(question_path.iterdir())
-            except FileNotFoundError:
-                return
-            else:
-                for path in dir_entries:
-                    if path.is_dir() and re.match(ID_RE, path.name):
-                        self._delete_attempt_data_sync(question_id, path.name)
+    def _delete_question_sync(self, question_id: str) -> None:
+        question_path = self._get_question_path(question_id)
+        try:
+            (question_path / self.StateFilename.QUESTION_STATE).unlink()
+        except FileNotFoundError as err:
+            raise webserver_errors.MissingQuestionStateError from err
 
-            with contextlib.suppress(OSError):
-                # Ignore in case of non-empty directory
-                question_path.rmdir()
+        try:
+            dir_entries = list(question_path.iterdir())
+        except FileNotFoundError:
+            return
+        for path in dir_entries:
+            if self._is_id_dir(path):
+                self._delete_attempt_data_sync(question_id, path.name)
+
+        with contextlib.suppress(OSError):
+            # Ignore in case of non-empty directory
+            question_path.rmdir()
 
-        await asyncio.to_thread(_delete_question)
+    async def delete_all_questions(self) -> None:
+        def _delete_all_questions() -> None:
+            for path in self._get_question_state_paths():
+                self._delete_question_sync(path.name)
+
+        await asyncio.to_thread(_delete_all_questions)
 
     async def read_attempts(self, question_id: str) -> dict[str, Attempt]:
         return await asyncio.to_thread(self._read_attempts_sync, question_id)
@@ -128,14 +131,13 @@ def _read_attempts_sync(self, question_id: str) -> dict[str, Attempt]:
         attempts: dict[str, Attempt] = {}
 
         try:
-            dir_entries = list(self._question_path(question_id).iterdir())
+            dir_entries = list(self._get_question_path(question_id).iterdir())
         except FileNotFoundError:
             # Question dir might not have been created yet
             return attempts
 
         for path in dir_entries:
-            attempt_id = path.name
-            if path.is_dir() and re.match(ID_RE, attempt_id):
+            if self._is_id_dir(path):
                 state = (path / self.StateFilename.ATTEMPT_STATE).read_text()
                 try:
                     seed = int((path / self.StateFilename.ATTEMPT_SEED).read_text())
@@ -150,23 +152,23 @@ def _read_attempts_sync(self, question_id: str) -> dict[str, Attempt]:
                     data = json.loads((path / self.StateFilename.ATTEMPT_DATA).read_text())
                 except FileNotFoundError:
                     data = None
-                attempts[attempt_id] = Attempt(state, seed, score, data)
+                attempts[path.name] = Attempt(state, seed, score, data)
 
         return attempts
 
     async def read_attempt_state(self, question_id: str, attempt_id: str) -> str:
-        path = self._attempt_path(question_id, attempt_id)
+        path = self._get_attempt_path(question_id, attempt_id)
         try:
             return await self._read_state_file(path, self.StateFilename.ATTEMPT_STATE)
         except FileNotFoundError as err:
             raise webserver_errors.MissingAttemptStateError from err
 
     async def write_attempt_state(self, question_id: str, attempt_id: str, attempt_state: str) -> None:
-        path = self._attempt_path(question_id, attempt_id)
+        path = self._get_attempt_path(question_id, attempt_id)
         await self._write_state_file(path, self.StateFilename.ATTEMPT_STATE, attempt_state)
 
     async def read_attempt_seed(self, question_id: str, attempt_id: str) -> int:
-        path = self._attempt_path(question_id, attempt_id)
+        path = self._get_attempt_path(question_id, attempt_id)
         try:
             seed_str = await self._read_state_file(path, self.StateFilename.ATTEMPT_SEED)
         except FileNotFoundError as err:
@@ -175,11 +177,11 @@ async def read_attempt_seed(self, question_id: str, attempt_id: str) -> int:
 
     async def write_attempt_seed(self, question_id: str, attempt_id: str, seed: int) -> None:
         await self._write_state_file(
-            self._attempt_path(question_id, attempt_id), self.StateFilename.ATTEMPT_SEED, str(seed)
+            self._get_attempt_path(question_id, attempt_id), self.StateFilename.ATTEMPT_SEED, str(seed)
         )
 
     async def read_attempt_score(self, question_id: str, attempt_id: str) -> ScoreModel:
-        path = self._attempt_path(question_id, attempt_id)
+        path = self._get_attempt_path(question_id, attempt_id)
         try:
             score_json = await self._read_state_file(path, self.StateFilename.ATTEMPT_SCORE)
         except FileNotFoundError as err:
@@ -189,11 +191,11 @@ async def read_attempt_score(self, question_id: str, attempt_id: str) -> ScoreMo
     async def write_attempt_score(self, question_id: str, attempt_id: str, score: ScoreModel) -> None:
         score_json = TypeAdapter(ScoreModel).dump_json(score).decode()
         await self._write_state_file(
-            self._attempt_path(question_id, attempt_id), self.StateFilename.ATTEMPT_SCORE, score_json
+            self._get_attempt_path(question_id, attempt_id), self.StateFilename.ATTEMPT_SCORE, score_json
         )
 
     async def read_attempt_data(self, question_id: str, attempt_id: str) -> dict[str, JsonValue]:
-        path = self._attempt_path(question_id, attempt_id)
+        path = self._get_attempt_path(question_id, attempt_id)
         try:
             attempt_data_json = await self._read_state_file(path, self.StateFilename.ATTEMPT_DATA)
         except FileNotFoundError as err:
@@ -201,14 +203,14 @@ async def read_attempt_data(self, question_id: str, attempt_id: str) -> dict[str
         return json.loads(attempt_data_json)
 
     async def write_attempt_data(self, question_id: str, attempt_id: str, data: dict[str, JsonValue]) -> None:
-        path = self._attempt_path(question_id, attempt_id)
+        path = self._get_attempt_path(question_id, attempt_id)
         await self._write_state_file(path, self.StateFilename.ATTEMPT_DATA, json.dumps(data))
 
     async def delete_attempt(self, question_id: str, attempt_id: str) -> None:
         await asyncio.to_thread(self._delete_attempt_data_sync, question_id, attempt_id)
 
     def _delete_attempt_data_sync(self, question_id: str, attempt_id: str) -> None:
-        attempt_path = self._attempt_path(question_id, attempt_id)
+        attempt_path = self._get_attempt_path(question_id, attempt_id)
         if not attempt_path.exists():
             raise webserver_errors.MissingAttemptStateError
         for fname in (
@@ -232,8 +234,19 @@ def _write_state_file() -> None:
 
         await asyncio.to_thread(_write_state_file)
 
-    def _question_path(self, question_id: str) -> Path:
+    def _get_question_path(self, question_id: str) -> Path:
         return self._package_state_dir / question_id
 
-    def _attempt_path(self, question_id: str, attempt_id: str) -> Path:
-        return self._question_path(question_id) / attempt_id
+    def _get_attempt_path(self, question_id: str, attempt_id: str) -> Path:
+        return self._get_question_path(question_id) / attempt_id
+
+    def _get_question_state_paths(self) -> list[Path]:
+        try:
+            return [p for p in self._package_state_dir.iterdir() if self._is_id_dir(p)]
+        except FileNotFoundError:
+            # Package dir might not have been created yet
+            return []
+
+    @staticmethod
+    def _is_id_dir(path: Path) -> bool:
+        return path.is_dir() and bool(re.match(ID_RE, path.name))
diff --git a/tests/questionpy_sdk/webserver/routes/test_question.py b/tests/questionpy_sdk/webserver/routes/test_question.py
index 82c63611..b51640d1 100644
--- a/tests/questionpy_sdk/webserver/routes/test_question.py
+++ b/tests/questionpy_sdk/webserver/routes/test_question.py
@@ -40,6 +40,13 @@ async def test_get_questions(client: TestClient, mock_controller: AsyncMock) ->
         assert data == {"myuQ2JWl": {}, "xTXbLYfl": {}}
 
 
+@pytest.mark.app_routes(routes)
+async def test_delete_questions(client: TestClient, mock_controller: AsyncMock) -> None:
+    async with client.delete("/questions") as resp:
+        assert resp.status == HTTPOk.status_code
+    mock_controller.delete_all_questions.assert_awaited_once()
+
+
 @pytest.mark.app_routes(routes)
 async def test_get_question_state(client: TestClient, mock_controller: AsyncMock) -> None:
     mock_controller.get_options_state.return_value = {"foo": "bar"}
diff --git a/tests/questionpy_sdk/webserver/test_state.py b/tests/questionpy_sdk/webserver/test_state.py
index 20ab2cae..e93616bd 100644
--- a/tests/questionpy_sdk/webserver/test_state.py
+++ b/tests/questionpy_sdk/webserver/test_state.py
@@ -53,6 +53,19 @@ async def test_delete_question(state_manager: StateManager, tmp_path: Path) -> N
     assert not (tmp_path / "myuQ2JWl").exists()
 
 
+async def test_delete_all_questions(state_manager: StateManager, tmp_path: Path) -> None:
+    await state_manager.write_question_state("myuQ2JWl", "data1")
+    await state_manager.write_attempt_state("myuQ2JWl", "UY9ryXzq", "attempt data")
+    await state_manager.write_question_state("nYKEjBaA", "data2")
+    await state_manager.write_question_state("5YfGRyRs", "data3")
+
+    await state_manager.delete_all_questions()
+
+    assert not (tmp_path / "myuQ2JWl").exists()
+    assert not (tmp_path / "nYKEjBaA").exists()
+    assert not (tmp_path / "5YfGRyRs").exists()
+
+
 async def test_delete_question_leaves_other_files(state_manager: StateManager, tmp_path: Path) -> None:
     await state_manager.write_question_state("myuQ2JWl", "data")
     (tmp_path / "myuQ2JWl" / "some_file").touch()

From eb1cbd68e9749b0861146d8d2fa428aaf4924fdc Mon Sep 17 00:00:00 2001
From: Mirko Dietrich <dietrich@math.tu-berlin.de>
Date: Thu, 2 Oct 2025 15:32:16 +0200
Subject: [PATCH 3/5] feat: allow `InvalidQuestionStateError` for individual
 questions in question list

---
 .../components/common/error/ErrorDisplay.vue  |  1 -
 .../error/InvalidQuestionStateError.vue       | 10 ++++-----
 .../src/components/question/QuestionCard.vue  | 14 ++++++++++---
 .../src/components/question/QuestionList.vue  |  7 +++++--
 .../src/pages/question/[questionId]/index.vue |  2 +-
 frontend/src/queries/question.ts              | 10 +++++++--
 generate-ts-types.py                          |  2 +-
 .../controllers/question/controller.py        | 18 ++++++++++------
 questionpy_sdk/webserver/errors.py            | 21 +++++++++++++++++++
 questionpy_sdk/webserver/middlewares/error.py | 21 +++----------------
 questionpy_sdk/webserver/routes/question.py   |  3 ++-
 .../controllers/question/test_controller.py   | 10 +++++++--
 12 files changed, 77 insertions(+), 42 deletions(-)

diff --git a/frontend/src/components/common/error/ErrorDisplay.vue b/frontend/src/components/common/error/ErrorDisplay.vue
index 20c37ba8..fd065b82 100644
--- a/frontend/src/components/common/error/ErrorDisplay.vue
+++ b/frontend/src/components/common/error/ErrorDisplay.vue
@@ -6,7 +6,6 @@
 
 <template>
     <h5>{{ fetchError.message }} ({{ fetchError.status }}: {{ fetchError.statusText }})</h5>
-    <InvalidQuestionStateError v-if="fetchError.message === 'InvalidQuestionStateError'" />
     <h6>Stacktrace</h6>
     <code v-if="typeof fetchError.details === 'string'">
         <pre>{{ fetchError.details }}</pre>
diff --git a/frontend/src/components/common/error/InvalidQuestionStateError.vue b/frontend/src/components/common/error/InvalidQuestionStateError.vue
index c5efeb2a..af6ed902 100644
--- a/frontend/src/components/common/error/InvalidQuestionStateError.vue
+++ b/frontend/src/components/common/error/InvalidQuestionStateError.vue
@@ -8,12 +8,12 @@
     <BAlert :model-value="true" variant="warning">
         The package could not parse one or more question states. If you renamed or added required fields, delete the
         existing states and create a new question. Otherwise, this may be a bug in the package.
+        <ButtonGroup>
+            <IconButton @click="deleteQuestionStates" :icon-component="IMdiDelete" variant="danger" size="sm"
+                >Delete question states</IconButton
+            ></ButtonGroup
+        >
     </BAlert>
-    <ButtonGroup>
-        <IconButton @click="deleteQuestionStates" :icon-component="IMdiDelete" variant="danger" size="sm"
-            >Delete question states</IconButton
-        ></ButtonGroup
-    >
 </template>
 
 <script lang="ts" setup>
diff --git a/frontend/src/components/question/QuestionCard.vue b/frontend/src/components/question/QuestionCard.vue
index d694461a..d4d985ad 100644
--- a/frontend/src/components/question/QuestionCard.vue
+++ b/frontend/src/components/question/QuestionCard.vue
@@ -8,7 +8,14 @@
     <BCard :variant="cardVariant">
         <BCardText>
             <!-- TODO: Show Question -->
-            <pre>{{ formData }}</pre>
+            <CollapsibleCard v-if="isDetailedServerError(data)" variant="danger">
+                <template #button-title>{{ data.error }}</template>
+                <p>The package could not parse the question state.</p>
+                <code>
+                    <pre>{{ data.details }}</pre>
+                </code>
+            </CollapsibleCard>
+            <pre v-else>{{ data }}</pre>
         </BCardText>
         <ButtonGroup>
             <!-- TODO: Implement clone -->
@@ -49,11 +56,12 @@ import { useLink } from 'vue-router'
 
 import { useDeleteQuestion } from '@/composables/question'
 import useAppStateStore from '@/stores/useAppStateStore'
-import type { OptionsFormData } from '@/types'
+import { isDetailedServerError } from '@/types'
+import type { DetailedServerError, OptionsFormData } from '@/types'
 
 const { questionId } = defineProps<{
     questionId: string
-    formData: OptionsFormData
+    data: OptionsFormData | DetailedServerError
 }>()
 
 const questionLocation = { name: 'question', params: { questionId } } as const
diff --git a/frontend/src/components/question/QuestionList.vue b/frontend/src/components/question/QuestionList.vue
index 71041daf..31ec4a9f 100644
--- a/frontend/src/components/question/QuestionList.vue
+++ b/frontend/src/components/question/QuestionList.vue
@@ -9,13 +9,14 @@
     <ErrorCard v-if="error" :error="error" />
     <CollapsibleCard v-else expanded>
         <template #button-title>Saved questions ({{ questionCount }})</template>
+        <InvalidQuestionStateError v-if="hasInvalidStates" class="mb-3" />
         <QuestionCard
-            v-for="[questionId, formData] in Object.entries(questions)"
+            v-for="[questionId, data] in Object.entries(questions)"
             class="question-card"
             :id="`question-${questionId}`"
             :key="questionId"
             :questionId="questionId"
-            :formData="formData"
+            :data="data"
         />
         <BAlert v-if="questionCount === 0" :model-value="true" class="mb-0" variant="info"
             >This package has no questions yet.</BAlert
@@ -27,11 +28,13 @@
 import { computed } from 'vue'
 
 import { useQuestionStatesQuery } from '@/queries'
+import { isDetailedServerError } from '@/types'
 
 const { asyncStatus, error, data } = useQuestionStatesQuery()
 
 const questions = computed(() => data.value ?? {})
 const questionCount = computed(() => Object.keys(questions.value).length)
+const hasInvalidStates = computed(() => Object.values(questions.value).some(isDetailedServerError))
 </script>
 
 <style lang="scss" scoped>
diff --git a/frontend/src/pages/question/[questionId]/index.vue b/frontend/src/pages/question/[questionId]/index.vue
index b5613a57..dd988fd6 100644
--- a/frontend/src/pages/question/[questionId]/index.vue
+++ b/frontend/src/pages/question/[questionId]/index.vue
@@ -8,7 +8,7 @@
     <IconButton :to="{ name: 'index' }" :icon-component="IMdiArrowLeft" class="ps-0 mb-2" variant="link"
         >Back to Package Preview</IconButton
     >
-    <QuestionCard class="mb-3" :question-id="params.questionId" :form-data="formData?.data ?? {}" />
+    <QuestionCard class="mb-3" :question-id="params.questionId" :data="formData?.data ?? {}" />
     <ButtonGroup class="mb-4">
         <IconButton :icon-component="IMdiImport" variant="link" @click="importAttempt">Import attempt</IconButton>
         <IconButton :icon-component="IMdiAdd" @click="createAttempt" variant="primary">New attempt</IconButton>
diff --git a/frontend/src/queries/question.ts b/frontend/src/queries/question.ts
index 059a0879..b86bcabf 100644
--- a/frontend/src/queries/question.ts
+++ b/frontend/src/queries/question.ts
@@ -6,7 +6,13 @@
 
 import { useMutation, useQuery, useQueryCache } from '@pinia/colada'
 
-import type { OptionsFormData, OptionsFormDefinition, OptionsStateResponse, ServerValidationErrors } from '@/types'
+import type {
+    DetailedServerError,
+    OptionsFormData,
+    OptionsFormDefinition,
+    OptionsStateResponse,
+    ServerValidationErrors,
+} from '@/types'
 
 import { delete_, get, post } from './fetch'
 import QUERY_KEYS from './queryKeys'
@@ -19,7 +25,7 @@ import QUERY_KEYS from './queryKeys'
 const useQuestionStatesQuery = () =>
     useQuery({
         key: QUERY_KEYS.question.list(),
-        query: () => get<Record<string, OptionsFormData>>('questions'),
+        query: () => get<Record<string, OptionsFormData | DetailedServerError>>('questions'),
     })
 
 /**
diff --git a/generate-ts-types.py b/generate-ts-types.py
index 9d3b96d2..a3dd0ff4 100755
--- a/generate-ts-types.py
+++ b/generate-ts-types.py
@@ -20,7 +20,7 @@
 from questionpy_sdk.webserver.controllers.attempt.errors import ErrorSectionKey
 from questionpy_sdk.webserver.controllers.attempt.question_ui import ClientQuestionDisplayOptions
 from questionpy_sdk.webserver.controllers.question.controller import OptionsStateResponse
-from questionpy_sdk.webserver.middlewares.error import DetailedServerError
+from questionpy_sdk.webserver.errors import DetailedServerError
 
 logging.basicConfig(level=logging.INFO, format="")
 logger = logging.getLogger(__name__)
diff --git a/questionpy_sdk/webserver/controllers/question/controller.py b/questionpy_sdk/webserver/controllers/question/controller.py
index ae30ea58..1f717bb8 100644
--- a/questionpy_sdk/webserver/controllers/question/controller.py
+++ b/questionpy_sdk/webserver/controllers/question/controller.py
@@ -5,11 +5,12 @@
 from pydantic import ConfigDict
 from pydantic.dataclasses import dataclass
 
+from questionpy_common.api.qtype import InvalidQuestionStateError
 from questionpy_common.elements import OptionsFormDefinition
 from questionpy_sdk.webserver.constants import DEFAULT_REQUEST_INFO
 from questionpy_sdk.webserver.controllers.base import BaseController
 from questionpy_sdk.webserver.controllers.question._form_data import OptionsFormData, flatten_form_data, parse_form_data
-from questionpy_sdk.webserver.errors import MissingQuestionStateError
+from questionpy_sdk.webserver.errors import DetailedServerError, MissingQuestionStateError, format_error
 
 
 @dataclass(config=ConfigDict(use_attribute_docstrings=True))
@@ -35,17 +36,22 @@ async def get_form_definition(self, question_id: str) -> OptionsFormDefinition:
 
         return form_definition
 
-    async def get_questions(self) -> dict[str, OptionsFormData]:
+    async def get_questions(self) -> dict[str, OptionsFormData | DetailedServerError]:
         states_str = await self._state_manager.read_question_states()
-        states: dict[str, OptionsFormData] = {}
+        states: dict[str, OptionsFormData | DetailedServerError] = {}
 
         if len(states_str) > 0:
             async with self.get_worker() as worker:
                 for question_id in states_str:
                     state = states_str[question_id]
-                    form_definition, form_data = await worker.get_options_form(DEFAULT_REQUEST_INFO, state)
-                    flat_form_data = flatten_form_data(form_data, self._section_names_from_definition(form_definition))
-                    states[question_id] = flat_form_data
+                    try:
+                        form_definition, form_data = await worker.get_options_form(DEFAULT_REQUEST_INFO, state)
+                    except InvalidQuestionStateError as err:
+                        states[question_id] = DetailedServerError(type(err).__name__, format_error(err))
+                    else:
+                        section_names = self._section_names_from_definition(form_definition)
+                        flat_form_data = flatten_form_data(form_data, section_names)
+                        states[question_id] = flat_form_data
 
         return states
 
diff --git a/questionpy_sdk/webserver/errors.py b/questionpy_sdk/webserver/errors.py
index f9c7d848..2bdb44d0 100644
--- a/questionpy_sdk/webserver/errors.py
+++ b/questionpy_sdk/webserver/errors.py
@@ -2,6 +2,12 @@
 #  The QuestionPy SDK is free software released under terms of the MIT license. See LICENSE.md.
 #  (c) Technische Universität Berlin, innoCampus <info@isis.tu-berlin.de>
 
+import traceback
+
+from pydantic import ConfigDict
+from pydantic.dataclasses import dataclass
+from pydantic_core import ErrorDetails
+
 
 class MissingStateError(Exception):
     message: str
@@ -28,3 +34,18 @@ class MissingAttemptScoreError(MissingStateError):
 
 class MissingAttemptDataError(MissingStateError):
     message = "The attempt data is missing."
+
+
+@dataclass(config=ConfigDict(use_attribute_docstrings=True))
+class DetailedServerError:
+    """Represents a server-side error serialized for client display."""
+
+    error: str
+    """The name of the exception."""
+
+    details: str | list[ErrorDetails] | None = None
+    """Optional detailed error information, which may include a stack trace or Pydantic validation errors."""
+
+
+def format_error(err: Exception) -> str:
+    return "".join(traceback.format_exception(err))
diff --git a/questionpy_sdk/webserver/middlewares/error.py b/questionpy_sdk/webserver/middlewares/error.py
index 6def0573..89f457c6 100644
--- a/questionpy_sdk/webserver/middlewares/error.py
+++ b/questionpy_sdk/webserver/middlewares/error.py
@@ -3,31 +3,16 @@
 #  (c) Technische Universität Berlin, innoCampus <info@isis.tu-berlin.de>
 
 import logging
-import traceback
 
 from aiohttp import web
 from aiohttp.typedefs import Handler
 from aiohttp.web_exceptions import HTTPBadRequest, HTTPInternalServerError
-from pydantic import ConfigDict, RootModel, ValidationError
-from pydantic.dataclasses import dataclass
+from pydantic import RootModel, ValidationError
 from pydantic_core import ErrorDetails
 
-log = logging.getLogger("questionpy-sdk:web-server")
-
-
-@dataclass(config=ConfigDict(use_attribute_docstrings=True))
-class DetailedServerError:
-    """Represents a server-side error serialized for client display."""
-
-    error: str
-    """The name of the exception."""
+from questionpy_sdk.webserver.errors import DetailedServerError, format_error
 
-    details: str | list[ErrorDetails] | None = None
-    """Optional detailed error information, which may include a stack trace or Pydantic validation errors."""
-
-
-def format_error(err: Exception) -> str:
-    return "".join(traceback.format_exception(err))
+log = logging.getLogger("questionpy-sdk:web-server")
 
 
 def dump_detailed_server_error_text(exc: Exception, details: str | list[ErrorDetails] | None = None) -> str:
diff --git a/questionpy_sdk/webserver/routes/question.py b/questionpy_sdk/webserver/routes/question.py
index 0c622552..c74f848a 100644
--- a/questionpy_sdk/webserver/routes/question.py
+++ b/questionpy_sdk/webserver/routes/question.py
@@ -42,7 +42,8 @@ async def delete(self) -> web.Response:
 class QuestionListView(QuestionBaseView):
     async def get(self) -> web.Response:
         """Gets a list of all saved questions for the current package."""
-        return web.json_response(await self.controller.get_questions())
+        data = await self.controller.get_questions()
+        return self.json_model_response(RootModel(data))
 
     async def delete(self) -> web.Response:
         """Deletes all questions and its attempts from the state storage."""
diff --git a/tests/questionpy_sdk/webserver/controllers/question/test_controller.py b/tests/questionpy_sdk/webserver/controllers/question/test_controller.py
index ba92f7dc..94a79647 100644
--- a/tests/questionpy_sdk/webserver/controllers/question/test_controller.py
+++ b/tests/questionpy_sdk/webserver/controllers/question/test_controller.py
@@ -41,8 +41,14 @@ async def test_get_questions(
     )
     questions = await controller.get_questions()
 
-    assert questions["svyhZCg8"]["general[foo]"] == "Bar"
-    assert questions["tKVJTdsv"]["general[foo]"] == "Bar"
+    question_1 = questions["svyhZCg8"]
+    assert isinstance(question_1, dict)
+    assert question_1["general[foo]"] == "Bar"
+
+    question_2 = questions["tKVJTdsv"]
+    assert isinstance(question_2, dict)
+    assert question_2["general[foo]"] == "Bar"
+
     assert len(questions) == 2
 
 

From 15ed674e85f34e371471cdbcd6ecc7c974255011 Mon Sep 17 00:00:00 2001
From: Mirko Dietrich <dietrich@math.tu-berlin.de>
Date: Thu, 2 Oct 2025 16:31:17 +0200
Subject: [PATCH 4/5] feat: show error on question page

---
 .../src/components/question/QuestionCard.vue  | 13 ++++++------
 .../src/components/question/QuestionList.vue  | 20 +++++++++++++++----
 .../src/pages/question/[questionId]/index.vue | 15 ++++++++++----
 3 files changed, 34 insertions(+), 14 deletions(-)

diff --git a/frontend/src/components/question/QuestionCard.vue b/frontend/src/components/question/QuestionCard.vue
index d4d985ad..9f9c66df 100644
--- a/frontend/src/components/question/QuestionCard.vue
+++ b/frontend/src/components/question/QuestionCard.vue
@@ -8,14 +8,14 @@
     <BCard :variant="cardVariant">
         <BCardText>
             <!-- TODO: Show Question -->
-            <CollapsibleCard v-if="isDetailedServerError(data)" variant="danger">
-                <template #button-title>{{ data.error }}</template>
+            <CollapsibleCard v-if="isDetailedServerError(error)" variant="danger">
+                <template #button-title>{{ error.error }}</template>
                 <p>The package could not parse the question state.</p>
                 <code>
-                    <pre>{{ data.details }}</pre>
+                    <pre>{{ error.details }}</pre>
                 </code>
             </CollapsibleCard>
-            <pre v-else>{{ data }}</pre>
+            <pre v-if="data">{{ data }}</pre>
         </BCardText>
         <ButtonGroup>
             <!-- TODO: Implement clone -->
@@ -59,9 +59,10 @@ import useAppStateStore from '@/stores/useAppStateStore'
 import { isDetailedServerError } from '@/types'
 import type { DetailedServerError, OptionsFormData } from '@/types'
 
-const { questionId } = defineProps<{
+const { data, questionId } = defineProps<{
     questionId: string
-    data: OptionsFormData | DetailedServerError
+    data?: OptionsFormData
+    error?: DetailedServerError
 }>()
 
 const questionLocation = { name: 'question', params: { questionId } } as const
diff --git a/frontend/src/components/question/QuestionList.vue b/frontend/src/components/question/QuestionList.vue
index 31ec4a9f..d1771e36 100644
--- a/frontend/src/components/question/QuestionList.vue
+++ b/frontend/src/components/question/QuestionList.vue
@@ -11,12 +11,13 @@
         <template #button-title>Saved questions ({{ questionCount }})</template>
         <InvalidQuestionStateError v-if="hasInvalidStates" class="mb-3" />
         <QuestionCard
-            v-for="[questionId, data] in Object.entries(questions)"
+            v-for="[questionId, question] in Object.entries(questions)"
             class="question-card"
             :id="`question-${questionId}`"
             :key="questionId"
             :questionId="questionId"
-            :data="data"
+            :data="question.data"
+            :error="question.error"
         />
         <BAlert v-if="questionCount === 0" :model-value="true" class="mb-0" variant="info"
             >This package has no questions yet.</BAlert
@@ -29,12 +30,23 @@ import { computed } from 'vue'
 
 import { useQuestionStatesQuery } from '@/queries'
 import { isDetailedServerError } from '@/types'
+import type { DetailedServerError, OptionsFormData } from '@/types'
 
 const { asyncStatus, error, data } = useQuestionStatesQuery()
 
-const questions = computed(() => data.value ?? {})
+const questions = computed<Record<string, { data?: OptionsFormData; error?: DetailedServerError }>>(() => {
+    if (data.value === undefined) {
+        return {}
+    }
+    const entries = Object.entries(data.value).map(([questionId, value]) => [
+        questionId,
+        isDetailedServerError(value) ? { data: undefined, error: value } : { data: value, error: undefined },
+    ])
+    return Object.fromEntries(entries)
+})
+
 const questionCount = computed(() => Object.keys(questions.value).length)
-const hasInvalidStates = computed(() => Object.values(questions.value).some(isDetailedServerError))
+const hasInvalidStates = computed(() => Object.values(questions.value).some((q) => q.error))
 </script>
 
 <style lang="scss" scoped>
diff --git a/frontend/src/pages/question/[questionId]/index.vue b/frontend/src/pages/question/[questionId]/index.vue
index dd988fd6..4b47e9db 100644
--- a/frontend/src/pages/question/[questionId]/index.vue
+++ b/frontend/src/pages/question/[questionId]/index.vue
@@ -8,7 +8,7 @@
     <IconButton :to="{ name: 'index' }" :icon-component="IMdiArrowLeft" class="ps-0 mb-2" variant="link"
         >Back to Package Preview</IconButton
     >
-    <QuestionCard class="mb-3" :question-id="params.questionId" :data="formData?.data ?? {}" />
+    <QuestionCard class="mb-3" :question-id="params.questionId" :data="formData?.data" :error="detailedServerError" />
     <ButtonGroup class="mb-4">
         <IconButton :icon-component="IMdiImport" variant="link" @click="importAttempt">Import attempt</IconButton>
         <IconButton :icon-component="IMdiAdd" @click="createAttempt" variant="primary">New attempt</IconButton>
@@ -20,15 +20,16 @@
 import IMdiAdd from '~icons/mdi/add'
 import IMdiArrowLeft from '~icons/mdi/arrow-left'
 import IMdiImport from '~icons/mdi/import'
-import { watch } from 'vue'
+import { computed, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 
 import { useCreateAttempt } from '@/composables/attempt'
-import { useOptionsFormDataQuery } from '@/queries'
+import { FetchError, useOptionsFormDataQuery } from '@/queries'
+import type { DetailedServerError } from '@/types'
 
 const route = useRouter()
 const { params } = useRoute('question')
-const { data: formData } = useOptionsFormDataQuery(params.questionId)
+const { data: formData, error } = useOptionsFormDataQuery(params.questionId)
 const createAttempt = useCreateAttempt(params.questionId)
 
 // If question doesn't exist, show index instead
@@ -45,6 +46,12 @@ watch(
 function importAttempt() {
     // TODO: import question
 }
+
+const detailedServerError = computed(() =>
+    error.value instanceof FetchError && error.value.message === 'InvalidQuestionStateError'
+        ? ({ error: error.value.message, details: error.value.details } satisfies DetailedServerError)
+        : undefined,
+)
 </script>
 
 <route lang="json">

From 3d3d891cf9fa0b198c51971e8529d7c809b2c0d3 Mon Sep 17 00:00:00 2001
From: Mirko Dietrich <dietrich@math.tu-berlin.de>
Date: Thu, 2 Oct 2025 17:52:02 +0200
Subject: [PATCH 5/5] fix(webserver): write attempt seed only after successful
 creation

---
 .../webserver/controllers/attempt/controller.py           | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/questionpy_sdk/webserver/controllers/attempt/controller.py b/questionpy_sdk/webserver/controllers/attempt/controller.py
index f8a37edf..5f4c2322 100644
--- a/questionpy_sdk/webserver/controllers/attempt/controller.py
+++ b/questionpy_sdk/webserver/controllers/attempt/controller.py
@@ -36,6 +36,7 @@ async def get_attempt(
         data: dict[str, JsonValue] | None = None
         state: str | None = None
         score: ScoreModel | None = None
+        new_seed: bool = False
 
         with contextlib.suppress(webserver_errors.MissingAttemptDataError):
             data = await self._state_manager.read_attempt_data(question_id, attempt_id)
@@ -47,12 +48,15 @@ async def get_attempt(
             seed = await self._state_manager.read_attempt_seed(question_id, attempt_id)
         except webserver_errors.MissingAttemptSeedError:
             seed = random.randint(0, 1000)
-            await self._state_manager.write_attempt_seed(question_id, attempt_id, seed)
+            new_seed = True
 
         async with self.get_worker() as worker:
             attempt, state = await self._get_or_start_attempt(question_id, attempt_id, state, data, score, worker)
             renderer = _AttemptRenderer(attempt, display_options, self.generate_api_url, worker)
-            return await renderer.render_ui(data, state, score, seed)
+            render_data = await renderer.render_ui(data, state, score, seed)
+            if new_seed:
+                await self._state_manager.write_attempt_seed(question_id, attempt_id, seed)
+            return render_data
 
     async def get_attempts(self, question_id: str) -> dict[str, AttemptData]:
         """Gets all saved attempts."""