Estrutura bem arquitetada

A Estrutura bem-arquivada do Salesforce oferece aos arquitetos uma base compartilhada e fundamentada para tomar decisões que ajudam uma solução a ter sucesso ao longo do tempo. Ele é organizado em torno de cinco pilares – Trust, Reliabilidade, Excelência Operacional, Otimização de Recursos e Custos e Fairness – cada um dos quais captura uma dimensão de qualidade que importa em todas as fases da vida de uma solução, desde o projeto inicial até a operação e crescimento a longo prazo.

A estrutura aborda as realidades que os arquitetos enfrentam hoje: humanos, agentes e plataformas que trabalham juntos dentro de sistemas de negócios governados. Uma solução segura, mas frágil sob a carga, ou eficiente, mas opaca em suas decisões, não está bem arquivada. Esses cinco pilares trabalham juntos para garantir que a qualidade seja tratada como um todo e não como uma lista de verificação de preocupações independentes.

Os arquitetos usam a estrutura como um lens consistente durante revisões de design, conversas de compensação e governança contínua. Ela não prescreve uma única resposta à direita. Ele fornece as perguntas certas para você fazer, os padrões certos para considerar e um vocabulário comum para usar entre as equipes.

A Estrutura bem-arquivada do Salesforce é um guia de opinião sobre a qualidade arquitetônica para soluções criadas na Salesforce Platform. Ele codifica os princípios, os padrões e os prós e os contras que diferenciam soluções de escala e adaptação daquelas que acumulam débito técnico ou falham sob pressão.

A estrutura é organizada em torno de cinco pilares. Cada pilar define uma dimensão de qualidade, articula os principais princípios de design, identifica padrões comuns e fornece orientação explícita para funcionalidades tradicionais da plataforma e cargas de trabalho de IA agentes. Juntos, os pilares abrangem de modo abrangente o que significa criar algo bom no Salesforce.

Essa estrutura não é um manual de produto ou um guia de implementação. É uma estrutura de decisão arquitetônica, uma maneira de pensar sobre qualidade que se aplica independentemente das nuvens, recursos ou ferramentas que uma solução usa.

As estruturas do setor de provedores de nuvem de hiperescala fornecem orientação geral valiosa, mas são criadas principalmente para questões operacionais e de infraestrutura de nuvem, como máquinas virtuais, rede, armazenamento e computação. Os arquitetos do Salesforce enfrentam diferentes restrições e recursos: plataforma multitenant com limites de regulador, décadas de lógica de negócios no Customer 360, soluções de integração sofisticadas, automação declarativa, configuração orientada por metadados e modelos de compartilhamento gerenciado. Eles moldam cada decisão arquitetônica de maneiras que a orientação genérica de nuvem não pode lidar.

A mudança para agentes autônomos introduz considerações adicionais. Agentes que raciocinam e atuam apresentam padrões de supervisão Human-in-the-Loop, não determinismo, raciocínio probabilístico e que as estruturas anteriores não abordavam originalmente, embora as estruturas de finalidade geral tenham começado a se estender para esse espaço por meio de lenses de IA dedicados. A Estrutura bem-arquivada do Salesforce lida com arquitetura de plataforma tradicional e sistemas agentes por meio de um lens unificado.

Essa estrutura atende a qualquer pessoa responsável pela qualidade da arquitetura na plataforma Salesforce:

• Salesforce Architects projetando novas soluções ou ampliando as existentes
• Os Administradores do Salesforce configuram e protegem as organizações em que essas soluções são executadas
• Leads de desenvolvimento estabelecendo padrões e padrões para suas equipes
• Consultores e parceiros que aconselham os clientes sobre as melhores práticas da plataforma
• Especialistas de IA e agentes que criam e gerenciam sistemas autônomos de agentes

Nenhum conhecimento prévio em IA agente é necessário. A estrutura está acessível a todos os arquitetos enquanto fornece profundidade para aqueles que trabalham na fronteira de sistemas autônomos.

Não há uma ordem de leitura correta única. Escolha com base em seu papel e necessidade imediata:

• Se você é novo no framework: Leia este documento de visão geral de ponta a ponta e explore o pilar mais relevante para seu projeto atual.
• Se você estiver projetando uma nova solução: Comece com Trust and Reliability (fundamentos não negociáveis) e, em seguida, aborde Excelência operacional (como você vai operá-la), Otimização de recursos e custos (como você vai mantê-la) e Fairness (como você vai garantir que atenda a todos os usuários de forma equitativa).
• Se você estiver construindo soluções agentes: Leia a Visão geral da empresa do agente primeiro para obter orientação abrangente sobre a arquitetura do agente. Em seguida, leia os documentos de pilares principais (vinculados acima) para padrões fundamentais (Modelo de responsabilidade compartilhada, limites do regulador, ferramentas de monitoramento, modelagem de TCO, padrões de acessibilidade) que as soluções de agência criam. Por fim, consulte as variantes de pilar da Enterprise do agente (vinculadas de cada pilar) para sobreposições específicas da agência em cada dimensão de qualidade.
• Se você estiver realizando uma revisão de projeto: Use os documentos de pilares como uma lista de verificação de análise estruturada. Uma solução bem projetada tem respostas claras às principais perguntas em cada pilar relevante.

As decisões arquitetônicas mais importantes envolvem compensações entre os pilares. A estrutura ajuda a tornar isto explícito:

• Trust vs. Otimização de recursos e custos: O registro de criptografia e auditoria consome recursos. A estrutura ajuda você a identificar onde o requisito de Trust é não negociável versus onde você tem flexibilidade.
• Confiabilidade vs. Otimização de recursos e custos: Uma disponibilidade maior custa mais. As definições de SLO ajudam você a combinar o investimento com os reais requisitos de negócios em vez de usar como padrão a redundância máxima.
• Excelência operacional vs. Velocidade: A observação abrangente e o teste levam tempo para serem implementados. A estrutura ajuda a identificar a observabilidade mínima viável para seu perfil de risco.
• Justiça vs. Autonomia: Maior autonomia do agente permite a eficiência, mas cria risco de equidade. Os padrões humanos no loop ajudam a encontrar o equilíbrio certo para cada tipo de decisão.

Não há uma resposta universal a esses prós e os contras. A estrutura ajuda você a fazer as perguntas certas e fazer as compensações de forma consciente em vez de descobri-las na produção.

A estrutura bem arquivada em si é projetada considerando estes princípios:

• Especificamente para a plataforma, mas sem tecnologia: A orientação lida com restrições específicas do Salesforce (limites de governador, arquitetura multilocatário, ajustes conduzidos por metadados) sem prescrever produtos ou recursos específicos. Os arquitetos escolhem os recursos certos para o contexto.
• Opened without prescriptive: A estrutura assume posições claras sobre o que constitui qualidade, mas não determina um único caminho de implementação. Ele fornece princípios, padrões e perguntas, não requisitos.
• Olhando para o futuro, respeitando o presente: A estrutura lida com padrões emergentes (IA eficiente, sistemas autônomos) enquanto continua relevante para soluções de plataforma tradicionais. Ambos os casos de uso se beneficiam dos mesmos princípios fundamentais.
• Vivo, não estático: A estrutura evolui conforme a plataforma, as práticas do setor e as necessidades do cliente mudam. O Log de alteração rastreia atualizações para que os arquitetos possam se manter atualizados com novas orientações.
• Acionável em todos os estágios: Quer você esteja projetando uma nova solução, realizando uma revisão ou melhorando uma implementação existente, a estrutura fornece orientação relevante. Não é apenas uma lista de verificação de certificação, é uma ferramenta de trabalho.

Esses princípios garantem que a estrutura permaneça útil em diversos contextos arquitetônicos enquanto mantém uma orientação clara e consistente sobre o que a qualidade arquitetônica significa para as soluções do Salesforce.

Cada pilar aborda uma dimensão fundamental da qualidade arquitetônica. Juntos, os pilares fornecem uma cobertura abrangente: nenhum único pilar é suficiente sozinho, e as compensações entre os pilares são onde as decisões arquitetônicas mais importantes estão.

Os cinco pilares a seguir fornecem orientação arquitetônica básica para todas as soluções do Salesforce: aplicativos de plataforma tradicionais, integrações e sistemas agentes. O Agent Enterprise Overview e suas variantes de pilares complementares fornecem a sobreposição específica da agência: como os agentes criam esses recursos, o que muda quando os sistemas agem de modo autônomo e os padrões arquitetônicos necessários para IA governada.

Use ambos juntos:

• Comece com a orientação de pilares para padrões arquitetônicos principais (por exemplo, o Modelo de responsabilidade compartilhada, limites do regulador, ferramentas de monitoramento, modelagem de TCO, padrões de acessibilidade).
• Em seguida, consulte o pilar Enterprise do agente correspondente para considerações específicas do agente (por exemplo, permissões do agente e cadeias de auditoria, tratamento de falha de orquestração, ciclo de vida do agente de desenvolvimento, otimização de token, unidades de trabalho do agente, explicabilidade e capacidade de contestação).

Os pilares não são “tradicionais” vs. “agentes”, são a arquitetura fundamental em que as soluções agentes se baseiam. Os sistemas agentes devem satisfazer os mesmos requisitos de Trust, confiabilidade, excelência operacional, otimização de recursos e custos e equidade que qualquer outra solução empresarial, com considerações adicionais para operação autónoma.

Esta tabela fornece uma rápida referência. A orientação detalhada para cada pilar segue.

Proteja sua solução, seus dados e seus usuários por meio de segurança moderna, acesso de privilégio mínimo, controles de privacidade e governança clara. O Trust no Salesforce opera por meio do Modelo de responsabilidade compartilhada: O Salesforce protege a infraestrutura e a plataforma, então você arquita soluções seguras nessa base. Suas responsabilidades abrangem:

• Gerenciamento de identidade e acesso (papéis, perfis, conjuntos de permissões, MFA, SSO, OAuth)
• Governança de dados (Shield Platform Encryption, segurança em nível de objeto/campo/registro)
• Segurança de integração (autenticação de API, credenciais nomeadas)
• Práticas de desenvolvimento seguras (Top 10 do OASP adaptado para o Salesforce, análise estática, portões de segurança de CI/CD)

Para soluções agentes: Quando agentes agem de forma autônoma, os requisitos de Trust se estendem a governar o que os agentes têm permissão para fazer, auditar o que eles fizeram e proteger os limites de agente para plataforma (Agent Fabric, Einstein Trust Layer). Consulte Agentic Enterprise Trust.

Para saber mais, consulte Pilar Trust e Agent Enterprise Trust.

Projetado para disponibilidade contínua, recuperação rápida de interrupção e capacidade de escala sob demanda inesperada. A confiabilidade exige compreender as garantias da plataforma (infraestrutura de várias regiões, SLAs da plataforma) enquanto projeta soluções que permaneçam confiáveis dentro dessas restrições. O pilar abrange:

• Limites do controlador com 70% de orientação de limite operacional
• Padrões de processamento assíncrono (Apex em lote, Apex enfileirável, Eventos de plataforma)
• Interruptores de circuito para integrações externas
• Planejamento de capacidade
• Carregar teste
• Padrões de várias organizações
• Recuperação de desastres
• Modelagem de saúde

Para soluções agentes: Os sistemas conduzidos pelo agente apresentam um comportamento probabilístico que requer novos padrões para falhas de orquestração, disruptores de circuito para erros de agente em cascata e Gráficos de agente determinísticos em que os resultados de negócios exigem previsibilidade. Consulte Agent Enterprise Reliability.

Para saber mais, consulte Pilar de Confiabilidade e Confiabilidade corporativa da agência.

Crie observabilidade abrangente em sua solução e gerencie-a por meio de procedimentos e automação bem definidos. A Excelência operacional abrange:

• Observabilidade (Monitoramento de evento, Proactive Monitoring, Centro de escala)
• Práticas de DevOps (desenvolvimento orientado por origem, pipelines de CI/CD, estratégia de teste)
• Automação (principalmente declarativa com o Flow Builder, padrões programáticos com Apex)
• Gerenciamento de incidentes (níveis de gravidade, rotação na chamada, pós-mortems sem culpa)
• Melhoria contínua (métricas DORA, análises operacionais)

Para soluções agentes: A capacidade de observação fica mais difícil quando o comportamento do sistema é probabilístico. O ciclo de vida de desenvolvimento do agente (ADLC) fornece estrutura por meio de cinco fases: conceção e design, desenvolvimento, testes e validação (incluindo avaliações do Centro de Testes do agente para precisão, coerência e adesão às instruções), implantação e liberação, e monitoramento e ajuste (incluindo Rastreamento de sessão do Agentforce para visibilidade de ponta a ponta da interação). Consulte Excelência operacional da Agent Enterprise.

Para saber mais, consulte Pilar de Excelência Operacional e Excelência Operacional da Agência.

Retorne o valor comercial máximo para cada dólar e cada unidade de recurso da plataforma por meio do uso eficiente do que você tem e do investimento deliberado no que você compra. No lado do recurso, isso significa entender os limites do controlador (consultas SOQL, instruções DML, tamanho de heap, tempo de CPU) e projetar dentro deles por meio de otimização SOQL, processamento assíncrono e prevenção de discrepância de dados. No lado do custo, isso significa modelagem abrangente de TCO em custos diretos (implementação, operacional, manutenção) e custos indiretos (débito técnico, sobrecarga de governança) que geralmente excedem custos diretos de licença. O pilar abrange:

• Padrões de organização de código ( manipuladores de acionador, camadas de serviço, seletores)
• Empacotamento e modularidade (pacotes gerenciados 2GP vs. desbloqueados, que são ambos tipos de empacotamento de segunda geração, composição do LWC)
• Gerenciamento de ciclo de vida de dados (estratégias de arquivamento, otimização de fluxo)
• Ferramentas de monitoramento de desempenho (Centro de escala, Ferramenta do plano de consulta, ApexGuru, Analisador de código do Salesforce)
• Análise de criação vs. compra (avaliação do AgentExchange)
• Otimização de licença e sandbox
• Monitoramento e governança de custo (painéis, controles de orçamento, modelos de showback vs. chargeback)

Para soluções agentes: Os fluxos de trabalho do agente complicam o consumo de recursos compostos em etapas de raciocínio, chamadas de ferramentas e recuperações de dados, portanto, o uso de token, a latência de inferência e os padrões de memória exigem otimização. Os sistemas agentes também introduzem custos baseados em consumo (Creditos flexíveis, tokens de inferência) que são mais difíceis de prever do que o licenciamento por usuário. Unidades de trabalho agentes (AWUs) medem o consumo de token bruto que os agentes de fato concluíram (tarefas separadas concluídas). Consulte Recurso corporativo e otimização de custo da agência.

Para saber mais, consulte Pilar de Otimização de recurso e custo e Otimização de recursos empresariais e custo do agente.

Garanta que sua solução seja acessível, não discriminatória, inclusiva e transparente, com a supervisão humana adequada de decisões automatizadas. A justiça é baseada nas noções básicas da plataforma. O Salesforce Lightning Design System (SLDS) fornece acessibilidade integrada para componentes padrão, enquanto os componentes personalizados exigem implementação explícita do WCAG 2.1 AA (com WCAG 2.2 AA, a Recomendação atual do W3C a partir de dezembro de 2024, recomendado para novos trabalhos). O pilar abrange:

• Teste de acessibilidade (exe-core, scanner sfdx)
• Padrões de não discriminação (OWD, regras de compartilhamento, FLS com monitoramento de evento Shield)
• Arquitetura de privacidade (Gerenciamento de consentimento do Data 360, Trilha de auditoria de campo)
• Governança de ética de IA (quadros de revisão, portões de equidade, conformidade regulatória).

Para soluções agentes: Quando os agentes tomam decisões autônomas que afetam as pessoas, os riscos de imparcialidade aumentam. Capacidade de explicar (entender por que um agente agiu), capacidade de contestação (decisões desafiadoras) e Human-in-the-Loop (supervisão proporcional) se tornam essenciais. Consulte Agent Enterprise Fairness.

Para saber mais, consulte Pilar de Justiça e Justiça empresarial da agência.

Nenhum pilar existe em isolamento. Decisões arquitetônicas em um pilar inevitavelmente afetam outras:

• Controles de Trust mais fortes (criptografia, registro de auditoria) consomem mais recursos e aumentam o custo (Otimização de recursos e custo) e aumentam a latência afetando a confiabilidade
• Maior confiabilidade (redundância, várias regiões) aumenta o custo (Otimização de recursos e custos) e a complexidade operacional (Excelência operacional)
• A imposição de equidade mais abrangente (supervisão humana, monitoramento de viés) diminui a taxa de transferência do agente (Otimização de recurso e custo)
• Maior maturidade de Excelência Operacional (instrumentação abrangente) permite uma melhor imposição do Trust e detecção antecipada de problemas de Fairness

Essas interações significam que a qualidade arquitetônica é sempre um equilíbrio. A estrutura ajuda os arquitetos a entender o que estão negociando e fazer essas negociações intencionalmente. A meta não é maximizar cada pilar ao mesmo tempo, é alcançar o perfil de qualidade certo para os requisitos de uma determinada solução, tolerância ao risco e contexto de negócios.

Compartilhe seu feedback sobre o Framework bem-construído.