PIN único e modo de edição que expira ao fim de uma hora (v3.23.0)

[qzte]

Ponto #13 do plano, com a intenção corrigida: o PIN não é para proteger informação — é fricção deliberada, para que concluir passos do workflow seja sempre um acto consciente e nunca um clique distraído.

O que muda

1 · Um PIN só: SUPERMERCADO

Eram seis, um nome próprio por pessoa — seis nomes de colegas numa página pública, sem que isso protegesse fosse o que fosse. A lista continua a ser uma lista: acrescentar outro é acrescentar uma entrada.

2 · O modo de edição expira uma hora depois de o PIN ser aceite

Contagem absoluta e não por inactividade, de propósito: quem está a editar sem parar é precisamente quem deve voltar a parar. Uma sessão aberta de manhã ficava aberta o dia inteiro, e o travão diluía-se para uma vez por dia.

A expiração fecha os dois modos de edição — o React (separador Tracking) e o imperativo (separador Workflow) —, que o mesmo PIN abre conforme a vista. Fechar só um deixava-os a discordar, que é a família de bugs que esta aplicação já tem de sobra.

Expirar não perde trabalho. O deactivateWorkflowEditor grava o workflow ao sair, os processos continuam na sessão e o aviso ● não guardado mantém-se visível. O que desaparece são os controlos de edição — incluindo o 💾 Guardar backup —, que voltam com o PIN. O aviso in-app diz exactamente isso.

A saída forçada não pergunta nada, ao contrário da saída manual: ao fim de uma hora pode não estar ninguém à frente do ecrã, e uma pergunta sem resposta deixaria o editor aberto — que é precisamente o que a expiração existe para evitar.

A intenção fica escrita

O código e o README passam a dizer para que serve o PIN, com as duas advertências que faltavam e que apontam em sentidos opostos:

• não o transformar em autenticação — hashear ou cifrar no cliente é teatro, porque a chave viaja com a fechadura;
• não o remover por parecer inútil — o travão é a funcionalidade.

Guardas no build

Isto é do género de coisa que desaparece sem dar erro nenhum. O build.mjs falha se o expirarSessaoEditor deixar de existir, se o confirmPinModal deixar de armar a contagem, ou se a expiração deixar de fechar um dos dois modos.

Testes

Seis testes novos, em dois grupos, porque provam coisas diferentes:

Grupo	O que exerce
a sessão expira e fecha os dois editores	o que o temporizador chama: fechar ambos os modos, não perder dados, o aviso, e o PIN devolver o modo
expira à hora, não antes	o próprio temporizador, com o relógio do Playwright — aberto aos 59 minutos, fechado aos 61

A separação não é zelo: uma expiração ligada a um setTimeout que nunca chega a ser armado passaria no primeiro grupo inteiro.

npm run ci passa (86 unitários, lint, validate, build). Nos testes de browser todos os funcionais passam; as falhas restantes são o ERR_CERT_AUTHORITY_INVALID do proxy TLS deste ambiente, que varia entre 12 e 14 conforme o momento em que o pedido ao Google Fonts falha.

Fora do âmbito, mas registado

Duas coisas que valem por si e não são sobre o PIN: proteger main com um ruleset (é o que protege mesmo a escrita) e não comprometer dados reais no repositório público (hoje o supermercados_backup.json ainda está vazio). Ficam para quando quiseres.

🤖 Generated with Claude Code

https://claude.ai/code/session_01XwDMNpJzcA3Z2nP3jjwuJd

---

Generated by Claude Code

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.