Единый язык предметной области

Правила использования доменных терминов в коде, документации и UI. Полные определения терминов — в ../GLOSSARY.md. Этот документ про форму, а не про содержание.

Правила

1. Если термин присутствует в GLOSSARY.md, используйте его в канонической форме. Произвольные синонимы запрещены.
2. Каждый доменный термин имеет одно машинное имя (snake_case) — оно ниже в таблицах. Это имя используется в именах полей БД, ключах JSON, идентификаторах событий, конфиг-ключах.
3. Если в коде ProductCategory, а в документации “товарный класс” — это баг, откройте задачу.
4. Новые термины заводятся одновременно в GLOSSARY.md и в соответствующей секции ниже.

Машинные имена

Термин → snake_case идентификатор. Определения терминов — по ссылке в глоссарии.

Bounded Contexts и DDD

Термин	Машинное имя
Bounded Context	bounded_context
Context Map	context_map
Anti-Corruption Layer	acl
Published Language	pl
Open Host Service	ohs
Shared Kernel	shared_kernel
Domain Event	domain_event
Integration Event	integration_event
Aggregate	aggregate
Policy	policy

Каталог и товары

Термин	Машинное имя
Canonical Product	canonical_product
Identity Profile	identity_profile
Critical Attribute	critical_attribute
Identity Signature	identity_signature
Equivalence Class	equivalence_class
Lifecycle Status	lifecycle_status
Characteristic	characteristic
Unit	unit
Manufacturer	manufacturer
Manufacturer Alias	manufacturer_alias
Classification Tag	classification_tag
Raw Supplier Payload	raw_payload

Supplier Offers и наблюдения

Термин	Машинное имя
Supplier Offer	supplier_offer
Supplier Offer Observation	supplier_offer_observation
Match Confidence	match_confidence
Warehouse	warehouse
Warehouse Kind	warehouse_kind
Stock	stock
Stock Forecast	stock_forecast
Price Set	price_set
Price Kind	price_kind
Pricing Mode	pricing_mode
Sku Identity Pack	sku_identity_pack
Seller	seller
Seller Rating	seller_rating
Preferred Seller Policy	preferred_seller_policy
Identity Standard	identity_standard
Taxonomy Characteristic Mapping	taxonomy_characteristic_mapping
Taxonomy Class Mapping	taxonomy_class_mapping
External Identity	external_identity
Mapping Target	mapping_target
Multi-Currency Prices	multi_currency_prices
Price Validity Window	price_validity_window
Incremental Sync Cursor	incremental_sync_cursor
Master Key Token Exchange	master_key_token_exchange

Ценообразование

Термин	Машинное имя
Price Rule	price_rule
Pricing Context	pricing_context
Pricing Result	pricing_result
Customer Pricing Group	customer_pricing_group
Logistics Cost	logistics_cost
Custom Pricing Handler	custom_pricing_handler
Pricing Adjustment	pricing_adjustment
Observation Source	observation_source

Клиент

Термин	Машинное имя
Customer	customer
Customer Type	customer_type
Contract	contract
Auth Identity	auth_identity
Session	session
Session Context	session_context

Credentials

Термин	Машинное имя
Supplier Credential	supplier_credential
Credential Scope	credential_scope
Auth Schema	auth_schema
Credential Fingerprint	fingerprint
Supplier Credential Group	supplier_credential_group
Credential Context	credential_context

Сметы

Термин	Машинное имя
Estimate	estimate
Estimate Version	estimate_version
Estimate Line	estimate_line
Estimate Optimization	estimate_optimization
Optimization Mode	optimization_mode
Estimate Alternative	estimate_alternative
Estimate Explanation	estimate_explanation

Сеть поставщиков

Термин	Машинное имя
Supplier	supplier
Supplier Role	supplier_role
Supplier Relationship	supplier_relationship
Supply Chain Trace	supply_chain_trace
Trust Level	trust_level

Поступление данных

Термин	Машинное имя
Enrichment Job	enrichment_job
Job Kind	job_kind
Connector	connector

Видимость данных

Термин	Машинное имя
Data Visibility Policy	data_visibility_policy
Subject	subject
Target Kind	target_kind
Effect	effect

Модерация (AI)

Термин	Машинное имя
Moderation Queue	moderation_queue
Moderation Case	moderation_case
Case Kind	case_kind
Agent Runner	agent_runner
Agent Decision	agent_decision
Verdict	verdict
Proposed Action	proposed_action
Case Escalated	case_escalated
Attribute Alias	attribute_alias

Запрещённые термины

Термин	Вместо него
«Категория», category	classification_tag или identity_profile (category-agnostic дизайн)
«Товарная группа»	то же — classification_tag / identity_profile
SKU без контекста	canonical_product_id или supplier_sku (в зависимости от слоя)
product_category, category_id	те же замены

Связано

• ../GLOSSARY.md — полные определения терминов.
• domain-model.md — где термины применяются в доменной модели.
• ../50-processes/documentation-standard.md — требования к использованию терминов.