Bump version to 0.2.4, document SQL query mode, add Russian README

README.md

@@ -1,5 +1,7 @@
 # ⚠️ Deprecated ⚠️ OCCWeb terminal
 
+*Читать на [русском](README.ru.md).*
+
 ### A web terminal for admins to launch Nextcloud's occ commands
 
 ![occweb](https://github.com/Adphi/OCCWeb/raw/main/appinfo/screenshot.png)
@@ -14,6 +16,19 @@ As nextcloudd has no native support for asynchronous operations, due to the use
 
 Place this app in **nextcloud/apps/**
 
+## SQL query mode
+
+Type `sql` in the terminal to switch into SQL query mode and run raw SQL
+statements directly against the Nextcloud database (admin only). Separate
+statements with `;`. Use **Shift+Enter** to add a new line and **Enter** to
+run the whole block in a single request — this matters for scripts like
+`SET vars.x = 'value'; SELECT current_setting('vars.x');`, since every
+statement in one submission runs on the same database connection/session.
+Type `occ` to switch back to the normal occ-command mode.
+
+⚠️ There is no undo for `DELETE`/`UPDATE` statements — double check what
+you are about to run, ideally against a non-critical row/user first.
+
 ## ⚠️ Warnings ⚠️
 
 - The application is not a real interactive terminal and does not support long running tasks. 

README.ru.md

@@ -0,0 +1,51 @@
+# ⚠️ Устарело ⚠️ OCCWeb terminal
+
+*Read in [English](README.md).*
+
+### Веб-терминал для администраторов для запуска occ-команд Nextcloud
+
+![occweb](https://github.com/Adphi/OCCWeb/raw/main/appinfo/screenshot.png)
+
+
+## ⚠️ Устарело ⚠️
+
+Поскольку Nextcloud не имеет встроенной поддержки асинхронных операций
+(из-за использования PHP), это приложение считается устаревшим и больше не
+будет поддерживать будущие версии Nextcloud (19+). Автору не удалось найти
+способ реализовать полноценную поддержку интерактивных и долгих occ-задач в
+веб-терминале без введения дополнительных зависимостей (например, через
+websockets), а отсутствие настоящей асинхронности может привести к серьёзным
+проблемам на больших инсталляциях.
+[Этот issue](https://github.com/nextcloud/server/issues/16726) объясняет,
+почему разработчик решил больше не поддерживать это приложение.
+
+
+## Установка
+
+Поместите это приложение в **nextcloud/apps/**
+
+## Режим SQL-запросов
+
+Введите `sql` в терминале, чтобы переключиться в режим SQL-запросов и
+выполнять произвольные SQL-запросы напрямую к базе данных Nextcloud (только
+для администраторов). Запросы разделяются `;`. Используйте **Shift+Enter**
+для перехода на новую строку и **Enter**, чтобы отправить весь блок одним
+запросом — это важно для скриптов вида
+`SET vars.x = 'value'; SELECT current_setting('vars.x');`, так как все
+запросы, отправленные одним блоком, выполняются в рамках одного соединения
+(сессии) с базой данных. Введите `occ`, чтобы вернуться в обычный режим
+occ-команд.
+
+⚠️ Для `DELETE`/`UPDATE` нет отмены — внимательно проверяйте, что вы
+собираетесь выполнить, желательно сначала на некритичной записи/пользователе.
+
+## ⚠️ Предупреждения ⚠️
+
+- Это приложение не является настоящим интерактивным терминалом и не
+  поддерживает долгие задачи.
+  Поэтому на крупных инсталляциях команды вроде `occ files:scan` могут
+  завершаться по таймауту с ошибкой.
+- Не используйте `occ maintenance:mode --on`, это очевидно...
+
+## Планы (TODO):
+См. [открытые issues](https://github.com/Adphi/occweb/issues)

appinfo/info.xml

@@ -5,7 +5,7 @@
     <name>OCC Web</name>
     <summary>OCC Commands in a web terminal</summary>
     <description><![CDATA[Run OCC Commands in a web terminal]]></description>
-    <version>0.2.3</version>
+    <version>0.2.4</version>
     <licence>agpl</licence>
     <author mail="adphi.apps@gmail.com" >Adphi</author>
     <namespace>OCCWeb</namespace>