request-portal/src/webparts/requestPortal/features/myRequests/searchTrace.ts

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<Record<string, unknown>>).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 — вероятно, элементы удалены (индекс отстал) или список недоступен.`
      );
    }
  });
}