This can save everyone a lot of time and frustration.

For any non-trivial change, we need to be able to answer these questions:

* Why is this change done? What's the use case?
* For user-facing features, what will the API look like?
* What test cases should it have? What could go wrong?
* How will it roughly be implemented? We'll happily provide code pointers to save you time.

domain object that use plain getters and setters.  It is also not acceptable to add setters that take a Provider.

Note that when adding a lazy property to an existing class, you need to check if instances of the class are instantiated via ObjectFactory. Most classes are instantiated this way, but it's possible that a class without any lazy properties was never updated to use it. A tell-tale sign that an object is not instantiated via the ObjectFactory are direct calls to the constructor...

### 3. Backup Existing System

Before migration:

1. Export current search configurations
2. Backup existing indices and data
3. Document custom integrations and API endpoints
4. Save user access control settings

---

## Migration Methods

### Google Search Appliance (GSA) / Google Mini

Fess provides comprehensive GSA migration support through configuration import and API compatibility.

        assertNotNull(paramAnnotations, "Parameter annotations should exist");
        assertEquals("Should have one parameter", 1, paramAnnotations.length);
        assertEquals("Parameter should have one annotation", 1, paramAnnotations[0].length);

        final UriType annotation = (UriType) paramAnnotations[0][0];

                labelConstantCount++;
            }
        }

        assertEquals("Should have exactly one serialVersionUID", 1, serialVersionUIDCount);
        assertTrue("Should have many label constants", labelConstantCount > 100);
    }

    /**
     * Test that label constant values match their field names
     */
    @Test

        copiedGroups.add("new-group");

        // Verify original is not modified
        assertEquals("Original list should have 1 element", 1, originalGroups.size());
        assertEquals("Copied list should have 2 elements", 2, copiedGroups.size());
    }

    /**
     * Test that processParentGroup handles null user gracefully when depth limit is reached.
     */
    @Test

        QueryContext context = new QueryContext("test", false);

        try {
            boostQueryCommand.execute(context, termQuery, 1.0f);
            fail("Should have thrown InvalidQueryException");
        } catch (InvalidQueryException e) {
            // Expected exception
            assertTrue(e.getMessage().contains("Unknown q:"));

        assertTrue(logs.size() > 0, "Should have at least one failure URL log");

        // Verify response structure
        Integer status = JsonPath.from(response).get("response.status");
        assertEquals(0, status);

        // Verify log structure
        Map<String, Object> firstLog = logs.get(0);
        assertTrue(firstLog.containsKey("id"), "Log should have id field");

        } catch (SearchQueryException e) {
            assertEquals(expectedMessage, e.getMessage());
            assertNull(e.getCause());
        } catch (Exception e) {
            fail("Should have caught SearchQueryException");
        }
    }

    @Test
    public void test_throwWithCauseAndCatch() {
        // Test throwing with cause and catching
        String expectedMessage = "Test with cause";

                        String path = htmlNext.getRoutingPath();
                        assertTrue("Admin field should have /admin/ path: " + fieldName + " -> " + path, path.startsWith("/admin/"));
                        adminPaths.add(path);
                    }
                }
            }
        }
        assertTrue("Should have admin paths", adminPaths.size() > 0);
    }

    @Test