From b13d5544f2159187fcd569dec32889ec35210670 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Mon, 23 Feb 2026 20:08:34 +0400
Subject: [PATCH] Add Russian inline comments

---
 Application.cfc | 13 +++++++++++++
 README.md       |  7 +++++++
 index.cfm       |  1 +
 query.cfm       |  9 +++++++++
 4 files changed, 30 insertions(+)

diff --git a/Application.cfc b/Application.cfc
index 51e2487..0c3f4b3 100644
--- a/Application.cfc
+++ b/Application.cfc
@@ -1,10 +1,13 @@
 <cfcomponent displayname="Application" output="true">
+    <!--- Базовая конфигурация приложения и подключение JAR-клиента RabbitMQ. --->
     <cfset this.Name = "rabbit-lsd-ui" />
     <cfset this.sessionmanagement = "Yes" />
     <cfset this.datasource = "testds" />
     <cfset this.javaSettings = { loadPaths = [ expandPath("./lib") ] } />
+    <!--- Инициализируем datasource из переменных окружения. --->
     <cfset getDS(this.datasource) />
 
+    <!--- Безопасное чтение переменной окружения с дефолтом. --->
     <cffunction name="getEnv" access="private" returntype="string">
         <cfargument name="key" type="string" required="true" />
         <cfargument name="def" type="string" required="true" />
@@ -14,6 +17,7 @@
         <cfreturn arguments.def />
     </cffunction>
 
+    <!--- Собираем datasource из набора *_field переменных окружения. --->
     <cffunction name="getDS" access="private" returntype="void">
         <cfargument name="dsname" type="string" required="true" />
         <cfset var system = createObject("java", "java.lang.System") />
@@ -25,6 +29,7 @@
         <cfset this.datasources[arguments.dsname] = ds />
     </cffunction>
 
+    <!--- Публикация CRUD-сообщения в RabbitMQ. --->
     <cffunction name="publishToRabbit" access="private" returntype="void">
         <cfargument name="payload" type="struct" required="true" />
         <cfset var host = getEnv("RABBIT_HOST", "") />
@@ -39,6 +44,7 @@
         <cfset var connection = "" />
         <cfset var channel = "" />
 
+        <!--- Не стартуем публикацию без базовых кредов. --->
         <cfif host EQ "" OR user EQ "" OR pass EQ "">
             <cfthrow message="Rabbit credentials are missing" />
         </cfif>
@@ -49,6 +55,7 @@
         <cfset factory.setPassword(pass) />
         <cfset factory.setVirtualHost(vhost) />
 
+        <!--- Подключаемся, объявляем очередь и отправляем JSON. --->
         <cftry>
             <cfset connection = factory.newConnection() />
             <cfset channel = connection.createChannel() />
@@ -66,6 +73,7 @@
         </cftry>
     </cffunction>
 
+    <!--- Основной обработчик запроса: подготовка БД, логов и POST-операций. --->
     <cffunction name="OnRequest" access="public" returntype="void" output="true">
         <cfargument name="template" type="string" required="true" />
         <cfset request.DS = this.datasource />
@@ -76,6 +84,7 @@
         <cfset request.rabbitPassword = getEnv("RABBIT_PASSWORD", "") />
         <cfset request.nodeworkerUrl = getEnv("NODEWORKER_URL", "") />
 
+        <!--- Гарантируем наличие основной таблицы сообщений. --->
         <cftry>
             <cfquery datasource="#request.DS#">
                 CREATE TABLE IF NOT EXISTS #request.tableName# (id SERIAL PRIMARY KEY, test_data TEXT, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP)
@@ -83,6 +92,7 @@
             <cfcatch><cfset request.db_error = cfcatch.message /></cfcatch>
         </cftry>
 
+        <!--- Гарантируем наличие таблицы лога UI и обновляем статусы. --->
         <cftry>
             <cfquery datasource="#request.DS#">
                 CREATE TABLE IF NOT EXISTS #request.logTableName# (
@@ -134,6 +144,7 @@
             <cfcatch><cfset request.db_error = cfcatch.message /></cfcatch>
         </cftry>
 
+        <!--- Обрабатываем POST CRUD и отправляем событие в очередь. --->
         <cfif CGI.REQUEST_METHOD EQ "POST" AND structKeyExists(form, "crud_action")>
             <cfset var action = lcase(form.crud_action) />
             <cfset var requestId = createUUID() />
@@ -141,6 +152,7 @@
             <cfset var logText = "" />
             <cfset var logTargetId = "" />
 
+            <!--- Формируем payload и лог для очереди. --->
             <cftry>
                 <cfswitch expression="#action#">
                     <cfcase value="insert">
@@ -171,6 +183,7 @@
                     </cfdefaultcase>
                 </cfswitch>
 
+                <!--- Публикуем сообщение и пишем запись в лог UI. --->
                 <cfset publishToRabbit(payload) />
                 <cfquery datasource="#request.DS#">
                     INSERT INTO #request.logTableName# (action, text, request_id, target_id, queued_at, status)
diff --git a/README.md b/README.md
index 751ae25..cf8802f 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,8 @@
 
 UI publishes CRUD actions to RabbitMQ and reads results from Postgres.
 
+Коротко: интерфейс пишет в RabbitMQ, а фактическое состояние берет из Postgres, чтобы показать разницу между "поставлено в очередь" и "исполнено".
+
 ## Behavior
 
 - Insert/Update/Delete actions are queued via RabbitMQ.
@@ -33,6 +35,11 @@ RabbitMQ (required):
 Optional:
 - `PG_TABLE` (default `rabbit_messages`)
 
+Optional:
+- `UI_LOG_TABLE` (default `rabbit_ui_log`) — таблица лога для статуса запросов UI.
+
 ## Notes
 
 This app uses RabbitMQ Java client JARs located in `lib/`.
+
+Комментарий: JAR-ы подключены через `this.javaSettings.loadPaths`, поэтому важно держать `lib/` рядом с приложением.
diff --git a/index.cfm b/index.cfm
index dc18a34..a865783 100644
--- a/index.cfm
+++ b/index.cfm
@@ -1 +1,2 @@
+<!--- Простой редирект на основной экран UI. --->
 <cflocation addtoken="No" url="query.cfm##q"/>
diff --git a/query.cfm b/query.cfm
index 99c6d72..5ca67dd 100644
--- a/query.cfm
+++ b/query.cfm
@@ -52,12 +52,14 @@
     </style>
 </head>
 <body>
+<!--- Сводный статус последней операции и базовые ссылки. --->
 <cfset status = {}>
 <cfset rabbitAdminUrl = request.rabbitAdminUrl>
 <cfset rabbitUser = request.rabbitUser>
 <cfset rabbitPassword = request.rabbitPassword>
 <cfset nodeworkerUrl = request.nodeworkerUrl>
 
+<!--- Лог последних событий из UI-очереди. --->
 <cfquery name="qLog" datasource="#request.DS#">
     SELECT id, action, text, request_id, target_id, queued_at, processed_at, status, error_reason
     FROM #request.logTableName#
@@ -65,6 +67,7 @@
     LIMIT 20
 </cfquery>
 
+<!--- Формируем сообщение статуса из лога/ошибок. --->
 <cfif structKeyExists(request, "queue_error")>
     <cfset status.type = "error">
     <cfset status.message = "Ошибка постановки в очередь: " & request.queue_error>
@@ -77,6 +80,7 @@
     </cfif>
 </cfif>
 
+<!--- Фиксированный заголовок Nubes. --->
 <div class="header-bg">
     <div class="container header-content">
         <img src="https://nubes.ru/themes/custom/nubes_2025/logo.svg" alt="Nubes" class="logo">
@@ -84,6 +88,7 @@
     </div>
 </div>
 <div class="container main-content">
+    <!--- Карточка с ссылками и кредами Rabbit/worker. --->
     <div class="card">
         <div class="top-info">
             <div>
@@ -111,6 +116,7 @@
         </div>
     </div>
 
+    <!--- Карточка действий CRUD. --->
     <div class="card">
         <cfif structKeyExists(request, "db_error")>
             <div class="alert alert-error">Ошибка базы данных: <cfoutput>#request.db_error#</cfoutput></div>
@@ -129,6 +135,7 @@
         <div class="small">💾 — сохранить (update), 🗑 — удалить</div>
     </div>
 
+    <!--- Две таблицы: очередь/лог и фактическая БД. --->
     <div class="split">
         <div class="card">
             <h3>Очередь (лог отправки)</h3>
@@ -166,11 +173,13 @@
 
         <div class="card wide">
             <h3>База (фактические записи)</h3>
+            <!--- Читаем последние фактические записи для сравнения с логом. --->
             <cfquery name="qGet" datasource="#request.DS#">SELECT * FROM #request.tableName# ORDER BY id DESC LIMIT 20</cfquery>
             <table class="tight">
                 <thead><tr><th class="col-id">ID</th><th class="col-content">Содержимое</th><th class="col-req">Request ID</th><th>Действия</th></tr></thead>
                 <tbody>
                     <cfoutput query="qGet">
+                    <!--- Отделяем request_id из хвоста строки. --->
                     <cfset reqMatch = reFindNoCase("\\[req:[0-9a-f-]+\\]$", test_data, 1, true)>
                     <cfset reqTag = reqMatch.pos[1] GT 0 ? mid(test_data, reqMatch.pos[1], reqMatch.len[1]) : "">
                     <cfset cleanText = reReplace(test_data, "(?i)\\s*\\[req:[0-9a-f-]+\\]$", "", "all")>