}
    }

    /**
     * Deletes old documents that have the same URL but different document IDs
     * as the documents in the provided list. This prevents duplicate documents
     * from accumulating in the index.
     *
     * @param searchEngineClient the search engine client to use for deletion
     * @param docList the list of new documents to check against

- [ ] Set up authentication and user roles

### Data Migration

- [ ] Export documents from current system
- [ ] Transform documents to Fess format
- [ ] Validate NDJSON format
- [ ] Import documents via Admin UI or API
- [ ] Verify document count after import
- [ ] Test search queries on migrated data
- [ ] Configure document boost/relevance (if needed)

### Search Integration

            doc.put("role", "Rguest");
            documents.add(doc);
        }

        requestBody.put("documents", documents);

        // Execute bulk update
        checkMethodBase(requestBody).put(API_PATH + "/" + BULK_ENDPOINT).then().body("response.status", equalTo(0));
        refresh();

        // Verify documents were updated

            logger.debug("Total documents added: {}", documentSize.get());
        }

    }

    /**
     * Processes a document through the ingest pipeline.
     * Applies all available ingesters to transform the document data.
     *
     * @param paramMap the data store parameters
     * @param dataMap the document data to process
     * @return the processed document data
     */

        Map<String, Object>[] documents = new Map[1];
        documents[0] = new HashMap<>();
        // Document doesn't contain the supported field
        documents[0].put("other_field", "some content");

        SuggestIndexResponse response = suggester.indexer().indexFromDocument(documents);

        assertNotNull(response);

        }

        /**
         * Deletes old documents from the search index.
         * This method removes documents that were indexed in previous
         * crawling sessions for the same data configuration, keeping
         * only the documents from the current session.
         *
         * <p>The deletion process:</p>
         * <ul>
         *   <li>Checks if old document deletion is enabled</li>

 * reader.setScrollSize(1000); // Set the scroll size
 * reader.setLimitOfDocumentSize(1024 * 1024); // Limit document size to 1MB
 * reader.setQuery(QueryBuilders.termQuery("field", "value")); // Set a query
 *
 * Map<String, Object> document;
 * while ((document = reader.read()) != null) {
 *     // Process the document
 *     System.out.println(document);
 * }
 *
 * reader.close(); // Close the reader to release resources
 * }
 * </pre>
 */

            }
            throw new SuggestIndexException("Failed to index from documents: index=" + index + ", documentCount=" + documents.length, e);
        }
    }

    /**
     * Indexes documents from an array of maps.
     *
     * @param index The index name
     * @param documents The documents to index
     * @param supportedFields The supported fields
     * @param tagFieldNames The tag field names

import io.restassured.response.Response;

/**
 * Integration tests for the Favorites API (/api/v1/favorites and /api/v1/documents/{docId}/favorite)
 * This test requires crawled documents and favorites feature to be properly configured
 */
@Tag("it")
@Disabled("Requires favorites feature to be enabled and crawled documents")
public class FavoritesApiTests extends CrawlTestBase {

            processor.init();

            // Should handle null documents gracefully
            final List<Map<String, Object>> results = processor.search("*", new TestSearchRequestParams(0, 10, 0), OptionalThing.empty());
            assertNotNull(results);
        }
    }

    /**
     * Test handling of documents with missing ID field.
     */
    @Test