Merge branch 'copilot/migrate-mongo-repository-to-nitrite' of github.com:dizitart/nitrite-database into copilot/migrate-mongo-repository-to-nitrite

Author: anidotnet

nitrite/src/main/java/org/dizitart/no2/repository/Reflector.java

@@ -193,8 +193,6 @@ private <T> Field getFieldFromInterfaceProperty(Class<T> interfaceType, String p
 
             if (propertyName.equals(extractedPropertyName)) {
                 // Found matching getter - create a wrapper field
-                // For now, we return null and will handle this case specially
-                // Actually, let's throw a more helpful error with a workaround suggestion
                 return createSyntheticFieldForProperty(propertyName, method);
             }
         }
@@ -209,8 +207,12 @@ private <T> Field getFieldFromInterfaceProperty(Class<T> interfaceType, String p
      */
     private Field createSyntheticFieldForProperty(String propertyName, Method getterMethod) {
         try {
-            // Use a generic Object field as a template
-            // The name won't match but the infrastructure can work around it
+            // Use a generic Object field as a template.
+            // The field name ("property") does not match the actual property name,
+            // but InterfacePropertyHolder.registerProperty stores the mapping between
+            // the template field, the actual property name, and the getter method.
+            // This allows the infrastructure to later retrieve the correct property
+            // information for interface-based repositories, even though the field name is generic.
             Field templateField = InterfacePropertyHolder.class.getDeclaredField("property");
             // Store metadata about this field for later use
             InterfacePropertyHolder.registerProperty(templateField, propertyName, getterMethod);