*
 * <p>This class acts as a facade, delegating to internal operation classes for the actual work:
 * <ul>
 * <li>{@code IndexingOperations} - Core indexing functionality with bad word filtering</li>
 * <li>{@code DeletionOperations} - Deletion by ID, query, or kind</li>
 * <li>{@code WordManagementOperations} - Bad word and elevate word management</li>

    }

    /**
     * Gets a bad word by its ID.
     * @param id The bad word ID.
     * @return Optional entity containing the bad word if found.
     */
    public OptionalEntity<BadWord> getBadWord(final String id) {
        return badWordBhv.selectByPK(id);
    }

    /**
     * Stores (inserts or updates) a bad word.
     * @param badWord The bad word to store.
     */

    /**
     * Shows the main elevate word management page.
     *
     * @return HTML response for the elevate word list page
     */
    @Execute
    @Secured({ ROLE, ROLE + VIEW })
    public HtmlResponse index() {
        return asListHtml();
    }

    /**
     * Lists elevate words with pagination support.
     *

import org.lastaflute.web.response.StreamResponse;

import jakarta.annotation.Resource;

/**
 * API action for admin elevate word management.
 * Provides RESTful API endpoints for managing elevate word settings in the Fess search engine.
 * Elevate words boost specific search terms to appear higher in search results.
 */
public class ApiAdminElevatewordAction extends FessApiAdminAction {

                firstItems);
    }

    /**
     * Checks if the first word matches.
     * @param singleWordQuery True if it is a single word query.
     * @param hiraganaQuery True if it is a hiragana query.
     * @param text The text to check.
     * @return True if the first word matches, false otherwise.
     */

import jakarta.validation.constraints.Size;

/**
 * Form class for editing bad words in the admin interface.
 * This form extends CreateForm to include fields necessary for updating existing bad word entries,
 * including tracking information for optimistic locking and audit trails.
 * Bad words are terms that should be filtered or blocked in search results.
 *
 */
public class EditForm extends CreateForm {

- Suffixing is very important, when adding Turkish suffixes to the English words, do that based on the pronunciation of the word and with an apostrophe.

- Suffixes also changes based on what word comes next in Turkish too, here is an example:

"Server'a gelen request'leri intercept... " or this could have been "request'e", "request'i" etc.

        // Create content with empty lines and comments
        String content = "# Comment line\n" + "\n" + // empty line
                "word1\n" + "  \n" + // whitespace line (may be treated as content)
                "# Another comment\n" + "word2\n";

        // Write content to test file
        writeTestFile(content);

        // Reload and verify
        protwordsFile.reload(null);

/**
 * Form for uploading bad word files to the Fess search engine.
 * This form is used in the admin interface to upload bad word dictionary files
 * that contain words to be filtered from search results.
 */
public class UploadForm {

    /**
     * The multipart file containing bad words to be uploaded.
     * This file should contain a list of words that will be filtered from search results.
     */

                    logger.warn("Failed to read a suggest elevate word: {}", list, e);
                }
            }
            elevateWordBhv.refresh();
        } catch (final IOException e) {
            logger.warn("Failed to read a suggest elevate word.", e);
        }
    }

    /**
     * Exports elevate words to a CSV file.
     * CSV format: SuggestWord, Reading, Permissions, Labels, Boost