274 lines
5.6 KiB
Markdown
274 lines
5.6 KiB
Markdown
# JobMaker - Enterprise RAG & AI Consulting
|
|
|
|
🚀 Site profissional de consultoria em RAG e IA com versões em português e inglês.
|
|
|
|
## ✨ Características
|
|
|
|
- **Multilíngue**: Português (padrão) e Inglês (/en/)
|
|
- **SEO Otimizado**: URLs separadas para cada idioma
|
|
- **Responsivo**: Funciona perfeitamente em desktop e mobile
|
|
- **Alto Performance**: Nginx + Docker + compressão gzip
|
|
- **Fácil Deploy**: Scripts automatizados para desenvolvimento e produção
|
|
|
|
## 📁 Estrutura do Projeto
|
|
|
|
```
|
|
jobmaker-website/
|
|
├── index.html # Página principal (português)
|
|
├── en/
|
|
│ └── index.html # Versão em inglês
|
|
├── css/
|
|
│ └── styles.css # Estilos CSS
|
|
├── js/
|
|
│ └── scripts.js # JavaScript
|
|
├── assets/
|
|
│ ├── img/
|
|
│ │ └── jobmaker_logo.png
|
|
│ └── favicon.ico
|
|
├── Dockerfile # Configuração Docker
|
|
├── nginx.conf # Configuração Nginx
|
|
├── docker-compose.yml # Para desenvolvimento
|
|
├── build.sh # Script de build
|
|
└── deploy-production.sh # Script de deploy
|
|
```
|
|
|
|
## 🚀 Quick Start
|
|
|
|
### Desenvolvimento Local
|
|
|
|
1. **Clone o repositório**
|
|
```bash
|
|
git clone <seu-repositorio>
|
|
cd jobmaker-website
|
|
```
|
|
|
|
2. **Build e run com Docker**
|
|
```bash
|
|
chmod +x build.sh
|
|
./build.sh
|
|
```
|
|
|
|
3. **Acesse o site**
|
|
- Português: http://localhost:8080
|
|
- English: http://localhost:8080/en/
|
|
|
|
### Com Docker Compose
|
|
|
|
```bash
|
|
# Desenvolvimento
|
|
docker-compose up -d
|
|
|
|
# Com HTTPS local
|
|
docker-compose --profile ssl up -d
|
|
```
|
|
|
|
## 🌐 URLs e SEO
|
|
|
|
### Estrutura de URLs
|
|
- **Português**: `jobmaker.com.br/`
|
|
- **English**: `jobmaker.com.br/en/`
|
|
|
|
### Meta Tags Otimizadas
|
|
```html
|
|
<!-- Português -->
|
|
<meta name="description" content="Consultoria especializada em RAG e IA empresarial com C#/.NET. Reduza custos e aumente performance com soluções enterprise-grade." />
|
|
<title>JobMaker - Consultoria RAG e IA Empresarial | C#/.NET</title>
|
|
|
|
<!-- English -->
|
|
<meta name="description" content="Specialized consulting in enterprise RAG and AI with C#/.NET. Reduce costs and increase performance with enterprise-grade solutions." />
|
|
<title>JobMaker - Enterprise RAG & AI Consulting | C#/.NET</title>
|
|
```
|
|
|
|
### Headers de Idioma
|
|
```html
|
|
<html lang="pt-BR"> <!-- Versão portuguesa -->
|
|
<html lang="en"> <!-- Versão inglesa -->
|
|
```
|
|
|
|
## 🛠️ Tecnologias
|
|
|
|
- **Frontend**: HTML5, CSS3, JavaScript, Bootstrap 5
|
|
- **Servidor**: Nginx
|
|
- **Containerização**: Docker
|
|
- **Fontes**: Google Fonts (Montserrat, Roboto Slab)
|
|
- **Ícones**: Font Awesome
|
|
|
|
## 📱 Recursos
|
|
|
|
### Detectção de Idioma
|
|
O site detecta automaticamente o idioma do navegador:
|
|
- Brasileiros/portugueses: Permanecem na versão PT
|
|
- Outros países: Redirecionados para /en/
|
|
|
|
### Performance
|
|
- ✅ Compressão Gzip
|
|
- ✅ Cache de assets estáticos (1 ano)
|
|
- ✅ Headers de segurança
|
|
- ✅ Otimização de imagens
|
|
|
|
### SEO Features
|
|
- ✅ Meta tags otimizadas
|
|
- ✅ URLs amigáveis
|
|
- ✅ Structured data
|
|
- ✅ Open Graph tags
|
|
- ✅ Sitemap.xml
|
|
|
|
## 🚀 Deploy
|
|
|
|
### Desenvolvimento Local
|
|
```bash
|
|
./build.sh
|
|
```
|
|
|
|
### Produção
|
|
```bash
|
|
# Configurar registry no script
|
|
./deploy-production.sh
|
|
```
|
|
|
|
### Manual Docker
|
|
```bash
|
|
# Build
|
|
docker build -t jobmaker-website .
|
|
|
|
# Run
|
|
docker run -d -p 80:80 --name jobmaker-web jobmaker-website
|
|
```
|
|
|
|
## 🔧 Configuração
|
|
|
|
### Nginx
|
|
O arquivo `nginx.conf` inclui:
|
|
- Compressão Gzip
|
|
- Cache de assets
|
|
- Headers de segurança
|
|
- Redirecionamentos
|
|
- Logs de acesso
|
|
|
|
### Docker
|
|
- **Imagem**: nginx:alpine (leve e segura)
|
|
- **Porta**: 80 (HTTP)
|
|
- **Volume**: Arquivos copiados para imagem
|
|
|
|
## 📈 Monitoramento
|
|
|
|
### Logs
|
|
```bash
|
|
# Logs do container
|
|
docker logs jobmaker-web
|
|
|
|
# Logs do Nginx
|
|
docker exec jobmaker-web tail -f /var/log/nginx/access.log
|
|
```
|
|
|
|
### Health Check
|
|
```bash
|
|
# Verificar se está online
|
|
curl -f http://localhost:8080
|
|
```
|
|
|
|
## 🌍 Internacionalização
|
|
|
|
### Adicionando Novos Idiomas
|
|
|
|
1. **Criar nova pasta**
|
|
```bash
|
|
mkdir es/ # Para espanhol
|
|
```
|
|
|
|
2. **Copiar e traduzir**
|
|
```bash
|
|
cp en/index.html es/index.html
|
|
# Traduzir conteúdo
|
|
```
|
|
|
|
3. **Atualizar Nginx**
|
|
```nginx
|
|
location /es/ {
|
|
try_files $uri $uri/ /es/index.html;
|
|
}
|
|
```
|
|
|
|
### Manutenção de Traduções
|
|
- Manter estrutura HTML idêntica
|
|
- Traduzir apenas conteúdo textual
|
|
- Verificar meta tags e títulos
|
|
- Testar links e navegação
|
|
|
|
## 🔒 Segurança
|
|
|
|
### Headers Implementados
|
|
```nginx
|
|
X-Frame-Options: SAMEORIGIN
|
|
X-Content-Type-Options: nosniff
|
|
X-XSS-Protection: 1; mode=block
|
|
Strict-Transport-Security: max-age=31536000 (HTTPS)
|
|
```
|
|
|
|
### Para Produção
|
|
- Configure HTTPS com Let's Encrypt
|
|
- Use CDN (Cloudflare)
|
|
- Monitore logs de segurança
|
|
- Configure firewall
|
|
|
|
## 📞 Suporte
|
|
|
|
### Comandos Úteis
|
|
|
|
```bash
|
|
# Ver containers rodando
|
|
docker ps
|
|
|
|
# Parar site
|
|
docker stop jobmaker-web
|
|
|
|
# Reiniciar
|
|
docker restart jobmaker-web
|
|
|
|
# Remover completamente
|
|
docker rm -f jobmaker-web
|
|
docker rmi jobmaker-website
|
|
|
|
# Logs em tempo real
|
|
docker logs -f jobmaker-web
|
|
```
|
|
|
|
### Troubleshooting
|
|
|
|
**Site não carrega:**
|
|
```bash
|
|
docker logs jobmaker-web
|
|
curl -I http://localhost:8080
|
|
```
|
|
|
|
**Problemas de permissão:**
|
|
```bash
|
|
chmod +x build.sh
|
|
chmod +x deploy-production.sh
|
|
```
|
|
|
|
**Nginx não inicia:**
|
|
```bash
|
|
nginx -t # Testar configuração
|
|
```
|
|
|
|
## 📝 Licença
|
|
|
|
© 2024 JobMaker - Ricardo Carneiro. Todos os direitos reservados.
|
|
|
|
---
|
|
|
|
## 🤝 Contribuição
|
|
|
|
Para contribuir com melhorias:
|
|
|
|
1. Fork o projeto
|
|
2. Crie uma branch para sua feature
|
|
3. Commit suas mudanças
|
|
4. Push para a branch
|
|
5. Abra um Pull Request
|
|
|
|
---
|
|
|
|
**Desenvolvido com ❤️ para conectar empresas com soluções RAG/IA de alta performance.**
|