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

 * A chain of {@link ReadingConverter} implementations that applies each converter in sequence to generate possible reading variations of a given text.
 * It maintains a list of ReadingConverter instances and iterates through them, applying each converter to the input text and accumulating the results.
 * The chain stops processing when the maximum number of readings is reached.
 */
public class ReadingConverterChain implements ReadingConverter {
    /**

        offset += 16;
        
        // CurrentLeaseState (4 bytes)
        currentLeaseState = readInt4(buffer, offset);
        offset += 4;
        
        // NewLeaseState (4 bytes)
        newLeaseState = readInt4(buffer, offset);
        offset += 4;
        
        // BreakReason (4 bytes)
        breakReason = readInt4(buffer, offset);
        offset += 4;
        
        // AccessMaskHint (4 bytes)

        assertEquals(22, bytesEncoded);

        // Verify encoded data
        assertEquals(expectedAllocationSize, SMBUtil.readInt8(destinationBuffer, dstIndex));
        assertEquals(expectedEndOfFile, SMBUtil.readInt8(destinationBuffer, dstIndex + 8));
        assertEquals(expectedNumberOfLinks, SMBUtil.readInt4(destinationBuffer, dstIndex + 16));
        assertEquals(1, destinationBuffer[dstIndex + 20]); // deletePending

        // Verify structure size (should be 24)
        assertEquals(24, SMBUtil.readInt2(buffer, offset));

        // Verify close flags (2 bytes at offset+2, should be 0 by default)
        assertEquals(0, SMBUtil.readInt2(buffer, offset + 2));

        // Verify Reserved (4 bytes at offset+4, should be 0)
        assertEquals(0, SMBUtil.readInt4(buffer, offset + 4));

        ////
        »»»


### Headings

Every Markdown heading in the English text (all levels) ends with a part inside curly brackets. This part denotes the hash of this heading, which is used in links to this heading. In translations, translate the heading, but do not translate this hash part, so that links do not break.

Examples of how to translate a heading:

    Source (English):

        «««

        dst[dstIndex++] = (byte) (val >> 8 & 0xFF);
        dst[dstIndex] = (byte) (val & 0xFF);
    }

    static int readInt2(final byte[] src, final int srcIndex) {
        return ((src[srcIndex] & 0xFF) << 8) + (src[srcIndex + 1] & 0xFF);
    }

    static int readInt4(final byte[] src, final int srcIndex) {
        return ((src[srcIndex] & 0xFF) << 24) + ((src[srcIndex + 1] & 0xFF) << 16) + ((src[srcIndex + 2] & 0xFF) << 8)

        byte[] data = response.getOutputBuffer();
        int offset = 0;
        
        while (offset < data.length) {
            int nextEntryOffset = readInt4(data, offset);
            int action = readInt4(data, offset + 4);
            int fileNameLength = readInt4(data, offset + 8);
            
            // Extract filename
            byte[] fileNameBytes = new byte[fileNameLength];

        this.allow = buf[bi] == (byte) 0x00;
        bi++;
        this.flags = buf[bi++] & 0xFF;
        final int size = SMBUtil.readInt2(buf, bi);
        bi += 2;
        this.access = SMBUtil.readInt4(buf, bi);
        bi += 4;
        this.sid = new SID(buf, bi);
        return size;
    }

    void appendCol(final StringBuffer sb, final String str, final int width) {

import java.time.Duration;
import java.util.concurrent.TimeUnit;

/**
 * An object that accurately measures <i>elapsed time</i>: the measured duration between two
 * successive readings of "now" in the same process.
 *
 * <p>In contrast, <i>wall time</i> is a reading of "now" as given by a method like
 * {@link System#currentTimeMillis()}, best represented as an {@link java.time.Instant}. Such values