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](#como-entrar-no-painel)
- [A regra mais importante: o que torna algo visível no site](#a-regra-mais-importante-o-que-torna-algo-visível-no-site)
- [Editar os textos da home e das páginas institucionais](#editar-os-textos-da-home-e-das-páginas-institucionais)
- [Casos de portfólio: criar, editar, publicar e despublicar](#casos-de-portfólio-criar-editar-publicar-e-despublicar)
- [Depoimentos: adicionar e publicar](#depoimentos-adicionar-e-publicar)
- [Serviços: editar](#serviços-editar)
- [Contato: telefone, e-mail e redes sociais](#contato-telefone-e-mail-e-redes-sociais)
- [Imagens: formatos aceitos, tamanho e texto alternativo](#imagens-formatos-aceitos-tamanho-e-texto-alternativo)
- [Usuários: papéis, ativar e desativar contas](#usuários-papéis-ativar-e-desativar-contas)
- [O que NÃO mexer — e com quem falar](#o-que-não-mexer--e-com-quem-falar)
- [Seções da home que somem por completo se ficarem vazias](#seções-da-home-que-somem-por-completo-se-ficarem-vazias)
- [Sobre o arquivo depoimentos.md na raiz do repositório](#sobre-o-arquivo-depoimentosmd-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](#o-que-não-mexer--e-com-quem-falar) 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](#o-que-não-mexer--e-com-quem-falar).

## 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](#o-que-não-mexer--e-com-quem-falar).
- **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](#a-regra-mais-importante-o-que-torna-algo-visível-no-site)).
- **Publicado em** — data de publicação (ver
  [regra de publicação](#a-regra-mais-importante-o-que-torna-algo-visível-no-site)).
- **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](#casos-de-portfólio-criar-editar-publicar-e-despublicar) e
  [Galeria de fotos do caso](#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](#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](#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](#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](#depoimentos-adicionar-e-publicar). Trate esse arquivo como
material histórico de referência, não como fonte de conteúdo.