Обновления документации по uv

airflow-greenplum/README.md

@@ -15,12 +15,12 @@
 Локальным окружением управляет [uv](https://docs.astral.sh/uv/) — он скачивает нужный Python и создаёт `.venv` на основе `pyproject.toml` / `uv.lock`.
 
 ```bash
-uv python install 3.11      # один раз загружаем CPython 3.11
-uv python pin 3.11          # фиксируем версию для проекта (.python-version)
-uv sync                     # создаём .venv и ставим dev-зависимости
+uv sync
 ```
 
-Можно короче: `make dev-setup`. После изменения зависимостей запустите `uv sync` (или `make dev-sync`).
+`uv sync` сам подтянет версию Python из `.python-version`/`pyproject.toml`, создаст `.venv` и установит зависимости. Для тех же действий можно использовать `make dev-sync`. Цель `make dev-setup` (или вручную `uv python install` + `uv python pin`) нужна только когда вы меняете версию Python или прогреваете кэш.
+
+> Если требуется «классическое» активированное окружение, после `uv sync` выполните `.\.venv\Scripts\Activate.ps1` в PowerShell или `source .venv/bin/activate` в Unix-терминале.
 
 Проверки и форматирование выполняем через uv:
 
@@ -30,6 +30,14 @@ make lint            # black/isort в режиме проверки
 make fmt             # автоформатирование black + isort
 ```
 
+### Быстрый старт с uv
+
+```bash
+uv sync
+uv run pytest -q
+uv run black --check airflow tests
+```
+
 > Не устанавливайте пакеты напрямую через `pip install --user ...`. Если что-то уже попало в user-site, удалите `pip uninstall <package>` и проверьте `pip list --user`.
 ---