}

        this.languages = languages != null ? languages : new String[] {};

        kinds = new Kind[] { kind };
        if (userBoost > 1) {
            this.userBoost = userBoost;
        } else {
            this.userBoost = 1;
        }
        this.docFreq = docFreq;
        this.queryFreq = queryFreq;
        timestamp = ZonedDateTime.now();
        emptySource = createEmptyMap();

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

        Map<String, Object> source = SuggestItemSerializer.toSource(item);

        assertNotNull(source);

        // Should contain docFreq, queryFreq, and userBoost factors (camelCase field names)
        assertTrue("Should contain docFreq", queryString.contains("docFreq"));
        assertTrue("Should contain queryFreq", queryString.contains("queryFreq"));
        assertTrue("Should contain userBoost", queryString.contains("userBoost"));
    }

    @Test

        final long docFreq = Long.parseLong(source.get(FieldNames.DOC_FREQ).toString());
        final long queryFreq = Long.parseLong(source.get(FieldNames.QUERY_FREQ).toString());
        final float userBoost = Float.parseFloat(source.get(FieldNames.USER_BOOST).toString());
        final List<String> tags = SuggestUtil.getAsList(source.get(FieldNames.TAGS));
        final List<String> roles = SuggestUtil.getAsList(source.get(FieldNames.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

     * <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)
     * @param item2 The second SuggestItem (item to merge in)
     * @return A new merged SuggestItem

                new String[] { "field1", "field2" }, 10, // queryFreq
                5, // docFreq
                2.0f, // userBoost
                new String[] { "tag1", "tag2" }, new String[] { "role1" }, new String[] {}, // languages
                SuggestItem.Kind.DOCUMENT);
        item.setTimestamp(ZonedDateTime.now());

        }

        secondLine.put("fields", item.getFields());
        secondLine.put("queryFreq", item.getQueryFreq());
        secondLine.put("docFreq", item.getDocFreq());
        secondLine.put("userBoost", item.getUserBoost());
        secondLine.put("score", (item.getQueryFreq() + item.getDocFreq()) * item.getUserBoost());
        secondLine.put("tags", item.getTags());
        secondLine.put("roles", item.getRoles());

        Map<String, Object> source = item.getSource();
        float expectedScore = (10L + 20L) * 2.0f; // (docFreq + queryFreq) * userBoost
        assertEquals(expectedScore, (Float) source.get(FieldNames.SCORE), 0.001f);
    }

    @Test
    public void test_scoreCalculationZero() {
        String[] text = { "test" };