diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d343440
--- /dev/null
+++ b/README.md
@@ -0,0 +1,55 @@
+# 🧪 Playwright UI & API Tests – SSAS
+
+Автоматизированный набор UI-тестов для веб-платформы **ssas.dev.rdcenter.ru**.  
+Реализован на [Playwright](https://playwright.dev/) с модульной архитектурой, использованием Page Object и централизованными тестовыми данными.
+
+---
+
+## 🚀 Быстрый старт
+
+### Установка зависимостей
+
+Убедись, что установлен [Node.js](https://nodejs.org/en/) (рекомендуемая версия: LTS). Затем установи зависимости:
+
+```bash
+npm install
+
+---
+
+Запуск всех тестов
+npx playwright test
+
+---
+
+Открытие HTML-отчёта
+npx playwright show-report
+
+---
+
+📁 Структура проекта
+.
+├── tests/                           # UI и API тесты, сгруппированные по разделам
+│   ├── login/                       # Авторизация: позитивные, негативные, UI, ссылки
+│   ├── recovery/                    # Восстановление пароля
+│   └── api/                         # (будущие) API тесты
+│
+├── page-objects/                   # Page Object модели
+│   ├── LoginPage.ts
+│   └── RecoverPage.ts
+│
+├── utils/                          # Тестовые данные, вспомогательные функции
+│   ├── test-data.ts
+│
+├── playwright.config.ts           # Конфигурация Playwright
+├── .env                            # Переменные окружения (не коммитится)
+├── .gitignore
+└── README.md
+
+---
+
+📌 Информация
+
+Разработка: smykov
+Система контроля версий: GitTea @ RDCenter
+Репозиторий: https://git.rdcenter.ru/smykov/playwright-tests
+Начало проекта: июнь 2025