api-gateway: migrate YAML gen + provider core from deck-api (?endpoint=) to lk-api-gateway (REST paths)

- service_spec_gen: callAPI() auto-detects proxy vs REST mode by index.cfm presence
- core/client.go: buildURL() replaces all 4 ?endpoint= harcoded sites
- build-provider.sh: -ldflags -X main.version=${VERSION} for correct binary version
- 01_generate_yamls.sh (devops + root): Python auto-detect proxy vs REST
- 02_generate_resources_and_docs_v2.sh: pass -api-endpoint to doc generators
- 04_build_and_publish_docs.sh: normalize_api_endpoint without forced /index.cfm
- docs_template_gen + v2: -api-endpoint flag, hardcoded deck-api replaced
- provider.go (both): TODO(api-gateway) comments
- profiles/test/profile.env: NUBES_API_ENDPOINT -> lk-api-gateway-test
- HISTORY: 2026-07-02_api_gateway_migration.md

devops/02_generate_resources_and_docs_v2.sh

@@ -89,9 +89,20 @@ cp -R "$TMP_GEN_DIR/." "$GO_OUTPUT_DIR/"
 
 echo "Generating docs via template generator..."
 mkdir -p "$DOCS_DIR"
+
+# Determine API endpoint for doc examples.
+# Use NUBES_API_ENDPOINT from profile.env, fall back to production default.
+DOCS_API_ENDPOINT="${NUBES_API_ENDPOINT:-https://deck-api.ngcloud.ru/api/v1/index.cfm}"
+# If endpoint looks like new REST gateway (no index.cfm), keep as-is.
+# If it's old-style without index.cfm, append it for backward compat in docs.
+if [[ "$DOCS_API_ENDPOINT" != *"/index.cfm"* ]] && [[ "$DOCS_API_ENDPOINT" != *"/svc"* ]]; then
+  DOCS_API_ENDPOINT="${DOCS_API_ENDPOINT%/}/index.cfm"
+fi
+
 go run ./tools/docs_template_gen_v2 \
   -resources "$RESOURCES_YAML_DIR" \
   -docs "$DOCS_DIR" \
-  -services "$SERVICES_LIST_PATH"
+  -services "$SERVICES_LIST_PATH" \
+  -api-endpoint "$DOCS_API_ENDPOINT"
 
 echo "Resources and docs generated in template format."