rebase

README.md

@@ -73,13 +73,15 @@ cp .env.example .env
 # Отредактируйте SECRET_KEY, ADMIN_SETUP_TOKEN, LLM_API_URL, LLM_API_KEY
 
 # 2. Поднять всё
-docker compose up -d
+docker compose up -d --build
 
-# 3. Зайти на http://localhost (frontend через nginx)
-# Или http://localhost:5173 (frontend dev) / http://localhost:8000/api/docs (backend)
+# 3. Открыть в браузере:
+#    - Frontend (nginx + React build):  http://localhost:8080
+#    - Backend Swagger docs:            http://localhost:8000/api/docs
+#    - Health-check:                    http://localhost:8000/api/health
 ```
 
-При первом старте сервер напечатает в лог:
+При первом старте backend напечатает в лог:
 ```
 === AI-RPG Admin Setup ===
 No admin user yet. Open this URL in your browser:
@@ -87,7 +89,11 @@ No admin user yet. Open this URL in your browser:
 ===========================
 ```
 
-Откройте `http://localhost/register/admin?token=<...>` и создайте первого админа.
+Посмотреть лог: `docker compose logs backend | head -20`.
+
+Откройте `http://localhost:8080/register/admin?token=<...>` и создайте первого админа.
+
+> **Примечание про LLM:** если у вас Ollama на хосте, используйте `LLM_API_URL=http://host.docker.internal:11434/v1` — backend-контейнер автоматически резолвит `host.docker.internal` через `extra_hosts: host-gateway` (работает на Linux/macOS/Windows).
 
 ### Опция 2: локальный dev (backend + frontend раздельно)