diff --git a/README.md b/README.md
new file mode 100644
index 0000000..399de27
--- /dev/null
+++ b/README.md
@@ -0,0 +1,36 @@
+# WeechatPayBot
+
+Telegram-бот для создания ссылок на оплату WeChat/Alipay через WATA. В составе проекта:
+
+- `tgbot` — aiogram-бот
+- `webapp` — FastAPI webhook-сервис
+- `postgredb` — PostgreSQL
+- `redisdb` — Redis
+
+## Запуск
+
+```bash
+cp bot/.env.example bot/.env
+docker compose up --build -d
+```
+
+## Обязательные переменные
+
+В `bot/.env` заполни:
+
+- `TOKEN`
+- `BASE_ADMIN`
+- `POSTGRES_PASSWORD`
+- `WATA_API_TOKEN`
+
+## Полезно
+
+- Локальный healthcheck: `http://127.0.0.1:8000/health`
+- Webhook WATA: `POST /webhooks/wata`
+- Для локального теста без реальной WATA можно поставить `WATA_API_TOKEN=mock`
+
+## Остановка
+
+```bash
+docker compose down
+```