Serviço destinado ao módulo negocial eCarta. O serviço é uma solução de captação eletrônica dos dados da mensagem que depois são processados para o meio físico pelos Correios, automatizando o envio e retorno de correspondências.

1. Como funciona

O serviço eCarta recebe informações e retorna relatórios via interface REST, e realiza o retorno de documentos via MNI.

1.1. Configuração do tribunal no eCarta

Pode-se configurar o serviço eCarta para um tribunal através de serviço disponível em "/api/v1/configuracoes"

1.2. Envio de expedientes

O envio de expedientes ao eCarta se dá através dos serviços disponíveis em "/api/v1/expedientes"

1.3. Monitoramente de batch e relatórios

Os relatórios de execução dos batchs do eCarta são obtidos via serviços disponíveis em "/api/v1/jobs"

1.4. Relatórios negociais

Os relatórios negociais do eCarta são obtidos via serviços disponíveis em "/api/v1/relatorio"

1.5. Retorno via MNI

O eCarta retorna documentos por meio do mni-client-service.

Fluxo básico do sistema

image

2. Testes

Somente será dado acesso ao código fonte deste projeto àqueles que efetivamente irão contribuir com o seu desenvolvimento. Portanto, é necessário haver pelo menos uma demanda aberta no sistema de controle de demandas (Jira) para o projeto PJEECT.

2.2. Local

Execute o comando abaixo
$ docker container run --rm --name ecarta -it -p 8880:8880 \
registry.cnj.jus.br/pje2/pje2-servicos/ecarta:latest
Table 1. Variáveis de ambiente
Nome da variável Valor padrão Descrição

SERVER_PORT

8880

Porta do serviço

SSO_AUTH_SERVER

http://localhost:8080/auth

URL do Keycloak

SSO_REALM

pje

Realm da aplicação no Keyclaok

SSO_RESOURCE

ecarta-service

Resource no keycloak

DB_DRIVER

org.h2.Driver

Driver do banco de dados

DB_URL

jdbc:h2:mem:mydb;DB_CLOSE_ON_EXIT=FALSE

URL do banco

DB_USER

sa

Usuário do banco

DB_PASSWORD

Senha de acesso ao banco

EUREKA_SERVER_DEFAULT_ZONE

http://localhost:8761/eureka

Url do service discovery

EUREKA_CLIENT_ENABLED

true

Indicativo de que o serviço deve ou não se registrar no service discovery

3. Tecnologias empregadas

O serviço eCarta foi construído com SpringBoot 2. Este serviço fornece API para manipulação e recuperação de seus recursos utilizando REST. Utiliza o banco de dados PostgreSQL.

3.1. Linguagem de programação

Java versão 11.

3.2. Framework(s)

SpringBoot 2.

3.3. Armazenamento dos dados

Banco relacional PostgreSQL.

3.4. Outros temas

Os logs da aplicação podem ser enviados à um serviço REDIS para que seja consumido pelo Logstash e indexado no ElasticSearch.

Os logs de auditoria da aplicação são armazenados no banco de dados e disponibilizados via API, concedendo acesso por tribunal conforme configurado no Keycloak.

4. Comunidade

4.1. Dúvidas

Faça parte da nossa comunidade no rocket.chat. Acesse https://rocketchat.cloud.pje.jus.br/channel/ecarta.

4.2. Requisição de melhorias e correções de defeitos

Pode-se abrir uma demanda no sistema Jira para o projeto PJEECT.