优化Firestore复杂子字段查询：利用关键词数组构建复合索引

{
  "title": "Example Article",
  "year": 2023,
  "season": "Fall",
  "studios": {
    "Studio A": true,
    "Studio B": true,
    "Studio C": true
  },
  "genres": {
    "Action": true,
    "Comedy": true,
    "Drama": true,
    "Sci-Fi": true
  },
  "id": "article-123"
}

// 原始查询逻辑片段
if (filters.genre) q = query(q, where(`genres.${filters.genre}`, "==", true));
if (filters.studio) q = query(q, where(`studios.${filters.studio}`, "==", true));

{
  "title": "Example Article",
  "year": 2023,
  "season": "Fall",
  "studios": {
    "Studio A": true,
    "Studio B": true
  },
  "genres": {
    "Action": true,
    "Comedy": true
  },
  "id": "article-123",
  "keywords": [
    "Studio A",
    "Studio B",
    "Action",
    "Comedy",
    "Studio A, Action",
    "Studio A, Comedy",
    "Studio B, Action",
    "Studio B, Comedy"
  ]
}

/**
 * 从给定的两个数组中生成关键词数组。
 * 数组包含所有单个元素以及两个数组元素的交叉组合。
 * @param arr1 第一个元素数组 (例如：流派名称)
 * @param arr2 第二个元素数组 (例如：工作室名称)
 * @returns 包含所有单个和组合关键词的数组
 */
function generateKeywords(arr1: string[], arr2: string[]): string[] {
  const combinedArr: string[] = [...arr1, ...arr2]; // 添加所有单个关键词

  // 添加所有交叉组合关键词
  for (const item1 of arr1) {
    for (const item2 of arr2) {
      combinedArr.push(`${item1}, ${item2}`);
    }
  }
  return combinedArr;
}

// 示例用法（在文档写入/更新时调用）
// const genres = Object.keys(documentData.genres); // ['Action', 'Comedy']
// const studios = Object.keys(documentData.studios); // ['Studio A', 'Studio B']
// documentData.keywords = generateKeywords(genres, studios);

/**
 * 根据流派和工作室筛选条件生成查询目标关键词。
 * @param genre 选定的流派
 * @param studio 选定的工作室
 * @returns 组合后的关键词字符串，如果只有一个条件则返回该条件，如果都没有则返回空字符串。
 */
function combineValues(genre: string, studio: string): string {
  let combinedValue = "";

  if (genre) {
    combinedValue += genre;
  }

  if (genre && studio) {
    combinedValue += ", ";
  }

  if (studio) {
    combinedValue += studio;
  }

  return combinedValue;
}

// 更新后的查询函数
export function generateSearchQuery(
  searchTerms: string,
  filters: {
    year: number | "";
    season: string;
    genre: string;
    studio: string;
  }
): Query<DocumentData> {
  const docRef = collection(firestore, "example");
  let q = query(docRef);

  if (searchTerms) q = query(q, where("title", "==", searchTerms));
  if (filters.year) q = query(q, where("year", "==", filters.year));
  if (filters.season) q = query(q, where("season", "==", filters.season));

  // 使用关键词数组进行流派和工作室过滤
  if (filters.genre || filters.studio) {
    const targetKeyword = combineValues(filters.genre, filters.studio);
    if (targetKeyword) {
      q = query(q, where("keywords", "array-contains", targetKeyword));
    }
  }

  q = query(q, orderBy("id", "desc"), limit(20)); // id 用于分页
  return q;
}