docs: clarify Polygon auth and API contracts

site/templates/swagger.html

@@ -86,11 +86,30 @@
         .swagger-ui .info .title {
             font-family: system-ui, -apple-system, sans-serif;
         }
+
+        .auth-help {
+            max-width: 1460px;
+            margin: 16px auto;
+            padding: 12px 16px;
+            background: #fff;
+            border: 1px solid #d1d5db;
+            color: #374151;
+            font: 14px/1.5 system-ui, sans-serif;
+        }
     </style>
 </head>
 
 <body>
 
+    <aside class="auth-help">
+        <strong>Токен для служебных запросов</strong>
+        <p>Если администратор настроил <code>MOCK_AUTH_TOKEN</code> в переменных окружения сервиса, нажмите
+            <strong>Authorize</strong> в Swagger, вставьте выданное вам значение в поле <code>X-Mock-Auth</code>
+            (Value) и подтвердите кнопкой <strong>Authorize</strong>. Токен выдаёт администратор; Swagger его не
+            показывает. Если защита не включена, авторизация не требуется.
+        </p>
+    </aside>
+
     <div id="swagger-ui"></div>
 
     <script src="https://cdn.jsdelivr.net/npm/swagger-ui-dist@5/swagger-ui-bundle.js" crossorigin></script>
@@ -123,12 +142,12 @@
                 if (link) {
                     link.innerHTML = '<img class="logo" src="{{ url_for("static", filename="logo.svg") }}" alt="Nubes">' +
                         '<span class="version-badge">polygon v{{ version }}</span>';
-                    link.href = "/";
+                    link.href = "{{ home_url }}";
                 }
                 // Добавляем ссылку «← На главную»
                 const navLink = document.createElement("a");
                 navLink.className = "nav-link";
-                navLink.href = "/";
+                navLink.href = "{{ home_url }}";
                 navLink.textContent = "← На главную";
                 topbar.appendChild(navLink);
             }