Squashed commit of the following:

commit 977863c2dd56d5c835f2a710cad7f7d3ba42da68 Merge: 5c37b419d 3eb7ffed1 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Sun Dec 12 14:45:21 2021 +0100 Merge remote-tracking branch 'origin/master' into docgen/improve-normalizer commit 5c37b419ddf0b32b9950c33042396bba1860da84 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Sun Dec 12 14:37:05 2021 +0100 fix normalization for user and type in null value commit 4469d46cdb19051fedec86bbb84e2351e6fcb72e Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Sun Dec 12 13:24:23 2021 +0100 add civility to person commit 6cf92fbbde8f4d9f2f4763ec4ee88216257040f7 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Sun Dec 12 13:19:36 2021 +0100 fix person normalization: add a isNull on not null person commit ed6087ff8fd47b80ea5e9526756fe5d032d478e3 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Sun Dec 12 13:08:46 2021 +0100 fix stan and cs issues commit 8429c334c33b3545835cbde034fccaa529c134a7 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Sun Dec 12 13:08:36 2021 +0100 fix id type commit 39ae00d172a9f29320a97abb8518b2ea48d89d9b Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Sun Dec 12 12:52:41 2021 +0100 fix test and fix null or not-null value have same keys commit 312fcc44c07affa7aa60f6c5fce58f9d1c564cc3 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Sat Dec 11 03:27:30 2021 +0100 improve normalization wip commit f91a29635827005fc58617dc1c9d210091372be5 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Sat Dec 11 01:15:32 2021 +0100 improve normalization commit 56060e5e6a2191ef441039fdc91a01fb4653a553 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Sat Dec 11 00:41:09 2021 +0100 handle changelog with translatable string commit 9004686a13 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Fri Dec 10 01:10:55 2021 +0100 improve docgen wip commit e266fa0e5d Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Thu Dec 9 21:50:56 2021 +0100 show errors from relatorio driver commit 75ba56fa09 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Thu Dec 9 21:14:12 2021 +0100 add verification tool for admin commit 12d6829b98 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Thu Dec 9 14:17:42 2021 +0100 fix type with phonenumber helper commit 7b5e96771f Merge: 8a9024de1 8a4748dc2 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Thu Dec 9 14:11:14 2021 +0100 Merge remote-tracking branch 'origin/master' into docgen/improve-normalizer commit 8a9024de13 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Thu Dec 9 13:51:36 2021 +0100 add docgen:normalization for relation commit 24a404964b Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Thu Dec 9 12:44:41 2021 +0100 docgen normalization for relation commit 5d24bd4d11 Merge: 70ab23214 455b225f4 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 21:08:30 2021 +0100 Merge branch 'master' into docgen/improve-normalizer commit 70ab232149 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 13:58:49 2021 +0100 improve docgen, trnslations, admin commit 027c01fc58 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 12:23:24 2021 +0100 fix css block commit fdc5127c74 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 11:57:16 2021 +0100 fix some error in test (wip) commit b8d48f04ae Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 11:47:50 2021 +0100 fix tests (wip) commit f1b1771d6b Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 11:35:00 2021 +0100 fix tests (wip) commit 62dabbe1e7 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 11:14:46 2021 +0100 fix code style commit 4101392190 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 11:13:49 2021 +0100 fix tests and type hinting commit 3f1bed0b1c Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 11:05:41 2021 +0100 fix tests (wip) commit 79fbdcdee4 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 11:05:29 2021 +0100 type hint User class commit 3d8d79323e Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 10:56:30 2021 +0100 remove error messages commit 32178e22fe Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 10:51:30 2021 +0100 fix tests (wip) commit 60a8c20896 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 10:29:54 2021 +0100 update app commit 9d8011da61 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 10:06:35 2021 +0100 fix loading origin commit 789eeadb40 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 09:52:51 2021 +0100 fix loading fixtures for doc generator template commit f206fdb08c Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 09:52:35 2021 +0100 fix code style commit 9d5409d8d9 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 09:52:06 2021 +0100 fix casting commit e297d82533 Author: Julien Fastré <julien.fastre@champs-libres.coop> Date: Wed Dec 8 09:26:13 2021 +0100 fixes on tests [WIP]
2025-08-21 07:03:49 +00:00 · 2021-12-12 14:46:37 +01:00
parent 3eb7ffed1a
commit 839fb4a211
55 changed files with 1401 additions and 305 deletions
--- a/src/Bundle/ChillDocGeneratorBundle/Controller/DocGeneratorTemplateController.php
+++ b/src/Bundle/ChillDocGeneratorBundle/Controller/DocGeneratorTemplateController.php
@@ -18,6 +18,7 @@ use Chill\DocGeneratorBundle\Context\DocGeneratorContextWithPublicFormInterface;
 use Chill\DocGeneratorBundle\Context\Exception\ContextNotFoundException;
 use Chill\DocGeneratorBundle\Entity\DocGeneratorTemplate;
 use Chill\DocGeneratorBundle\GeneratorDriver\DriverInterface;
+use Chill\DocGeneratorBundle\GeneratorDriver\Exception\TemplateException;
 use Chill\DocGeneratorBundle\Repository\DocGeneratorTemplateRepository;
 use Chill\DocStoreBundle\Entity\StoredObject;
 use Chill\MainBundle\Pagination\PaginatorFactory;
@@ -28,10 +29,15 @@ use GuzzleHttp\Exception\TransferException;
 use Psr\Log\LoggerInterface;
 use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;

+use Symfony\Component\Form\Extension\Core\Type\FileType;
+use Symfony\Component\HttpFoundation\File\File;
+use Symfony\Component\HttpFoundation\RedirectResponse;
 use Symfony\Component\HttpFoundation\Request;

 // TODO à mettre dans services
 use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\HttpFoundation\StreamedResponse;
+use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
 use Symfony\Component\HttpKernel\Exception\HttpException;
 use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
 use Symfony\Component\HttpKernel\KernelInterface;
@@ -78,6 +84,27 @@ final class DocGeneratorTemplateController extends AbstractController
        $this->client = $client;
    }

+    /**
+     * @Route(
+     *     "{_locale}/admin/doc/gen/generate/test/from/{template}/for/{entityClassName}/{entityId}",
+     *     name="chill_docgenerator_test_generate_from_template"
+     * )
+     */
+    public function adminTestGenerateDocFromTemplateAction(
+        DocGeneratorTemplate $template,
+        string $entityClassName,
+        int $entityId,
+        Request $request
+    ): Response {
+        return $this->generateDocFromTemplate(
+            $template,
+            $entityClassName,
+            $entityId,
+            $request,
+            true
+        );
+    }
+
    /**
     * @Route(
     *     "{_locale}/doc/gen/generate/from/{template}/for/{entityClassName}/{entityId}",
@@ -89,6 +116,81 @@ final class DocGeneratorTemplateController extends AbstractController
        string $entityClassName,
        int $entityId,
        Request $request
+    ): Response {
+        return $this->generateDocFromTemplate(
+            $template,
+            $entityClassName,
+            $entityId,
+            $request,
+            false
+        );
+    }
+
+    /**
+     * @Route(
+     *     "/api/1.0/docgen/templates/by-entity/{entityClassName}",
+     *     name="chill_docgenerator_templates_for_entity_api"
+     * )
+     */
+    public function listTemplateApiAction(string $entityClassName): Response
+    {
+        $nb = $this->docGeneratorTemplateRepository->countByEntity($entityClassName);
+        $paginator = $this->paginatorFactory->create($nb);
+        $entities = $this->docGeneratorTemplateRepository->findByEntity(
+            $entityClassName,
+            $paginator->getCurrentPageFirstItemNumber(),
+            $paginator->getItemsPerPage()
+        );
+
+        return $this->json(
+            new Collection($entities, $paginator),
+            Response::HTTP_OK,
+            [],
+            [AbstractNormalizer::GROUPS => ['read']]
+        );
+    }
+
+    /**
+     * @Route(
+     *     "{_locale}/admin/doc/gen/generate/test/redirect",
+     *     name="chill_docgenerator_test_generate_redirect"
+     * )
+     *
+     * @return void
+     */
+    public function redirectToTestGenerate(Request $request): RedirectResponse
+    {
+        $template = $request->query->getInt('template');
+
+        if (null === $template) {
+            throw new BadRequestHttpException('template parameter is missing');
+        }
+
+        $entityClassName = $request->query->get('entityClassName');
+
+        if (null === $entityClassName) {
+            throw new BadRequestHttpException('entityClassName is missing');
+        }
+
+        $entityId = $request->query->get('entityId');
+
+        if (null === $entityId) {
+            throw new BadRequestHttpException('entityId is missing');
+        }
+
+        return $this->redirectToRoute(
+            'chill_docgenerator_test_generate_from_template',
+            ['template' => $template, 'entityClassName' => $entityClassName, 'entityId' => $entityId,
+                'returnPath' => $request->query->get('returnPath', '/'), ]
+        );
+    }
+
+    private function generateDocFromTemplate(
+        DocGeneratorTemplate $template,
+        string $entityClassName,
+        int $entityId,
+        Request $request,
+        bool $isTest
    ): Response {
        try {
            $context = $this->contextManager->getContextByDocGeneratorTemplate($template);
@@ -105,9 +207,29 @@ final class DocGeneratorTemplateController extends AbstractController
        $contextGenerationData = [];

        if ($context instanceof DocGeneratorContextWithPublicFormInterface
-            && $context->hasPublicForm($template, $entity)) {
-            $builder = $this->createFormBuilder($context->getFormData($template, $entity));
+            && $context->hasPublicForm($template, $entity) || $isTest) {
+            if ($context instanceof DocGeneratorContextWithPublicFormInterface) {
+                $builder = $this->createFormBuilder(
+                    array_merge(
+                        $context->getFormData($template, $entity),
+                        $isTest ? ['test_file' => null] : []
+                    )
+                );
+            } else {
+                $builder = $this->createFormBuilder(
+                    ['test_file' => null]
+                );
+            }
+
            $context->buildPublicForm($builder, $template, $entity);
+
+            if ($isTest) {
+                $builder->add('test_file', FileType::class, [
+                    'label' => 'Template file',
+                    'required' => false,
+                ]);
+            }
+
            $form = $builder->getForm()->handleRequest($request);

            if ($form->isSubmitted() && $form->isValid()) {
@@ -121,43 +243,72 @@ final class DocGeneratorTemplateController extends AbstractController
            }
        }

-        $getUrlGen = $this->tempUrlGenerator->generate(
-            'GET',
-            $template->getFile()->getFilename()
-        );
+        if ($isTest && null !== $contextGenerationData['test_file']) {
+            /** @var File $file */
+            $file = $contextGenerationData['test_file'];
+            $templateResource = fopen($file->getPathname(), 'rb');
+        } else {
+            $getUrlGen = $this->tempUrlGenerator->generate(
+                'GET',
+                $template->getFile()->getFilename()
+            );

-        $data = $this->client->request('GET', $getUrlGen->url);
+            $data = $this->client->request('GET', $getUrlGen->url);

-        $iv = $template->getFile()->getIv(); // iv as an Array
-        $ivGoodFormat = pack('C*', ...$iv);  // iv as a String (ok for openssl_decrypt)
+            $iv = $template->getFile()->getIv(); // iv as an Array
+            $ivGoodFormat = pack('C*', ...$iv);  // iv as a String (ok for openssl_decrypt)

-        $method = 'AES-256-CBC';
+            $method = 'AES-256-CBC';

-        $key = $template->getFile()->getKeyInfos()['k'];
-        $keyGoodFormat = Base64Url::decode($key);
+            $key = $template->getFile()->getKeyInfos()['k'];
+            $keyGoodFormat = Base64Url::decode($key);

-        $dataDecrypted = openssl_decrypt($data->getContent(), $method, $keyGoodFormat, 1, $ivGoodFormat);
+            $dataDecrypted = openssl_decrypt($data->getContent(), $method, $keyGoodFormat, 1, $ivGoodFormat);

-        if (false === $dataDecrypted) {
-            throw new Exception('Error during Decrypt ', 1);
+            if (false === $dataDecrypted) {
+                throw new Exception('Error during Decrypt ', 1);
+            }
+
+            if (false === $templateResource = fopen('php://memory', 'r+b')) {
+                $this->logger->error('Could not write data to memory');
+
+                throw new HttpException(500);
+            }
+            fwrite($templateResource, $dataDecrypted);
+            rewind($templateResource);
        }

-        if (false === $templateResource = fopen('php://memory', 'r+b')) {
-            $this->logger->error('Could not write data to memory');
-
-            throw new HttpException(500);
-        }
-
-        fwrite($templateResource, $dataDecrypted);
-        rewind($templateResource);
-
        $datas = $context->getData($template, $entity, $contextGenerationData);
        dump('datas compiled', $datas);

-        $generatedResource = $this->driver->generateFromResource($templateResource, $template->getFile()->getType(), $datas, $template->getFile()->getFilename());
+        try {
+            $generatedResource = $this->driver->generateFromResource($templateResource, $template->getFile()->getType(), $datas, $template->getFile()->getFilename());
+        } catch (TemplateException $e) {
+            $msg = implode("\n", $e->getErrors());
+
+            return new Response($msg, 400, [
+                'Content-Type' => 'text/plain',
+            ]);
+        }

        fclose($templateResource);

+        if ($isTest) {
+            return new StreamedResponse(
+                static function () use ($generatedResource) {
+                    fpassthru($generatedResource);
+                    fclose($generatedResource);
+                },
+                Response::HTTP_OK,
+                [
+                    'Content-Transfer-Encoding', 'binary',
+                    'Content-Type' => 'application/vnd.oasis.opendocument.text',
+                    'Content-Disposition' => sprintf('attachment; filename="%s.odt"', 'generated'),
+                    'Content-Length' => fstat($generatedResource)['size'],
+                ],
+            );
+        }
+
        $genDocName = 'doc_' . sprintf('%010d', mt_rand()) . 'odt';

        $getUrlGen = $this->tempUrlGenerator->generate(
@@ -206,28 +357,4 @@ final class DocGeneratorTemplateController extends AbstractController

        throw new Exception('Unable to generate document.');
    }
-
-    /**
-     * @Route(
-     *     "/api/1.0/docgen/templates/by-entity/{entityClassName}",
-     *     name="chill_docgenerator_templates_for_entity_api"
-     * )
-     */
-    public function listTemplateApiAction(string $entityClassName): Response
-    {
-        $nb = $this->docGeneratorTemplateRepository->countByEntity($entityClassName);
-        $paginator = $this->paginatorFactory->create($nb);
-        $entities = $this->docGeneratorTemplateRepository->findByEntity(
-            $entityClassName,
-            $paginator->getCurrentPageFirstItemNumber(),
-            $paginator->getItemsPerPage()
-        );
-
-        return $this->json(
-            new Collection($entities, $paginator),
-            Response::HTTP_OK,
-            [],
-            [AbstractNormalizer::GROUPS => ['read']]
-        );
-    }
 }
--- a/src/Bundle/ChillDocGeneratorBundle/GeneratorDriver/Exception/TemplateException.php
+++ b/src/Bundle/ChillDocGeneratorBundle/GeneratorDriver/Exception/TemplateException.php
@@ -0,0 +1,35 @@
+<?php
+
+/**
+ * Chill is a software for social workers
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Chill\DocGeneratorBundle\GeneratorDriver\Exception;
+
+use RuntimeException;
+use Throwable;
+
+/**
+ * A exception to throw when there are syntax errors in the
+ * template file.
+ */
+class TemplateException extends RuntimeException
+{
+    private array $errors;
+
+    public function __construct(array $errors, $code = 0, ?Throwable $previous = null)
+    {
+        parent::__construct('Error while generating document from template', $code, $previous);
+        $this->errors = $errors;
+    }
+
+    public function getErrors(): array
+    {
+        return $this->errors;
+    }
+}
--- a/src/Bundle/ChillDocGeneratorBundle/GeneratorDriver/RelatorioDriver.php
+++ b/src/Bundle/ChillDocGeneratorBundle/GeneratorDriver/RelatorioDriver.php
@@ -11,6 +11,7 @@ declare(strict_types=1);

 namespace Chill\DocGeneratorBundle\GeneratorDriver;

+use Chill\DocGeneratorBundle\GeneratorDriver\Exception\TemplateException;
 use Psr\Log\LoggerInterface;
 use Symfony\Component\DependencyInjection\ParameterBag\ParameterBagInterface;
 use Symfony\Component\Mime\Part\DataPart;
@@ -45,6 +46,7 @@ class RelatorioDriver implements DriverInterface
            'template' => new DataPart($template, $templateName ?? uniqid('template_'), $resourceType),
        ];
        $form = new FormDataPart($formFields);
+        dump(json_encode($data));

        try {
            $response = $this->relatorioClient->request('POST', $this->url, [
@@ -54,10 +56,21 @@ class RelatorioDriver implements DriverInterface

            return $response->toStream();
        } catch (HttpExceptionInterface $e) {
+            $content = $e->getResponse()->getContent(false);
+
+            if (400 === $e->getResponse()->getStatusCode()) {
+                $content = json_decode($content, true);
+                $this->logger->error('relatorio: template error', [
+                    'error' => $content['message'] ?? '_not defined',
+                ]);
+
+                throw new TemplateException([$content['message']]);
+            }
+
            $this->logger->error('relatorio: error while generating document', [
                'msg' => $e->getMessage(),
                'response' => $e->getResponse()->getStatusCode(),
-                'content' => $e->getResponse()->getContent(false),
+                'content' => $content,
            ]);

            throw $e;
--- a/src/Bundle/ChillDocGeneratorBundle/Resources/views/Admin/DocGeneratorTemplate/index.html.twig
+++ b/src/Bundle/ChillDocGeneratorBundle/Resources/views/Admin/DocGeneratorTemplate/index.html.twig
@@ -6,6 +6,7 @@
            <th></th>
            <th>{{ 'Title'|trans }}</th>
            <th>{{ 'docgen.Context'|trans }}</th>
+            <th>{{ 'docgen.test generate'|trans }}</th>
            <th>{{ 'Edit'|trans }}</th>
        {% endblock %}

@@ -13,8 +14,22 @@
            {% for entity in entities %}
                <tr>
                    <td>{{ entity.id }}</td>
-                    <td>{{ entity.name | localize_translatable_string }}</td>
+                    <td>{{ entity.name|localize_translatable_string}}</td>
                    <td>{{ contextManager.getContextByKey(entity.context).name|trans }}</td>
+                    <td>
+                        <form method="get" action="{{ path('chill_docgenerator_test_generate_redirect') }}">
+                            <input type="hidden" name="returnPath" value="{{ app.request.query.get('returnPath', '/')|e('html_attr') }}" />
+                            <input type="hidden" name="template" value="{{ entity.id|e('html_attr') }}" />
+                            <input type="hidden" name="entityClassName" value="{{ contextManager.getContextByKey(entity.context).entityClass|e('html_attr') }}" />
+                            <input type="text" name="entityId" />
+
+                            <ul class="record_actions">
+                                <li>
+                                    <button type="submit" class="btn btn-mini btn-neutral">{{ 'docgen.test generate'|trans }}</button>
+                                </li>
+                            </ul>
+                        </form>
+                    </td>
                    <td>
                        <a href="{{ chill_path_add_return_path('chill_crud_docgen_template_edit', { 'id': entity.id }) }}" class="btn btn-edit">
                            {{ 'Edit'|trans }}
--- a/src/Bundle/ChillDocGeneratorBundle/Serializer/Helper/NormalizeNullValueHelper.php
+++ b/src/Bundle/ChillDocGeneratorBundle/Serializer/Helper/NormalizeNullValueHelper.php
@@ -16,16 +16,27 @@ use function array_merge;

 class NormalizeNullValueHelper
 {
+    private ?string $discriminatorType = null;
+
+    private ?string $discriminatorValue = null;
+
    private NormalizerInterface $normalizer;

-    public function __construct(NormalizerInterface $normalizer)
+    public function __construct(NormalizerInterface $normalizer, $discriminatorType = null, $discriminatorValue = null)
    {
        $this->normalizer = $normalizer;
+        $this->discriminatorType = $discriminatorType;
+        $this->discriminatorValue = $discriminatorValue;
    }

    public function normalize(array $attributes, string $format = 'docgen', ?array $context = [])
    {
        $data = [];
+        $data['isNull'] = true;
+
+        if (null !== $this->discriminatorType) {
+            $data[$this->discriminatorType] = $this->discriminatorValue;
+        }

        foreach ($attributes as $key => $class) {
            if (is_numeric($key)) {
--- a/src/Bundle/ChillDocGeneratorBundle/Serializer/Normalizer/CollectionDocGenNormalizer.php
+++ b/src/Bundle/ChillDocGeneratorBundle/Serializer/Normalizer/CollectionDocGenNormalizer.php
@@ -0,0 +1,56 @@
+<?php
+
+/**
+ * Chill is a software for social workers
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+declare(strict_types=1);
+
+namespace Chill\DocGeneratorBundle\Serializer\Normalizer;
+
+use ArrayObject;
+use Doctrine\Common\Collections\Collection;
+use Symfony\Component\Serializer\Normalizer\ContextAwareNormalizerInterface;
+use Symfony\Component\Serializer\Normalizer\NormalizerAwareInterface;
+use Symfony\Component\Serializer\Normalizer\NormalizerAwareTrait;
+
+/**
+ * Normalize a collection for docgen format.
+ */
+class CollectionDocGenNormalizer implements ContextAwareNormalizerInterface, NormalizerAwareInterface
+{
+    use NormalizerAwareTrait;
+
+    /**
+     * @param Collection $object
+     *
+     * @return array|ArrayObject|bool|float|int|string|void|null
+     */
+    public function normalize($object, ?string $format = null, array $context = [])
+    {
+        $data = [];
+
+        if (null === $object || 0 === $object->count()) {
+            return $data;
+        }
+
+        foreach ($object->getIterator() as $item) {
+            $data[] = $this->normalizer->normalize($item, $format, $context);
+        }
+
+        return $data;
+    }
+
+    public function supportsNormalization($data, ?string $format = null, array $context = [])
+    {
+        if ('docgen' !== $format) {
+            return false;
+        }
+
+        return $data instanceof Collection
+            || (null === $data && Collection::class === ($context['docgen:expects'] ?? null));
+    }
+}
--- a/src/Bundle/ChillDocGeneratorBundle/Serializer/Normalizer/DocGenObjectNormalizer.php
+++ b/src/Bundle/ChillDocGeneratorBundle/Serializer/Normalizer/DocGenObjectNormalizer.php
@@ -12,6 +12,7 @@ declare(strict_types=1);
 namespace Chill\DocGeneratorBundle\Serializer\Normalizer;

 use Chill\DocGeneratorBundle\Serializer\Helper\NormalizeNullValueHelper;
+use Chill\MainBundle\Templating\TranslatableStringHelperInterface;
 use ReflectionClass;
 use RuntimeException;
 use Symfony\Component\PropertyAccess\PropertyAccess;
@@ -42,10 +43,15 @@ class DocGenObjectNormalizer implements NormalizerAwareInterface, NormalizerInte

    private PropertyAccessor $propertyAccess;

-    public function __construct(ClassMetadataFactoryInterface $classMetadataFactory)
-    {
+    private TranslatableStringHelperInterface $translatableStringHelper;
+
+    public function __construct(
+        ClassMetadataFactoryInterface $classMetadataFactory,
+        TranslatableStringHelperInterface $translatableStringHelper
+    ) {
        $this->classMetadataFactory = $classMetadataFactory;
        $this->propertyAccess = PropertyAccess::createPropertyAccessor();
+        $this->translatableStringHelper = $translatableStringHelper;
    }

    public function normalize($object, ?string $format = null, array $context = [])
@@ -57,7 +63,12 @@ class DocGenObjectNormalizer implements NormalizerAwareInterface, NormalizerInte
        }

        if (!$this->classMetadataFactory->hasMetadataFor($classMetadataKey)) {
-            throw new LogicException(sprintf('This object does not have metadata: %s. Add groups on this entity to allow to serialize with the format %s and groups %s', is_object($object) ? get_class($object) : $context['docgen:expects'], $format, implode(', ', $context['groups'])));
+            throw new LogicException(sprintf(
+                'This object does not have metadata: %s. Add groups on this entity to allow to serialize with the format %s and groups %s',
+                is_object($object) ? get_class($object) : '(todo' /*$context['docgen:expects'],*/ ,
+                $format,
+                implode(', ', ($context['groups'] ?? []))
+            ));
        }

        $metadata = $this->classMetadataFactory->getMetadataFor($classMetadataKey);
@@ -98,8 +109,9 @@ class DocGenObjectNormalizer implements NormalizerAwareInterface, NormalizerInte
            if ($reflection->hasProperty($attribute->getName())) {
                if (!$reflection->getProperty($attribute->getName())->hasType()) {
                    throw new \LogicException(sprintf(
-                        'Could not determine how the content is determined for the attribute %s. Add a type on this property',
-                        $attribute->getName()
+                        'Could not determine how the content is determined for the attribute %s on class %s. Add a type on this property',
+                        $attribute->getName(),
+                        $reflection->getName()
                    ));
                }

@@ -107,8 +119,9 @@ class DocGenObjectNormalizer implements NormalizerAwareInterface, NormalizerInte
            } elseif ($reflection->hasMethod($method = 'get' . ucfirst($attribute->getName()))) {
                if (!$reflection->getMethod($method)->hasReturnType()) {
                    throw new \LogicException(sprintf(
-                        'Could not determine how the content is determined for the attribute %s. Add a return type on the method',
-                        $attribute->getName()
+                        'Could not determine how the content is determined for the attribute %s on class %s. Add a return type on the method',
+                        $attribute->getName(),
+                        $reflection->getName()
                    ));
                }

@@ -116,8 +129,9 @@ class DocGenObjectNormalizer implements NormalizerAwareInterface, NormalizerInte
            } elseif ($reflection->hasMethod($method = 'is' . ucfirst($attribute->getName()))) {
                if (!$reflection->getMethod($method)->hasReturnType()) {
                    throw new \LogicException(sprintf(
-                        'Could not determine how the content is determined for the attribute %s. Add a return type on the method',
-                        $attribute->getName()
+                        'Could not determine how the content is determined for the attribute %s on class %s. Add a return type on the method',
+                        $attribute->getName(),
+                        $reflection->getName()
                    ));
                }

@@ -125,8 +139,9 @@ class DocGenObjectNormalizer implements NormalizerAwareInterface, NormalizerInte
            } elseif ($reflection->hasMethod($attribute->getName())) {
                if (!$reflection->getMethod($attribute->getName())->hasReturnType()) {
                    throw new \LogicException(sprintf(
-                        'Could not determine how the content is determined for the attribute %s. Add a return type on the method',
-                        $attribute->getName()
+                        'Could not determine how the content is determined for the attribute %s on class %s. Add a return type on the method',
+                        $attribute->getName(),
+                        $reflection->getName()
                    ));
                }

@@ -153,12 +168,32 @@ class DocGenObjectNormalizer implements NormalizerAwareInterface, NormalizerInte
    {
        $keys = [];

+        // add a discriminator
+        if (null !== $discriminator = $metadata->getClassDiscriminatorMapping()) {
+            $typeKey = $discriminator->getTypeProperty();
+            $typeValue = null;
+
+            foreach ($discriminator->getTypesMapping() as $type => $typeClass) {
+                if ($typeClass === $context['docgen:expects']) {
+                    $typeValue = $type;
+
+                    break;
+                }
+            }
+
+            if (null === $typeValue) {
+                $typeKey = null;
+            }
+        } else {
+            $typeKey = $typeValue = null;
+        }
+
        foreach ($attributes as $attribute) {
            $key = $attribute->getSerializedName() ?? $attribute->getName();
            $keys[$key] = $this->getExpectedType($attribute, $metadata->getReflectionClass());
        }

-        $normalizer = new NormalizeNullValueHelper($this->normalizer);
+        $normalizer = new NormalizeNullValueHelper($this->normalizer, $typeKey, $typeValue);

        return $normalizer->normalize($keys, $format, $context);
    }
@@ -172,6 +207,10 @@ class DocGenObjectNormalizer implements NormalizerAwareInterface, NormalizerInte

        switch ($type) {
            case 'array':
+                if (in_array('is-translatable', $attribute->getNormalizationContextForGroups(['docgen:read']), true)) {
+                    return '';
+                }
+
                return [];

            case 'bool':
@@ -208,14 +247,26 @@ class DocGenObjectNormalizer implements NormalizerAwareInterface, NormalizerInte
    private function normalizeObject($object, $format, array $context, array $expectedGroups, ClassMetadata $metadata, array $attributes)
    {
        $data = [];
+        $data['isNull'] = false;
        $reflection = $metadata->getReflectionClass();

+        // add a discriminator
+        if (null !== $discriminator = $metadata->getClassDiscriminatorMapping()) {
+            $data[$discriminator->getTypeProperty()] = $discriminator->getMappedObjectType($object);
+        }
+
        foreach ($attributes as $attribute) {
            /** @var AttributeMetadata $attribute */
            $value = $this->propertyAccess->getValue($object, $attribute->getName());
            $key = $attribute->getSerializedName() ?? $attribute->getName();
+            $isTranslatable = $attribute->getNormalizationContextForGroups(
+                is_array($context['groups']) ? $context['groups'] : [$context['groups']]
+            )['is-translatable'] ?? false;

-            if (is_iterable($value)) {
+            if ($isTranslatable) {
+                $data[$key] = $this->translatableStringHelper
+                    ->localize($value);
+            } elseif (is_iterable($value)) {
                $arr = [];

                foreach ($value as $k => $v) {
--- a/src/Bundle/ChillDocGeneratorBundle/config/services.yaml
+++ b/src/Bundle/ChillDocGeneratorBundle/config/services.yaml
@@ -20,6 +20,9 @@ services:
        resource: '../Serializer/Normalizer/'
        tags:
            - { name: 'serializer.normalizer', priority: -152 }
+    Chill\DocGeneratorBundle\Serializer\Normalizer\CollectionDocGenNormalizer:
+        tags:
+            - { name: 'serializer.normalizer', priority: -126 }

    Chill\DocGeneratorBundle\Controller\:
        resource: "../Controller"
--- a/src/Bundle/ChillDocGeneratorBundle/tests/Serializer/Normalizer/DocGenObjectNormalizerTest.php
+++ b/src/Bundle/ChillDocGeneratorBundle/tests/Serializer/Normalizer/DocGenObjectNormalizerTest.php
@@ -11,7 +11,7 @@ declare(strict_types=1);

 namespace Chill\DocGeneratorBundle\tests\Serializer\Normalizer;

-use Chill\MainBundle\Entity\Center;
+use Chill\MainBundle\Entity\Scope;
 use Chill\MainBundle\Entity\User;
 use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
 use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
@@ -35,25 +35,36 @@ final class DocGenObjectNormalizerTest extends KernelTestCase

    public function testNormalizationBasic()
    {
-        $user = new User();
-        $user->setUsername('User Test');
-        $user->setMainCenter($center = new Center());
-        $center->setName('test');
+        $scope = new Scope();
+        $scope->setName(['fr' => 'scope']);

-        $normalized = $this->normalizer->normalize($user, 'docgen', [AbstractNormalizer::GROUPS => ['docgen:read'], 'docgen:expects' => User::class]);
+        $normalized = $this->normalizer->normalize($scope, 'docgen', [AbstractNormalizer::GROUPS => ['docgen:read'], 'docgen:expects' => Scope::class]);
        $expected = [
-            'label' => 'User Test',
-            'email' => '',
-            'mainCenter' => [
-                'name' => 'test',
-            ],
+            'id' => null,
+            'name' => 'scope',
+            'type' => 'scope',
+            'isNull' => false,
        ];

-        $this->assertEquals($expected, $normalized, 'test normalization fo an user');
+        $this->assertEquals($expected, $normalized, 'test normalization fo a scope');
+    }
+
+    public function testNormalizeNull()
+    {
+        $actual = $this->normalizer->normalize(null, 'docgen', [AbstractNormalizer::GROUPS => ['docgen:read'], 'docgen:expects' => Scope::class]);
+        $expected = [
+            'id' => '',
+            'name' => '',
+            'type' => 'scope',
+            'isNull' => true,
+        ];
+
+        $this->assertEquals($expected, $actual, 'test normalization for a null scope');
    }

    public function testNormalizeNullObjectWithObjectEmbedded()
    {
+        $this->markTestIncomplete('test to implement');
        $normalized = $this->normalizer->normalize(null, 'docgen', [
            AbstractNormalizer::GROUPS => ['docgen:read'],
            'docgen:expects' => User::class,
@@ -62,7 +73,7 @@ final class DocGenObjectNormalizerTest extends KernelTestCase
        $expected = [
            'label' => '',
            'email' => '',
-            'mainCenter' => [
+            'main_center' => [
                'name' => '',
            ],
        ];
@@ -72,6 +83,7 @@ final class DocGenObjectNormalizerTest extends KernelTestCase

    public function testNormalizeWithNullValueEmbedded()
    {
+        $this->markTestIncomplete('test to write');
        $user = new User();
        $user->setUsername('User Test');