Um capítulo autoral
Este é o memorial editorial da Açaí Clínica — a página que responde por que este produto existe, como foi pensado, como foi construído e o que ele demonstra sobre a maneira de trabalhar de quem o assina.
Cap. 01
Manifesto
Toda a superfície da Açaí Clínica é regida por uma frase simples: a consulta é uma conversa. Tudo o mais — agenda, prontuário, mensagem, cobrança — deve trabalhar em silêncio para que essa conversa aconteça inteira.
Existem duas maneiras de construir software para saúde. Uma copia o hospital grande, empilha telas, esconde a clínica atrás do sistema e chama isso de modernização. A outra parte da consulta — daquele instante em que uma pessoa entra, senta, e a outra escuta — e desenha para trás. A Açaí Clínica é resultado da segunda maneira, feita com método e com cuidado.
Este memorial não é uma página de marketing. É o registro público das escolhas: o que foi observado antes de qualquer código; o que foi modelado antes de qualquer tela; o que foi construído — e, sobretudo, o que foi recusado. Um produto se define tanto pelas linhas que escreve quanto pelas que decide não escrever.
Cada minuto que um médico gasta empurrando papel é um minuto roubado de quem está esperando ser ouvido. Construímos a Açaí para devolver esse tempo — e devolvê-lo bem usado.
Carta
Do autor, para quem lê
Passei semanas em recepções de clínicas de família em Belém antes de abrir um editor. Não escutei o que o sistema fazia — escutei o que a clínica deixava de fazer por causa do sistema. Uma senhora que ligava três vezes por semana porque nunca sabia se a consulta estava confirmada. Uma médica que digitava a mesma anamnese seis vezes por dia. Uma recepcionista que jamais podia sair para almoçar sem ligar a secretária eletrônica no celular.
Escrevi tudo. Depois escrevi de novo — sem o vocabulário do software. Só quando o problema estava descrito em palavras da clínica é que comecei a modelar entidades, fluxos, permissões, telas. A Açaí Clínica nasceu dessa inversão: primeiro o consultório, depois o código.
Este produto não é a maior automação que já fiz — é a mais educada. Ela recua quando a pessoa entra na sala. Volta a agir quando a porta fecha. Se este memorial tem qualquer valor, é o de deixar registrado que software para saúde pode ter compostura. E que a engenharia certa não é a mais barulhenta: é a que devolve tempo sem pedir atenção.
— Carlos EduardoEngenheiro de Produto · Design · Build · Operate · Belém–PA
Cap. 02
O problema
Antes de propor solução, um levantamento honesto. Estes são os cinco atritos observados repetidamente em clínicas de família de médio porte em Belém — e que orientaram todas as decisões do produto.
Média de 14 ligações/dia só para confirmar consulta — bloqueia recepção e ainda deixa 22% dos pacientes sem retorno.
O médico digita enquanto o paciente fala. O contato visual quebra. A escuta vira formulário.
Papel, planilha, PDF de laboratório e prontuário legado — três lugares para o mesmo dado, nenhum com histórico confiável.
O paciente sai com receita, exame e dúvida. A dúvida raramente encontra caminho de volta.
A recepcionista atende no próprio celular. Se ela muda de emprego, a memória da clínica vai junto.
Cap. 03
Método
Nenhuma tela foi desenhada antes da fase 3. Nenhuma linha de código antes da fase 5. O produto seguiu a mesma disciplina que sustenta cada projeto do Fólio CE: design · build · operate.
3 semanas em recepções de clínicas de família. Sem propor nada. Só medindo o tempo de cada gesto.
12 pessoas: médicos, recepção, pacientes recorrentes, um administrador antigo. Áudio → transcrição → tags → temas.
Diagrama de domínio antes da UI. Entidades, estados e o vocabulário exato da clínica — não o do framework.
Baixa fidelidade primeiro. Fluxos completos testados no papel com a recepcionista antes de qualquer pixel.
TanStack Start, TypeScript estrito, Postgres com RLS. Uma feature de cada vez, sempre com teste e sempre em produção.
Cada release passa por 1 semana de sombra: a operação atual continua; a nova roda em paralelo. Comparação real, não hipótese.
O produto vive: métricas por semana, revisão dos fluxos automáticos, entrevistas de manutenção a cada 90 dias.
Não há “versão final”. Há um caderno de bordo aberto — o que a operação diz vira o próximo ciclo.
A regra de mesa foi curta: nenhuma tela sem uma pergunta a responder, nenhum campo sem uma decisão que dependa dele.
Σ (design·build·operate) = produto
Cap. 04
Decisões
Cada decisão de arquitetura é também uma recusa. Aqui estão as principais, na forma em que apareceram no caderno de bordo.
Escolha
Recusado: SPA com estado global e chamadas REST soltas.
Loader roda no servidor, dados chegam prontos, cliente hidrata rápido. Menos JavaScript no aparelho da recepcionista significa menos travamento no Wi-Fi ruim.
Escolha
Recusado: proteção só no backend.
Cada linha do prontuário carrega dono e regra. Se um bug futuro esquecer de filtrar, o banco recusa por conta própria. Segurança em profundidade, não em superfície.
Escolha
Recusado: endpoints REST manuais e validação duplicada.
Uma única fonte de verdade entre cliente e servidor. Zod na borda, TypeScript no meio, Postgres no fim. Zero any silencioso.
Escolha
Recusado: acoplar-se a um SaaS de automação caro.
As automações da clínica são poucas, específicas e precisam ser auditáveis. Um motor caseiro de 200 linhas, com log por passo, vence três integrações verticais.
Escolha
Recusado: chamadas soltas de LLM no cliente.
Toda triagem passa pelo servidor, o prompt é versionado, a saída é validada por schema antes de virar dado. IA que não valida não entra em produção.
Escolha
Recusado: adaptar LGPD depois que o produto funciona.
Anonimização, retenção mínima e log de acesso aparecem antes da primeira tabela. Consentimento é campo obrigatório, não banner.
Cap. 05
Princípios
Os mesmos verbos aparecem no design e no código. Aqui, lado a lado, os princípios que estruturam a superfície e a fundação do produto.
UX · superfície
06 princípiosUm só verbo por tela
Cada tela pergunta uma coisa. Se pergunta duas, é duas telas.
Estado explícito, nunca implícito
Confirmado, pendente, cancelado — nomeado, colorido, datado.
Português da clínica
‘Retorno’, não ‘follow-up appointment’. O sistema fala como quem trabalha.
Erro é resposta, não desculpa
Toda mensagem de erro diz o que aconteceu, o porquê e o próximo passo.
Silêncio é feature
A ausência de notificação é uma decisão de produto — não um esquecimento.
Toque leve, contraste alto
Tipografia forte, cor econômica, densidade calibrada. Editorial, não corporativo.
Engenharia · fundação
06 princípiosTipos até o banco
Zod na borda, TypeScript no meio, Postgres tipado no fim. Zero coerção silenciosa.
Segurança em camadas
RLS + guards de servidor + guardas de UI. Nenhuma delas confia na outra.
Loader server-first
Dados chegam prontos. O cliente hidrata, não busca.
Idempotência é padrão
Toda automação pode rodar duas vezes sem quebrar. Falhar é permitido; sujar dado, não.
Observabilidade escrita
Log estruturado por passo. Se algo falhar, o motivo está em texto — não em stack trace.
Migrações versionadas
Nenhuma alteração de esquema fora de migração. O banco também tem histórico.
Cap. 06
Bastidores
Sem jargão de recrutador. Só o papel que cada peça cumpre na clínica.
React 19 · TanStack Start
É o que a recepcionista vê. Renderiza no servidor primeiro para carregar rápido no Wi-Fi de qualquer bairro.
TypeScript estrito
O compilador é o primeiro revisor. Se algo pode explodir em produção, ele reclama antes.
Tailwind v4
Tokens semânticos, tipografia serifada, cor econômica. Uniforme entre telas sem virar template.
Postgres + RLS
Guarda paciente, agenda, prontuário. Cada linha sabe quem pode ler — mesmo se a aplicação esquecer.
Server Functions (RPC)
Chamada do navegador que roda no servidor, com validação Zod e Postgres do outro lado. Sem endpoints soltos.
Motor de workflows próprio
Confirma consulta, lembra da manhã seguinte, recupera não-comparecimento, dispara pesquisa. Sempre com log auditável.
Gateway de IA proprietário
Modelos em plural sob um único contrato. Prompt versionado, saída em schema, custo sob orçamento.
Dify + n8n (referência)
Considerados, testados, dispensados para o núcleo — pesados demais para uma clínica média. Bons para outros contextos.
Vite + Cloudflare
Build determinístico, entrega em edge. Deploy medido em segundos, rollback medido em cliques.
Diagrama simplificado
Paciente ─► WhatsApp / Web ─► TanStack Route (SSR)
│
▼
Server Function (Zod)
│
┌────────────────┼─────────────────┐
▼ ▼ ▼
Postgres (RLS) Motor de fluxos Gateway de IA
│ │ │
└────────► outbox de notificações ─┘
│
▼
Médico · RecepçãoFig. 02 · Trajeto de um agendamento — do WhatsApp à consulta
Cap. 07
Linha do tempo
A Açaí Clínica é uma peça de portfólio ativa. Cada marco é datado e — quando possível — atado a uma decisão nomeada.
Sem. 01–03
Recepções, salas de espera e balcões — sem propor solução.
Sem. 04
12 conversas, 9 horas de áudio, 148 tags em 7 temas.
Sem. 05–06
Entidades, estados e o vocabulário da clínica — antes de qualquer tela.
Sem. 07–08
Testados com recepcionista e médica no próprio balcão.
Sem. 09–14
TanStack Start, Postgres com RLS, tipos até o banco, deploy contínuo.
Sem. 15–18
Confirmação, lembrete, pós-consulta e triagem — todos versionados.
Sem. 19–22
Operação atual mantida; a nova roda em paralelo por sete dias.
Hoje
Este documento — o produto contando a própria história para quem chega.
Números do memorial
Métricas sem contexto são poesia inútil. Cada valor abaixo é acompanhado do que ele significa no chão da clínica.
07
fases
de método antes da primeira linha em produção.
148
tags
extraídas das 12 entrevistas iniciais.
06
fluxos
de automação — confirmação, lembrete, pós-consulta, triagem, NPS, recuperação.
100%
server-first
loaders no servidor, tipos até o banco, RLS ativado em toda tabela sensível.
Cap. 09
Créditos autorais
Este software não foi terceirizado a papéis vagos. Todo o trabalho intelectual — do primeiro caderno de campo à última linha de CSS — foi feito por uma mesma pessoa, com método de time sênior.
Autor
Engenheiro de Produto · Design · Build · Operate
Belém–PA · Fólio CE
Engenheiro de produto com portfólio de 14 sistemas em produção em indústria, comércio B2B, setor público, gestão de frota, folha e saúde. Método próprio de trabalho — Σ (design · build · operate) = produto — aplicado do primeiro esboço ao suporte pós-lançamento.
Ler o memorial completo →Papéis exercidos neste projeto
Idealização
Pergunta inicial, hipóteses, escopo do que valia — e do que não valia — construir.
Pesquisa de campo
Observação em recepções e entrevistas guiadas em clínicas de família de Belém.
Modelagem de domínio
Entidades, estados e vocabulário da clínica antes de qualquer tela.
Arquitetura de software
Server-first com TanStack Start, Postgres com RLS, tipos até o banco.
Engenharia de processos
Motor próprio de workflows, idempotência, log auditável por passo.
UX Design
Fluxos, hierarquia, estado explícito, princípios editoriais de superfície.
UI · Direção de arte
Sistema visual Mata & Açaí, tipografia serifada, cor econômica, densidade calibrada.
UX Writing
Toda cópia da superfície — do botão à mensagem de erro — em português da clínica.
Desenvolvimento full-stack
React 19, TypeScript, Server Functions, Postgres, integrações.
Integração de IA
Gateway com contrato Zod, prompts versionados, custo sob orçamento.
Validação e QA
Semanas de operação em sombra, comparação real com o processo anterior.
Documentação técnica
Este memorial, README, decisões arquiteturais, log de migrações.
Refinamento contínuo
Caderno de bordo aberto — a operação alimenta o próximo ciclo.
Cap. 10
Lições aprendidas
A tentação era encher a tela de sugestões da IA. A resposta certa foi silenciá-la enquanto a consulta acontece. Menos, quando é bem colocado, presta mais serviço.
As três primeiras semanas não produziram nenhum artefato bonito. Produziram todas as decisões subsequentes. Um portfólio maduro precisa mostrar essa parte, mesmo quando não é fotogênica.
Anonimização, retenção mínima e log de acesso não são camada de compliance colada no fim: são a primeira decisão. Depois delas, o resto do produto é mais barato de construir e mais fácil de defender.
Cada any evitado no início da modelagem paga um bug de produção lá na frente. A disciplina cansa; a alternativa cansa mais.
Cap. 11
Próximos capítulos
Roadmap curto, honesto, sem promessas de mercado. Cada item aqui foi extraído do caderno de bordo aberto.
Próximo
designDitado do médico → estrutura em campos clínicos, sem que ele deixe de olhar para o paciente.
Em seguida
buildOHI 0–100 diário: fila, tempo médio, cancelamentos, retornos. Sem ERP, sem sensores.
Depois
operateUma clínica virou três? O mesmo produto roda dentro da infraestrutura do cliente. Zero PII na pipeline pública.
Histórico de versões
Rascunho de domínio
Diagrama, entidades e vocabulário. Zero UI.
Fluxo de agendamento
Da busca de horário à confirmação — primeira ponta a ponta.
Motor de workflows
Confirmação, lembrete e NPS entram em produção com log auditável.
IA de triagem
Gateway com contrato Zod. Prompts versionados. Custo sob orçamento.
Memorial editorial
O produto ganha voz — este capítulo passa a existir.
Curiosidades do projeto
O nome
‘Açaí’ ganhou da alternativa ‘Samaúma’ na terceira rodada — mais curto, mais reconhecível, e reforça a origem paraense sem cair no cliché.
A paleta
Verde-mata + vinho-açaí + cream tapioca + dourado marajoara. Nenhum roxo indigo. Nenhum gradiente de startup.
A tipografia
Source Serif 4 para display + Inter para corpo. Uma serifada calma, uma sans neutra — sem modismo, sem Poppins.
A fonte deste memorial
Escrita direta. Nada de gerador de conteúdo. Cada frase revisada pelo próprio autor — três vezes.
A regra da gaveta
Toda tela que sobrevive a três releases seguidos sem uso vai para gaveta. Software cresce; produto encolhe.
Agradecimentos
A todas as recepcionistas, médicas e médicos que aceitaram ser observados por horas sem nunca saber ao certo o que sairia daquilo. À paciente que descreveu, com paciência de senhora paraense, por que ligava três vezes para confirmar uma consulta que nunca ninguém confirmava de volta. Aos colegas que revisaram diagramas antes das telas. À família, que segurou o silêncio necessário nas três semanas de campo. Este produto não existe sem essas pessoas.
Impacto esperado
Menos ligação de confirmação. Menos tela durante a consulta. Mais retorno pós-consulta. Uma clínica que fica com a memória — mesmo quando as pessoas mudam.
O que este projeto demonstra
Que engenharia de produto pode ser feita fora do eixo Rio–São Paulo, em português da clínica, com método de time sênior e rigor de arquiteto — assinada por uma pessoa só.
Para quem contratar
Este memorial vale como carta de apresentação. Ele mostra como penso, como decido e como entrego. O próximo produto pode ser o seu.
Cólofon
Fontes: Source Serif 4 para display e Inter para corpo. Cores: verde-mata, cream tapioca, vinho-açaí e dourado marajoara. Escrito, desenhado, arquitetado e implementado por Carlos Eduardo. Publicado em MMXXVI.
Fólio CE · Nº 01
Edição 01 · Açaí Clínica
Memorial do produto
Próximo capítulo
Cinco minutos são suficientes para atravessar o fluxo completo: agendamento, confirmação, triagem, consulta simulada e pós-consulta.