amare/docs/operations/atualizacao-de-conteudo.md

Atualização de conteúdo do site

Guia para quem cuida do conteúdo do site (textos, fotos, casos de portfólio, depoimentos, serviços e dados de contato) sem precisar mexer em código.

O site é editado por um painel interno chamado "admin" — é uma tela web, parecida com um formulário, onde cada bloco do site (textos da home, casos de portfólio, depoimentos, etc.) vira uma "página" que você edita e salva.

Antes de qualquer coisa, leia a seção "A regra mais importante: o que torna algo visível no site" — ela explica um comportamento que engana quase todo mundo na primeira vez.

Sumário

• Como entrar no painel
• A regra mais importante: o que torna algo visível no site
• Editar os textos da home e das páginas institucionais
• Casos de portfólio: criar, editar, publicar e despublicar
• Depoimentos: adicionar e publicar
• Serviços: editar
• Contato: telefone, e-mail e redes sociais
• Imagens: formatos aceitos, tamanho e texto alternativo
• Usuários: papéis, ativar e desativar contas
• O que NÃO mexer — e com quem falar
• Seções da home que somem por completo se ficarem vazias
• Sobre o arquivo depoimentos.md na raiz do repositório

Como entrar no painel

1. Acesse /admin no domínio do site (ex.: https://seusite.com.br/admin).
2. Se você não estiver logada, o painel mostra uma tela de login pedindo e-mail e senha.
3. Faça login com o e-mail e senha da sua conta.

Se você não conseguir entrar:

• Esqueceu a senha: hoje o painel não tem um link de "esqueci minha senha" self-service. Só uma pessoa com perfil Administrador consegue trocar a senha de outra conta (em Usuários → editar a conta → campo "Senha"). Se você é a única Administradora e está travada fora do painel, vai precisar pedir para quem desenvolve o site trocar a senha diretamente no banco de dados.
• Mensagem de acesso negado / conta inativa: sua conta pode estar com o campo "Ativo" desligado. Só uma Administradora pode reativar isso em Usuários (veja O que NÃO mexer sobre quem pode mexer em contas de usuário).
• Perfil "Assistente" sem acesso a nada: hoje, contas com o papel "Assistente" conseguem fazer login, mas não conseguem ver nem editar nenhum conteúdo — nem Configurações, nem Portfólio, nem Depoimentos, nada. Isso é uma limitação atual do sistema, não um erro seu. Se você precisa dar acesso de edição a alguém que não seja Administrador, avise quem desenvolve o site — hoje não existe um meio-termo (“pode editar mas não pode tudo”), só "Administrador com acesso total" ou "Assistente sem acesso a nada".

A regra mais importante: o que torna algo visível no site

Duas coisas controlam se algo aparece no site. Entender essas duas evita 99% das dúvidas de "publiquei e não apareceu" ou "não publiquei e apareceu".

1. O campo "Publicado em" não é um agendamento

Em Serviços, Portfólio e Depoimentos existe um campo chamado "Publicado em". A intuição normal seria pensar "se eu colocar uma data futura, ele só aparece nessa data" — isso está errado. Assim que você preenche esse campo com qualquer data/hora (passada, presente ou futura) e salva, o item fica visível no site imediatamente. Não existe agendamento.

• Para publicar: preencha "Publicado em" com uma data qualquer e salve.
• Para despublicar: apague o conteúdo desse campo (deixe em branco) e salve. Colocar uma data no futuro não esconde o item — ele continua visível.

2. Home precisa de DOIS interruptores; páginas de listagem só de um

• Nas páginas de listagem completas — /servicos (todos os serviços) e /portfolio (todos os casos) — basta o item estar publicado (campo "Publicado em" preenchido) para aparecer.

• Já nos blocos de Serviços e Portfólio dentro da home (a página inicial), o item só aparece se as duas coisas forem verdadeiras ao mesmo tempo:

  1. Estiver publicado ("Publicado em" preenchido), e
  2. Tiver o interruptor "Destaque" ligado.

  Publicar sozinho não é suficiente para aparecer na home — só coloca o item na listagem completa. Você precisa também ligar "Destaque" se quiser que apareça na home.

• Depoimentos são a exceção: o bloco de Depoimentos na home mostra todo depoimento publicado, independente do interruptor "Destaque". Em Depoimentos, "Destaque" só serve para filtrar a tabela dentro do painel — não muda nada no que aparece para quem visita o site.

Editar os textos da home e das páginas institucionais

No menu lateral, vá em Configurações (dentro do grupo "Conteúdo do site"). É uma página só, dividida em seções. Edite o que quiser e clique em salvar no final.

Diferente de Portfólio, Depoimentos e Serviços, aqui não existe "Publicado em". Tudo o que você salva em Configurações entra no ar imediatamente — não há passo extra de publicação nem como "rascunhar" uma mudança antes de ela aparecer no site.

• Marca e hero — nome da marca, logo (+ texto alternativo, obrigatório se houver logo), textos do topo da home ("hero"): eyebrow (frase pequena acima do título), título, subtítulo, texto dos dois botões de chamada (CTA), nota de rodapé do hero, e o resumo institucional (about_summary). Atenção: nome da marca, título do hero, subtítulo e texto do botão principal são obrigatórios — o formulário não deixa salvar em branco. Já o eyebrow, o botão secundário e a nota do hero podem ficar em branco (o site simplesmente não mostra essa parte se estiver vazia).
  • O resumo institucional é usado em dois lugares e se comporta diferente em cada um: na seção "A Amare" da home, se ficar em branco o site mostra uma frase padrão fixa no lugar; já na página Sobre (/sobre), esse mesmo texto aparece como o parágrafo principal e, se ficar em branco, fica realmente vazio ali (sem frase padrão). O formulário deixa salvar em branco sem avisar — ou seja, não dá erro nenhum, o parágrafo só fica vazio silenciosamente na página Sobre até alguém notar. Por isso, nunca deixe o resumo institucional em branco; depois de editar, confira a página /sobre para garantir que o texto apareceu.
  • A página Sobre também tem uma frase fixa no código ("A [nome da marca] atua em [cidade] com foco em planejamento completo...") que não é editável pelo painel — ela só muda se você editar Nome da marca ou Cidade (que entram nessa frase), o resto do texto é fixo. Para mudar essa frase, é preciso pedir para quem desenvolve o site.
• Manifesto editorial — título, texto de abertura ("lead") e corpo do bloco "Manifesto" da home. Diferente de outros textos, se você deixar esses campos em branco o site não esconde a seção — ele mostra um texto padrão fixo no lugar. Ou seja: em branco aqui não é "some", é "volta ao texto genérico".
• Método — introdução do bloco "Método" e até 4 passos (título + descrição cada), reordenáveis arrastando. Se você apagar todos os passos, o site mostra passos padrão pré-definidos em vez de ficar vazio.
• Princípios — lista de princípios (tags) mostrada na seção institucional. Se ficar vazia, o site mostra uma lista padrão.
• Página Sobre — imagem da página "Sobre" (+ texto alternativo, obrigatório se houver imagem).
• SEO padrão — título e descrição que aparecem quando o site é compartilhado ou aparece no Google (título e descrição são obrigatórios), e a imagem padrão de compartilhamento (que também é reaproveitada como a imagem à direita no hero da home — ao trocar essa imagem, ela muda em dois lugares ao mesmo tempo).
• Analytics — não mexa aqui, veja O que NÃO mexer.

Casos de portfólio: criar, editar, publicar e despublicar

No menu, vá em Portfólio.

Criar ou editar um caso

Clique em "Novo" (ou abra um caso existente) e preencha:

• Título e Slug — o slug é o pedacinho do endereço na internet (ex.: casamento-joana-pedro). Se você deixar o slug em branco ao criar, ele é gerado automaticamente a partir do título. Depois de publicado, evite mudar o slug — isso quebra qualquer link já compartilhado para aquele caso (redes sociais, WhatsApp, Google). Se precisar mesmo mudar, veja O que NÃO mexer.
• Resumo — texto curto usado nas listagens.
• Tipo de evento, Cidade, Local, Data do evento.
• Desafio, Solução, Resultado — o texto do "case" propriamente dito (Desafio e Solução são obrigatórios; Resultado é opcional).
• Imagem de capa (+ texto alternativo, obrigatório se houver imagem). Atenção: diferente de quase toda outra imagem do painel, a capa de um caso de portfólio é sempre obrigatória por trás dos panos — mas o formulário não bloqueia o salvamento se você esquecer de anexá-la. Se você tentar salvar um caso novo sem imagem de capa, o painel não avisa "campo obrigatório": o salvamento simplesmente falha com um erro técnico feio (erro de banco de dados), não a mensagem amigável que você vê para título, resumo etc. Sempre anexe a imagem de capa antes de salvar um caso novo.
• Ordem — número usado para ordenar os casos nas listagens.
• Destaque — liga/desliga a aparição desse caso na home (ver regra das duas chaves).
• Publicado em — data de publicação (ver regra de publicação).
• Meta title / Meta description — título e descrição específicos desse caso para compartilhamento e Google (opcionais; se em branco, usa o padrão configurado em Configurações).

Galeria de fotos do caso

Depois de salvar o caso, abra-o novamente e procure a aba "Galeria". Ali você adiciona quantas fotos quiser, cada uma com:

• Imagem (obrigatória para criar o item da galeria). Atenção: assim como a capa do caso, o formulário não bloqueia o salvamento se você esquecer a imagem — ele deixa parecer que deu certo até você clicar em salvar, e aí falha com um erro técnico de banco de dados em vez de avisar "campo obrigatório". Sempre anexe a imagem antes de salvar um item da galeria.
• Texto alternativo — obrigatório assim que você anexa uma imagem. O sistema não deixa salvar uma foto sem essa descrição.
• Legenda (opcional) — texto que aparece junto da foto.
• Ordem — dá para arrastar as fotos na tabela para reordenar.

Publicar e despublicar um caso

• Publicar: preencha "Publicado em" com qualquer data e salve. Aparece imediatamente em /portfolio e na página própria do caso. Para também aparecer na home, ligue "Destaque".
• Despublicar: apague o conteúdo de "Publicado em" e salve. Colocar uma data futura não esconde o caso.

"Excluir" não é a mesma coisa que despublicar. Cada linha da tabela de Portfólio (e também cada foto dentro da aba "Galeria") tem um botão "Excluir", além do botão de editar. Diferente de despublicar, Excluir apaga o caso para sempre: não existe lixeira, não existe desfazer, e ao excluir um caso todas as fotos da galeria dele são apagadas junto automaticamente. Selecionar várias linhas na tabela também libera uma ação de exclusão em massa, que apaga todas de uma vez com uma única confirmação. Para esconder um caso do site, sempre use "apagar o Publicado em" — só use Excluir quando tiver certeza de que quer destruir o registro definitivamente.

Depoimentos: adicionar e publicar

No menu, vá em Depoimentos.

• Depoimento — o texto do casal. Se você separar o texto em parágrafos com uma linha em branco entre eles, o site respeita essa quebra e mostra cada parágrafo separadamente.
• Nome do autor — ex.: "Jeniffer e Maick".
• Contexto — texto livre mostrado como "— contexto", ex.: Casamento · 06/12/2025.
• Foto (+ texto alternativo, obrigatório se houver foto) — atenção: a foto existe no formulário mas hoje não aparece na home; o campo é preenchido para o futuro, mas visualmente ainda não é exibido.
• Ordem — ordena os depoimentos no bloco da home.
• Destaque — não afeta o site público. Serve só para filtrar a tabela de depoimentos dentro do painel.
• Publicado em — este é o único interruptor que importa para depoimentos aparecerem na home. Preencha e salve para publicar; apague e salve para despublicar. Não existe listagem própria de depoimentos fora da home.

Atenção ao botão "Excluir" em cada linha da tabela (e à exclusão em massa ao selecionar várias linhas): ele é diferente de despublicar e apaga o depoimento para sempre, sem lixeira e sem desfazer. Para tirar um depoimento do ar, apague o "Publicado em" — não use Excluir a menos que queira apagar o registro definitivamente.

Serviços: editar

No menu, vá em Serviços.

• Título e Slug (mesmo comportamento de auto-geração e mesmo cuidado ao mudar depois de publicado que o portfólio).
• Resumo e Descrição.
• Imagem de capa (+ texto alternativo, obrigatório se houver imagem).
• Ordem, Destaque e Publicado em funcionam exatamente como em portfólio: publicado aparece em /servicos; publicado e destaque aparece também na home.

Atenção ao botão "Excluir" em cada linha da tabela (e à exclusão em massa ao selecionar várias linhas): ele é diferente de despublicar e apaga o serviço para sempre, sem lixeira e sem desfazer. Para tirar um serviço do ar, apague o "Publicado em" — não use Excluir a menos que queira apagar o registro definitivamente.

Contato: telefone, e-mail e redes sociais

Esses campos ficam em Configurações → seção "Contato".

• E-mail e Telefone são obrigatórios — o formulário não deixa salvá-los em branco. Eles aparecem no rodapé do site e na página "Contato" como links clicáveis (e-mail abre o programa de e-mail; telefone abre o discador do celular). Importante: esse mesmo e-mail é também o endereço para onde o site envia toda mensagem enviada pelo formulário de contato em /contato (o "briefing" que um visitante preenche e envia). Ou seja, esse campo não é só um link de exibição — ele precisa ser uma caixa de entrada de verdade, monitorada, porque é para lá que vão os pedidos de orçamento e contato de clientes em potencial. Trocar esse e-mail por um endereço que ninguém acompanha faz o site parar de avisar sobre novos contatos, sem nenhum erro aparecer em lugar nenhum do painel.
• Importante sobre WhatsApp: hoje existe um único campo de telefone, e ele vira apenas um link tel: (ligação), não um botão de WhatsApp. Se o número cadastrado for um número de WhatsApp, quem clicar vai abrir o discador, não o WhatsApp. Se você precisa de um botão específico de WhatsApp no site, isso é um pedido para quem desenvolve o site — hoje o campo não faz isso sozinho.
• Cidade — opcional, aparece na página de Contato.
• Redes sociais — lista de "Rede" + "URL" (ex.: instagram → https://instagram.com/suaempresa). Adicione quantas quiser pelo botão "Adicionar rede"; para remover uma, apague a linha inteira.

Imagens: formatos aceitos, tamanho e texto alternativo

Vale para toda imagem enviada em qualquer tela do painel (logo, capas, galeria de portfólio, fotos de depoimento, imagem da página Sobre, imagem de SEO):

• Formatos aceitos: JPG, JPEG, PNG ou WEBP. Qualquer outro formato (ex.: HEIC direto do iPhone, PDF, GIF) é recusado com uma mensagem de erro — converta a imagem antes de enviar. HEIC é o caso mais comum, porque é o formato padrão das fotos tiradas no iPhone. Duas formas simples de resolver:
  • Fotos novas: no iPhone, vá em Ajustes → Câmera → Formatos e escolha "Mais Compatível" — a partir daí, novas fotos já são salvas em JPEG em vez de HEIC.
  • Fotos que já estão em HEIC: envie a foto para você mesma por WhatsApp (ex.: em "Mensagens salvas" ou num grupo/conversa qualquer) e baixe a versão recebida — o WhatsApp converte a imagem para JPEG automaticamente ao enviar.
• Tamanho máximo: 10 MB por arquivo. Acima disso, o envio é recusado.
• Texto alternativo é obrigatório sempre que houver imagem. Isso não é burocracia: é o texto que leitores de tela usam para descrever a imagem para pessoas com deficiência visual, e também ajuda o Google a entender do que se trata a foto. Sem uma imagem, o campo de texto alternativo pode ficar em branco; assim que você anexa uma imagem, o sistema passa a exigir o texto.
• Exceção: a imagem de capa de um caso de portfólio e a imagem de um item da galeria não são realmente opcionais, ao contrário de toda outra imagem do painel (logo, imagem da página Sobre, foto de depoimento, imagem de SEO). Nesses dois casos específicos, o formulário não impede você de salvar sem imagem, mas o salvamento falha de qualquer forma com um erro técnico em vez de uma mensagem amigável de "campo obrigatório" (ver detalhes nas seções Casos de portfólio e Galeria de fotos do caso). Sempre anexe uma imagem antes de salvar um caso de portfólio ou um item de galeria.
• Você não precisa fazer nada além de enviar a imagem normalmente — o sistema gera sozinho as versões menores usadas em celulares e tablets. Não existe um botão ou comando manual que você precise rodar depois de subir uma foto.

Usuários: papéis, ativar e desativar contas

No menu, vá em Usuários. Esta tela só aparece, e só pode ser editada, por contas com perfil Administrador — se você consegue ver este menu e seguir o resto deste guia, você é Administradora.

Ao criar ou editar uma conta, os campos são:

• Nome e E-mail — identificação da pessoa; o e-mail também é o usado para fazer login.
• Papel — Administrador ou Assistente. Como já visto em Como entrar no painel, hoje não existe meio-termo: Administrador tem acesso total, e Assistente consegue fazer login mas não vê nem edita nenhum conteúdo (nem Portfólio, nem Configurações, nada). Trocar o Papel de alguém para Assistente remove todo o acesso dela imediatamente.
• Ativo — desligar este interruptor bloqueia o login dessa conta por completo, mesmo com e-mail e senha corretos.
• Senha — só é preciso preencher ao criar uma conta nova ou quando você realmente quer trocar a senha de alguém; deixando em branco ao editar uma conta existente, a senha atual não muda.

Cuidado ao editar a sua própria conta. O painel não impede uma Administradora de trocar o próprio Papel para Assistente ou de desligar o próprio "Ativo". Se isso acontecer, você perde o acesso imediatamente e, como visto em Como entrar no painel, hoje não existe "esqueci minha senha" nem qualquer forma de uma Administradora reverter isso sozinha — só sobra pedir para quem desenvolve o site mexer diretamente no banco de dados. Ao mexer no seu próprio usuário, confira duas vezes o que está mudando antes de salvar.

O que NÃO mexer — e com quem falar

• Seção "Analytics" em Configurações (o interruptor e o campo de script). É um campo técnico que injeta código de rastreamento no site. Mexer errado aqui pode quebrar o carregamento do site inteiro. Peça para quem desenvolve o site fazer essa alteração.
• Slug de serviços e casos de portfólio, depois de publicados. Mudar quebra links já compartilhados (redes sociais, WhatsApp, resultados de busca do Google). Se for realmente necessário mudar, avise quem desenvolve o site para avaliar redirecionamento.
• Usuários e permissões (menu "Usuários") — só para quem não é Administradora: essa tela só existe para contas com perfil Administrador, então se você não consegue nem ver o menu "Usuários", precisa de uma conta nova, de desativar alguém, ou de trocar uma senha, peça a uma Administradora — ou, na ausência de uma, a quem desenvolve o site. Se você é Administradora, essa tela é sua e está descrita em Usuários: papéis, ativar e desativar contas.
• Qualquer coisa fora do painel /admin — arquivos de código, banco de dados, comandos de terminal. Nada disso deve ser mexido para uma atualização de conteúdo do dia a dia; se alguém pedir para você rodar um comando técnico para "gerar imagens" ou algo do tipo, isso é tarefa de engenharia, não de edição de conteúdo — fale com quem desenvolve o site.

Seções da home que somem por completo se ficarem vazias

Estas três seções da home desaparecem inteiramente (sem nenhum aviso ou espaço reservado) se não houver nenhum item que atenda aos critérios abaixo:

Seção da home	Desaparece quando...
Serviços	zero serviços estiverem, ao mesmo tempo, publicados e com "Destaque" ligado
Portfólio	zero casos estiverem, ao mesmo tempo, publicados e com "Destaque" ligado
Depoimentos	zero depoimentos estiverem publicados (o "Destaque" não importa aqui)

Se você despublicar o último item de uma dessas categorias — ou esquecer de ligar "Destaque" em qualquer serviço/caso — a home simplesmente fica sem aquele bloco, sem mensagem de erro em lugar nenhum. Se um bloco "sumiu" da home, o primeiro lugar para checar é exatamente essa combinação de publicado + destaque.

Sobre o arquivo depoimentos.md na raiz do repositório

Existe um arquivo chamado depoimentos.md na raiz do projeto com os cinco depoimentos reais originais, copiados manualmente de onde vieram (WhatsApp/redes sociais). Ele foi o material bruto usado, uma única vez, para digitar os depoimentos dentro do sistema (e é citado em documentos técnicos antigos como a origem desse conteúdo) — mas hoje nenhum código do site lê esse arquivo. Editar, corrigir ou apagar depoimentos.md não muda nada no site: o texto que aparece de verdade para quem visita o site vive no banco de dados, e é editado exclusivamente pela tela Depoimentos descrita acima. Trate esse arquivo como material histórico de referência, não como fonte de conteúdo.