NODEDC_1C/docs/ADDRESS/address_query

ADDRESS Query Docs

Дата: 2026-04-02
Статус синхронизации: актуализировано по текущему коду в llm_normalizer/backend/src/services/*.

Актуальный статус (2026-04-02)

• Этап стабилизации закрыт под strict_policy=route.
• Step-0 pre-prod rails закрыт (reference-domain + nightly automation).
• Финальный stress-pack: 102/102
docs/ADDRESS/runs/2026-04-02_Address_Slang_Live_Stress_2026-04-02_12-57-27/run_summary.json
• Финальный follow-up pack: 25/25
docs/ADDRESS/runs/2026-04-02_Address_Followup_Context_Chains_2026-04-02_19-15-Run5/run_summary.json
• Актуальный nightly regression (green):
  docs/ADDRESS/runs/2026-04-02_Address_Nightly_Regression_2026-04-02_17-35-00/nightly_summary.json
• Task Scheduler: NDC_ADDRESS_Nightly_Regression (daily 03:30, owner DCTOUCH).
• Текущий production-контур: question_mode=address_query, live-first через MCP.
• Следующий этап: Step-4 domain expansion по рельсовой модели Step-0.

Что реально реализовано в коде (срез 2026-04-02)

Поддерживаемые intents в runtime:

• period_coverage_profile (Wave-1 B1, pre-gate)
• document_type_and_account_section_profile (Wave-1 B1, pre-gate)
• list_open_contracts
• list_payables_counterparties
• list_receivables_counterparties
• account_balance_snapshot
• open_items_by_counterparty_or_contract
• list_documents_by_counterparty
• bank_operations_by_counterparty
• list_documents_by_contract
• bank_operations_by_contract
• documents_forming_balance

Ключевой scope-лимит:

• COMPOUND_FACTUAL_QUERY пока detection-only (без multi-intent execution).
• period_coverage_profile и document_type_and_account_section_profile реализованы в коде, но еще не закрыты через domain live-gate Batch-1.
• account_turnover_snapshot и list_documents_by_type не реализованы в runtime V1.

Основные документы

• address_scenario_matrix.md - актуальная матрица сценариев question -> intent -> recipe_id.
• query_recipes_v1.md - фактический каталог runtime recipes и их контрактов.
• runtime_readiness_matrix_v1.md - статус готовности сценариев по текущему коду.
• address_runtime_contracts.md - актуальный debug/output контракт address lane.
• runtime_integration_plan.md - фактическая схема интеграции в assistantService.
• address_architecture_contract_v1.md - guardrails Decompose -> Resolve -> Execute -> Compose.
• global_execution_checklist_v1.md - release-gate и шаги этапа.
• stage_closeout_2026-04-02.md - закрытие этапа стабилизации.
• step0_preprod_rail_plan_v1.md - обязательный pre-prod рельсовый этап перед массовым расширением доменов.
• step0_closeout_2026-04-02.md - факт закрытия Step-0 с артефактами и gate-подтверждением.
• domain_expansion_implementation_plan_v1.md - план Step-4.
• general_domain_questions_analysis_plan_v1_2026-04-02.md - глубокий разбор общего домена (40 вопросов), route-модель и batch-план внедрения.
• management_route_probe_report_g1_2026-04-02.md - live Batch-0 probe по первой группе общего домена (Q1–Q5) с route-верификацией через MCP/1С.
• complex_questions_status_and_reuse_map_2026-04-02.md - сверка кода/доков по "сложным вопросам": что реализовано, что detection-only, и как переиспользовать в продуктовом плане.
• step4_wave1_batch1_master_checker_v1.md - master checker первой волны Step-4 (Q1..Q7 + Q28) с go/no-go фазами.
• wave1_batch1_readiness_report_2026-04-02.md - авто-отчет готовности к старту Batch-1.
• domain_general_batch1_foundation_card_v1.md - domain card первой волны (Phase A).
• step4_wave1_batch1_phaseA_backlog_v1.md - рабочий backlog по подготовке кода и gate-этапам Batch-1.
• domain_card_template_v1.md - шаблон описания домена для repeatable delivery.
• domain_acceptance_question_set_template_v1.md - шаблон структуры domain acceptance question set.
• run_pack_spec_v1.md - обязательный формат run-артефактов и gate-валидации.

Исторические и supporting docs:

• entity_map_1c_2020.md
• address_query_bootstrap_report_2026-03-29.md
• known_positive_live_suite_v1.md
• data_aware_positive_acceptance_suite_v1.md
• curated_positive_live_suite_v1.md

Step-0 Automation (rail tools)

• python scripts/validate_address_run_pack.py docs/ADDRESS/runs/<run_id>
• python scripts/compare_address_run_summary.py --baseline-summary <baseline_run_summary.json> --candidate-summary <candidate_run_summary.json>
• python scripts/run_address_nightly_regression.py
• python scripts/run_address_nightly_regression.py --dry-run
• python scripts/check_address_wave1_batch1_readiness.py
• powershell -ExecutionPolicy Bypass -File .\scripts\run_address_nightly_regression.ps1

Связанные run-паки

• docs/ADDRESS/runs/2026-03-29_Address_Query_Entity_Inventory_2020/
• docs/ADDRESS/runs/2026-03-29_Address_Query_Runtime_V1_M2_2_Documents_BankOps_By_Counterparty/
• docs/ADDRESS/runs/2026-03-29_Address_Query_Runtime_V1_M2_3_DocumentsFormingBalance_DataAwareAcceptance/
• docs/ADDRESS/runs/2026-03-29_Address_Query_Runtime_V1_M2_3A_Stage_Diagnostic_Materialization/
• docs/ADDRESS/runs/2026-03-29_Address_Query_Runtime_V1_M2_3B_AccountScope_Mode_Tuning/
• docs/ADDRESS/runs/2026-03-29_Address_Query_Runtime_V1_M2_3C_Resolver_Filter_Tuning_And_AccountScope_Audit/
• docs/ADDRESS/runs/2026-04-01_Address_Query_Runtime_V1_M2_3D_Query_Variants_Expansion/
• docs/ADDRESS/runs/2026-04-01_Address_Query_Runtime_V1_M2_3E_Stability_Hardening_AccountQueryScope/
• docs/ADDRESS/runs/2026-04-01_Address_Query_Runtime_V1_M2_3F_LLM_Decompose_Coercion_Layer/
• docs/ADDRESS/runs/2026-04-02_Address_Slang_Live_Stress_2026-04-02_12-57-27/
• docs/ADDRESS/runs/2026-04-02_Address_Followup_Context_Chains_2026-04-02_19-15-Run5/
• docs/ADDRESS/runs/2026-04-02_Address_Domain_ContractsOpenItems_Reference_Acceptance_2026-04-02_17-00-22/
• docs/ADDRESS/runs/2026-04-02_Address_Nightly_Regression_2026-04-02_17-35-00/