cleanup: trim bookmark and realm list comments

This commit is contained in:
“Naeel”
2026-04-29 21:25:20 +04:00
parent 9b0a33f3c9
commit 95163da958
3 changed files with 56 additions and 22 deletions
+49
View File
@@ -558,3 +558,52 @@
### Вывод
Паттерн повторяется: в небольших list-resource можно безопасно удалять слой исторических и отладочных комментариев отдельными локальными коммитами без вмешательства в бизнес-логику.
## Обновление: выбран следующий mini-cleanup проход
Дата фиксации: 2026-04-29.
### Выбранные файлы
- `v1/resources/available_resource_realms.cfc`
- `v1/resources/bookmark_ls.cfc`
### Что планируется убрать
- закомментированные debug-возвраты и `cfdump`-хвосты
- старые временные комментарии рядом с `cftry` и helper-инициализацией
- закомментированные неиспользуемые строки и хвосты в `cfscript`
### Что в этот этап не входит
- изменение SQL-логики
- пересмотр бизнес-ограничений по `contragent_id`
- правка спорных комментариев, которые еще могут нести смысл бизнес-правил
### Результат этапа
Выполнен cleanup-проход по двум следующим ресурсам:
- `v1/resources/available_resource_realms.cfc`
- `v1/resources/bookmark_ls.cfc`
Что убрано:
- комментарии-рассуждения рядом с helper-инициализацией
- закомментированные debug-возвраты и `cfdump`-хвосты
- закомментированные неиспользуемые строки и временные следы в `cfscript`
- старые закомментированные альтернативы сортировки и выборки полей
Что оставлено специально:
- рабочая SQL-логика
- комментарий про общую букмарку, так как он still поясняет текущее бизнес-правило
- структура ответа и набор аргументов
### Проверка
Измененные файлы проверены на ошибки.
Результат:
- синтаксических ошибок в `v1/resources/available_resource_realms.cfc` не обнаружено
- синтаксических ошибок в `v1/resources/bookmark_ls.cfc` не обнаружено
### Вывод
Даже в чуть более длинных list-resource по-прежнему удается безопасно снимать debug/comment слой малыми независимыми коммитами, если не заходить в спорные бизнес-комментарии и не трогать логику запросов.