src/ApplicationBundle/Modules/Document/Controller/DocumentController.php line 25

Open in your IDE?
  1. <?php
  3. namespace ApplicationBundle\Modules\Document\Controller;
  5. use ApplicationBundle\Controller\GenericController;
  6. use ApplicationBundle\Interfaces\SessionCheckInterface;
  7. use ApplicationBundle\Modules\Document\DocumentNumberService;
  8. use Symfony\Component\HttpFoundation\JsonResponse;
  9. use Symfony\Component\HttpFoundation\Request;
  11. /**
  12.  * S2.4 — Document Number Sequence admin controller.
  13.  *
  14.  * Provides:
  15.  *  - DocumentPrefixListAction  GET  /document/prefix_list
  16.  *  - DocumentPrefixResetAction POST /document/prefix_reset        (admin only)
  17.  *  - DocumentSequenceApiAction GET  /document/next_number/{type}  (internal dev/test)
  18.  */
  19. class DocumentController extends GenericController implements SessionCheckInterface
  20. {
  21.     /**
  22.      * List all active prefix sequences (current year), grouped by prefix.
  23.      * Admin page — information card.
  24.      */
  25.     public function DocumentPrefixListAction(Request $request)
  26.     {
  27.         $em       = $this->getDoctrine()->getManager();
  28.         $year     = (int)date('Y');
  29.         $tenantId = 1;
  31.         $conn = $em->getConnection();
  33.         // `document_number_sequences` is created by NOTHING in this codebase: it has no
  34.         // Entity and no .orm.yml, so update_database_schema will never provision it, and
  35.         // DocumentNumberService writes to it with raw SQL assuming it is already there.
  36.         // On a tenant without the table this page 500'd outright. An admin information
  37.         // page must not be the thing that breaks — it now says the sequences are not
  38.         // provisioned and stays readable, which is also what tells an admin WHY the
  39.         // numbering feature is doing nothing.
  40.         $rows          = [];
  41.         $tableMissing  = false;
  42.         try {
  43.             $rows = $conn->fetchAllAssociative(
  44.                 'SELECT prefix, year, last_seq, tenant_id
  45.                    FROM document_number_sequences
  46.                   WHERE tenant_id = ?
  47.                   ORDER BY prefix ASC, year DESC',
  48.                 [$tenantId]
  49.             );
  50.         } catch (\Throwable $e) {
  51.             // Only a missing table is tolerated; anything else is a real fault and
  52.             // should keep surfacing rather than hiding behind an empty list.
  53.             if (stripos($e->getMessage(), 'document_number_sequences') === false) {
  54.                 throw $e;
  55.             }
  56.             $tableMissing = true;
  57.         }
  59.         // Build prefix description map from service
  60.         $typeToPrefix = DocumentNumberService::getTypeToPrefix();
  61.         $prefixToType = array_flip($typeToPrefix);
  63.         return $this->render('@Document/pages/list/list_document_prefixes.html.twig', [
  64.             'page_title'    => 'Document Number Sequences',
  65.             'rows'          => $rows,
  66.             'prefixToType'  => $prefixToType,
  67.             'currentYear'   => $year,
  68.             'tableMissing'  => $tableMissing,
  69.         ]);
  70.     }
  72.     /**
  73.      * AJAX: return the next formatted document number without consuming it.
  74.      * Used by forms to preview the number that will be assigned.
  75.      * GET /document/peek_number/{type}
  76.      */
  77.     public function DocumentPeekNumberAction(Request $request, string $type = 'offer')
  78.     {
  79.         $em       = $this->getDoctrine()->getManager();
  80.         $tenantId = 1;
  81.         $year     = (int)date('Y');
  83.         $conn = $em->getConnection();
  84.         try {
  85.             $prefix = DocumentNumberService::prefixForType($type);
  86.         } catch (\RuntimeException $e) {
  87.             return new JsonResponse(['error' => $e->getMessage()], 400);
  88.         }
  90.         $row = $conn->fetchAssociative(
  91.             'SELECT last_seq FROM document_number_sequences WHERE tenant_id=? AND prefix=? AND year=?',
  92.             [$tenantId, $prefix, $year]
  93.         );
  95.         $nextSeq = $row ? (int)$row['last_seq'] + 1 : 1;
  96.         return new JsonResponse([
  97.             'type'   => $type,
  98.             'prefix' => $prefix,
  99.             'year'   => $year,
  100.             'nextSeq'=> $nextSeq,
  101.             'number' => DocumentNumberService::format($prefix, $year, $nextSeq),
  102.         ]);
  103.     }
  104. }