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
+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')