diff --git a/Makefile b/Makefile
new file mode 100644
index 0000000..65eb0da
--- /dev/null
+++ b/Makefile
@@ -0,0 +1,17 @@
+all: build run-services migrate up
+
+build:
+ @echo "Сборка образов..."
+ docker-compose build
+
+run-services:
+ @echo "Запуск сервисов..."
+ docker-compose up -d db redis backend
+
+migrate:
+ @echo "Применение миграций..."
+ docker-compose exec backend alembic upgrade head
+
+up:
+ @echo "Запуск всех сервисов..."
+ docker-compose up -d
\ No newline at end of file
diff --git a/README.md b/README.md
index 09dfbf1..4f68912 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,138 @@
-# Derbit Client
+
-Клиент каждую минуту забирает с биржи текущую цену btc_usd и eth_usd (index price валюты) после чего сохраняет в базу данных тикер валюты, текущую цену и время в UNIX timestamp
+## Derbit Client
+
+Клиент для криптобиржи Deribit
+
+[](https://github.com/dmsnback/derbit_client/actions/workflows/main.yml)
+[](https://github.com/dmsnback/derbit_client/actions/workflows/main.yml)
+[](https://github.com/dmsnback/derbit_client/actions/workflows/main.yml)
+
+
+- [Описание](#Описание)
+- [Технологии](#Технологии)
+- [Тестирование](#Тестирование)
+- [Таблица эндпоинтов](#Таблица)
+- [Шаблон заполнения .env-файла](#Шаблон)
+- [Запуск проекта на локальной машине](#Запуск)
+- [Автор](#Автор)
+
+
+
+### Описание
+
+Асинхронный клиент для криптобиржи Deribit.
+Сервис периодически получает ```index price``` BTC_USD и ETH_USD,
+сохраняет данные в базу тикер валюты, текущую цену и время в ```UNIX timestamp```.
+
+Приложение написано с использованием **асинхронного FastAPI**, **SQLAlchemy**, **PostgreSQL**, **Celery** и **Redis**.
+
+В проекте настроен **CI/CD pipeline** с использованием **GitHub Actions**:
+
+```md
+- Автоматическая проверка кода (black, isort, flake8)
+- Запуск unit-тестов (`pytest`)
+- Сборка Docker-образа
+- Публикация образа в **Docker Hub** при пуше в соответствующие ветки
+```
+
+```md
+Проект адаптирован для использования **PostgreSQL** и развёртывания в контейнерах **Docker**.
+```
+
+> [Вернуться в начало](#Начало)
+
+
+
+### Технологии
+
+[](https://www.python.org)
+[](https://fastapi.tiangolo.com)
+[](https://docs.celeryq.dev/en/stable/index.html)
+[](https://redis-docs.ru)
+[](https://github.com/aio-libs/aiohttp?ysclid=mkqid6e88x702921033)
+[](https://www.sqlalchemy.org)
+[](https://docs.pydantic.dev/latest/)
+[](https://www.docker.com)
+[](https://www.postgresql.org)
+[](https://docs.pytest.org/en/stable/index.htmlc)
+[](https://github.com/features/actions)
+
+> [Вернуться в начало](#Начало)
+
+
+
+### Тестирование
+
+В проекте реализованы **unit-тесты** с использованием `pytest` и `pytest-asyncio`.
+
+- Тестируется CRUD-логика работы с ценами
+- Асинхронные операции с базой данных
+- Для тестов используется изолированная база данных (SQLite)
+
+Запуск тестов локально:
+
+```python
+pytest -v
+```
+
+> [Вернуться в начало](#Начало)
+
+
+
+### Таблица эндпоинтов
+
+**Prices**
+
+|Метод|URL|Описание|
+|:-:|:-:|:-:|
+|GET|/all/{ticker}|Получение всех сохраненных данных по указанной валюте|
+|GET|/latest/{ticker}|Получение последней цены валюты|
+|GET|/filter_by_date/{ticker}|Получение цены валюты с фильтром по дате|
+
+> [Вернуться в начало](#Начало)
+
+
+
+### Шаблон заполнения .env-файла
+
+> `env.example` с дефолтнными значениями расположен в корневой папке
+
+```python
+POSTGRES_DB = derbit_db # Имя базы дданнных
+POSTGRES_USER = postgres # Имя юзера PostgreSQL
+POSTGRES_PASSWORD = yourpassword # Пароль юзера PostgreSQL
+DATABASE_URL = postgresql+asyncpg://postgres:yourpassword@db:5432/derbit_db # Указываем адрес БД
+```
+
+> [Вернуться в начало](#Начало)
+
+
+
+### Запуск проекта на локальной машине
+
+- Склонируйте репозиторий
+
+```python
+git clone git@github.com:dmsnback/derbit_client.git
+```
+
+- Запускаем проект в **Docker**
+
+```python
+make all
+```
+
+- Документация к API станет доступна по адресу:
+
+[http://localhost:8000/docs/](http://localhost:8000/docs/)
+
+> [Вернуться в начало](#Начало)
+
+
+
+### Автор
+
+- [Титенков Дмитрий](https://github.com/dmsnback)
+
+> [Вернуться в начало](#Начало)
diff --git a/env.example b/env.example
new file mode 100644
index 0000000..370301b
--- /dev/null
+++ b/env.example
@@ -0,0 +1,7 @@
+DATABASE_URL=postgresql+asyncpg://postgres:postgres@db:5432/derbit_db
+
+POSTGRES_DB = derbit_db
+POSTGRES_USER = postgres
+POSTGRES_PASSWORD = postgres
+POSTGRES_HOST=db
+POSTGRES_PORT=5432
\ No newline at end of file