webmoney/.github/copilot-instructions.md

# Copilot Instructions

## 🔄 REPOSITÓRIO GIT - GITEA (Self-Hosted)

**IMPORTANTE:** O repositório principal é o Gitea no nosso servidor, NÃO o GitHub.

### Configuração do Repositório

```bash
# Repositório principal (Gitea)
git remote -v
# gitea   https://git.cnxifly.com/marco/webmoney.git

# URL Web
https://git.cnxifly.com/marco/webmoney

# Credenciais Gitea
Usuário: marco
Senha:   M@ster9354
```

### Comandos Git

```bash
# Push para Gitea (SEMPRE usar este)
git push gitea main

# Pull do Gitea
git pull gitea main

# Commit padrão
git add -A && git commit -m "descrição" && git push gitea main
```

### ❌ Proibições Git

- NUNCA usar `git push origin` (GitHub foi descontinuado)
- NUNCA criar repositórios no GitHub para este projeto

---

## 🚨 REGRA CRÍTICA DE DEPLOY

**NUNCA envie arquivos manualmente com scp/rsync para o servidor.**

### Deploy Obrigatório

Sempre que precisar enviar código para produção, USE OS SCRIPTS:

```bash
# Para mudanças no BACKEND (PHP/Laravel)
cd /workspaces/webmoney/backend && ./deploy.sh

# Para mudanças no FRONTEND (React/JS)
cd /workspaces/webmoney/frontend && ./deploy.sh
```

### Por que usar os scripts?

Os scripts de deploy:
1. **Backend (deploy.sh)**:
   - Sincroniza arquivos com rsync
   - Instala dependências com composer
   - Executa migrações
   - Limpa e regenera cache
   - Reinicia PHP-FPM
   - Ajusta permissões

2. **Frontend (deploy.sh)**:
   - Faz build do React (npm run build)
   - Envia para /var/www/webmoney/frontend/**dist** (não /frontend!)
   - Verifica se deploy funcionou

### Proibições

❌ `scp arquivo root@213.165.93.60:/var/www/webmoney/...`
❌ `rsync arquivo root@213.165.93.60:/var/www/webmoney/...`
❌ Copiar arquivos individuais manualmente

### Workflow

1. Editar código
2. `cd backend && ./deploy.sh` ou `cd frontend && ./deploy.sh`
3. Testar em https://webmoney.cnxifly.com
4. Se OK: 
   - `VERSION++` (incrementar versão)
   - Atualizar `CHANGELOG.md` (documentar mudanças)
   - Atualizar `README.md` (sempre que necessário - novas features, requisitos, comandos, etc.)
5. Commit e push para Gitea:
   ```bash
   git add -A && git commit -m "descrição" && git push gitea main
   ```

### 📝 Quando atualizar README.md

- Nova funcionalidade importante
- Mudança de requisitos (versão PHP, Node, etc.)
- Novos endpoints de API
- Alteração de variáveis de ambiente
- Novos comandos artisan
- Mudança na estrutura do projeto

## 🚫 Regras de UI/UX

**NUNCA use alert(), confirm() ou prompt() do navegador.**

Sempre usar componentes modais ou toast:
- Para erros: `toast.error('mensagem')`
- Para sucesso: `toast.success('mensagem')`
- Para confirmação: Usar `<ConfirmModal />` component
- Para formulários: Criar modal customizado

```jsx
// ❌ PROIBIDO
alert('Erro!');
confirm('Tem certeza?');

// ✅ CORRETO
import { useToast } from '../components/Toast';
import { ConfirmModal } from '../components/Modal';

const toast = useToast();
toast.error('Erro!');
toast.success('Sucesso!');
```

## Estrutura do Servidor

```
/var/www/webmoney/
├── backend/          # Laravel (Nginx → PHP-FPM)
└── frontend/
    └── dist/         # React build (Nginx root)
```

## Credenciais

- **Servidor**: root@213.165.93.60 (senha: Master9354)
- **Banco**: webmoney / M@ster9354
- **Usuário WebMoney**: marco@cnxifly.com / M@ster9354

## 🔑 Acesso SSH - SEMPRE usar sshpass

**OBRIGATÓRIO:** Sempre usar `sshpass` para comandos SSH/SCP/RSYNC.

```bash
# SSH para executar comandos
sshpass -p 'Master9354' ssh -o StrictHostKeyChecking=no root@213.165.93.60 "comando"

# Ver logs do Laravel
sshpass -p 'Master9354' ssh -o StrictHostKeyChecking=no root@213.165.93.60 "tail -50 /var/www/webmoney/backend/storage/logs/laravel.log"

# Executar tinker
sshpass -p 'Master9354' ssh -o StrictHostKeyChecking=no root@213.165.93.60 "cd /var/www/webmoney/backend && php artisan tinker --execute='codigo'"

# MySQL
sshpass -p 'Master9354' ssh -o StrictHostKeyChecking=no root@213.165.93.60 "mysql -u webmoney -p'M@ster9354' webmoney -e 'QUERY'"
```

❌ NUNCA usar `ssh root@213.165.93.60` sem sshpass (vai travar esperando senha)

## 🎨 Padrão Visual de Modais

**TODOS os modais de formulário devem seguir este padrão elegante:**

### Estrutura Base
```jsx
<div className="modal show d-block" style={{ backgroundColor: 'rgba(0,0,0,0.8)' }}>
  <div className="modal-dialog modal-dialog-centered modal-lg">
    <div className="modal-content border-0" style={{ background: '#1e293b', maxHeight: '90vh' }}>
      
      {/* Header sem borda */}
      <div className="modal-header border-0 pb-0">
        <div>
          <h5 className="modal-title text-white mb-1">
            <i className="bi bi-icon me-2 text-primary"></i>
            Título
          </h5>
          <p className="text-slate-400 mb-0 small">Subtítulo</p>
        </div>
        <button className="btn-close btn-close-white" onClick={onClose}></button>
      </div>

      {/* Body com scroll */}
      <div className="modal-body pt-3" style={{ maxHeight: '65vh', overflowY: 'auto' }}>
        {/* Preview Card - SEMPRE no topo */}
        <div className="mb-4 p-3 rounded-3" style={{ background: '#0f172a' }}>
          {/* Preview visual do item sendo criado/editado */}
        </div>

        {/* Campos em cards com background #0f172a */}
        {/* Labels com ícones coloridos */}
        {/* Badges "Opcional" quando necessário */}
      </div>

      {/* Footer sem borda */}
      <div className="modal-footer border-0">
        <button className="btn btn-outline-secondary px-4">Cancelar</button>
        <button className="btn btn-primary px-4">Salvar</button>
      </div>
    </div>
  </div>
</div>
```

### Cores do Sistema
- **Background modal**: `#1e293b`
- **Background campos/cards**: `#0f172a`
- **Texto principal**: `text-white`
- **Texto secundário**: `text-slate-400`
- **Texto desabilitado**: `text-slate-500`

### Labels com Ícones
```jsx
<label className="form-label text-white fw-medium mb-2">
  <i className="bi bi-type me-2 text-primary"></i>
  Nome *
</label>
```

### Badge Opcional
```jsx
<span className="badge bg-secondary ms-2" style={{ fontSize: '0.65rem' }}>
  {t('common.optional')}
</span>
```

### Seleção Visual com Cards
Para seleções (categorias, ícones), usar cards clicáveis:
```jsx
<div
  onClick={() => handleSelect(item)}
  className="p-2 rounded text-center"
  style={{ 
    background: isSelected ? 'rgba(59, 130, 246, 0.15)' : '#0f172a',
    cursor: 'pointer',
    border: isSelected ? '2px solid #3b82f6' : '2px solid transparent'
  }}
>
  <i className={`bi ${icon} d-block mb-1`} style={{ color }}></i>
  <small className="text-white">{label}</small>
</div>
```

### Seção de Keywords/Tags
```jsx
<div className="p-3 rounded" style={{ background: '#0f172a' }}>
  <div className="input-group mb-2">
    <input className="form-control bg-dark text-white border-0" />
    <button className="btn btn-primary px-3">
      <i className="bi bi-plus-lg"></i>
    </button>
  </div>
  <div className="d-flex flex-wrap gap-2">
    {/* Tags com cor do item */}
  </div>
</div>
```

### Switch de Status
```jsx
<div className="form-check form-switch">
  <input type="checkbox" className="form-check-input" role="switch" />
  <label className="form-check-label text-white">
    <i className={`bi ${isActive ? 'bi-check-circle text-success' : 'bi-x-circle text-secondary'} me-2`}></i>
    {isActive ? 'Activo' : 'Inactivo'}
  </label>
</div>
```

## Documentação

Consulte `.DIRETRIZES_DESENVOLVIMENTO_v5` para regras completas.