String[] tags = { "tag1" };
        String[] roles = { "role1" };
        String[] languages = { "en" };
        long docFreq = 10L;
        long queryFreq = 5L;
        float userBoost = 1.5f;

        SuggestItem item =
                new SuggestItem(text, readings, fields, docFreq, queryFreq, userBoost, tags, roles, languages, SuggestItem.Kind.DOCUMENT);

        },
        "match": "*",
        "match_mapping_type": "string"
      }
    }
  ],
  "properties": {
    "@timestamp": {
      "type": "date",
      "format": "epoch_millis"
    },
    "docFreq": {
      "type": "long"
    },
    "fields": {
      "type": "keyword"
    },
    "kinds": {
      "type": "keyword"
    },
    "queryFreq": {
      "type": "long"
    },
    "roles": {

    }

    private SuggestItem createItem(String text, long docFreq, long queryFreq, float userBoost) {
        String[] texts = { text };
        String[][] readings = { { "reading" } };
        String[] fields = { "field" };

        return new SuggestItem(texts, readings, fields, docFreq, queryFreq, userBoost, new String[0], new String[0], new String[0],
                SuggestItem.Kind.DOCUMENT);

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

    public static final String SCORE = "score";
    /** The query frequency field. */
    public static final String QUERY_FREQ = "queryFreq";
    /** The document frequency field. */
    public static final String DOC_FREQ = "docFreq";
    /** The user boost field. */
    public static final String USER_BOOST = "userBoost";
    /** The kinds field. */
    public static final String KINDS = "kinds";
    /** The timestamp field. */

     * <li>Fields, tags, languages, and roles are merged, maintaining uniqueness</li>
     * <li>Kinds are merged, maintaining uniqueness</li>
     * <li>Frequencies (queryFreq, docFreq) are summed</li>
     * <li>Timestamp and userBoost are taken from item2 (newer values)</li>
     * </ul>
     *
     * @param item1 The first SuggestItem (base item)

            logger.info("Deleting all suggest items: index={}", index);
        }
        return deleteByQuery(index, QueryBuilders.matchAllQuery());
    }

    /**
     * Deletes document words (words with DOC_FREQ >= 1 that don't have QUERY or USER kinds).
     *
     * @param index The index name
     * @return The SuggestDeleteResponse
     */
    public SuggestDeleteResponse deleteDocumentWords(final String index) {

                    ScoreFunctionBuilders.weightFactorFunction(prefixMatchWeight)));
        }

        flist.add(new FunctionScoreQueryBuilder.FilterFunctionBuilder(ScoreFunctionBuilders.fieldValueFactorFunction(FieldNames.DOC_FREQ)
                .missing(0.1f)
                .modifier(FieldValueFactorFunction.Modifier.LOG2P)
                .setWeight(1.0F)));