ALPHA LAB: Self-Hosted Infrastructure

ALPHA CORE

Plataforma de inteligência operacional

Contexto Ler o estado de uma infraestrutura obriga normalmente a juntar inventário, telemetria e eventos de sítios diferentes. Nesse processo, o acesso privilegiado ao host, a interpretação dos dados e a apresentação acabam misturados na mesma camada.

Decisão Separar essas três responsabilidades por contrato, não por convenção. Um processo público sem privilégios nunca toca no host; um processo privilegiado é o único com acesso aos providers; a interface consome apenas contratos versionados e nunca contacta hosts directamente.

Implementação Agent em Go dividido em dois processos que comunicam por socket local, com providers só de leitura para host Linux, Docker, systemd, rede, armazenamento e hardware. API v1 descrita em OpenAPI 3.1 com eventos por SSE. Console em Next.js consome apenas essa API. Kernel em TypeScript trata de composição, widgets e políticas. Os dados preservam origem, actualidade e incerteza em vez de as esconder.

Resultado Developer Preview consolidada, com contratos, documentação de arquitectura, ADRs, deployment e governação no mesmo repositório. A direcção dos contratos v1 está estável; instalação, upgrades e federação remota ainda não têm garantias de produção, e o projecto diz isso de forma explícita.

Go Next.js TypeScript OpenAPI 3.1 SSE Fronteira de privilégios

ALPHA DRIVER LOG

Produto

Contexto Registar actividade profissional de condução não é preencher uma tabela. Envolve classificar períodos de condução, pausas e descansos, lidar com semanas que não coincidem com o calendário e com regras de descanso reduzido e tripulação dupla. Fazer isso à mão é onde nascem os erros.

Decisão Construir a aplicação à volta de um motor de regras testado, em vez de a tratar como um formulário com validação. As regras vivem isoladas do interface e são verificadas por testes unitários próprios.

Implementação Next.js com React e TypeScript, PostgreSQL através de Prisma, e um módulo de regras separado para agregação de condução, semana legal, pausas, descansos diários e reduzidos, tripulação dupla, validação de segmentos e detecção de violações, coberto por testes. Exportação para PDF gerada no servidor e para CSV. Instalável como PWA, com histórico filtrável e paginado. Autenticação à frente da aplicação, headers de segurança aplicados e dados de teste removidos antes do uso real.

Resultado Produto próprio levado do desenho à produção, alojado na infraestrutura do laboratório, com backups operacionais e checklist de validação antes de entrar em uso real.

PWA Next.js TypeScript PostgreSQL Prisma Data Validation PDF/CSV

ALPHA LAB

Do exterior ao core, cada camada tem uma função.

Cada nó tem uma responsabilidade. Nenhum acumula todas.

Dois sistemas construídos de raiz, do problema ao deployment.

ALPHA CORE

ALPHA DRIVER LOG

Engenharia para além dos produtos.

Como decido.

Esta página é servida pela infraestrutura que descreve.

Observabilidade com minimização à partida