Entenda o que é publicar um site
No módulo 2.1 você viu o localhost: o endereço que só existe dentro do seu computador. A página fica linda na sua tela, mas se mandar o link para alguém, não abre.
Publicar é copiar essa página para um computador que fica ligado o tempo todo na internet e dar a ela um endereço público. Esse serviço se chama hospedagem. A novidade é que o próprio Codex faz essa parte, sem você contratar nada à parte para projetos simples.
🆕 Novo aqui? Quatro palavras deste módulo
- Hospedagem — um computador na nuvem que guarda o seu site e o entrega a quem pedir, dia e noite.
- Publicar — mandar a página do seu computador para a hospedagem e ganhar um link público.
- Domínio — o nome do endereço, como
lojadorui.com.br. Sem domínio próprio, o site ganha um endereço provisório. - Banco de dados — o lugar onde o site guarda informações que mudam: cadastros, logins, pedidos.
Como ler o desenho: à esquerda, a página mora no notebook e o celular do cliente não alcança. À direita, ela foi copiada para a nuvem, ganhou um link, e os celulares azuis abrem de qualquer lugar.
✗ Página em localhost
- ✗ Só abre no computador onde foi criada
- ✗ Some quando você desliga a máquina
- ✗ O link mandado no WhatsApp não funciona
- ✗ Ninguém sabe quantas pessoas viram
✓ Site publicado
- ✓ Abre em qualquer celular ou computador
- ✓ Fica no ar com seu notebook desligado
- ✓ Link pronto para mandar a clientes
- ✓ Painel mostra quantas visitas teve
Transforme um localhost em site
O Rui pediu ao Codex uma página com as promoções da semana, montada a partir do arquivo promocoes.csv da loja-rui. Ela ficou pronta em localhost. Agora ele quer mandar o link no grupo de clientes.
Há dois jeitos de pedir: escrever "transforme isso num site" na conversa ou usar o atalho /site. Os sites publicados ficam reunidos numa área própria do aplicativo, chamada Sites. O nome do botão pode mudar entre versões; procure por "Sites" no menu de explorar.
Como ler o desenho: o foguete sai do localhost (embaixo) e chega ao planeta "no ar" (em cima). Os três marcos azuis são as paradas obrigatórias: revisar a página, decidir quem pode abrir e só então publicar.
Revise no localhost
Abra a página no navegador do Codex, confira preços, telefone e endereço da loja. Corrija agora, antes de qualquer cliente ver.
Peça a publicação
Na mesma conversa, escreva o pedido abaixo ou use /site. Ele prepara os arquivos e envia para a nuvem.
Escolha quem abre
Público ou só você e seu time (próximo tópico). Na dúvida, comece fechado.
Teste fora de casa
Abra o link no celular, com o Wi-Fi desligado. Se abrir no 4G, abre para o cliente.
Objetivo: levar para a internet a página que hoje só abre no localhost, com uma revisão antes.
Transforme a página de promoções que está rodando no localhost num site publicado. Antes de publicar: 1) confira se não há nenhum dado pessoal de cliente na página; 2) me mostre a lista de arquivos que vão subir; 3) deixe o site visível só para mim, eu abro para o público depois. Quando terminar, me passe o endereço.
Decida quem pode abrir
Todo site publicado tem uma chave de visibilidade. Público quer dizer que qualquer pessoa com o link abre. Privado quer dizer que só você, ou só o seu time, abre, e para isso precisa estar logado.
O catálogo de promoções do Rui é público: quanto mais gente vir, melhor. Já a Paula montou um painel com o andamento dos processos seletivos dos clientes dela. Esse fica privado, porque tem nome de candidato.
Como ler o desenho: o cadeado âmbar está aberto e as pessoas entram sem crachá. O azul está fechado: só entra quem fez login (direita); o visitante sem login (esquerda, cinza) fica de fora.
✓ Pode ser público
- ✓ Catálogo e promoções
- ✓ Página de apresentação do seu serviço
- ✓ Horário, endereço e telefone de contato
- ✓ Artigos e materiais gratuitos
✗ Nunca público
- ✗ Lista de clientes, CPF, telefone de pessoas
- ✗ Currículos e dados de candidatos
- ✗ Planilha de custos e margens da loja
- ✗ Rascunhos que ainda não foram revisados
💡 "Link escondido" não é privado
Um site público com endereço difícil de adivinhar continua público: basta alguém repassar o link. Se a página tem algo que não pode vazar, a escolha é privado, com login.
Acompanhe as visitas
Cada site publicado ganha um painel de visitas, o que no mundo da internet se chama analytics. Ele mostra quantas pessoas abriram, em que dias e por qual caminho chegaram. O nome do botão pode mudar entre versões; procure pelo ícone de gráfico na página do site.
O Rui descobriu que as promoções que ele manda na segunda às 7h têm o dobro de visitas das que manda na sexta à tarde. Mudou o dia do envio sem precisar de ninguém para interpretar os números.
Como ler o desenho: cada barra é um dia. A barra âmbar (segunda) é o dia do envio às 7h e puxa a semana. O cartão à direita resume o que importa: total, aparelho e de onde as pessoas vieram. Os números são de exemplo.
Objetivo: transformar o painel de visitas numa decisão simples, em linguagem de gente.
Olhe as visitas do site de promoções nas últimas 4 semanas. Em até 5 linhas, me diga: qual dia e horário trazem mais visitas, de onde as pessoas chegam e uma mudança que eu deveria testar na próxima semana. Salve em relatorios/visitas-do-mes.md.
Ligue um domínio e um banco de dados
O site nasce com um endereço provisório, longo e sem cara de loja. Se o Rui já tem um nome registrado, como lojadorui.com.br, dá para ligar o domínio ao site. O Codex explica o passo a passo do registro e do apontamento; a parte de comprar ou renovar o nome é sua.
O segundo degrau é o banco de dados. Com ele o site deixa de ser só vitrine: guarda cadastro de clientes que querem receber promoções, logins, configurações. Para projetos simples, isso substitui contratar uma hospedagem tradicional. Os nomes das opções podem mudar entre versões.
Como ler o desenho: a placa à esquerda dá ao site um nome fácil de lembrar. O cilindro à direita é a memória do site: as setas vão e voltam porque ele grava o cadastro quando o cliente clica em "Quero receber" e lê de volta quando precisa.
| Recurso | Para que serve | Quem faz o quê |
|---|---|---|
| Site simples | Vitrine, catálogo, apresentação | O Codex publica; você revisa |
| Domínio próprio | Endereço com o nome do seu negócio | Você registra e paga; o Codex guia a ligação |
| Banco de dados | Cadastro, login, preferências | O Codex monta; você decide o que guardar |
O que olhar na tabela: a última coluna. Quanto mais o site guarda, mais decisões são suas, porque passam a envolver dados de outras pessoas.
Publique com responsabilidade
Publicar ficou fácil a ponto de ser perigoso. Em dois minutos uma planilha com telefone de cliente pode virar página pública. No Brasil, a LGPD (Lei Geral de Proteção de Dados) diz que quem coleta dado pessoal responde por ele, inclusive o pequeno comerciante.
A regra do Rui virou linha no AGENTS.md da loja: "nenhum dado de cliente em página pública; antes de publicar, me mostre o que vai subir". Assim o Codex confere sozinho em toda publicação.
Como ler o desenho: a página só chega ao botão azul depois de passar pelo escudo. As quatro luzes verdes são as conferências que você pede ao Codex em toda publicação. Uma apagada, a página volta.
✓ Antes de publicar
- ✓ Pedir a lista do que vai subir
- ✓ Ler a página inteira no celular
- ✓ Avisar no formulário para que o dado será usado
- ✓ Começar privado e abrir depois
✗ Nunca
- ✗ Publicar a pasta inteira do projeto
- ✗ Usar foto de cliente sem autorização
- ✗ Guardar cadastro sem dizer para quê
- ✗ Prometer na página o que a loja não cumpre
💡 Tirar do ar também é um pedido
Se publicou algo errado, peça na hora: "tire o site de promoções do ar" ou mude para privado. Depois corrija com calma e publique de novo.
Teste rápido (opcional): a Paula quer publicar o painel com o andamento dos processos seletivos dos clientes. Qual visibilidade?
🎓 Resumo do módulo
/site — revise antes.Próximo módulo:
4.3 — Subagentes: delegue em paralelo