first commit
This commit is contained in:
Ricardo Carneiro
commit
1c00ba0339
273
README.md
Normal file
273
README.md
Normal file
@ -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 <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.**
|
||||
Loading…
Reference in New Issue
Block a user