dev-стенд: 0.0.0.0:9011, vite host:true, гейт ключа только по 401-зонду

- docker-compose.dev.yml: ports 127.0.0.1:9011:80 → 9011:80 (вход по LAN-IP хоста)
- vite.config.ts: server.host=true — dev-сервер тоже на все интерфейсы
- api.ts: probeApiKey() — GET /api/v1/convert (POST-only эндпоинт): 401 от
  ApiKeyFilter ⟺ сервер требует ключ; при выключенной аутентификации не 401
- App.tsx: экран ApiKeyGate показывается только когда зонд вернул 'required';
  401 на конвертации возвращает к гейту (setGate('required'))
- AGENTS.md: обновлены поведенческие строки (dev-вход, контракт гейта)
This commit is contained in:
Pjandro
2026-10-16 22:11:53 +00:00
parent e925242948
commit 2750486c91
5 changed files with 47 additions and 11 deletions
+22
View File
@@ -70,3 +70,25 @@ export async function convertDocx(
const blob = await resp.blob()
return { blob, filename }
}
/**
* Требует ли сервер ключ: GET /api/v1/convert (эндпоинт POST-only) —
* 401 пишет ApiKeyFilter при требуемом и непринятом ключе; при выключенной
* аутентификации (dev) до фильтра дело не доходит — 405 от Spring.
* Сетевая ошибка — 'open': не блокировать UI, конвертация сама покажет ошибку.
*/
export async function probeApiKey(): Promise<'open' | 'required'> {
const key = getApiKey()
try {
const resp = await fetch(`${import.meta.env.BASE_URL}api/v1/convert`, {
headers: key ? { 'X-API-Key': key } : undefined,
})
if (resp.status === 401) {
clearApiKey() // ключ устарел/отозван — форма откроется пустой
return 'required'
}
return 'open'
} catch {
return 'open'
}
}
+18 -6
View File
@@ -1,5 +1,5 @@
import { useEffect, useRef, useState } from 'react'
import { ApiError, convertDocx, getApiKey, setApiKey, UnauthorizedError } from '../api'
import { ApiError, convertDocx, probeApiKey, setApiKey, UnauthorizedError } from '../api'
import ApiKeyGate from './ApiKeyGate'
import DropZone from './DropZone'
import Logo from './Logo'
@@ -47,8 +47,11 @@ export default function App() {
if (on) setRenderSmartArt(false)
}
// ключ в localStorage: публичная статика, в бандл зашивать нельзя
const [apiKey, setApiKeyValue] = useState<string | null>(() => getApiKey())
// экран ключа показываем только когда сервер реально требует ключ: зонд
// probeApiKey (GET /api/v1/convert → 401) решает до загрузки файла; в dev
// без ключа форма открывается сразу. Ключ лежит в localStorage (публичная
// статика, в бандл зашивать нельзя), читает его api.ts сам.
const [gate, setGate] = useState<'checking' | 'open' | 'required'>('checking')
const [keyError, setKeyError] = useState<string | null>(null)
// снимаем blob-URL предыдущего результата — иначе он течёт до закрытия вкладки
@@ -90,7 +93,7 @@ export default function App() {
// UnauthorizedError раньше ApiError: он её наследник; ключ уже
// очищен в api.ts — форма откроется пустой
if (e instanceof UnauthorizedError) {
setApiKeyValue(null)
setGate('required')
setKeyError('Ключ доступа не принят — введите заново')
setStatus('idle')
return
@@ -112,13 +115,22 @@ export default function App() {
[],
)
if (!apiKey)
useEffect(() => {
probeApiKey().then(setGate)
}, [])
// зонд — один быстрый same-origin запрос, спиннер не вводим
if (gate === 'checking') return null
if (gate === 'required')
return (
<ApiKeyGate
error={keyError}
onSubmit={(k) => {
setApiKey(k)
setApiKeyValue(k)
// повторный зонд не шлём: неверный ключ всплывёт 401 на первой
// конвертации (текущий контракт гейта)
setGate('open')
setKeyError(null)
// возврат после отзыва ключа не должен показать «Конвертация…»/старый результат
setStatus('idle')
+2
View File
@@ -9,6 +9,8 @@ export default defineConfig({
base: process.env.VITE_BASE ?? '/',
plugins: [react(), tailwindcss()],
server: {
// dev-сервер наружу: слушает все интерфейсы (LAN-доступ к стенду с других машин)
host: true,
// dev без CORS: запросы /api и документация (/swagger-ui*, /v3/api-docs*) идут на бэкенд через прокси
proxy: {
'/api': 'http://localhost:8080',