avz-site/COMO-USAR-CONFIG.md

Como Usar a Configuracao Central - Avanzato

O que mudou?

Agora tudo (logo, redes sociais, contatos, enderecos, menu, etc.) esta em um unico arquivo:

src/config/site.ts

Nao precisa mais editar Navigation.tsx, Footer.tsx ou qualquer componente!

---

EDITAR APENAS ESTE ARQUIVO

src/config/site.ts

1. Trocar o Logo

Opcao A - SVG inline:

export const LOGO = {
  svgInline: `<svg width="40" height="40">...COLE O SVG AQUI...</svg>`,
  imageUrl: '', // Deixe vazio
  text: 'avanzato',
  textHighlight: '.',
};

Opcao B - Imagem (PNG/SVG):

export const LOGO = {
  svgInline: '', // Deixe vazio
  imageUrl: '/assets/logo.png', // Ou .svg
  text: '', // Deixe vazio se nao quiser texto
  textHighlight: '',
};

2. Trocar Redes Sociais

export const SOCIAL_LINKS = {
  facebook: {
    url: 'https://www.facebook.com/avanzatotec',
    label: 'Facebook',
  },
  youtube: {
    url: '', // Deixe vazio para OCULTAR
    label: 'YouTube',
  },
  linkedin: {
    url: 'https://www.linkedin.com/...',
    label: 'LinkedIn',
  },
  instagram: {
    url: 'https://www.instagram.com/...',
    label: 'Instagram',
  },
};

Para adicionar uma rede nova, adicione uma linha:

  tiktok: {
    url: 'https://tiktok.com/...',
    label: 'TikTok',
    iconSvg: '', // Opcional: SVG customizado
  },

3. Trocar Contatos

export const CONTACT = {
  phone: '(11) 4810-1704',
  phoneRaw: '551148101704',
  email: 'leads@avanzato.com.br',
  supportUrl: 'https://suporte.avanzato.com.br/',
};

4. Trocar Enderecos

export const ADDRESSES = [
  {
    label: 'Escritorio Principal',
    street: 'Rua Juiz de Fora, 76',
    city: 'Guarulhos',
    state: 'SP',
    cep: '',
  },
  // Adicione mais ou remova
];

5. Trocar Menu de Navegacao

export const NAV_LINKS = [
  { name: 'Home', href: '/' },
  { name: 'Sobre', href: '/sobre' },
  { name: 'Servicos', href: '#', submenu: [...] },
];

6. Desabilitar WhatsApp Widget

export const WHATSAPP_CONFIG = {
  enabled: false, // Mude para false para ocultar
  // ...
};

---

APOS EDITAR

Sempre que editar site.ts, faca:

npm run build

O build vai usar os novos valores automaticamente.

---

SISTEMA DE PRESERVACAO DE ASSETS

Para imagens que NAO devem ser sobrescritas no deploy:

1. Crie a pasta de assets customizados

mkdir -p custom-assets/logo
mkdir -p custom-assets/images

2. Coloque seus arquivos

custom-assets/
  logo/
    logo.png          <- Seu logo (substitui o do build)
    favicon.ico       <- Favicon customizado
  images/
    hero-bg.jpg       <- Imagem do hero
    about.jpg         <- Imagem da secao sobre

3. Execute o script apos o deploy

bash scripts/preserve-assets.sh /caminho/do/site/no/servidor

Ou se o site esta em /var/www/avanzato:

bash scripts/preserve-assets.sh /var/www/avanzato/dist

O que o script faz?

• Copia logo/logo.* para a pasta do site
• Copia images/* para a pasta do site
• Copia fonts/* se houver
• Nao altera nenhum outro arquivo do build

---

FLUXO DE TRABALHO RECOMENDADO

Quando editar config (textos, links, etc.):

1. Edite src/config/site.ts
2. Rode npm run build
3. Deploy

Quando trocar apenas imagens/logo:

1. Coloque a nova imagem em custom-assets/
2. Rode bash scripts/preserve-assets.sh /caminho/do/site
3. Nao precisa rebuild!

Quando eu (dev) atualizar o site:

1. Eu faco as mudancas no codigo
2. Build + deploy
3. Voce roda: bash scripts/preserve-assets.sh /caminho/do/site
4. Seu logo e imagens sao restaurados automaticamente!

---

EXEMPLO COMPLETO

Cenario: Trocar apenas o logo

Passo 1: Coloque o novo logo em custom-assets/logo/logo.png

Passo 2: Execute:

bash scripts/preserve-assets.sh /var/www/avanzato/dist

Resultado:

[LOGO] Copiando logo.png...
Concluido! 1 arquivo(s) preservado(s).

Pronto! O logo foi trocado sem precisar rebuild.

---

PERGUNTAS FREQUENTES

Q: Preciso rebuild quando troco o logo via custom-assets? R: Nao! O script copia diretamente.

Q: E se eu quiser trocar o texto do logo? R: Ai sim, edite site.ts e faca rebuild.

Q: O script funciona em qualquer servidor? R: Sim! Basta passar o caminho correto como argumento.

Q: Posso adicionar novas redes sociais? R: Sim! Basta adicionar em SOCIAL_LINKS no site.ts.

---

Documento criado em: Maio 2026