Sistemas Acadêmicos em Oracle PL/SQL

Decisões de engenharia

1. 01

   O binário que a documentação diz que não atravessa

   Para emitir o diploma digital eu precisava do documento digitalizado, que vive em outro banco de dados. A documentação da Oracle é explícita: o ponteiro de um arquivo binário selecionado de uma tabela remota não pode ser usado localmente — o banco recusa. A saída óbvia seria um serviço intermediário; a saída que encontrei dispensa isso. Em vez de ler o ponteiro remoto, materializo o binário direto numa tabela temporária local, com uma única instrução de inserção alimentada pela consulta remota: a partir dali o arquivo é local e manipulável. Depois leio em blocos de 1.440 bytes — múltiplo de três, para que o preenchimento do base64 não corrompa a emenda entre blocos — e monto o JSON. Um detalhe de três bytes é a diferença entre um diploma válido e um arquivo corrompido.

2. 02

   Encabecei a troca da plataforma inteira de aplicações

   Migrar a plataforma de formulários e relatórios de uma versão maior para a seguinte não é copiar arquivos: cada módulo precisa recompilar, e o que não compila precisa ser entendido e corrigido — um a um. Encabecei essa migração no sistema acadêmico e montei o parque que roda hoje: 1.622 formulários e 1.052 relatórios recompilados, revalidados e editados onde foi preciso, mais as bibliotecas compartilhadas e a configuração de diretórios remotos. O acervo de origem tinha quase o dobro de módulos, entre versões e duplicatas; o que ficou em produção passou por curadoria. É o parque que continua no ar.

3. 03

   Diploma digital: liderei a troca do papel pelo documento com fé pública

   Liderei o projeto que trocou o diploma de papel pelo digital — documento com validade jurídica, exigência regulatória, sem margem para erro de dado. O package que escrevi orquestra o ciclo inteiro sem sair do banco: valida vinte regras antes de deixar o registro sair (a carga horária tem de fechar com a matriz curricular, as portarias de reconhecimento precisam existir e não duplicar, o número da página do Diário Oficial tem de ser numérico), monta o JSON e dispara a requisição autenticada para a API do registrador, com carteira HTTPS e credencial lida de parâmetro cifrado. Registrar, consultar e anular; e uma fila com job de cinco em cinco minutos reconciliando o estado de cada diploma. São 35 mil diplomas digitais emitidos.

4. 04

   O relatório que a Reitoria lê toda manhã

   O mapa de matrículas — 61 milhões de linhas e 182 colunas reconstruídas por uma rotina diária — vinha de madrugadas que estouravam o horário. Reescrevi o motor para acumular os subtotais em memória, em tabelas associativas indexadas por chave de texto, e gravar uma única vez no fim: o package inteiro tem só dois INSERTs. A própria tabela audita quando cada linha nasce, então o efeito é medível na série de 20 anos: a janela típica de geração caiu de 19 para 9 minutos, o p90 de 58 para 24 — o melhor patamar de toda a série — e as madrugadas de 8 horas ou mais, que eram dezenas por ano, praticamente desapareceram.

5. 05

   Correção de provas fora da tela (2016)

   O EAD gera provas aos milhões e a correção síncrona travava a experiência do aluno. Transformei o fluxo em fila: a resposta entra numa tabela e um job corrige em background — o que hoje se chamaria de worker assíncrono, feito com as peças que o Oracle 11g oferecia. São 8,2 milhões de provas na tabela de produção.

6. 06

   Vestibular online na semana do lockdown

   Entre 18 e 22 de março de 2020, o processo seletivo presencial deixou de existir. A rotina de prova online entrou em produção nessa mesma janela, reaproveitando o motor de provas do EAD — e o vestibular não parou. Anos depois, o mesmo package ganhou a fila de integração com o CRM.

7. 07

   Migração de ERP com trava financeira

   Migrar histórico escolar e financeiro com o sistema no ar exige mais que ETL: 25 tabelas de staging com 16 milhões de linhas conciliadas, mapeamento de matrizes curriculares entre os dois sistemas — e uma trigger que bloqueia a movimentação dos títulos em migração, para nenhuma cobrança nascer errada durante o corte.

8. 08

   O problema clássico, resolvido uma vez

   Trigger que lê a própria tabela que a disparou é a armadilha mais clássica do Oracle (mutating table). Em vez de N contornos espalhados, um package central concentra o padrão — estado em memória por sessão — e as triggers do sistema delegam a ele. Legado também tem arquitetura.

9. 09

   Regras de dinheiro real

   Boleto do kit de matrícula, segunda via que se recusa a imprimir título rejeitado pelo banco, renegociação de dívida, confirmação automática de matrícula para bolsistas com 75%+ de aproveitamento. Regras financeiras onde um if errado vira cobrança indevida para um aluno real — o domínio onde aprendi a conferir antes de confiar.

10. 10

    O banco como hub: as integrações, nomeadas

    De dentro do PL/SQL, o sistema conversa com o ecossistema inteiro: folha de pagamento, LDAP e contas Google, gestão documental (GED), biblioteca, o CRM (fila de candidatos), os órgãos reguladores (registro de diploma, Censo, ENADE) — e alimenta a plataforma de dados. Os pagamentos têm capítulo próprio: Pix, boleto registrado em dois bancos e recorrência de cartão passam por middlewares Node que fazem o TLS moderno que o banco não negocia. E na direção contrária o banco também serve: 108 endpoints REST em 18 módulos, com 57 milhões de chamadas auditadas com payload.

11. 11

    A camada Java: o portal do aluno sobre o núcleo do banco

    O que o aluno vê — rematrícula, atestados, provas do ensino a distância, faturas, acordos, diploma — é um portal Java que atravessou duas gerações, e eu atravessei as duas com ele: 195 arquivos e 52,7 mil linhas carregam minha assinatura no versionamento, 72 deles em Spring. A arquitetura é honesta com o que existe embaixo: o controller Spring MVC recebe a requisição, o DAO chama os packages PL/SQL por procedure — JDBC direto, sem ORM no caminho — e a resposta volta em JSP. Quando o portal foi reescrito, 28 dos meus arquivos reapareceram na geração nova: portei meus próprios módulos em vez de deixá-los no legado. No caminho, a plataforma saiu do contêiner OC4J para o WebLogic e o runtime saltou de Java 1.4 para 6 (com o código mantido em nível 5, para não quebrar o que já rodava); não conduzi o início dessa migração — validei e garanti que tudo voltasse a funcionar.

12. 12

    Quando o ambiente de teste desaparece

    Até 2023 havia desenvolvimento e homologação; os dois bancos foram desativados e ficou só a produção. Quando a rede de segurança sai, o processo passa a ser o ambiente: mudanças pequenas, changelog datado no cabeçalho de cada package — padrão que mantive por 14 anos e que permitiu, hoje, reconstruir a história inteira desse trabalho a partir do próprio sistema — e uma pergunta antes de cada apply: "como eu desfaço isso?". É a mesma disciplina que levo para qualquer stack.

Arquitetura