Visão geral da plataforma

O Manual Técnico 2.1 descreve uma aplicação web Java distribuída em modelo cliente-servidor, organizada em MVC e implantada como WAR no WildFly.

Diagrama de referência do repositório: aplicação Java/JSF, banco LEC e consulta ao banco AGHU. A menção a Java 7/8 é histórica; o manual vigente especifica Java 8.

Camadas e tecnologias vigentes

ResponsabilidadeTecnologia documentadaPapel
VisãoJSF 2.3, XHTML/Facelets, Bootstrap 4.1.3, jQuery 3.4.1Renderiza telas e recebe eventos do usuário.
ControleBeans JSFValida entradas e coordena chamadas ao modelo.
NegócioEJBImplementa serviços e regras de negócio.
PersistênciaJPA 2.1 / HibernateMapeia entidades Java para tabelas PostgreSQL.
AplicaçãoJava 8 e WildFly 20.0.1.FinalExecuta o WAR AgendaCirurgicaAdm.
Web / TLSApache 2.4Proxy reverso, HTTPS e possível balanceamento.
RelatóriosJasperReports 5.6.0 e Apache POI 4.1.2Gera PDFs e planilhas.
DadosPostgreSQL 11.13Mantém dblec e permite consulta ao AGHU por datasource separado.

Serviços e dependências

Navegador
   ↓ HTTPS
Apache 2.4 (proxy / certificado)
   ↓
WildFly 20 + Java 8
   ├── datasource LEC → PostgreSQL / dblec
   ├── datasource AGHU → réplica de leitura / dbaghu
   ├── LDAP/AD → autenticação corporativa
   └── CUPS / AGHU → impressão
  • O manual recomenda consulta ao banco secundário do AGHU para reduzir carga e risco de interrupção.
  • O banco LEC mantém os dados operacionais próprios; a documentação de infraestrutura considera replicação conforme o padrão local.
  • O Apache termina TLS e encaminha o contexto da aplicação ao WildFly.
  • Autenticação de usuários finais permanece corporativa via LDAP/AD e resolução de perfil no AGHU.
  • Impressão depende do cadastro AGHU e do cliente CUPS no servidor de aplicação.

Referência de infraestrutura

A solicitação operacional de 2026 e o Manual 2.1 convergem em uma referência básica para a VM de aplicação.

RecursoReferência documentada
Sistema operacionalDebian 12, 64 bits
CPU4 vCPU
Memória8 GB
Disco100 GB na solicitação operacional; o manual detalha particionamento LVM
JavaOpenJDK 8
Servidor de aplicaçãoWildFly 20.0.1.Final
Servidor webApache 2.4.62
BancoPostgreSQL, com acesso separado ao dblec e à réplica AGHU

Sequência segura de implantação

  1. 1
    Preparar infraestrutura

    Validar SO, rede, DNS, firewall, certificados e contas administradas nos canais oficiais.

  2. 2
    Provisionar os bancos

    Criar dblec pelo artefato vigente e conceder apenas leitura ao datasource AGHU.

  3. 3
    Instalar Java e WildFly

    Configurar serviço, memória e driver PostgreSQL conforme o manual validado.

  4. 4
    Configurar datasources

    Separar LEC e AGHU, usar valores do cofre e testar a conectividade sem registrar segredos em tickets.

  5. 5
    Publicar o WAR

    Fazer deploy controlado e verificar o contexto da aplicação.

  6. 6
    Configurar Apache e TLS

    Preferir certificado institucional; restringir consoles administrativos.

  7. 7
    Cadastrar perfis e parâmetros

    Aplicar nomes e defaults da versão atual antes da validação funcional.

  8. 8
    Executar aceite

    Testar login, indicação, rotinas AGHU, impressão, relatórios e logs em ambiente apropriado.