From 1c00ba03397a99bcfdb9913736796a968a91dc26 Mon Sep 17 00:00:00 2001 From: Ricardo Carneiro Date: Tue, 17 Jun 2025 15:45:45 -0300 Subject: [PATCH] first commit --- README.md | 273 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 273 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..dce1605 --- /dev/null +++ b/README.md @@ -0,0 +1,273 @@ +# 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 + 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 + + +JobMaker - Consultoria RAG e IA Empresarial | C#/.NET + + + +JobMaker - Enterprise RAG & AI Consulting | C#/.NET +``` + +### Headers de Idioma +```html + + +``` + +## đŸ› ïž 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.**