Files
tf_provider/docs/20_discovery/name_to_uuid_mapping.md
T
Repinoid 2d8e435dd4 docs: пометить отменённый заход модификаторов как LEGACY + исправить ложные факты
- баннеры «ЛОЖНЫЙ ПУТЬ — ОТМЕНЕНО» на 4 файла HISTORY/OPUS/2026-09-22_modifier_* и docs/60_strategy/modifier_resources_ideology_and_specification.md
- vIPConfigure: replace-семантика, НЕ накопительная (по тесту docs/ORG_IP_MODIFIER_TEST_2026-09-22.md)
- обновлены ссылки на перенесённые материалы (docs/... -> NOTES/..., HOW_TO/...)
2026-09-24 07:51:25 +03:00

1.5 KiB

Name to UUID Mapping (Discovery)

Date: 2026-02-10 Branch: name-mapping

Goal: users supply UI names only; provider resolves names to UUID/ID internally in the core CRUD flow. Resource files must remain generated and template-like.

Architecture sources

  • docs/help/architecture-and-methods.md: universal core + CRUD flow, resources generated from YAML.
  • NOTES/30_analysis/ARCHITECTURE_NEW.md: core in universal_rebuild/internal/core, generated resources in internal/resources_gen, shared CRUD in crud.go.
  • docs/00_overview/ai_universal_provider_gen.md: core utilities include FindInstanceByDisplayName; resources generated from YAML.
  • docs/ai_universal_provider_gen.md: same architecture; core utilities include FindInstanceByDisplayName.

Mapping rule

  • Input: human-readable name as shown in UI (display_name).
  • Internal: resolve to instanceUid/UUID using core helper(s) and GetInstances list.
  • Resource code must not implement per-resource lookup logic; mapping happens in core/CRUD and is driven by YAML metadata.

Implications for generator

  • service_params_gen should capture refSvcId / param metadata when available.
  • tools/gen should use metadata to mark parameters that need name->UUID resolution.
  • CRUD layer should resolve names to UUIDs for any param flagged as refSvcId or dataType uuid (when input is not already a UUID).

Safety

  • Backward compatibility: if input already looks like UUID, do not re-resolve.
  • Use a single shared resolver in core; no per-resource code changes.