SILVER
/
NODEDC_1C
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
NODEDC_1C/docs/ADDRESS/address_query/address_scenario_matrix.md

7.0 KiB
Raw Blame History

Address Scenario Matrix (V1)

Дата: 2026-04-02
Режим: question_mode=address_query (отдельно от deep-analysis)

Scope

Этот сценарный слой покрывает direct factual lookup без causal/proof reasoning:

  • списки документов/операций;
  • агрегатные срезы остатков/взаиморасчетов;
  • drilldown до документов по счету.

Не покрывается в V1:

  • причинно-следственный анализ ("почему", "докажи", root-cause);
  • многошаговый multi-intent execution для составных вопросов;
  • свободный query builder вне whitelist recipe.

Matrix (актуально по коду)

scenario_id Пользовательский вопрос intent required_filters (runtime) optional_filters target_entity_family recipe_id (runtime) expected_response_type (runtime) priority
AQ-P0-01 Какие договоры не закрыты на текущую дату? list_open_contracts - as_of_date, organization, limit ACCOUNTING_REGISTER, DOCUMENT, NSI_CATALOG address_open_contracts_candidates_v1 FACTUAL_LIST P0
AQ-P0-02 Кому мы должны денег на сегодня? list_payables_counterparties - as_of_date, counterparty, contract, limit ACCOUNTING_REGISTER address_movements_payables_v1 FACTUAL_LIST P0
AQ-P0-03 Кто должен нам денег на сегодня? list_receivables_counterparties - as_of_date, counterparty, contract, limit ACCOUNTING_REGISTER address_movements_receivables_v1 FACTUAL_LIST P0
AQ-P0-04 Какой остаток по счету 60 на дату? account_balance_snapshot account (as_of_date defaulted) as_of_date, period_from, period_to, limit ACCOUNTING_REGISTER, CHART_OF_ACCOUNTS address_movements_account_snapshot_v1 FACTUAL_SUMMARY P0
AQ-P0-05 Какие хвосты висят по контрагенту/договору? open_items_by_counterparty_or_contract counterparty OR contract as_of_date, counterparty, contract, limit ACCOUNTING_REGISTER, DOCUMENT address_open_items_by_party_or_contract_v1 FACTUAL_LIST P0
AQ-P0-06 Покажи документы по контрагенту X list_documents_by_counterparty counterparty period_from, period_to, as_of_date, organization, limit, sort DOCUMENT, DOCUMENT_JOURNAL, ACCOUNTING_REGISTER address_documents_by_counterparty_v1 FACTUAL_LIST P0
AQ-P0-07 Покажи банковские операции по контрагенту X bank_operations_by_counterparty counterparty period_from, period_to, as_of_date, organization, limit, sort DOCUMENT, DOCUMENT_JOURNAL, ACCOUNTING_REGISTER address_bank_operations_by_counterparty_v1 FACTUAL_LIST P0
AQ-P0-08 Покажи документы по договору Y list_documents_by_contract contract period_from, period_to, as_of_date, organization, counterparty, limit, sort DOCUMENT, DOCUMENT_JOURNAL, ACCOUNTING_REGISTER, NSI_CATALOG address_documents_by_contract_v1 FACTUAL_LIST P0
AQ-P0-08B Покажи банковские операции по договору Y bank_operations_by_contract contract period_from, period_to, as_of_date, organization, counterparty, limit, sort DOCUMENT, DOCUMENT_JOURNAL, ACCOUNTING_REGISTER, NSI_CATALOG address_bank_operations_by_contract_v1 FACTUAL_LIST P0
AQ-P0-09 Какие документы формируют остаток по счету 62? documents_forming_balance account + as_of_date (as_of_date defaulted) organization, counterparty, contract, period_from, period_to, limit, sort ACCOUNTING_REGISTER, DOCUMENT address_documents_forming_balance_v1 FACTUAL_LIST P0
AQ-B1-10 За какие годы/месяцы в базе есть активность? period_coverage_profile - period_from, period_to, organization, limit ACCOUNTING_REGISTER address_period_coverage_profile_v1 FACTUAL_SUMMARY B1
AQ-B1-11 Какие типы документов чаще всего и какие разделы учета заполнены/пустые? document_type_and_account_section_profile - period_from, period_to, organization, limit ACCOUNTING_REGISTER, DOCUMENT address_document_type_and_account_section_profile_v1 FACTUAL_SUMMARY B1
AQ-P1-10 Дай обороты по счету 51 за период account_turnover_snapshot account, period_from, period_to organization, counterparty, limit ACCOUNTING_REGISTER, DOCUMENT - (not implemented) LIMITED_WITH_REASON P1
AQ-P1-11 Дай список документов по типу за период list_documents_by_type document_type, period_from, period_to organization, counterparty, contract, limit DOCUMENT, DOCUMENT_JOURNAL - (not implemented) LIMITED_WITH_REASON P1
AQ-P2-12 Покажи технические константы конфигурации unsupported_for_v1 - - CONSTANT - LIMITED_WITH_REASON P2

Runtime rules (актуально по коду)

  • Если mode распознан как address_query, ответ строится через whitelist recipe + MCP live path.
  • Если shape=EXPLAIN_OR_REASON, запрос не идет в address lane (handoff в deep-analysis).
  • Если обязательные фильтры не извлечены, возвращается LIMITED_WITH_REASON с limited_reason_category=missing_anchor.
  • Для account_balance_snapshot и documents_forming_balance:
    • as_of_date берется из period_to, если период задан;
    • иначе default на текущую дату runtime.
  • Для documents/bank by counterparty|contract период по умолчанию не форсируется (all-time), с runtime лимитами и fallback-логикой.
  • COMPOUND_FACTUAL_QUERY пока только детектируется; multi-intent execution не реализован.

Runtime status note (2026-04-02)

Реально реализованы в runtime:

  • period_coverage_profile
  • document_type_and_account_section_profile
  • list_open_contracts
  • open_items_by_counterparty_or_contract
  • list_documents_by_counterparty
  • bank_operations_by_counterparty
  • list_documents_by_contract
  • bank_operations_by_contract
  • account_balance_snapshot
  • documents_forming_balance
  • list_payables_counterparties
  • list_receivables_counterparties

Остаются вне runtime V1:

  • account_turnover_snapshot
  • list_documents_by_type