Refactor subject conversion handling and enhance audit logging

- Replaced `Subject|array` return types with `SubjectBag` in `SubjectConverterInterface` for more robust handling.
- Updated `getSubjectsForEntity` to include an optional `$includeAssociated` parameter for finer control over associated subject resolution.
- Refactored `AuditEvent` to differentiate `mainSubject` from associated subjects, improving clarity in audit logging.
- Introduced database schema changes to add `main_subject` and `subjects` columns in the `chill_main_audit_trail` table.
- Added `SubjectBag` class for grouped subject management and implemented deduplication logic.
- Updated all converters and test cases to use the new `SubjectBag` approach, ensuring compatibility.
- Improved event dispatching in controllers to utilize the updated `AuditEvent` structure and refined metadata handling.

src/Bundle/ChillMainBundle/Audit/SubjectConverterInterface.php

@@ -18,10 +18,8 @@ interface SubjectConverterInterface
 {
     /**
      * @param T $subject
-     *
-     * @return Subject|list<Subject>
      */
-    public function convert(mixed $subject): Subject|array;
+    public function convert(mixed $subject, bool $includeAssociated = false): SubjectBag;
 
     /**
      * Determines whether the given subject is supported for conversion.