баг-фикс завершён

docs/README.md

@@ -29,6 +29,7 @@
 
 - Docker и Docker Compose
 - Git
+- запущенный Caddy из `../сaddy-proxy/`
 
 ### Локальный запуск
 
@@ -41,13 +42,21 @@ cp .env.example .env
 # Укажите в .env POSTGRES_PASSWORD и случайный JWT_SECRET.
 # JWT_SECRET можно сгенерировать командой: openssl rand -base64 48
 
-# 3. Запустить все сервисы
+# 3. Один раз создать общую proxy-сеть и запустить Caddy
+docker network inspect proxy >/dev/null 2>&1 || docker network create proxy
+docker compose -f ../сaddy-proxy/compose.yaml up -d
+
+# 4. Запустить все сервисы Magistr
 docker compose up -d --build
 ```
 
-Compose сам создаёт внутреннюю сеть и именованный том PostgreSQL. После запуска приложение
-доступно по адресу **http://localhost:80**; если в `.env` задан другой `HTTP_PORT`, используйте
-его. Backend и PostgreSQL наружу не публикуются: `/api` проксируется frontend-контейнером.
+Compose создаёт внутреннюю сеть и именованный том PostgreSQL, а backend/frontend подключает
+к общей внешней сети `proxy`. Они не публикуют порты на хосте: Caddy принимает запросы на
+**https://localhost** (`http://localhost` перенаправляется на HTTPS), `/api` отправляет в
+backend, остальные пути — во frontend. PostgreSQL остаётся только во внутренней сети.
+
+Caddy использует локальный корневой сертификат. В CachyOS/Arch его можно добавить в
+системное хранилище командами из `STARTUP_GUIDE.md`; без этого браузер покажет предупреждение.
 
 **Учётные данные по умолчанию:**