diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1914074
--- /dev/null
+++ b/README.md
@@ -0,0 +1,29 @@
+# tfluceecrud — Lucee CRUD приложение
+
+CRUD-приложение на Lucee для работы с таблицей в PostgreSQL.
+
+## Структура
+
+- `Application.cfc` — конфигурация datasource из env vars (префикс `testds_`)
+- `index.cfm` — веб-интерфейс: список, добавить, редактировать, удалить
+
+## Переменные окружения (json_env)
+
+| Переменная | Назначение |
+|---|---|
+| `TABLE_NAME` | Имя таблицы (по умолчанию `check_point`) |
+| `testds_class` | JDBC-драйвер |
+| `testds_connectionString` | Строка подключения |
+| `testds_username` | Пользователь БД |
+| `testds_password` | Пароль БД |
+
+## Таблица
+
+```sql
+CREATE TABLE check_point (
+    id    SERIAL PRIMARY KEY,
+    value INTEGER NOT NULL
+);
+```
+
+Имя через `TABLE_NAME`.