АРХ - NODEDC PLATFORM: запуск локального proxy/Authentik стенда

infra/README.md

@@ -16,6 +16,8 @@
 
 Authentik построен по актуальной официальной Docker Compose схеме 2026.2: PostgreSQL 16, server и worker. Redis для Authentik в этой версии официального compose не используется.
 
+Reverse proxy использует `PLATFORM_PROXY_IMAGE=nodedc/plane-proxy:ru`, потому что этот локальный образ уже содержит Caddy и не требует отдельного pull с Docker Hub. На чистой машине можно заменить значение на `caddy:2-alpine`.
+
 ## Expected files
 
 ```text
@@ -38,6 +40,8 @@ infra/
 127.0.0.1 task.local.nodedc
 ```
 
+This requires admin rights on macOS.
+
 2. Generate local secrets:
 
 ```bash
@@ -59,6 +63,25 @@ curl -I -H 'Host: auth.local.nodedc' http://127.0.0.1/
 
 Generated Authentik bootstrap credentials are stored only in `infra/.env`.
 
+## Current local status
+
+This stack was verified locally with `PLATFORM_PROXY_IMAGE=nodedc/plane-proxy:ru`:
+
+- `auth.local.nodedc` returns `302` to the Authentik authentication flow through Caddy;
+- `launcher.local.nodedc` returns `200` from the current Vite launcher through Caddy;
+- `task.local.nodedc` returns `200` from the current Plane runtime through Caddy;
+- Authentik server, Authentik worker and PostgreSQL report healthy in Docker Compose.
+
+Browser testing still requires `/etc/hosts` entries on the host machine.
+
+## Troubleshooting
+
+If Docker Hub pulls hang on `caddy:2-alpine`, keep `PLATFORM_PROXY_IMAGE=nodedc/plane-proxy:ru` on this workstation. If the local Plane proxy image is unavailable on a clean machine, set:
+
+```bash
+PLATFORM_PROXY_IMAGE=caddy:2-alpine
+```
+
 ## Current decision
 
 Текущий Plane runtime не переносится в compose платформы до backup и отдельного шага миграции.