NODEDC_1C/docs/ADDRESS/address_query/semantic_layer_design.md

Semantic Layer Design (Address Query Foundation V1)

Дата: 2026-03-29

1) Layer components

• semanticEntityRegistry
• semanticAliasMap
• semanticResolvers
• semanticFilterCatalog
• addressRecipeCatalog

2) Entity registry (V1)

Источник: entity_map_1c_2020.md + run inventories.

P0 families:

• ACCOUNTING_REGISTER
• DOCUMENT
• DOCUMENT_JOURNAL
• NSI_CATALOG (contracts)
• CHART_OF_ACCOUNTS

3) Alias normalization

Задача: приводить бытовые формулировки к канонике.

Примеры:

• "дебиторка" -> receivables scope
• "кредиторка" -> payables scope
• "платежка" -> bank/payment docs
• "хвост" -> open items / residual balances

4) Resolver contracts

Каждый resolver возвращает:

• resolved_value
• resolved_ref
• confidence
• ambiguous_candidates[]

5) Filter catalog

Базовые фильтры:

• as_of_date
• period_from/period_to
• organization
• counterparty
• contract
• account
• document_type
• document_ref
• status
• limit/sort

6) Recipe binding

LLM выбирает только recipe_id из whitelist.

Никаких произвольных query generation.

7) Evolution path

V1:

• P0 entities + P0 intents

V1.1:

• расширенный resolver coverage
• richer decomposition
• P1 intents