Added comments

application/symfony/src/Domain/ActionManagement/ActionFactoryService.php

@@ -9,9 +9,15 @@ use Infinito\Exception\NoDefaultClassException;
  */
 final class ActionFactoryService extends AbstractActionConstructor implements ActionFactoryServiceInterface
 {
-    const BASE_NAMESPACE = 'Infinito\\Domain\\ActionManagement\\';
+    /**
+     * @var string Namespace in which the actions will be found
+     */
+    private const BASE_NAMESPACE = 'Infinito\\Domain\\ActionManagement\\';
 
-    const CLASS_SUFFIX = 'Action';
+    /**
+     * @var string Suffix for action classes
+     */
+    private const CLASS_SUFFIX = 'Action';
 
     /**
      * @param string $name

application/symfony/src/Domain/ActionManagement/ActionHandlerServiceInterface.php

@@ -12,6 +12,8 @@ interface ActionHandlerServiceInterface
     /**
      * Process an action an returns the results.
      *
+     * @todo Implement that also results can be returned
+     *
      * @return EntityInterface|null
      */
     public function handle(): ?EntityInterface;

application/symfony/src/Domain/ActionManagement/ActionInterface.php

@@ -12,6 +12,8 @@ interface ActionInterface
     /**
      * Executes the action.
      *
+     * @todo Implement that also results can be returned
+     *
      * @return EntityInterface|null
      */
     public function execute(): ?EntityInterface;