vendor/crosiersource/crosierlib-radx/src/Entity/Financeiro/Categoria.php line 61

Open in your IDE?
  1. <?php
  3. namespace CrosierSource\CrosierLibRadxBundle\Entity\Financeiro;
  5. use ApiPlatform\Core\Annotation\ApiFilter;
  6. use ApiPlatform\Core\Annotation\ApiResource;
  7. use ApiPlatform\Core\Bridge\Doctrine\Orm\Filter\OrderFilter;
  8. use ApiPlatform\Core\Bridge\Doctrine\Orm\Filter\SearchFilter;
  9. use ApiPlatform\Core\Serializer\Filter\PropertyFilter;
  10. use CrosierSource\CrosierLibBaseBundle\Doctrine\Annotations\EntityHandler;
  11. use CrosierSource\CrosierLibBaseBundle\Doctrine\Annotations\NotUppercase;
  12. use CrosierSource\CrosierLibBaseBundle\Entity\EntityId;
  13. use CrosierSource\CrosierLibBaseBundle\Entity\EntityIdTrait;
  14. use CrosierSource\CrosierLibBaseBundle\Utils\StringUtils\StringUtils;
  15. use Doctrine\Common\Collections\ArrayCollection;
  16. use Doctrine\ORM\Mapping as ORM;
  17. use Exception;
  18. use Symfony\Component\Serializer\Annotation\Groups;
  19. use Symfony\Component\Serializer\Annotation\MaxDepth;
  21. /**
  22.  *
  23.  * @ApiResource(
  24.  *     normalizationContext={"groups"={"categoria","entityId"},"enable_max_depth"=true},
  25.  *     denormalizationContext={"groups"={"categoria"},"enable_max_depth"=true},
  26.  *
  27.  *     itemOperations={
  28.  *          "get"={"path"="/fin/categoria/{id}", "security"="is_granted('ROLE_FINAN')"},
  29.  *          "put"={"path"="/fin/categoria/{id}", "security"="is_granted('ROLE_FINAN_MASTER')"},
  30.  *          "delete"={"path"="/fin/categoria/{id}", "security"="is_granted('ROLE_FINAN_MASTER')"}
  31.  *     },
  32.  *     collectionOperations={
  33.  *          "get"={"path"="/fin/categoria", "security"="is_granted('ROLE_FINAN')"},
  34.  *          "post"={"path"="/fin/categoria", "security"="is_granted('ROLE_FINAN_MASTER')"}
  35.  *     },
  36.  *
  37.  *     attributes={
  38.  *          "pagination_items_per_page"=10,
  39.  *          "formats"={"jsonld", "csv"={"text/csv"}}
  40.  *     }
  41.  *
  42.  * )
  43.  * @ApiFilter(PropertyFilter::class)
  44.  *
  45.  * @ApiFilter(SearchFilter::class, properties={
  46.  *     "codigo": "exact",
  47.  *     "codigoSuper": "exact",
  48.  *     "descricao": "partial",
  49.  *     "id": "exact",
  50.  *     "categoria": "exact"
  51.  * })
  52.  * @ApiFilter(OrderFilter::class, properties={"id", "codigoOrd", "descricao", "dtConsolidado", "updated"}, arguments={"orderParameterName"="order"})
  53.  *
  54.  * @EntityHandler(entityHandlerClass="CrosierSource\CrosierLibRadxBundle\EntityHandler\Financeiro\CategoriaEntityHandler")
  55.  *
  56.  * @ORM\Entity(repositoryClass="CrosierSource\CrosierLibRadxBundle\Repository\Financeiro\CategoriaRepository")
  57.  * @ORM\Table(name="fin_categoria")
  58.  *
  59.  * @author Carlos Eduardo Pauluk
  60.  */
  61. class Categoria implements EntityId
  62. {
  63.     use EntityIdTrait;
  64.     
  65.     /**
  66.      * @ORM\Id()
  67.      * @ORM\Column(type="bigint")
  68.      * @Groups("entityId")
  69.      */
  70.     private ?int $id = null;
  72.     public const MASK = '0.00.000.000.000';
  75.     /**
  76.      * @ORM\ManyToOne(targetEntity="CrosierSource\CrosierLibRadxBundle\Entity\Financeiro\Categoria", inversedBy="subCategs")
  77.      * @ORM\JoinColumn(name="pai_id",nullable=true)
  78.      * @Groups("categoria")
  79.      * @MaxDepth(1)
  80.      */
  81.     public ?Categoria $pai = null;
  83.     /**
  84.      * @ORM\OneToMany(
  85.      *      targetEntity="Categoria",
  86.      *      mappedBy="pai"
  87.      * )
  88.      * @Groups({"public"})
  89.      *
  90.      * @var Categoria[]|ArrayCollection|null
  91.      */
  92.     public $subCategs = null;
  94.     /**
  95.      * @ORM\Column(name="descricao", type="string")
  96.      * @Groups("categoria")
  97.      */
  98.     public ?string $descricao = null;
  100.     /**
  101.      * Para os casos onde a movimentação é importada automaticamente, define qual a descrição padrão.
  102.      *
  103.      * @ORM\Column(name="descricao_padrao_moviment", type="string")
  104.      */
  105.     public ?string $descricaoPadraoMoviment = null;
  107.     /**
  108.      * @ORM\Column(name="codigo", type="bigint", nullable=false)
  109.      * @Groups("categoria")
  110.      */
  111.     public ?int $codigo = null;
  113.     /**
  114.      * A fim de relatórios.
  115.      *
  116.      * @ORM\Column(name="totalizavel", type="boolean", nullable=false)
  117.      */
  118.     public ?bool $totalizavel = false;
  120.     /**
  121.      * Informa se esta categoria necessita que o CentroCusto seja informado (ou se ele será automático).
  122.      *
  123.      * @ORM\Column(name="centro_custo_dif", type="boolean", nullable=false)
  124.      */
  125.     public ?bool $centroCustoDif = false;
  127.     /**
  128.      * Informa quais ROLES possuem acesso as informações (categoria.descricao e movimentacao.descricao).
  129.      * Para mais de uma, informar separado por vírgula.
  130.      *
  131.      * @ORM\Column(name="roles_acess", type="string", nullable=true, length=2000)
  132.      */
  133.     public ?string $rolesAcess = null;
  135.     /**
  136.      * Caso o usuário logado não possua nenhuma das "rolesAcess", então a descrição alternativa deve ser exibida.
  137.      *
  138.      * @ORM\Column(name="descricao_alternativa", type="string", nullable=true, length=200)
  139.      */
  140.     public ?string $descricaoAlternativa = null;
  142.     /**
  143.      * Atalho para não precisar ficar fazendo parse.
  144.      *
  145.      * @ORM\Column(name="codigo_super", type="bigint", nullable=true)
  146.      * @Groups("categoria")
  147.      */
  148.     public ?int $codigoSuper = null;
  150.     /**
  151.      * Atalho para não precisar ficar fazendo parse.
  152.      *
  153.      * @ORM\Column(name="codigo_ord", type="bigint", nullable=true)
  154.      * @Groups("categoria")
  155.      */
  156.     public ?int $codigoOrd = null;
  158.     /**
  159.      *
  160.      * @ORM\Column(name="json_data", type="json")
  161.      * @var null|array
  162.      * @NotUppercase()
  163.      * @Groups("categoria")
  164.      */
  165.     public ?array $jsonData = null;
  166.     
  167.     /**
  168.      */
  169.     public function __construct()
  170.     {
  171.         $this->subCategs = new ArrayCollection();
  172.     }
  174.     /**
  175.      * @return Categoria[]|ArrayCollection|null
  176.      */
  177.     public function getSubCategs()
  178.     {
  179.         return $this->subCategs;
  180.     }
  182.     /**
  183.      * @param Categoria[]|ArrayCollection|null $subCategs
  184.      * @return Categoria
  185.      */
  186.     public function setSubCategs($subCategs): Categoria
  187.     {
  188.         $this->subCategs = $subCategs;
  189.         return $this;
  190.     }
  192.     /**
  193.      * Retorna a descrição de uma Categoria no formato codigo + descricao (Ex.:
  194.      * 2.01 - DESPESAS PESSOAIS).
  195.      * @Groups("categoria")
  196.      */
  197.     public function getDescricaoMontada(): ?string
  198.     {
  199.         return $this->getCodigoM() . ' - ' . $this->descricao;
  200.     }
  202.     /**
  203.      *
  204.      * Retorna a descrição de uma Categoria no formato codigo + descricao (Ex.:
  205.      * 2.01 - DESPESAS PESSOAIS).
  206.      * @Groups("categoria")
  207.      * @return string|null
  208.      */
  209.     public function getDescricaoMontadaTree(): ?string
  210.     {
  211.         return str_pad('', (strlen($this->codigo) - 1) * 2, '.') . ' ' . $this->getCodigoM() . ' - ' . $this->descricao;
  212.     }
  214.     /**
  215.      * @return string|null
  216.      * @Groups("categoria")
  217.      */
  218.     public function getCodigoM(): ?string
  219.     {
  220.         try {
  221.             return StringUtils::mascarar($this->codigo, self::MASK);
  222.         } catch (Exception $e) {
  223.             return $this->codigo;
  224.         }
  225.     }
  227.     /**
  228.      * Retorna somente o último 'bloco' do código.
  229.      * @return string|null
  230.      */
  231.     public function getCodigoSufixo(): ?string
  232.     {
  233.         if ($this->codigo) {
  234.             if (!$this->pai) {
  235.                 return $this->codigo;
  236.             }
  237.             // else
  238.             // Se tem pai, é o restante do código, removendo a parte do pai:
  239.             return substr($this->pai->getCodigoM(), strlen($this->pai->getCodigoM()) + 1);
  241.         }
  242.         return null;
  243.     }
  246.     /**
  247.      * @return string
  248.      * @Groups("categoria")
  249.      */
  250.     public function getMascaraDoFilho(): ?string
  251.     {
  252.         if (!$this->codigo) {
  253.             return null;
  254.         }
  255.         $tam = strlen($this->codigo);
  256.         if ($tam === 1) {
  257.             return '99';
  258.         } elseif ($tam <= 12) {
  259.             return '999';
  260.         } else {
  261.             return null;
  262.         }
  263.     }
  265. }