cleanup: trim bookmark and realm list comments
This commit is contained in:
@@ -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 слой малыми независимыми коммитами, если не заходить в спорные бизнес-комментарии и не трогать логику запросов.
|
||||
|
||||
Reference in New Issue
Block a user