README.md
ADDRESS Query Docs
Дата: 2026-04-03
Статус синхронизации: актуализировано по текущему коду в llm_normalizer/backend/src/services/*.
Актуальный статус (2026-04-08)
- Этап стабилизации закрыт под
strict_policy=route. - Step-0 pre-prod rails закрыт (reference-domain + nightly automation).
- Этап 3 (универсализация value-вопросов общего домена) закрыт на уровне кода и targeted-тестов.
- Batch-1 domain live-gate закрыт:
strict 28/28
docs/ADDRESS/runs/2026-04-03_Address_Domain_General_B1_PhaseC_LiveGate_R3/run_summary.json - Batch-3 value live-gate закрыт:
strict 33/33
docs/ADDRESS/runs/2026-04-03_Address_Domain_General_B3_Value_LiveGate_R2/run_summary.json - Global nightly comparator после фиксов закрыт (
overall_ok=true, comparator PASS):
docs/ADDRESS/runs/2026-04-03_Address_Nightly_Regression_Post_AnchorHardening_R6/nightly_summary.json - Ручной контрольный nightly (
2026-04-08 10:29) зафиксировал точечный flake:stress_102:101/102(провалS019,materialized_but_not_anchor_matched)followup_25:25/25- run:
docs/ADDRESS/runs/2026-04-08_Address_Nightly_Regression_2026-04-08_10-29-08/nightly_summary.json
- Повторный контрольный nightly (
2026-04-08 10:51) закрыт вPASS:stress_102:102/102followup_25:25/25- comparator:
PASS - run:
docs/ADDRESS/runs/2026-04-08_Address_Nightly_Regression_2026-04-08_10-51-20/nightly_summary.json
- Финальный 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-08_Address_Nightly_Regression_2026-04-08_10-51-20/nightly_summary.json - Task Scheduler:
NDC_ADDRESS_Nightly_RegressionвременноDisabled(ручной режим до стабилизации infra-канала). - Текущий production-контур:
question_mode=address_query, live-first через MCP. - Следующий этап:
Step-4domain expansion по рельсовой модели Step-0.
Что реально реализовано в коде (срез 2026-04-03)
Поддерживаемые intents в runtime:
period_coverage_profile(Wave-1 B1, pre-gate)document_type_and_account_section_profile(Wave-1 B1, pre-gate)counterparty_population_and_roles(Wave-1 B1, pre-gate)counterparty_activity_lifecycle(Wave-1/B2, pre-gate)contract_usage_overview(Wave-1 B1, pre-gate)customer_revenue_and_payments(Wave-1 B3 value, pre-gate)supplier_payouts_profile(Wave-1 B3 value, pre-gate)contract_usage_and_value(Wave-1 B3 value, pre-gate)list_open_contractslist_payables_counterpartieslist_receivables_counterpartiesaccount_balance_snapshotopen_items_by_counterparty_or_contractlist_documents_by_counterpartybank_operations_by_counterpartylist_documents_by_contractbank_operations_by_contractdocuments_forming_balance
Ключевой scope-лимит:
COMPOUND_FACTUAL_QUERYпока detection-only (без multi-intent execution).- management/value intents реализованы в коде и закрыты через domain live-gate (Batch-1/Batch-3).
- глобальный comparator на
102 + 25закрыт вPASS(nightly R6). - для value-ranking ответов действует дефолт:
top-20(если пользователь явно не запросил другой лимит). 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- guardrailsDecompose -> 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.stage3_value_universalization_closeout_2026-04-03.md- закрытие этапа 3 по value-вопросам общего домена (профит, тестовый gate, остаточные риски).wave1_batch1_batch3_live_gate_report_2026-04-03.md- фактический отчет по live-gate Batch-1/Batch-3 и статусу глобального regression/comparator (PASS в R6).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.mdaddress_query_bootstrap_report_2026-03-29.mdknown_positive_live_suite_v1.mddata_aware_positive_acceptance_suite_v1.mdcurated_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.pypython scripts/run_address_nightly_regression.py --dry-runpython scripts/check_address_wave1_batch1_readiness.pypowershell -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/