cleanup: trim cfs param resource commentary

2026-04-29 21:42:19 +04:00
parent 7808083a08
commit 9cf8f5e9ce
3 changed files with 37 additions and 71 deletions
@@ -773,3 +773,31 @@
 Результат:
 - синтаксических ошибок в `v1/resources/notification_ls.cfc` не обнаружено
 - синтаксических ошибок в `v1/resources/instance_operation_default.cfc` не обнаружено
+
+## Обновление: выбран cleanup-проход по `instance_operation_cfs_param_ls.cfc`
+
+Дата фиксации: 2026-04-29.
+
+### Цель этапа
+
+- снять с большого файла верхний слой явных рассуждений и закомментированного кода
+- не вычищать насильно все технические пояснения за один проход
+- спорные смысловые комментарии при необходимости оставлять и учитывать через внешний список кандидатов
+
+### Результат этапа
+
+В `v1/resources/instance_operation_cfs_param_ls.cfc` удалены:
+- большой верхний блок авторских рассуждений про URI и контекст
+- закомментированные альтернативные поля и отладочные хвосты
+- часть комментариев-оценок вокруг helper-вызовов, уникальности и временных веток
+- закомментированные catch/debug-блоки, не участвующие в runtime
+
+Что оставлено:
+- технические комментарии, которые все еще объясняют ограничения валидации и semantics параметров
+- спорные пояснения, которые могут быть полезны при дальнейшей разборке файла
+
+### Проверка
+
+Измененный файл проверен на ошибки.
+Результат:
+- синтаксических ошибок в `v1/resources/instance_operation_cfs_param_ls.cfc` не обнаружено
@@ -53,12 +53,13 @@

 ### 4. `v1/resources/instance_operation_cfs_param_ls.cfc`

-Ожидаемо спорный файл для будущего этапа:
- содержит большой пласт рассуждений автора, предупреждений и объяснений по валидации, уникальности и доступу
+После частичной зачистки в файле все еще оставлены:
+- комментарии по смыслу валидации, уникальности и ограничениям параметров
+- часть пояснений к SQL-условиям и поведению проверок

 Почему вынесено заранее:
 - файл крупный и неоднозначный
 - лучше разбирать отдельным этапом, чем смешивать с обычной зачисткой компактных ресурсов

 Рекомендация:
- перед правкой сначала отделить чистый commented-out код от действительно полезных пояснений к ограничениям параметров
+- если потребуется более жесткая зачистка, пройтись по оставшимся поясняющим комментариям отдельно и удалить те, которые не нужны для понимания правил валидации