### SuggestItem (Domain Entity)
Location: `src/main/java/org/codelibs/fess/suggest/entity/SuggestItem.java`

Core attributes: `text`, `timestamp`, `queryFreq`, `docFreq`, `userBoost`, `readings`, `tags`, `roles`, `languages`, `kinds`

Kind types: `DOCUMENT`, `QUERY`, `USER`

---

## Development Workflow

### Build Commands

```bash

        // Test creating bulk line for indexing
        SuggestItem item = new SuggestItem(new String[] { "test text" }, new String[][] { { "reading1" }, { "reading2" } },
                new String[] { "field1", "field2" }, 10, // queryFreq
                5, // docFreq
                2.0f, // userBoost
                new String[] { "tag1", "tag2" }, new String[] { "role1" }, new String[] {}, // languages
                SuggestItem.Kind.DOCUMENT);

        for (int i = 0; i < readings.length; i++) {
            secondLine.put("reading_" + i, readings[i]);
        }

        secondLine.put("fields", item.getFields());
        secondLine.put("queryFreq", item.getQueryFreq());
        secondLine.put("docFreq", item.getDocFreq());
        secondLine.put("userBoost", item.getUserBoost());

    /**
     * Returns the number of query words in the suggestion index.
     * @return The number of query words.
     */
    public long getQueryWordsNum() {
        return getNum(QueryBuilders.rangeQuery(FieldNames.QUERY_FREQ).gte(1));
    }

    private long getNum(final QueryBuilder queryBuilder) {
        final SearchResponse searchResponse = client.prepareSearch()
                .setIndices(getSearchAlias(index))

     */
    public SuggestDeleteResponse deleteQueryWords() {
        if (logger.isInfoEnabled()) {
            logger.info("Deleting query words: index={}", index);
        }
        return deleteWordsByKind(FieldNames.QUERY_FREQ, SuggestItem.Kind.QUERY, item -> item.setQueryFreq(0), SuggestItem.Kind.DOCUMENT,
                SuggestItem.Kind.USER);
    }

    /**
     * Common method to delete words by kind.