CKTIS / JavaScript
Arquitetura do programa
A arquitetura do programa define responsabilidades, fluxo de dados e direção das dependências. Em JavaScript, é possível separar a lógica do domínio da orquestração dos casos de utilização e das interações com o ambiente, sem exigir uma framework específica.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
program architecture: domain logic + application orchestration + environment adaptersResponsabilidades e fronteiras
A arquitetura do programa (program architecture) é a organização das partes que colaboram, incluindo as respetivas responsabilidades, interfaces e dependências. Não é uma construção única de JavaScript. O ECMAScript define mecanismos da linguagem, incluindo funções e módulos, mas não prescreve a arquitetura de uma aplicação. Dividir o código por ficheiros, por si só, não garante a separação de responsabilidades.
Uma divisão prática
Uma organização útil separa a lógica do domínio, a orquestração dos casos de utilização e os adaptadores do ambiente. A lógica do domínio calcula um resultado; o código da aplicação determina a sequência das ações; um adaptador guarda dados ou trata da entrada e saída. Passar uma função para executar uma operação externa é uma forma simples de injeção de dependências: o código da aplicação não precisa de escolher um mecanismo de armazenamento concreto.
Como ler o exemplo
calculateTotal soma montantes em unidades monetárias menores sem alterar o array fornecido. createCheckout recebe a função saveTotal, e a função checkout devolvida calcula o total e passa-o para armazenamento. O array savedTotals é usado no lugar de um sistema externo de armazenamento de dados. Para [1200, 800], o total esperado é 2000. O exemplo pressupõe números inteiros válidos e não negativos, e um total dentro do intervalo dos inteiros seguros.
Âmbito e limitações
Esta é uma demonstração síncrona das fronteiras de responsabilidade, não um sistema de pagamentos completo: não abrange validação, falhas de armazenamento nem concorrência. As funções permanecem num único excerto para facilitar a execução; um programa maior pode expor essas fronteiras através de export e import. O exemplo usa funcionalidades da linguagem disponíveis desde o ECMAScript 2015. Não requer Web APIs; console.log é fornecido pelo ambiente, não pelo ECMAScript. A presença de Node 24 num repositório não comprova o suporte de APIs do browser.
Exemplos
function calculateTotal(prices) {
return prices.reduce((sum, price) => sum + price, 0);
}
function createCheckout(saveTotal) {
return function checkout(prices) {
const total = calculateTotal(prices);
saveTotal(total);
return total;
};
}
const savedTotals = [];
const checkout = createCheckout((total) => savedTotals.push(total));
const total = checkout([1200, 800]);
console.log(JSON.stringify({ total, savedTotals }));Resultado
{"total":2000,"savedTotals":[2000]}O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.