Histórico da Página

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

draw.io Diagram

border	true

diagramName	estrutura_pata_informe
simpleViewer	false
width
links	auto
tbstyle	top
lbox	true
diagramWidth	410538
revision	28

Pasta Raiz Importação: `pasta_parametrizada` (object storage)
1. Pastas por Empresa: Dentro da `pasta_parametrizada`pasta raiz de importação, haverá uma pasta para cada empresa, nomeada com o nome código da empresa (ex: `Empresa`codigo_empresa_A`, `Empresa`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. `finalizados``sucesso`: Armazena os arquivos JSON que foram processados com 100% de sucesso.`informes_gerados`
Pasta Raiz Geração: Armazena os informes gerados em PDF.
1. Subpastas de Anos: Dentro da pasta `informes_gerados`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 (`lote_1`, `lote_2`, `1`, `2`, `3`…) para que não atinja limite de pastas/arquivos por sistema de arquivo ou SO. A cada 10k 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\

Árvore de páginas

Versões comparadas

Versão antiga 8

Nova versão Atual

Chave

Estrutura