Árvore de páginas

Para o correto funcionamento do sistema, é obrigatória a parametrização da pasta raiz de importação e da pasta raiz de geração. Este caminho servirá como a base para que o sistema crie e gerencie uma estrutura de pastas específica, essencial para o processamento, armazenamento e organização dos arquivos da aplicação.

Inicialmente, na primeira definição da pasta de importação pelo usuário será ativado um serviço que cria uma pasta para cada empresa com formato `codigo_empresa` cadastrada no sistema bem como as pastas internas necessárias. A partir daí a cada criação de empresa será verificada se existe pasta para tal, se não, será criada uma nova pasta com o diretório de importação e geração referente a ela.

A criação automática desta estrutura garante a organização dos dados e o fluxo correto das informações processadas, desde a entrada dos arquivos até a geração dos informes finais.

Inicialmente, o sistema não realizará nenhuma validação sobre o conteúdo ou a integridade da estrutura de pastas após sua criação.

A responsabilidade pela manutenção da integridade do diretório parametrizado é inteiramente do cliente. Qualquer alteração manual, como renomear ou excluir pastas vitais da estrutura padrão, pode comprometer o fluxo de processamento e resultar em erros críticos na aplicação. Recomenda-se que nenhum usuário altere ou remova as pastas geradas automaticamente pelo sistema.


Estrutura


  1. Pasta Raiz Importação: `pasta_parametrizada` (object storage)
    1. Pastas por Empresa: Dentro da pasta raiz de importação, haverá uma pasta para cada empresa, nomeada com o código da empresa (ex: `codigo_empresa_A`, `codigo_empresa_B`, etc.).
      1. Subpastas dentro de cada Pasta de Empresa: Cada pasta de empresa conterá as seguintes subpastas:
        1. `entrada`: Armazena os arquivos JSON de entrada para o processamento do software.
        2. `processando`: Armazena os arquivos JSON com status de processamento em andamento.
        3. `erro`: Armazena os arquivos JSON que geraram erros impeditivos durante o processamento.
        4. `aviso`: Armazena os arquivos JSON que foram processados com alguns erros*, mas com registros de sucesso.
        5. `sucesso`: Armazena os arquivos JSON que foram processados com 100% de sucesso.
  2. Pasta Raiz Geração: Armazena os informes gerados em PDF.
    1. Subpastas de Anos: Dentro da pasta raiz de geração, haverá pastas para cada ano com informes gerados (ex: `2025`, `2024`, etc.).
      1. Subpastas de período de meses (anual e trimestral): Dentro de cada pasta de ano haverá as pastas de informes anuais e informes trimestrais (ex: `anual`, `03`, `06`, `09`, `12`).
        1. Subpastas por lote: Dentro de cada pasta de período de mês, haverá pastas por lote identificadas com um número sequencial (`1`, `2`, `3`…) para que não atinja limite de pastas/arquivos por sistema de arquivo ou SO. A cada 1000 arquivos (este valor é parametrizável) uma nova pasta de lote é gerada.


Exemplo:

  • Padrão de entrada: {Diretorio_Raiz_Configurado}/{CODIGO_EMPRESA}/entrada/
  • Diretorio_Raiz_Configurado: Caminho base definido nas Configurações Gerais do sistema.
  • CODIGO_EMPRESA: Código numérico da empresa (ex: 12345).
  • Se o diretório raiz for C:\Users\usuario\produto_informe_rendimentos\dados\importacao e a empresa for 11111, o arquivo deve ser salvo em:
  • C:\Users\usuario\produto_informe_rendimentos\dados\importacao\11111\entrada\


  • Sem rótulos