From d2ed47801577a6f90802185dd114b75c2ac1b65d Mon Sep 17 00:00:00 2001
From: Dmitry Dementev <me@dementev.space>
Date: Sun, 14 Sep 2025 22:02:03 +0300
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D1=80=D0=B0=D0=B1=D0=BE=D1=82?=
 =?UTF-8?q?=D0=BA=D0=B8=20=D0=B8=D0=BD=D1=81=D1=82=D1=80=D1=83=D0=BA=D1=86?=
 =?UTF-8?q?=D0=B8=D0=B8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 postgres-bookings/README.md | 47 +++++++++++++++++--------------------
 1 file changed, 22 insertions(+), 25 deletions(-)

diff --git a/postgres-bookings/README.md b/postgres-bookings/README.md
index 7f90777..f37873c 100644
--- a/postgres-bookings/README.md
+++ b/postgres-bookings/README.md
@@ -18,32 +18,37 @@ docker compose version
 
 ---
 
-## Состав проекта (что у вас должно быть в папке)
+## Структура проекта
+
+> Важно: файлы 00_init.sql и 01_bookings.sql создаются скриптом download_db.sh и изначально отсутствуют.
+
 ```
 postgres-bookings/
 ├─ docker-compose.yml
+├─ download_db.sh       # скрипт скачивания и подготовки демо-БД
 ├─ .env                 # опционально: логин/пароль/порт
-├─ initdb/
-│   ├─ 00_init.sql      # создаёт БД demo (страхует первый запуск)
-│   └─ 01_bookings.sql  # скрипт с учебными данными
+├─ initdb/              # изначально пусто
 └─ psql_sh              # помощник: открыть psql внутри контейнера
 ```
-
-> Если нет файлов `initdb/00_init.sql` и `initdb/01_bookings.sql`, запустите скрипт ниже (раздел «Быстрый старт», шаг 1).
-
+После выполнения шага «Быстрый старт → п.1» в initdb/ появятся:
+```
+initdb/
+├─ 00_init.sql # создаёт БД demo (страхует первый запуск)
+└─ 01_bookings.sql # учебные данные Postgres Pro
+```
 ---
 
 ## Быстрый старт (Linux/macOS/WSL2)
-1) Подготовьте init‑скрипты (скачивание демо‑БД):
+1) Скачать и подготовить демо‑БД:
 ```bash
 bash download_db.sh
 chmod +x psql_sh
 ```
-2) Поднимите кластер:
+2) Запустить кластер:
 ```bash
 docker compose up -d
 ```
-3) Проверьте, что сервис готов (статус `healthy`) и подключайтесь:
+3) Проверить статус и подключиться к psql:
 ```bash
 docker compose ps
 ./psql_sh
@@ -53,22 +58,14 @@ docker compose ps
 \dt;
 SELECT COUNT(*) FROM bookings.flights;
 ```
-
-> **DBeaver:** Host `127.0.0.1`, Port `5432` (или ваш из `.env`), Database `demo`, User `postgres`, Password `postgres`, SSL — Off.
-
 ---
-
-## Как поменять порт/логин/пароль
-Создайте файл `.env` в корне проекта:
-```ini
-POSTGRES_USER=postgres
-POSTGRES_PASSWORD=postgres
-PG_PORT=5432
-```
-Перезапустите контейнеры:
-```bash
-docker compose down && docker compose up -d
-```
+## Подключение из DBeaver
+- Host: 127.0.0.1
+- Port: 5432 (или ваш из .env)
+- Database: demo
+- User: postgres
+- Password: postgres
+- SSL: Off
 
 ---