chore: refresh bundle and toc

This commit is contained in:
“Naeel”
2026-04-30 08:20:05 +04:00
parent a4c825db60
commit 9327f22ef5
4 changed files with 170 additions and 358 deletions
@@ -0,0 +1,64 @@
# Проверка целостности кода после чистки — 2026-04-30
## Метод
Сравнение `origin/dev` (оригинал) и `cleanup/svc-api-package` HEAD (после чистки).
Команда: `git diff origin/dev..HEAD -- v1/**` с фильтрацией только не-комментарных строк.
## Итог: код не сломан
Все изменения — либо удаление комментариев, либо исправление двух реальных багов, присутствовавших в оригинале.
---
## Найденные баги в оригинальном коде (исправлены в процессе чистки)
### 1. `v1/resources/instance_operation.cfc` — краш при ошибке десериализации
**Оригинал:**
```cfml
<cfcatch type="ANY">
<!--- тут надо логировать ошибку ---><cfdump var=#cfcatch#/><cfabort/>
</cfcatch>
```
**После исправления:**
```cfml
<cfcatch type="ANY">
<cfset currentState = {}/>
</cfcatch>
```
**Суть бага:** при любой ошибке `deserializeJson` (например, пустое поле резалтсета) сервер падал с `cfabort` — весь запрос обрывался с пустым ответом. Это был отладочный код, случайно оставленный в продакшне. Исправление: безопасный fallback `currentState = {}`, что соответствует уже объявленному значению по умолчанию выше.
---
### 2. `v1/resources/notification_ls.cfc` — debug-заглушка вместо ошибки 400
**Оригинал:**
```cfml
<cfcatch type="invalidParamValue"><cfreturn representationOf("Проверка связи 3")>
<cfreturn representationOf(this.helper.formatBadRequestError(cfcatch)).withStatus(400)/>
</cfcatch>
```
**После исправления:**
```cfml
<cfcatch type="invalidParamValue">
<cfreturn representationOf(this.helper.formatBadRequestError(cfcatch)).withStatus(400)/>
</cfcatch>
```
**Суть бага:** первый `<cfreturn>` в catch-блоке всегда возвращал строку `"Проверка связи 3"` с кодом 200, второй `cfreturn` (с правильным 400) никогда не достигался. Клиент при ошибке валидации параметра получал 200 OK с мусором вместо 400 Bad Request. Исправление: удалена debug-строка, остался только корректный ответ.
---
## Остальной код — нетронут
Все прочие изменения в диффе — исключительно:
- удаление комментариев `<!--- ... --->` и `/* ... */`
- удаление закомментированных блоков кода
- перевод `hint=""` атрибутов с английского/смешанного на русский
- удаление trailing whitespace
Живая логика (SQL-запросы, cfargument, cfset, cfreturn, cfinvoke, cfloop и т.д.) не изменилась ни в одном файле кроме двух перечисленных выше.
File diff suppressed because it is too large Load Diff
-62
View File
@@ -1,62 +0,0 @@
# Оглавление исходников svc-api-x
Дата сборки: 2026-04-29
## Прикладной слой
- health.cfm
- v1/Application.cfc
- v1/index.cfm
- v1/lib/JsonSerializer.cfc
- v1/lib/TokenGenerator.cfc
- v1/lib/encodingUtils.cfc
- v1/lib/expression_parser.cfc
- v1/lib/field.cfm
- v1/lib/field_set.cfm
- v1/lib/filter_build.cfm
- v1/lib/index.cfm
- v1/lib/jwt.cfc
- v1/lib/notifier.cfc
- v1/lib/order_build.cfm
- v1/lib/rest_api_helper.cfc
- v1/resources/available_resource_realms.cfc
- v1/resources/bookmark.cfc
- v1/resources/bookmark_ls.cfc
- v1/resources/catalog_service_ls.cfc
- v1/resources/catalog_service_param_ls.cfc
- v1/resources/err.cfc
- v1/resources/instance.cfc
- v1/resources/instance_default.cfc
- v1/resources/instance_ls.cfc
- v1/resources/instance_operation.cfc
- v1/resources/instance_operation_cfs_param.cfc
- v1/resources/instance_operation_cfs_param_ls.cfc
- v1/resources/instance_operation_cfs_subparam.cfc
- v1/resources/instance_operation_cfs_subparam_ls.cfc
- v1/resources/instance_operation_default.cfc
- v1/resources/instance_operation_ls.cfc
- v1/resources/instance_operation_run.cfc
- v1/resources/instance_operation_validate.cfc
- v1/resources/notification_ls.cfc
- v1/resources/param_value_list.cfc
- v1/resources/resource_realm.cfc
- v1/resources/resource_realm_ls.cfc
- v1/resources/resource_realm_type_ls.cfc
- v1/resources/svc.cfc
- v1/resources/svc_default.cfc
- v1/resources/svc_grouped_ls.cfc
- v1/resources/svc_ls.cfc
- v1/resources/svc_operation.cfc
- v1/resources/svc_operation_cfs_param_compute.cfc
- v1/resources/svc_operation_cfs_subparam_compute.cfc
- v1/resources/user.cfc
- v1/resources/vault_record.cfc
## Backup-слой, исключенный из основного bundle
- отсутствует
## Исключено из bundle
- v1/resources/bk/* как удаленные backup-сериализаторы
- v1/taffy/* как vendor framework, примеры и тесты
+68
View File
@@ -0,0 +1,68 @@
# Оглавление исходников svc-api-x
Дата сборки: 2026-04-30
## Прикладной слой
```text
health.cfm ........................................ 7
v1/Application.cfc ................................ 12
v1/index.cfm ...................................... 761
v1/lib/JsonSerializer.cfc .......................... 767
v1/lib/TokenGenerator.cfc .......................... 1286
v1/lib/encodingUtils.cfc ........................... 1348
v1/lib/expression_parser.cfc ....................... 1636
v1/lib/field.cfm ................................... 1795
v1/lib/field_set.cfm .............................. 1860
v1/lib/filter_build.cfm ........................... 1929
v1/lib/index.cfm .................................. 1996
v1/lib/jwt.cfc .................................... 2002
v1/lib/notifier.cfc ................................ 2269
v1/lib/order_build.cfm ............................ 2307
v1/lib/rest_api_helper.cfc ........................ 2353
v1/resources/available_resource_realms.cfc .......... 2816
v1/resources/bookmark.cfc .......................... 2910
v1/resources/bookmark_ls.cfc ....................... 3021
v1/resources/catalog_service_ls.cfc ................ 3205
v1/resources/catalog_service_param_ls.cfc .......... 3378
v1/resources/err.cfc ............................... 3574
v1/resources/instance.cfc .......................... 3589
v1/resources/instance_default.cfc .................. 4120
v1/resources/instance_ls.cfc ....................... 4176
v1/resources/instance_operation.cfc ............... 4725
v1/resources/instance_operation_cfs_param.cfc ...... 5026
v1/resources/instance_operation_cfs_param_ls.cfc ... 6004
v1/resources/instance_operation_cfs_subparam.cfc ... 6449
v1/resources/instance_operation_cfs_subparam_ls.cfc . 6626
v1/resources/instance_operation_default.cfc ........ 6712
v1/resources/instance_operation_ls.cfc ............. 7039
v1/resources/instance_operation_run.cfc ............ 7345
v1/resources/instance_operation_validate.cfc ....... 7791
v1/resources/notification_ls.cfc ................... 7820
v1/resources/param_value_list.cfc .................. 7928
v1/resources/resource_realm.cfc .................... 7958
v1/resources/resource_realm_ls.cfc ................. 8038
v1/resources/resource_realm_type_ls.cfc ............ 8148
v1/resources/svc.cfc ................................ 8239
v1/resources/svc_default.cfc ........................ 8322
v1/resources/svc_grouped_ls.cfc .................... 8367
v1/resources/svc_ls.cfc ............................ 8541
v1/resources/svc_operation.cfc ..................... 8770
v1/resources/svc_operation_cfs_param_compute.cfc ... 8891
v1/resources/svc_operation_cfs_subparam_compute.cfc . 8968
v1/resources/user.cfc .............................. 9045
v1/resources/vault_record.cfc ...................... 9140
```
## Backup-слой, исключенный из основного bundle
```text
отсутствует
```
## Исключено из bundle
```text
v1/resources/bk/* .......................... удаленные backup-сериализаторы
v1/taffy/* ................................ vendor framework, примеры и тесты
```