Files
avz-site/COMO-USAR-CONFIG.md
T

233 lines
4.5 KiB
Markdown

# 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:**
```typescript
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):**
```typescript
export const LOGO = {
svgInline: '', // Deixe vazio
imageUrl: '/assets/logo.png', // Ou .svg
text: '', // Deixe vazio se nao quiser texto
textHighlight: '',
};
```
### 2. Trocar Redes Sociais
```typescript
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:
```typescript
tiktok: {
url: 'https://tiktok.com/...',
label: 'TikTok',
iconSvg: '', // Opcional: SVG customizado
},
```
### 3. Trocar Contatos
```typescript
export const CONTACT = {
phone: '(11) 4810-1704',
phoneRaw: '551148101704',
email: 'leads@avanzato.com.br',
supportUrl: 'https://suporte.avanzato.com.br/',
};
```
### 4. Trocar Enderecos
```typescript
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
```typescript
export const NAV_LINKS = [
{ name: 'Home', href: '/' },
{ name: 'Sobre', href: '/sobre' },
{ name: 'Servicos', href: '#', submenu: [...] },
];
```
### 6. Desabilitar WhatsApp Widget
```typescript
export const WHATSAPP_CONFIG = {
enabled: false, // Mude para false para ocultar
// ...
};
```
---
## APOS EDITAR
Sempre que editar `site.ts`, faca:
```bash
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
```bash
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
bash scripts/preserve-assets.sh /caminho/do/site/no/servidor
```
Ou se o site esta em `/var/www/avanzato`:
```bash
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
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*