Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Para o correto funcionamento do sistema, é obrigatória a

...

Foi definido que a estrutura de pastas no servidor parametrizado deverá obedecer a seguinte:

...

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

draw.io Diagram
bordertrue
diagramNameestrutura_pata_informe
simpleViewerfalse
width
linksauto
tbstyletop
lboxtrue
diagramWidth538
revision8


  1. Pasta Raiz Importação
  1. : `pasta_parametrizada` (object storage)
    1. Pastas por Empresa: Dentro da

...

    1. pasta raiz de importação, haverá uma pasta para cada empresa, nomeada com o

...

    1. código da empresa (ex:

...

    1. `codigo_

...

    1. empresa_A`,

...

    1. `codigo_

...

    1. 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.

...

        1. `sucesso`: Armazena os arquivos JSON que foram processados com 100% de sucesso.

...

  1. Pasta Raiz Geração: Armazena os informes gerados em PDF.
    1. Subpastas de Anos: Dentro da pasta

...

    1. raiz de geração, haverá pastas para cada ano com informes gerados (ex:

...

    1. `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. `1`, `2`, `3`…) para que não atinja limite de pastas/arquivos por sistema de arquivo ou SO. A cada

...

        1. 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\