# 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