feat: improve OpenAPI request contracts and examples (#418)

* feat: improve OpenAPI request contracts and examples

* fix: align AJV docs plugin typing

* fix: preserve runtime behavior for OpenAPI schemas

* fix: align medication OpenAPI body schema with app payloads

backend/src/routes/settings.ts

@@ -481,6 +481,33 @@ export async function settingsRoutes(app: FastifyInstance) {
 						shareScheduleTodayOnly: { type: "boolean" },
 						swapDashboardMainSections: { type: "boolean" },
 					},
+					example: {
+						emailEnabled: true,
+						notificationEmail: "daniel@example.com",
+						reminderDaysBefore: 7,
+						repeatDailyReminders: true,
+						lowStockDays: 14,
+						normalStockDays: 30,
+						highStockDays: 90,
+						shoutrrrEnabled: false,
+						shoutrrrUrl: "",
+						emailStockReminders: true,
+						emailIntakeReminders: true,
+						emailPrescriptionReminders: true,
+						shoutrrrStockReminders: false,
+						shoutrrrIntakeReminders: false,
+						shoutrrrPrescriptionReminders: false,
+						skipRemindersForTakenDoses: true,
+						repeatRemindersEnabled: true,
+						reminderRepeatIntervalMinutes: 30,
+						maxNaggingReminders: 5,
+						language: "en",
+						stockCalculationMode: "automatic",
+						shareStockStatus: true,
+						upcomingTodayOnly: false,
+						shareScheduleTodayOnly: false,
+						swapDashboardMainSections: false,
+					},
 				},
 				response: {
 					200: { type: "object", properties: { success: { type: "boolean" } } },
@@ -560,6 +587,9 @@ export async function settingsRoutes(app: FastifyInstance) {
 					properties: {
 						language: { type: "string", enum: ["en", "de"] },
 					},
+					example: {
+						language: "de",
+					},
 				},
 				response: {
 					200: { type: "object", properties: { success: { type: "boolean" } } },
@@ -607,6 +637,9 @@ export async function settingsRoutes(app: FastifyInstance) {
 					properties: {
 						email: { type: "string", format: "email" },
 					},
+					example: {
+						email: "daniel@example.com",
+					},
 				},
 				response: {
 					200: {
@@ -714,6 +747,9 @@ export async function settingsRoutes(app: FastifyInstance) {
 					properties: {
 						url: { type: "string" },
 					},
+					example: {
+						url: "ntfy://user:token@push.example.com/medassist",
+					},
 				},
 				response: {
 					200: {