rx.scoreodonto.com/dental-server/bkp/docs/INSTALACAO-DENTAL-SERVER.md

# 🦷 MANUAL DE INSTALAÇÃO - DENTAL SERVER v2.0

## 📋 SUMÁRIO
1. [Pré-requisitos](#pré-requisitos)
2. [Upload de Arquivos](#upload-de-arquivos)
3. [Configuração no VPS](#configuração-no-vps)
4. [Banco de Dados](#banco-de-dados)
5. [PM2 e Nginx](#pm2-e-nginx)
6. [Verificação](#verificação)

---

## ✅ PRÉ-REQUISITOS

### **No aaPanel:**
- ✅ Node.js instalado (versão 16+)
- ✅ PM2 instalado globalmente
- ✅ Nginx configurado
- ✅ SSL/HTTPS configurado (Let's Encrypt)
- ✅ Porta 3000 liberada (ou outra porta configurada)

### **No terminal do VPS:**
```bash
# Verificar Node.js
node --version

# Verificar PM2
pm2 --version

# Se não tiver PM2:
npm install -g pm2
```

---

## 📤 UPLOAD DE ARQUIVOS

### **1. Estrutura no VPS:**
Crie a pasta no seu VPS (normalmente em `/www/wwwroot/dental-server` ou similar):

```bash
mkdir -p /www/wwwroot/dental-server
cd /www/wwwroot/dental-server
```

### **2. Arquivos para upload:**

Faça upload de TODOS estes arquivos para o servidor:

```
dental-server/
├── routes/
│   └── images.js          ← API de imagens
├── public/
│   ├── index.html         ← Interface web
│   ├── style.css          ← Estilos
│   └── app.js             ← JavaScript
├── installer/
│   └── check-installation.js
├── image-processor.js     ← Processamento de imagens
├── migration-v2.sql       ← SQL para atualizar banco
├── package.json           ← Se não tiver, criar
├── server.js              ← Arquivo principal (existente)
├── database.js            ← Conexão MySQL (existente)
└── INSTALACAO-DENTAL-SERVER.md
```

---

## ⚙️ CONFIGURAÇÃO NO VPS

### **1. Instalar dependências:**

```bash
cd /www/wwwroot/dental-server

# Instalar npm packages
npm install
```

Se o `package.json` não existir, crie:

```bash
npm init -y
npm install express socket.io sharp dotenv cors cookie-parser bcrypt jsonwebtoken mysql2
```

### **2. Criar arquivo `.env`:**

```bash
nano .env
```

Adicione (ajuste conforme seu setup):

```env
# Porta do servidor
PORT=3000

# Ambiente
NODE_ENV=production

# JWT Secret (mude para algo seguro!)
JWT_SECRET=sua_chave_secreta_super_segura_aqui

# Session Secret
SESSION_SECRET=outra_chave_secreta

# Banco de dados MySQL
DB_HOST=localhost
DB_PORT=3306
DB_USER=root
DB_PASSWORD=sua_senha_mysql
DB_NAME=dental_images

# Uploads
UPLOAD_DIR=/www/wwwroot/dental-server/uploads
PROCESSED_DIR=/www/wwwroot/dental-server/processed

# SSL/Domínio
ALLOWED_ORIGINS=https://seu-dominio.com
TRUST_PROXY=true
```

Salve com `Ctrl+O` e `Ctrl+X`.

### **3. Criar pastas necessárias:**

```bash
mkdir -p uploads processed logs
chmod 755 uploads processed logs
```

---

## 🗄️ BANCO DE DADOS

### **Opção A: Via Terminal MySQL:**

```bash
cd /www/wwwroot/dental-server

# Criar banco de dados (se não existir)
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS dental_images CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

# Executar migration
mysql -u root -p dental_images < migration-simple.sql
```

### **Opção B: Via phpMyAdmin ou MySQL Workbench:**

1. Crie o banco de dados `dental_images`
2. Selecione o banco
3. Importe o arquivo `migration-simple.sql`

### **Verificar estrutura:**

```bash
mysql -u root -p dental_images -e "DESCRIBE images;"
```

Deve mostrar todas as colunas incluindo as novas:
- `enabled`, `tooth_number`, `tooth_side`, `patient_name_resumed`
- `original_image_id`, `rotation`, `flip_horizontal`, `flip_vertical`

---

## 🚀 PM2 E NGINX

### **1. Iniciar com PM2:**

```bash
cd /www/wwwroot/dental-server

# Iniciar servidor
pm2 start server.js --name dental-server

# Salvar configuração
pm2 save

# Ver status
pm2 status dental-server

# Ver logs
pm2 logs dental-server
```

### **2. Configurar Nginx (Proxy Reverso):**

No aaPanel:
1. Vá em **Website** → **Sua lista de sites** → Clique em **Configuração**
2. Vá em **Configuração** → **Painel de configuração**

Adicione este código ANTES do último `}`:

```nginx
# Dental Server Proxy
location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

# Socket.IO support
location /socket.io/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}
```

Salve e teste a configuração:

```bash
nginx -t
```

Se tudo OK, recarregue:

```bash
nginx -s reload
# ou
service nginx reload
```

---

## ✅ VERIFICAÇÃO

### **1. Testar servidor:**

```bash
# Ver se está rodando
pm2 status dental-server

# Ver logs em tempo real
pm2 logs dental-server --lines 50

# Reiniciar se necessário
pm2 restart dental-server
```

### **2. Acessar no navegador:**

1. **Login:** `https://seu-dominio.com/login`
   - Usuário: `rcesar` ou `rcesar@rcesar.com`
   - Senha: `Rc362514`

2. **Interface:** `https://seu-dominio.com/`
   - Você verá o gerenciador de imagens

3. **Installer:** `https://seu-dominio.com/install`
   - Para reconfigurar ou atualizar

### **3. Testar upload do cliente:**

Configure o cliente Windows para apontar para `https://seu-dominio.com` e envie uma imagem de teste.

---

## 🔧 COMANDOS ÚTEIS

```bash
# Ver status PM2
pm2 status

# Ver logs
pm2 logs dental-server

# Reiniciar
pm2 restart dental-server

# Parar
pm2 stop dental-server

# Iniciar
pm2 start dental-server

# Deletar
pm2 delete dental-server

# Ver informações
pm2 info dental-server

# Monitoramento
pm2 monit
```

---

## 🐛 TROUBLESHOOTING

### **Erro: "Cannot find module"**
```bash
npm install
```

### **Erro: "Port already in use"**
```bash
# Ver quem está usando a porta 3000
lsof -i :3000

# Matar processo
kill -9 <PID>

# Ou mudar porta no .env
PORT=3001
```

### **Erro no banco de dados MySQL**
```bash
# Verificar conexão MySQL
mysql -u root -p -e "USE dental_images; SHOW TABLES;"

# Ver estrutura
mysql -u root -p dental_images -e "DESCRIBE images;"

# Verificar usuário e senha
mysql -u root -p -e "SELECT User, Host FROM mysql.user;"
```

### **Nginx não carrega**
```bash
# Verificar configuração
nginx -t

# Ver logs do Nginx
tail -f /var/log/nginx/error.log
```

### **Socket.IO não conecta**
Verifique se adicionou as configurações de proxy do Socket.IO no Nginx e se o `cors` está configurado no `server.js`.

---

## 📝 PRÓXIMOS PASSOS

1. ✅ Configure o cliente Windows com o IP/domínio do servidor
2. ✅ Faça upload de imagens de teste
3. ✅ Teste todas as funcionalidades:
   - Transformações (rotação, flip)
   - Download com nome personalizado
   - Apagar versões
   - Habilitar/Desabilitar

---

## 📞 SUPORTE

Para problemas:
1. Verifique os logs: `pm2 logs dental-server`
2. Verifique o banco: `mysql -u root -p dental_images -e "SELECT * FROM images LIMIT 5;"`
3. Verifique Nginx: `tail -f /var/log/nginx/error.log`

---

**Última atualização:** 2025-01-26  
**Versão:** 2.0.0  
**Autor:** Rcesar