Pular para o conteúdo

O panorama da Steve Trucking

Também em 28 idiomas

English · Español · 日本語 · Português (Brasil) · Français · Deutsch · Italiano · 한국어 · 简体中文 · 繁體中文 · Bahasa Indonesia · Türkçe · Polski · Tiếng Việt · ไทย · Nederlands · العربية · עברית · Українська · हिन्दी · Русский · Svenska · Dansk · Norsk bokmål · Suomi · Español (México) · Français (Canada) · Deutsch (Schweiz)

A cracked truck-yard surface with each problem circled in bright paint and orange cones set out, nothing repaired yet, a delivery truck at the dock behind.
Imagem gerada com IA

Módulo 6 de 6 do capítulo Entender os dados empresariais, capítulo 4 do curso Data Architect. Cada módulo sustenta-se sozinho. Anterior: A estratégia de orgs é uma decisão de panorama · Próximo: o próximo capítulo, Qualidade e governação de dados

A pergunta que este módulo responde: O que nos diz um panorama real antes de projetarmos seja o que for?

Este capítulo tem andado a afastar a câmara: o Salesforce como um sistema entre muitos, os tipos de dados, os sistemas à volta do Salesforce, como desenhar o panorama, e a estratégia de orgs. Agora vamos juntar tudo na Steve Trucking. Mas ainda não vamos corrigir nada. Essa é a disciplina: desenhe o que existe, percorra cada seta, e veja o que o panorama nos diz.

A Steve Trucking corre uma org Salesforce, nos EUA. O Service Cloud trata os casos de Destinatários e Parceiros retalhistas; o Field Service trata das marcações, das equipas e da aplicação móvel; o Experience Cloud dá aos Parceiros retalhistas um portal, usado hoje só para reclamações e relatórios; o Sales Cloud acompanha contratos com parceiros e propostas para novos CD. Por isso o Salesforce vai no centro.

À esquerda, as pessoas: 45 coordenadores de expedição a trabalhar dentro dos CD dos Parceiros retalhistas, cerca de 700 membros de equipa em 330 camiões, 60 agentes de relação com o cliente, 40 pessoas de operações, finanças e vendas, e cerca de 300 utilizadores dos Parceiros retalhistas. Isso já nos diz algo: este não é um CRM departamental. É uma plataforma operacional para a maior parte do negócio. Mas continua a ser uma caixa. Agora vamos ver o que a rodeia.

O panorama atual da Steve Trucking O panorama da Steve Trucking hoje, marcado «Estado atual: hoje, antes de uma implementação a sério». À esquerda: 45 coordenadores de expedição dentro de nove CDs parceiros, cerca de 700 membros das equipas de entrega em 330 camiões, 100 pessoas de apoio e de escritório, cerca de 300 utilizadores dos Parceiros retalhistas, e cerca de um milhão de Destinatários por ano. No centro, uma única org Salesforce nos EUA com o portal dos Parceiros retalhistas; o fornecedor de identidade corporativo, acima, partilha um certificado com ela, só para o pessoal de escritório. Um job de exportação programado, no centro, extrai uma exportação semanal do Salesforce pela Bulk API e carrega o Snowflake. O FleetLink tem uma linha pontilhada vermelha até ao Salesforce: em falta, onde está o camião? Entre o RouteDesk e o Salesforce, duas setas tracejadas vermelhas: rotas reintroduzidas no Salesforce, e paragens concluídas reintroduzidas de volta no RouteDesk, à mão. Setas tracejadas vermelhas também levam as contagens de entregas do RouteDesk para uma folha de cálculo mensal e daí para o ERP financeiro, à mão. Cada Parceiro retalhista tem duas setas com o RouteDesk: manifestos a entrar, abertas pelo parceiro (o ficheiro da Keystone, a API da Redrock, o EDI da Brightwave), e estado a sair, abertas pelo RouteDesk. No canto inferior direito, o RouteDesk envia uma mensagem na véspera, sem link, pelo fornecedor de SMS e e-mail, a vermelho; os Destinatários telefonam, a vermelho, 60% deles a perguntar onde está a entrega; o e-mail passa a casos no Salesforce. A legenda: vermelho é um processo mau ou inadequado hoje, tracejado é feito à mão, pontilhado vermelho é uma ligação em falta. Estado atual: hoje, antes de uma implementação a sério ACIMA: IDENTIDADE, APPEXCHANGE, WEB PESSOAS DIREITA: SISTEMAS INTERNOS ABAIXO: CANAIS DE CLIENTES CANTO INFERIOR DIREITO: PARCEIROS E FORNECEDORES Coordenadores de expedição 45, dentro de 9 CDs parceiros Equipas de entrega ~700 em 330 camiões Atendimento e escritório 100: atendimento, operações, finanças Utilizadores dos Parceiros retalhistas ~300 em 3 parceiros Destinatários ~1 milhão por ano IdP corporativo SSO só para o pessoal de escritório Portal dos Parceiros retalhistas JOB DE EXPORTAÇÃO Snowflake análise de operações e finanças FleetLink GPS a cada minuto; um ecrã separado ERP financeiro fatura os parceiros, paga as equipas Folha de cálculo mensal contagens de entregas, à mão RouteDesk (legado) rotas nos CDs; 8 anos de histórico Telefone agentes de apoio E-mail email-to-case Fornecedor de SMS e e-mail mensagem na véspera, sem link Redrock API REST, webhooks Keystone CSV via SFTP Brightwave EDI por uma rede de terceiros Salesforce uma org, EUA só pessoal de escritório chamadas: 60% onde está a entrega? casos entram manifestos entram (API) estado sai (webhook) manifestos entram (ficheiro) estado sai (ficheiro) manifestos entram (EDI) estado sai (EDI) exportação semanal (Bulk API) carga semanal rotas, reintroduzidas paragens concluídas, reintroduzidas em falta: onde está o camião? na véspera, sem link contagens de entregas mensal, à mão Salesforce uma comunidade pessoas identidade, aplicações, web um sistema interno um canal de clientes dados que entram e saem a camada de integração parte do sistema que abre a ligação; o rótulo diz o que se move tracejado: feito à mão vermelho: um processo mau ou inadequado hoje pontos vermelhos: uma ligação que falta um certificado partilhado: confiança, sem chamada direta © 2026 Twinshark LLC · stevetecharc.com
Click to enlarge

A Steve Trucking hoje, antes de uma implementação a sério. Cada manifesto chega ao RouteDesk; os coordenadores reintroduzem as rotas no Salesforce e as paragens concluídas de volta, à mão; ao FleetLink falta a sua ligação.

Este é um estado atual, antes de uma implementação a sério, e digo-o no desenho. Depois abro a paleta. No panorama de um sistema acabado não uso vermelho; num estado atual, uso. Vermelho marca um processo mau ou inadequado, tracejado marca algo feito à mão, e pontos vermelhos marcam uma ligação que está em falta. Deixar uma seta de fora também diz alguma coisa. Nada disto é enfeite: cada linha vermelha é um requisito à espera de ser escrito.

Os três Parceiros retalhistas enviam manifestos de três formas diferentes, por isso desenhe cada um separadamente.

A Keystone deixa um manifesto CSV num servidor SFTP todas as tardes, para entrega dois dias depois, e quer um ficheiro de estado de volta todas as noites. Duas setas: manifesto a entrar por ficheiro, aberta pela Keystone, e estado a sair por ficheiro, aberta pelo RouteDesk. Assíncrono, com uma janela de tempo larga.

A Redrock envia manifestos por uma API REST e espera atualizações de estado por webhook à medida que acontecem. Duas setas, dois mecanismos: a Redrock chama com os manifestos pela API, e o RouteDesk chama com o estado pelo webhook. Quase em tempo real.

A Brightwave envia ficheiros EDI por uma rede de terceiros e espera mensagens de estado EDI de volta. Outro formato, outro mecanismo.

Os mesmos conceitos de negócio (manifesto, entrega, estado), três integrações completamente diferentes. Não simplifique o desenho por gostar que fossem consistentes. Não são. Esse é o estado atual.

Depois percorra-as. Keystone: como se autentica a ligação SFTP, onde cai o ficheiro, o que o vai buscar, como sabemos que o ficheiro inteiro foi processado, o que acontece a uma linha má, e como fica a Keystone a saber de uma mudança antes do ficheiro desta noite? Redrock: como se autentica a API, o que acontece quando um dos lados está em baixo, o que conta como um webhook bem-sucedido, e se o mesmo estado chegar duas vezes? Brightwave: quem opera a rede EDI, onde fica a tradução, que confirmações voltam? Não estamos a reprojetar nada. Estamos a descobrir as perguntas. Esse é o trabalho do panorama.

O RouteDesk é a ferramenta legada de expedição e planeamento de rotas para desktop que os coordenadores usam em cada CD para transformar manifestos em rotas. Guarda oito anos de histórico de entregas, e a sua retirada está programada. Desenhe-o na mesma. Um erro comum é deixar de fora o sistema «de que nos estamos a livrar». Quando? Digamos que a resposta é dezoito meses. Então faz parte da arquitetura durante pelo menos dezoito meses, e os seus oito anos de histórico, cerca de cinco milhões de entregas, não desaparecem quando a aplicação desaparece. E veja o que o panorama expõe: o RouteDesk e o Salesforce não estão ligados. As equipas trabalham as suas paragens na aplicação de Field Service do Salesforce, mas as rotas são montadas no RouteDesk, por isso os coordenadores reintroduzem-nas no Salesforce todas as noites, e depois reintroduzem as paragens concluídas de volta no RouteDesk para que ele possa enviar o estado aos parceiros. Cerca de 3.300 paragens por dia, duas vezes, à mão. Isso fica tracejado e a vermelho no desenho. Também lhe diz que o webhook «à medida que acontecem» da Redrock não é bem à medida que acontecem. De que é o RouteDesk dono hoje? O que depende dele? Que histórico tem de lhe sobreviver, e onde: no Salesforce, no data warehouse, num arquivo? Ainda não estamos a responder. O panorama só expôs as perguntas.

O FleetLink, a plataforma de telemetria, recebe o GPS de cada camião: cerca de 200 mil leituras por dia, cada camião, cada minuto em que está em andamento. E não está ligado a nada. Os coordenadores olham para ele num ecrã separado. Por isso desenhe o FleetLink sem setas. Nenhuma linha de integração mágica por acharmos que deveria haver uma.

Depois conte os zeros: 200 mil por dia são mais de 70 milhões por ano. Isso não é «temos dados de GPS». É uma fonte de streaming com muitos zeros, fora da experiência do Salesforce. O Salesforce precisa de 70 milhões de leituras por ano? Provavelmente não de todas. É uma pergunta de design para depois.

O ERP financeiro fatura cada Parceiro retalhista por entrega, instalação e recolha, e paga os incentivos das equipas. E as contagens de entregas chegam até ele por uma folha de cálculo mensal. Desenhe a folha de cálculo. Não a substitua por uma seta de API arrumadinha por sermos arquitetos e sabermos mais; faz parte da arquitetura atual. E, depois de desenhada, vêm as perguntas: quem a faz, a partir de que sistema, quem a confere, o que acontece se uma entrega muda depois do envio, e o número de quem conta? Há dinheiro associado às respostas.

O Snowflake guarda a análise de operações e finanças, alimentado por uma exportação semanal. O Snowflake não consegue fazer isso sozinho; algo no meio faz: um job de exportação programado, a correr fora do Salesforce, que extrai os dados pela Bulk API e carrega o Snowflake. Onde vive a análise segue onde vivem os dados, e o Snowflake já é a casa analítica. Mas o tempo também nos diz algo. «O que aconteceu no mês passado?» Um feed semanal serve. «Onde está esta entrega agora?» O Snowflake não é por onde eu começaria. A mesma empresa, outra carga de trabalho, outra atualidade, outra resposta.

O fornecedor de identidade empresarial vai acima do Salesforce. O pessoal de escritório usa single sign-on. Mas coordenadores e equipas entram com credenciais do Salesforce. Por isso uma única linha de confiança do IdP para o Salesforce esconderia metade da história. A pergunta real é que utilizadores entram por que caminho, e isso pertence ao panorama.

O fornecedor de SMS e e-mail envia aos Destinatários uma mensagem genérica de «a sua entrega é amanhã» a partir do RouteDesk. Não há link de seguimento. Entretanto, há cerca de 180 mil casos por ano, e cerca de 60% deles são «onde está a minha entrega?»: mais ou menos 108 mil casos por ano a fazer a mesma pergunta. Agora ponha isso ao lado do FleetLink. A empresa sabe onde estão os seus camiões. Os seus Destinatários continuam a telefonar para perguntar. E o sistema que sabe não está ligado ao que responde. Ainda não preciso de projetar a solução. O panorama já está a contar a história.

Agora conte o que se move. Como no módulo 4, os zeros não vão nas setas; vão no inventário por trás do desenho, onde vão determinar os mecanismos quando formos projetar. Cerca de um milhão de entregas por ano, cerca de 3.300 por dia, a crescer 30% ao ano; cerca de 1,6 itens de linha cada; cerca de oito atualizações de estado cada, portanto oito milhões de atualizações de estado por ano hoje; quatro a cinco milhões de fotografias por ano, atualmente nos telemóveis pessoais das equipas; cerca de 200 mil leituras de GPS por dia; cerca de 180 mil casos por ano. Uma seta rotulada «estado da entrega» não é uma mensagem ocasional. As caixas dizem-lhe o que existe. As setas dizem-lhe o que se move. Os zeros dizem-lhe se as suas suposições sobrevivem à realidade.

O inventário da Steve Trucking, com os zeros O inventário da Steve Trucking hoje, uma linha por tipo de dado, com o volume e o mecanismo coloridos em conjunto. Manifestos dos parceiros: transacionais, de cada Parceiro retalhista para o RouteDesk, cerca de um milhão de entregas por ano a crescer 30%, por ficheiro SFTP, API REST e EDI. Estado da entrega: transacional, do RouteDesk para os parceiros, cerca de oito milhões de atualizações por ano, por ficheiro noturno, webhook e EDI. Rotas e paragens concluídas: entre o RouteDesk e o Salesforce, cerca de 3.300 paragens por dia nos dois sentidos, reintroduzidas à mão pelos coordenadores. Leituras de GPS: streaming, no FleetLink, cerca de 200 mil por dia, mais de 70 milhões por ano, sem ligação, só um ecrã separado. Fotografias das entregas: não estruturadas, nos telemóveis pessoais das equipas, quatro a cinco milhões por ano, sem mecanismo nenhum. Casos: transacionais, no Salesforce, cerca de 180 mil por ano, 60% a perguntar onde está uma entrega, por telefone e email-to-case. Contagens de entregas para faturação: transacionais, no ERP financeiro, mensais, por uma folha de cálculo feita à mão a partir do RouteDesk. Análise de operações e finanças: no Snowflake, semanal, por um job de exportação que extrai os dados pela Bulk API e carrega o Snowflake. Histórico de entregas: no RouteDesk, oito anos e cerca de cinco milhões de entregas, numa aplicação legada. Por baixo: as caixas dizem-lhe o que existe, as setas dizem-lhe o que se move, e os zeros dizem-lhe se as suas suposições sobrevivem à realidade. DADOS TIPO ONDE VIVEM HOJE CARGA DE TRABALHO VOLUME E TEMPO MECANISMO ATUAL Manifestos dos parceiros Transacional Cada Parceiro retalhista, depois o RouteDesk Operacional ~1 milhão de entregas por ano, a crescer 30% Ficheiro SFTP, API REST, EDI, para o RouteDesk Estado da entrega Transacional RouteDesk, enviado aos parceiros Operacional ~8 milhões de atualizações por ano Ficheiro noturno, webhook, EDI, a partir do RouteDesk Rotas e paragens concluídas Transacional RouteDesk e Salesforce Operacional ~3.300 paragens por dia, nos dois sentidos Reintroduzidas pelos coordenadores, à mão Leituras de GPS Streaming FleetLink Streaming, operacional ~200 mil por dia, mais de 70 milhões por ano Nenhum: um ecrã separado Fotografias das entregas Não estruturado Telemóveis pessoais das equipas Operacional, histórica 4 a 5 milhões por ano Nenhum Casos Transacional Salesforce Operacional ~180 mil por ano; 60% «onde está a minha entrega?» Telefone, email-to-case Contagens de entregas para faturação Transacional ERP financeiro Financeira Mensal Uma folha de cálculo, feita à mão a partir do RouteDesk Análise de operações e finanças Analítico Snowflake Analítica Semanal Job de exportação: sai pela Bulk API, carrega o Snowflake Histórico de entregas Histórico RouteDesk Referência 8 anos, ~5 milhões de entregas Aplicação legada As caixas dizem-lhe o que existe. As setas dizem-lhe o que se move. Os zeros dizem-lhe se as suas suposições sobrevivem à realidade. © 2026 Twinshark LLC · stevetecharc.com
Click to enlarge

O inventário por trás do panorama da Steve Trucking: o volume ao lado do mecanismo que ele vai determinar.

Ainda nenhuma arquitetura-alvo, e já consigo ver onde vivem os dados importantes, de que tipo são, com que rapidez se movem e como os sistemas os trocam.

Além do exame: o que a IA muda. Suponha que a Steve Trucking constrói um agente para responder ao «onde está a minha entrega?» de um Destinatário. A que sistema deve perguntar? O Salesforce conhece a marcação, o FleetLink sabe onde está o camião, o manifesto do parceiro definiu a entrega. O panorama atual é o mapa do agente e, antes de o agente poder responder com segurança, o arquiteto precisa de saber que sistema tem autoridade sobre cada facto e quão atual ele é. Aponte um agente para a fonte errada e dados desatualizados tornam-se uma resposta confiante.

Dê um passo atrás. Três parceiros, três estilos de integração. Uma ferramenta de expedição legada a guardar oito anos de histórico, e coordenadores a reintroduzir 3.300 paragens por dia no Salesforce e de volta. Uma plataforma de telemetria com 200 mil leituras por dia, desligada. As finanças a contar entregas a partir de uma folha de cálculo mensal. A análise uma semana atrasada. Single sign-on para alguns utilizadores, não para outros. Nenhum link de seguimento, e 108 mil casos por ano a perguntar onde está uma entrega. Tudo a crescer 30% ao ano.

É muita arquitetura a sair de um desenho. A tentação é começar a corrigir. Não o faça. Ainda não. Quero que se sinta à vontade para deixar um diagrama de estado atual feio, porque às vezes o estado atual é feio. O ponto não é impressionar ninguém com um desenho limpo; é um entendimento partilhado da realidade. Reprojete enquanto documenta e perde a linha de base. Mais tarde quero poder dizer: isto é o que existia, este é o problema que resolvemos, isto é o que mudámos, e porquê. O capítulo 6 começa a tomar decisões sobre propriedade e identidade, e o Checkpoint 1 junta a Parte 1. O curso Integration Architect projeta os fluxos dos parceiros em profundidade.

Nesta etapa, o arquiteto não está a decidir a arquitetura-alvo. A decisão é se o estado atual está suficientemente bem entendido para projetar uma:

  • Que sistemas, populações de utilizadores, repositórios de dados e parceiros externos existem de facto hoje.
  • Que dados atravessam cada fronteira importante, em que direção, com que frequência e por que mecanismo.
  • Onde vivem agora os dados operacionais, analíticos, de streaming, históricos e não estruturados.
  • Que fluxos transportam mais volume e merecem atenção cedo.
  • Que lacunas, etapas manuais, sistemas desligados, autoridades pouco claras e padrões inconsistentes se tornam perguntas de design explícitas.

Este capítulo começou com uma ideia: desenhe o panorama antes de projetar a org. Se tivesse começado pelo modelo de dados da Steve Trucking, poderia ter passado horas em objetos e relações enquanto o FleetLink ficava lá fora com 200 mil leituras por dia, o RouteDesk guardava oito anos de histórico, três parceiros falavam três línguas, as finanças usavam uma folha de cálculo, e cem mil casos por ano perguntavam onde estava uma entrega. Estas não são perguntas de modelo de objetos. São perguntas de dados empresariais. Desenhe as integrações feias, a folha de cálculo, o sistema que supostamente está a retirar. Anote os zeros. Percorra cada seta. Aí está pronto para mudar.

  • O briefing da Steve Trucking (em inglês), secções 2–4, e o seu diagrama de panorama.