Abra o link em outra aba pra simular o motorista. (A tela do motorista
será conectada à API na próxima fase — por enquanto pode usar /api/v1/docs
com o token e o código acima.)
`);
} else {
mostrarFeedback($feedback, 'ok', `Solicitação enviada (edição #${edicaoId}).`);
}
```
por (Task 5 vai adicionar copy buttons depois — esse step só renomeia):
```js
// Canal 'exibir_tela': backend devolve código em claro pra que o
// atendente repasse manualmente ao destinatário. Mostramos código,
// token e link no próprio modal.
const codigoExibido = gerarResp?.data?.codigo_exibido;
if (canal === 'exibir_tela' && codigoExibido) {
const linkMotorista = `${window.location.origin}/missao/Logistica/edicaorota/ver_status?token=${encodeURIComponent(token)}`;
$feedback.removeClass('hidden bg-green-900/30 text-green-300 bg-red-900/30 text-red-300')
.addClass('bg-green-900/30 text-green-300')
.html(`
Copie e repasse os dados ao motorista. O modal não fecha sozinho — feche em "Cancelar"/×.
`);
} else {
mostrarFeedback($feedback, 'ok', `Solicitação enviada (edição #${edicaoId}).`);
}
```
- [ ] **Step 4: Smoke manual no browser**
Subir o ambiente local (ou apontar pra dev), abrir a Central, abrir o modal "Liberar rota":
- Verificar que o select agora mostra "Exibir em tela — mostra código, token e link"
- Selecionar "Exibir em tela" — confirmar que **não** pré-preenche telefone/email
- Selecionar outros canais (whatsapp/email/sms) — comportamento normal preservado
Se algo quebrar, voltar e ajustar antes de seguir.
- [ ] **Step 5: Pause — aguardar usuário aprovar antes de commitar**
Mostrar diff:
```bash
git diff componentes/Missoes/Logistica/sinais/Central/html/central.php
```
Aguardar "ok". Quando aprovado:
```bash
git add componentes/Missoes/Logistica/sinais/Central/html/central.php
git commit -m "refactor(central): rename canal teste -> exibir_tela in liberar-motorista modal"
```
---
## Task 4: Fix do auto-close + copy buttons no painel "Exibir em tela"
**Files:**
- Modify: `componentes/Missoes/Logistica/sinais/Central/html/central.php` (render do painel + L.4099)
- [ ] **Step 1: Adicionar copy buttons no HTML do painel**
No mesmo bloco que foi tocado no Task 3 step 3, substituir o `.html(...)` pra incluir botões "Copiar":
```js
const codigoExibido = gerarResp?.data?.codigo_exibido;
if (canal === 'exibir_tela' && codigoExibido) {
const linkMotorista = `${window.location.origin}/missao/Logistica/edicaorota/ver_status?token=${encodeURIComponent(token)}`;
$feedback.removeClass('hidden bg-green-900/30 text-green-300 bg-red-900/30 text-red-300')
.addClass('bg-green-900/30 text-green-300')
.html(`
Copie e repasse os dados ao motorista. O modal não fecha sozinho — feche em "Cancelar"/×.
`);
} else {
mostrarFeedback($feedback, 'ok', `Solicitação enviada (edição #${edicaoId}).`);
}
```
- [ ] **Step 2: Adicionar handler global pro botão `.copiar-exibir-tela`**
Logo após o handler `mostrarFeedback` (ou junto dos outros `$(document).on(...)` da seção, ~L.4111), adicionar:
```js
// Handler dos botões "Copiar" do painel exibir_tela.
// Usa Clipboard API moderna; fallback pra execCommand em browsers antigos.
$(document).on('click', '.copiar-exibir-tela', async function () {
const $btn = $(this);
const valor = $btn.attr('data-copiar-valor') || '';
const rotulo = $btn.attr('data-copiar-rotulo') || '';
if (!valor) return;
let ok = false;
try {
if (navigator.clipboard && window.isSecureContext) {
await navigator.clipboard.writeText(valor);
ok = true;
} else {
const ta = document.createElement('textarea');
ta.value = valor;
ta.setAttribute('readonly', '');
ta.style.position = 'absolute';
ta.style.left = '-9999px';
document.body.appendChild(ta);
ta.select();
ok = document.execCommand('copy');
document.body.removeChild(ta);
}
} catch (e) {
console.warn('[exibir-tela] copiar falhou:', e);
ok = false;
}
const htmlOriginal = $btn.html();
$btn.html(ok
? `${rotulo} copiado`
: `Falhou`);
setTimeout(() => $btn.html(htmlOriginal), 1500);
});
```
- [ ] **Step 3: Fix do auto-close — só fecha quando canal != 'exibir_tela'**
Em `central.php`, linha 4099. Trocar:
```js
setTimeout(() => $('#liberar-motorista-modal').addClass('hidden'), 1200);
```
por:
```js
// No modo 'exibir_tela' o atendente precisa ler/copiar código,
// token e link antes de fechar. Não auto-close nesse caso —
// o usuário fecha em "Cancelar"/×.
if (canal !== 'exibir_tela') {
setTimeout(() => $('#liberar-motorista-modal').addClass('hidden'), 1200);
}
```
- [ ] **Step 4: Smoke manual no browser**
Cenário 1 — exibir_tela:
- Abrir modal "Liberar rota", selecionar "Exibir em tela", preencher dados, confirmar.
- Verificar que aparece o painel verde com Código (6 dígitos) / Token / Link, cada um com botão "Copiar".
- Clicar em cada "Copiar" — confirmar que: (a) o conteúdo vai pro clipboard, (b) o botão muda pra "Código copiado" / "Token copiado" / "Link copiado" por ~1.5s.
- **Confirmar que o modal NÃO fecha sozinho** depois de 1.2s. Modal só fecha clicando em × ou "Cancelar".
Cenário 2 — outros canais:
- Trocar pra "WhatsApp" (ou outro), confirmar.
- Modal mostra feedback breve "Solicitação enviada (edição #N)." e fecha em ~1.2s. Comportamento atual preservado.
Se quebrar, voltar e ajustar.
- [ ] **Step 5: Pause — aguardar usuário aprovar antes de commitar**
Mostrar diff:
```bash
git diff componentes/Missoes/Logistica/sinais/Central/html/central.php
```
Aguardar "ok". Quando aprovado:
```bash
git add componentes/Missoes/Logistica/sinais/Central/html/central.php
git commit -m "feat(central): keep liberar-motorista modal open on exibir_tela + copy buttons"
```
---
## Task 5: Verificação final + cleanup
**Files:** nenhum direto — sondagem.
- [ ] **Step 1: Re-rodar test de integração**
```bash
php componentes/Missoes/Plataforma/sinais/Api/Testes/Handlers/CanalExibirTelaIntegrationTest.php
```
Expected: `RESULTADO: PASS=8 FAIL=0`.
- [ ] **Step 2: Sondar referências esquecidas**
```bash
grep -rn "TesteCanal\|codigo_teste" componentes/Missoes/Mensageria componentes/Missoes/Plataforma componentes/Missoes/Logistica/sinais/Edicaorota componentes/Missoes/Logistica/sinais/Central 2>/dev/null | grep -v "tasks/" | grep -v "\.md:"
```
Expected: zero linhas em código `.php`/`.js`. Se aparecer alguma:
- Em `tasks/*.md` ou `PRD/`: ignorar (histórico).
- Em código vivo: voltar e atualizar antes de fechar.
```bash
grep -rn "'teste'" componentes/Missoes/Plataforma/sinais/Api 2>/dev/null | grep -v "tasks/"
```
Expected: zero linhas.
- [ ] **Step 3: Verificar OpenAPI**
Abrir `/api/v1/docs` (com user dev autenticado) e conferir:
- Endpoint `POST /api/v1/edicao-rota/{token}/otp/gerar` mostra enum com `exibir_tela` (não `teste`).
- Descrição da response 200 menciona `codigo_exibido`.
Se a página não estiver acessível em dev local, basta validar visualmente o conteúdo gerado por `OpenApi/spec.php`.
- [ ] **Step 4: Smoke final no browser — fluxo completo**
- Abrir Central, selecionar uma rota, abrir "Liberar rota para motorista".
- Selecionar "Exibir em tela", preencher, confirmar.
- Copiar código e token, abrir o link em outra aba.
- Confirmar que a tela do motorista carrega com o token (a integração além disso já existe — só estamos validando que o fluxo de geração + repasse manual funciona).
- Voltar pro modal, fechar manualmente.
- [ ] **Step 5: Atualizar memory do projeto se necessário**
Não esperado — esse é um fix/refactor pontual, não introduz padrão novo. Se durante implementação surgir algo surpreendente (ex.: descobrir uma convenção do canal que não estava documentada), salvar via memory conforme regras de auto-memory.
---
## Self-Review (notas do plano)
- **Spec coverage**: cada decisão do spec mapeia pra uma task:
- Rename canal/classe → Task 2
- Remoção do gate dev → Task 2 step 3
- Rename de chaves resposta → Task 2 step 3
- OpenAPI → Task 2 step 4
- Fix auto-close → Task 4 step 3
- Copy buttons → Task 4 steps 1-2
- Test refactor → Task 1
- Critérios de aceite → cobertos pelos smoke tests (Task 3 step 4, Task 4 step 4) e Task 5
- **Placeholder scan**: nenhum TBD/TODO/"add error handling" sem código.
- **Type consistency**: `ExibirTelaCanal::$ultimoCodigo` é a mesma propriedade estática que `TesteCanal::$ultimoCodigo` — só renomeada. Não há divergência entre tasks. `codigo_exibido` / `codigo_exibido_dest` consistente em backend + test + frontend.
- **i18n**: spec deixou em aberto "verificar antes de adicionar". Plano mantém label hardcoded em PT-BR (consistente com o resto do modal `liberar-motorista` que também é hardcoded). Se i18n for necessário, é escopo separado.