88 lines
5.2 KiB
Markdown
88 lines
5.2 KiB
Markdown
# 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:
|
||
|
||
- `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).
|
||
- `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`.
|
||
- `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`
|
||
- `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/`
|