import { IRequestType } from '../../shared/approval'; /** * Точечная отладка поиска по ОДНОМУ типу заявки. * * Зачем отдельный модуль: тип может выпасть из выдачи на любом из пяти шагов * (не пришёл из API маршрутов → не попал в KQL → индекс его не отдал → Path * хита не совпал с адресом списка → REST не вернул строку), и снаружи все пять * выглядят одинаково — «заявок этого типа нет». Трассировка печатает каждый * шаг отдельно, чтобы было видно, на каком именно набор становится пустым. * * Включение/выключение БЕЗ пересборки — из консоли браузера: * window.rpSearchTrace = 'обходной' // подстрока имени типа или ключа формы * window.rpSearchTrace = true // следить за всеми типами * window.rpSearchTrace = false // выключить * Значение сверяется с именем типа и с pageUrl (ключом формы), регистр не важен. * * По умолчанию выключена (false) — включённый DEFAULT_TRACE был точечной * настройкой на время разбора конкретного бага с партициями «Обходного листа» * и не должен постоянно писать в консоль всем остальным. */ const DEFAULT_TRACE: string | boolean = false; const PREFIX = '[Поиск]'; function traceSetting(): string | boolean { const w = window as unknown as { rpSearchTrace?: string | boolean }; return w.rpSearchTrace === undefined ? DEFAULT_TRACE : w.rpSearchTrace; } function matches(type: IRequestType, setting: string | boolean): boolean { if (setting === true) return true; if (!setting) return false; const needle = String(setting).toLowerCase(); return ( (type.name || '').toLowerCase().indexOf(needle) >= 0 || (type.pageUrl || '').toLowerCase().indexOf(needle) >= 0 ); } /** Типы, за которыми сейчас следим. Пусто — трассировка выключена. */ export function tracedTypes(types: IRequestType[]): IRequestType[] { const setting = traceSetting(); if (!setting) return []; return types.filter((t) => matches(t, setting)); } export function traceEnabled(): boolean { return !!traceSetting(); } /** * Шаг 1: что вообще пришло из API маршрутов и что из этого пригодно для чтения. * * Тип без listId/siteUrl молча отбрасывается (см. getLinkedTypes) — до поиска * он не доходит вообще, и это первая версия, которую надо исключить. */ export function traceLinkedTypes(all: IRequestType[], linked: IRequestType[]): void { const setting = traceSetting(); if (!setting) return; const watched = all.filter((t) => matches(t, setting)); if (watched.length === 0) { console.warn( `${PREFIX} Тип по фильтру «${String(setting)}» не найден среди ${all.length} типов из API маршрутов. ` + `Есть: ${all.map((t) => `${t.name} (${t.pageUrl})`).join(', ')}` ); return; } watched.forEach((t) => { const isLinked = linked.some((l) => l.id === t.id); console.log(`${PREFIX} Тип «${t.name}» (id=${t.id}, ключ=${t.pageUrl}):`, { 'дошёл до поиска': isLinked, listId: t.listId ?? '(нет)', siteUrl: t.siteUrl ?? '(нет)', }); if (!isLinked) { console.warn( `${PREFIX} Тип «${t.name}» в поиске НЕ участвует: у него нет listId и/или siteUrl ` + `в approval-route API — заполните их в админке, иначе портал не знает, где лежит список.` ); } }); } /** * Шаг 2–4: KQL, сырые хиты индекса и сопоставление их с адресом списка. * * Path каждого хита сверяется с абсолютным адресом списка (см. hitsToEntries). * Если индекс что-то отдал, а совпадений с этим типом нет — печатаем образцы * путей: расхождение обычно видно глазами (другой сайт, /Lists/ против * человекочитаемого адреса, иной регистр). */ export function traceSearchHits( label: string, kql: string, types: IRequestType[], results: { PrimarySearchResults: unknown[]; TotalRows?: number }, listAbsUrl: (type: IRequestType) => string ): void { const watched = tracedTypes(types); if (watched.length === 0) return; const hits = (results.PrimarySearchResults as Array>).map((r) => String(r.Path || '').toLowerCase() ); // Со слешем на конце — ровно как в боевом сопоставлении (см. listPathPrefix): // иначе трассировка показывала бы «хиты есть» там, где код уже отдал их // другому типу с более коротким адресом (…/Lists/List1 против …/Lists/List10). const prefix = (t: IRequestType): string => `${listAbsUrl(t).toLowerCase().replace(/\/+$/, '')}/`; console.log(`${PREFIX} ${label}: запрос отправлен`, { KQL: kql, 'хитов получено': hits.length, 'TotalRows индекса': results.TotalRows ?? 0, }); watched.forEach((t) => { const url = prefix(t); const mine = hits.filter((p) => p.indexOf(url) === 0); console.log(`${PREFIX} ${label}: «${t.name}» — хитов индекса ${mine.length}`, { 'адрес списка (ожидаемый префикс Path)': url, }); if (mine.length === 0) { // Индекс мог не отдать НИЧЕГО (тогда дело не в путях), либо отдать // чужие хиты (тогда почти наверняка не совпал префикс). console.warn( `${PREFIX} ${label}: по типу «${t.name}» индекс не вернул ни одного хита. ` + (hits.length === 0 ? 'Хитов нет вообще — проверьте сам запрос и права.' : `Пути первых чужих хитов (сравните с ожидаемым префиксом выше): ${hits .slice(0, 5) .join(' | ')}`) ); } }); } /** * Шаг 5: сколько строк этого типа дожило до выдачи после сопоставления с * адресом списка и дочитывания полей через REST. * * Расхождение «хиты были, строк нет» означает, что элементы из индекса в * списке уже не существуют (удалены, индекс отстал) либо REST их не отдал. */ export function traceResultRows( label: string, types: IRequestType[], entries: Array<{ type: IRequestType }>, rows: Array<{ requestTypeId: number }> ): void { const watched = tracedTypes(types); if (watched.length === 0) return; watched.forEach((t) => { const mineEntries = entries.filter((e) => e.type.id === t.id).length; const mineRows = rows.filter((r) => r.requestTypeId === t.id).length; console.log( `${PREFIX} ${label}: «${t.name}» — сопоставлено со списком ${mineEntries}, в выдаче ${mineRows}` ); if (mineEntries > 0 && mineRows === 0) { console.warn( `${PREFIX} ${label}: по типу «${t.name}» элементы в индексе есть, но ни одной строки ` + `не дочиталось через REST — вероятно, элементы удалены (индекс отстал) или список недоступен.` ); } }); }