*
 * <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.
     *

errors.invalid_query_sort_value = De opgegeven sorteerwaarde {0} is ongeldig.
errors.invalid_query_unsupported_sort_field = Het opgegeven sorteerveld {0} wordt niet ondersteund.
errors.invalid_query_unsupported_sort_order = De opgegeven sorteervolgorde {0} wordt niet ondersteund.
errors.invalid_query_cannot_process=Kan de opgegeven query niet verwerken.
errors.crud_invalid_mode = Ongeldige modus. (Is {1}, niet {0})

        // 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);

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.
     */

- 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.

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 {

/**
 * 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.
     */