From f90cc36ebd9fa1977e0657208352fc54f4beaf0f Mon Sep 17 00:00:00 2001
From: "alexei.dolgolyov" <dolgolyov.alexei@gmail.com>
Date: Tue, 24 Mar 2026 16:00:22 +0300
Subject: [PATCH] feat: add API docs link button in sidebar footer

Opens Swagger UI (/docs) in a new tab. Proxies /docs and /openapi.json
in dev mode so the link works from the Vite dev server.
---
 frontend/src/lib/i18n/en.json      |  1 +
 frontend/src/lib/i18n/ru.json      |  1 +
 frontend/src/routes/+layout.svelte | 31 +++++++++++++++++-------------
 frontend/vite.config.ts            |  4 +++-
 4 files changed, 23 insertions(+), 14 deletions(-)

diff --git a/frontend/src/lib/i18n/en.json b/frontend/src/lib/i18n/en.json
index e808847..ddb8ad7 100644
--- a/frontend/src/lib/i18n/en.json
+++ b/frontend/src/lib/i18n/en.json
@@ -806,6 +806,7 @@
 		"headersInvalid": "Invalid JSON",
 		"language": "Language",
 		"theme": "Theme",
+		"apiDocs": "API Docs",
 		"light": "Light",
 		"dark": "Dark",
 		"system": "System",
diff --git a/frontend/src/lib/i18n/ru.json b/frontend/src/lib/i18n/ru.json
index dff4bc0..cd48bef 100644
--- a/frontend/src/lib/i18n/ru.json
+++ b/frontend/src/lib/i18n/ru.json
@@ -806,6 +806,7 @@
 		"headersInvalid": "Невалидный JSON",
 		"language": "Язык",
 		"theme": "Тема",
+		"apiDocs": "API Docs",
 		"light": "Светлая",
 		"dark": "Тёмная",
 		"system": "Системная",
diff --git a/frontend/src/routes/+layout.svelte b/frontend/src/routes/+layout.svelte
index 00ddcd7..2a20224 100644
--- a/frontend/src/routes/+layout.svelte
+++ b/frontend/src/routes/+layout.svelte
@@ -354,19 +354,6 @@
 				</button>
 			</div>
 
-			<!-- Search button -->
-			<div class="{collapsed ? 'px-2 py-1.5' : 'px-3 py-1.5'}" style="border-bottom: 1px solid var(--color-border);">
-				<button onclick={() => openSearch?.()}
-					class="search-btn flex items-center gap-2 w-full {collapsed ? 'justify-center px-2' : 'px-2.5'} py-1.5 rounded-lg text-sm transition-all duration-200"
-					title={t('searchPalette.placeholder')}>
-					<MdiIcon name="mdiMagnify" size={16} />
-					{#if !collapsed}
-						<span class="flex-1 text-left text-xs">{t('searchPalette.placeholder')}</span>
-						<kbd class="text-[0.6rem] font-mono px-1 py-0.5 rounded" style="background: var(--color-background); border: 1px solid var(--color-border);">{isMac ? '⌘' : 'Ctrl '}K</kbd>
-					{/if}
-				</button>
-			</div>
-
 			<!-- Global provider filter -->
 			{#if allProviders.length > 1}
 				<div class="{collapsed ? 'px-2 py-1' : 'px-3 py-1.5'}" style="border-bottom: 1px solid var(--color-border);">
@@ -386,6 +373,19 @@
 				</div>
 			{/if}
 
+			<!-- Search button -->
+			<div class="{collapsed ? 'px-2 py-1.5' : 'px-3 py-1.5'}" style="border-bottom: 1px solid var(--color-border);">
+				<button onclick={() => openSearch?.()}
+					class="search-btn flex items-center gap-2 w-full {collapsed ? 'justify-center px-2' : 'px-2.5'} py-1.5 rounded-lg text-sm transition-all duration-200"
+					title={t('searchPalette.placeholder')}>
+					<MdiIcon name="mdiMagnify" size={16} />
+					{#if !collapsed}
+						<span class="flex-1 text-left text-xs">{t('searchPalette.placeholder')}</span>
+						<kbd class="text-[0.6rem] font-mono px-1 py-0.5 rounded" style="background: var(--color-background); border: 1px solid var(--color-border);">{isMac ? '⌘' : 'Ctrl '}K</kbd>
+					{/if}
+				</button>
+			</div>
+
 			<!-- Nav -->
 			<nav class="flex-1 p-2 space-y-0.5 overflow-y-auto">
 				{#each navEntries as entry}
@@ -463,6 +463,11 @@
 						title={t('common.theme')}>
 						<MdiIcon name={theme.resolved === 'dark' ? 'mdiWeatherNight' : theme.current === 'system' ? 'mdiDesktopTowerMonitor' : 'mdiWeatherSunny'} size={14} />
 					</button>
+					<a href="/docs" target="_blank" rel="noopener noreferrer"
+						class="footer-pill flex items-center justify-center {collapsed ? 'w-8 h-8' : 'px-2.5 py-1'} rounded-lg text-xs transition-all duration-200"
+						title={t('common.apiDocs')}>
+						<MdiIcon name="mdiApi" size={14} />
+					</a>
 				</div>
 
 				<!-- User info -->
diff --git a/frontend/vite.config.ts b/frontend/vite.config.ts
index 2c44af1..929eaf7 100644
--- a/frontend/vite.config.ts
+++ b/frontend/vite.config.ts
@@ -6,7 +6,9 @@ export default defineConfig({
 	plugins: [tailwindcss(), sveltekit()],
 	server: {
 		proxy: {
-			'/api': 'http://localhost:8420'
+			'/api': 'http://localhost:8420',
+			'/docs': 'http://localhost:8420',
+			'/openapi.json': 'http://localhost:8420'
 		}
 	}
 });