miHAN Chat frontend test site
Expo / React Native Web SPA для проверки публичных пользовательских потоков HAN Chat.
Запуск
cp .env.example .env.local
npm install
npm run web
Проверки: npm test, npm run typecheck, npm run build:pwa, npm run test:e2e.
PWA
Иконки лежат в public/:
| Файл | Размер |
|---|---|
favicon.png |
32×32 |
icon-192.png |
192×192 |
icon-512.png |
512×512 |
apple-touch-icon.png |
180×180 |
Manifest: public/manifest.json. Корневой HTML: app/+html.tsx.
npm run build:pwa # export + service-worker.js (Workbox)
npm run serve # локальная проверка dist/
Chrome DevTools → Application → Manifest / Service Workers. API и /auth/ не кэшируются.
Production
npm run build:pwa создаёт dist/ с manifest, иконками и service-worker.js. Каталог монтируется в корневой nginx; отдельный frontend nginx не используется. Для SPA nginx должен применять try_files $uri /index.html, не кэшировать index.html, manifest.json, register-sw.js, service-worker.js и бессрочно кэшировать hashed assets.
Dockerfile собирает статический OCI-артефакт /dist без runtime-сервера:
docker build --target static \
--build-arg EXPO_PUBLIC_API_BASE_URL="${PUBLIC_WEB_URL}" \
--build-arg EXPO_PUBLIC_AUTH_BASE_URL="${PUBLIC_AUTH_URL}" \
--build-arg EXPO_PUBLIC_KEYCLOAK_REALM=han-chat \
--build-arg EXPO_PUBLIC_KEYCLOAK_CLIENT_ID=han-chat-frontend .
Во frontend разрешены только публичные URL, realm, client id и имя среды. Service tokens, S3 credentials и mock OTP code добавлять запрещено. На web refresh token хранится в browser storage с известным XSS-риском; production требует строгой CSP и отсутствия сторонних scripts.
WebSocket использует subprotocols han-chat-v1 и bearer.<JWT>. Они должны совпадать с реализацией api-backend. Query-token намеренно не используется.