name="search"
                                                    value="<la:message key="labels.crud_button_search" />">
                                                <i class="fa fa-search" aria-hidden="true"></i>
                                                <la:message key="labels.crud_button_search"/>

import java.util.Locale;

import org.apache.commons.lang3.StringUtils;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.apache.lucene.search.Query;
import org.apache.lucene.search.WildcardQuery;
import org.codelibs.core.lang.StringUtil;
import org.codelibs.fess.Constants;
import org.codelibs.fess.entity.QueryContext;
import org.codelibs.fess.exception.InvalidQueryException;

import jakarta.servlet.ServletOutputStream;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

/**
 * API manager for search engine administrative operations.
 * Provides secure access to search engine APIs through authentication and token-based authorization.
 */
public class SearchEngineApiManager extends BaseApiManager {
    private static final String ADMIN_SERVER = "/admin/server_";

import org.lastaflute.web.ruts.multipart.MultipartFormFile;
import org.lastaflute.web.validation.Required;

/**
 * Form for uploading synonym files to the Fess search engine.
 * Synonyms are words or phrases that should be treated as equivalent during search operations.
 * This form is used in the admin interface to upload custom synonym dictionary files.
 */
public class UploadForm {

    /**

# CLAUDE.md - Fess Suggest Project Guide

> AI assistant guidance for the Fess Suggest project - a Java library providing intelligent search suggestions built on OpenSearch.

## Project Overview

**Fess Suggest** delivers auto-completion, search suggestions, and popular word analytics with multi-language support.

**Technology Stack:**
- Java 21+, Maven
- OpenSearch (provided dependency)
- Apache Lucene (query parsing, text analysis)

                                                    name="search"
                                                    value="<la:message key="labels.crud_button_search" />">
                                                <i class="fa fa-search" aria-hidden="true"></i>
                                                <la:message key="labels.crud_button_search"/>

                                                    name="search"
                                                    value="<la:message key="labels.crud_button_search" />">
                                                <i class="fa fa-search" aria-hidden="true"></i>
                                                <la:message key="labels.crud_button_search"/>

     * Uses caching to improve performance for repeated requests.
     *
     * @param searchRequestType the type of search request
     * @param seed the seed value for popular word generation
     * @param tags array of tags to filter results
     * @param roles array of roles to filter results
     * @param fields array of fields to search in

import jakarta.annotation.Resource;

/**
 * API action for admin related content management.
 * Provides RESTful API endpoints for managing related content settings in the Fess search engine.
 * Related content settings define content relationships and associations for search results.
 */
public class ApiAdminRelatedcontentAction extends FessApiAdminAction {

import org.lastaflute.web.ruts.multipart.MultipartFormFile;
import org.lastaflute.web.validation.Required;

/**
 * Form for uploading stopwords files to the Fess search engine.
 * Stopwords are common words that should be ignored during search indexing and querying.
 * This form is used in the admin interface to upload custom stopwords dictionary files.
 */
public class UploadForm {

    /**