From 5d506ca336ad68ecd4f918b9f7ab7769e1f7ea33 Mon Sep 17 00:00:00 2001 From: Herbert Rocha Date: Wed, 4 Nov 2026 18:36:11 -0400 Subject: [PATCH 1/3] =?UTF-8?q?docs(plano):=20distribui=C3=A7=C3=A3o=20das?= =?UTF-8?q?=20issues=20do=20milestone=20Pilot?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Levantamento, classificação, caminho crítico e tabela de atribuição aprovada; registra o resultado aplicado (atribuições, fechamento de #81/#83/#90/#94 e #100/#101/#111 movidas para v1.0). --- .../2026-11-04-distribuicao-issues-pilot.md | 295 ++++++++++++++++++ 1 file changed, 295 insertions(+) create mode 100644 docs/superpowers/plans/2026-11-04-distribuicao-issues-pilot.md diff --git a/docs/superpowers/plans/2026-11-04-distribuicao-issues-pilot.md b/docs/superpowers/plans/2026-11-04-distribuicao-issues-pilot.md new file mode 100644 index 00000000..b0bd89a6 --- /dev/null +++ b/docs/superpowers/plans/2026-11-04-distribuicao-issues-pilot.md @@ -0,0 +1,295 @@ +# Distribuição das issues do milestone "Pilot": plano + +> **Para agentes:** SUB-SKILL OBRIGATÓRIA: use superpowers:executing-plans para executar este plano tarefa a tarefa. Os passos usam checkbox (`- [ ]`). **Nenhuma tarefa da Parte B roda antes de o dono do projeto (hbgit) aprovar a Tabela de atribuição da Parte A.** + +**Objetivo:** distribuir as 35 issues abertas do milestone "Pilot" (hbgit/SinalACS) entre os colaboradores, de forma equilibrada e coerente com a área de cada um, para fechar os apps na versão Pilot. + +**Abordagem:** a Parte A traz o levantamento já feito (somente leitura, em 2026-11-04), a classificação, o caminho crítico e a tabela proposta. A Parte B aplica a tabela com `gh`, só depois da aprovação, e confere o resultado. + +**Ferramentas:** `gh` CLI autenticado como `hbgit` (admin do repositório). + +**Fontes:** [`spec/requisitos_piloto.md`](../../../spec/requisitos_piloto.md) (prioridade de cada RF/RNF), [`spec/escopo_projeto.md`](../../../spec/escopo_projeto.md) (P-02…P-14), [`docs/escopo/mudancas-de-codigo-recomendadas.md`](../../escopo/mudancas-de-codigo-recomendadas.md) (C-01…C-12). + +## Restrições globais + +- Nenhuma issue é alterada (responsável, milestone, comentário, estado) antes da aprovação da Tabela de atribuição. +- Toda issue de **deploy/infraestrutura** e de **regulamentação** (LGPD, termos, política de privacidade, CEP, parecer jurídico, custódia de chave, publicação) fica com `hbgit`. +- Onde faltou informação para decidir, a issue vai para a lista de **Pendências**, sem suposição. +- Comentários e textos nas issues em pt-BR, sem atribuição de IA. +- Regra do projeto (RNF07/RNF08): nenhuma atribuição pode tornar um requisito Essencial dependente de unidade de saúde, sistema oficial ou serviço pago. + +## Foco de revisão + +1. **Login com caixa diferente:** o login do GitHub é `Rosialdo` (os commits aparecem também como `rosialdo`). Usar exatamente os logins da API de colaboradores; `gh` aceita sem distinção de caixa, mas a conferência da Task B5 compara pelo login canônico. +2. **Comentário duplicado ao reexecutar:** a Task B4 confere se o comentário de responsabilidade já existe antes de postar. +3. **Fechar issue entregue sem conferir o aceite:** #81/#83/#90/#94 só fecham depois de a Task B2 ler cada critério de aceite contra o `PROGRESS.md`. +4. **Atribuir antes da decisão do pilar B (#149):** as issues marcadas "B" na tabela mudam de milestone se a P-14 sair "não". A Task B3 só atribui essas issues se a #149 estiver decidida por "sim", ou se o dono aprovar atribuí-las mesmo assim. +5. **Conflito de arquivos entre issues paralelas:** #124 e #129 tocam textos com "UBS"; #124 e #125 copiam o mesmo aviso canônico. A Task B4 deixa registrado nas issues quem toca qual arquivo. + +--- + +# Parte A: levantamento, análise e proposta (pronta para revisão) + +## A1. Colaboradores e área de atuação + +Fonte: `gh api repos/hbgit/SinalACS/collaborators`, `git log` desde 2026-01-01 e PRs de autores externos. + +| Login | Papel | Commits | Onde atua (evidência) | Área inferida | +|---|---|---|---|---| +| `hbgit` | admin | ~1030 | todo o repositório | dono, deploy, regulamentação | +| `vinimartinsufrr` | write | 22 | `apps/admin` (35 arquivos), `apps/acs`, `apps/patient`, CI (PRs #5, #11, #26, #27) | **Flutter/mobile + CI** | +| `GuilhermeAlmeidadaLuz` | write | 9 | `backend/sinalacs_server` (38), `spec/lgpd_data_audit.md` (PRs #7, #53: cifra AES-GCM, HMAC, expurgo) | **backend Dart + LGPD/cifra** | +| `sarahw3b` | write | 4 | `spec/ux_accessibility_assessment.md`, `spec/ux_ui_test_plan.md`, guia da Google Play (PRs #6, #12, #29) | **UX/acessibilidade + testes de UX** (sem commit de código) | +| `Rosialdo` | write | 9 | `spec/security_assessment.md` (NIST CSF), `docs/showcase`, `video/showcase` (PRs #10, #35) | **segurança (análise) + conteúdo/apresentação** (1 arquivo em cada app) | + +## A2. Issues abertas e classificação + +Esforço: **P** (≤ 1 dia), **M** (2 a 5 dias), **G** (> 1 semana). Prioridade: **Alta** (bloqueia requisito Essencial ou o início do piloto), **Média** (Essencial sem bloquear outra issue, ou Desejável no caminho crítico), **Baixa** (Desejável/P3). Pilar: **A** (conteúdo e lembretes, sem login), **B** (acompanhamento pelo agente, depende da #149), **—** (ambos). + +| Issue | Título curto | Tipo | Pilar | Esforço | Prioridade | Bloqueada por | +|---|---|---|---|---|---|---| +| #141 | P-02 encarregado da UFRR | regulamentação | — | P | Alta | — | +| #142 | P-03 PET-Saúde: agentes, preceptor | regulamentação | B | P | Alta | — | +| #143 | P-04 Plataforma Brasil (CEP) | regulamentação | — | G | **Alta (crítica)** | #141, #142, #144, #147 | +| #144 | P-05 território | regulamentação | — | P | Alta | — | +| #145 | P-07 temas e revisores | regulamentação/conteúdo | A | P | Alta | — | +| #146 | P-11 parecer da Procuradoria | regulamentação | A | P (+ espera) | Alta | — | +| #147 | P-12 instrumentos dos questionários | regulamentação | — | M | Alta | — | +| #148 | P-13 custódia do repo e da chave | regulamentação/deploy | — | P | **Alta (crítica)** | — | +| #149 | P-14 pilar B no piloto? | regulamentação (escopo) | B | P | **Alta (crítica)** | — | +| #124 | C-01 texto legal do paciente | regulamentação | — | P | Alta | #141 | +| #134 | APK assinado no GitHub Releases | deploy | — | M | **Alta (crítica)** | #148 | +| #135 | compose do piloto + Let's Encrypt | deploy | — | M | Alta | #148 (custódia da CA) | +| #136 | RNF03 cifra local do paciente (Fase 2: PIN) | funcionalidade/segurança | B | M | Alta | #128 (Fase 2) | +| #125 | C-02 aviso educativo (1ª abertura + Sobre) | UI/conteúdo | A | P | Alta | — | +| #126 | C-03 biblioteca de conteúdo offline | funcionalidade/conteúdo | A | M | Alta | #145 | +| #127 | C-04 pedido de contato + "Ligar 192" | funcionalidade | — | G | Alta (bloqueia #130, #131) | #136 Fase 1 (entregue no PR #150) | +| #128 | C-05 acesso sem CPF/SMS/e-mail | funcionalidade | B | G | Alta | #149 | +| #129 | C-06 trocar "UBS" nos textos | UI/conteúdo | — | M | Média | — | +| #130 | C-08 três saídas, sem risco | UI/UX | A | M | Alta | #127, #146 (se P-11 for rejeitada, RF04 vira Futuro) | +| #131 | C-10 "Apagar meus dados" + 30 dias | funcionalidade/LGPD | A | M | Alta | #127; prazo final pelo TCLE (#143) | +| #132 | C-11 autoavaliação local + paridade 64 | funcionalidade/testes | A | M | Alta | — | +| #133 | C-12 recuperação de acesso | funcionalidade/segurança | B | M | Alta | #128 | +| #137 | RNF05 WCAG AA no paciente | UI/UX + testes | — | G | Alta (fecha o caminho) | #125, #126, #127, #128, #130, #131 (telas existirem) | +| #151 | ACS `open_failed` ambíguo | correção | B | M | Alta (perda de visitas, RNF02) | — | +| #152 | ACS `dataExtractionRules` | correção/segurança | B | P | Média | — | +| #153 | paciente preso no diálogo de notificação | correção | — | P | **Alta** (tela de urgência não abre) | — | +| #114 | `acs_full_e2e.sh` 5/6 (SnackBar) | testes | B | P | Média | — | +| #111 | aviso "outro ACS já confirmou" | funcionalidade | B | M | Baixa | — | +| #117 | ACK com identidade do aparelho | segurança | B | M | Média | — | +| #100 | descartes de telemetria pelo teto local | funcionalidade | B | M | Baixa (P3) | — | +| #101 | reemitir eventos de telemetria perdidos | funcionalidade | B | M | Baixa (P3) | — | +| #81 | remote wipe (R3) | — | B | — | já entregue | — | +| #83 | telemetria §1.3 | — | B | — | já entregue | — | +| #90 | mTLS Traefik ↔ backend | — | — | — | já entregue | — | +| #94 | certificado MQTT por aparelho | — | B | — | já entregue | — | + +Por tipo: regulamentação 10 (#124, #141–#149), deploy/infra 2 (#134, #135), funcionalidade 11, UI/UX/conteúdo 4, correção 3, testes 1, já entregues 4. + +## A3. Caminho crítico + +Três trilhas correm em paralelo. O piloto começa quando as três terminam. + +1. **Ética (a mais longa, externa):** #141 + #142 + #144 + #147 → **#143** (submissão e parecer do CEP). O parecer também fixa o prazo de retenção da #131 (30 dias propostos). +2. **Entrega do APK:** **#148** (custódia da chave) → **#134** (release assinado) e #135 (compose com a CA fora do repositório). +3. **Código:** + - Pilar A: #127 → #130 e #131; #125, #126 (depois da #145) e #132 em paralelo; #153 antes de tudo, porque impede a tela de urgência de abrir na primeira execução. + - Pilar B (se a #149 disser "sim"): #128 → #133 e a Fase 2 da #136. + - Fechamento: **#137** (WCAG), depois que as telas novas existirem. + +A **#149** decide o tamanho da trilha 3: se o pilar B sair, #128, #133, a Fase 2 da #136, #111, #114, #117, #151 e #152 passam para v1.0. + +## A4. Duplicadas, vagas ou fora do milestone + +| Issue | Situação | Proposta | +|---|---|---| +| #81, #83, #90, #94 | Entregues e em `main` (PRs #93, #98, #113 e #119 em `develop`, levados a `main` pelo PR #120). Seguem abertas porque o PR mirou `develop` e não fechou a issue. As partes restantes já têm issue própria (#116, #117, #118, #100, #101). | Conferir o aceite (Task B2) e **fechar**. | +| #100, #101 | P3. A própria #83 recomenda fazer a #100 só se o piloto mostrar aparelhos no teto. | **Mover para v1.0.** | +| #111 | Melhoria de UX (Desejável), depende do pilar B. | **Mover para v1.0** (ver Pendência 4). | +| #117 | Lacuna de segurança, não é regressão; com 2 ou 3 agentes o risco é pequeno. | **Decisão do dono** (Pendência 4). | +| #134 × #148, #135 × #148 | Não são duplicadas, mas o primeiro critério da #134 e o último da #135 são a própria #148. | Manter; registrar na #134 e na #135 que esses critérios fecham com a #148. | +| #124 × #125 × #129 | Sobrepõem texto: o aviso canônico (em #124 e #125) e a palavra "UBS" (em #124 e #129). | Manter; a #129 não toca `legal_documents.dart` (fica com a #124), e a #125 reaproveita o mesmo texto canônico. | +| #144, #145, #146 | Têm um critério só ("registrado"), sem dizer onde registrar. | Vaga, mas aceitável para uma ação. Ao fechar, registrar na tabela de pendências de `spec/escopo_projeto.md`. | + +## A5. Tabela de atribuição proposta (para aprovação) + +Carga em pontos (P=1, M=2, G=3), sem as issues propostas para v1.0 ou para fechamento. + +| Issue | Tipo | Esforço | Prioridade | Responsável sugerido | Justificativa | +|---|---|---|---|---|---| +| #141 | regulamentação | P | Alta | `hbgit` | Regra: regulamentação (LGPD, encarregado). | +| #142 | regulamentação | P | Alta | `hbgit` | Regra: regulamentação (acordo com o PET-Saúde). | +| #143 | regulamentação | G | Alta | `hbgit` | Regra: regulamentação (CEP); pesquisador responsável é o líder do PRISM (P-02). | +| #144 | regulamentação | P | Alta | `hbgit` | Regra: regulamentação (território, entra no TCLE). | +| #145 | regulamentação | P | Alta | `hbgit` | Regra: regulamentação (licença CC BY 4.0, revisores institucionais). | +| #146 | regulamentação | P | Alta | `hbgit` | Regra: regulamentação (parecer jurídico). | +| #147 | regulamentação | M | Alta | `hbgit` | Regra: regulamentação (instrumentos do CEP, operador de dados). | +| #148 | regulamentação/deploy | P | Alta | `hbgit` | Regra: custódia da chave e do repositório. | +| #149 | regulamentação (escopo) | P | Alta | `hbgit` | Regra: decisão de escopo junto ao CEP/PET-Saúde. | +| #124 | regulamentação | P | Alta | `hbgit` | Regra: termos e política de privacidade. | +| #134 | deploy | M | Alta | `hbgit` | Regra: publicação do APK. | +| #135 | deploy | M | Alta | `hbgit` | Regra: deploy/infraestrutura. | +| #136 | funcionalidade/segurança | M | Alta | `hbgit` (mantém) | Já atribuída; Fase 1 entregue no PR #150 pelo próprio dono. | +| #127 | funcionalidade | G | Alta | `vinimartinsufrr` | Maior histórico em `apps/patient`; é a peça que destrava #130 e #131. | +| #132 | funcionalidade/testes | M | Alta | `vinimartinsufrr` | Paridade das 64 combinações no CI; único colaborador com PRs de CI (#26, #27). | +| #151 | correção | M | Alta | `vinimartinsufrr` | Código do `apps/acs`, onde já atuou; segue a solução D2d da #136. | +| #153 | correção | P | Alta | `vinimartinsufrr` | `main.dart` do paciente; correção pequena e urgente, junto da #127. | +| #128 | funcionalidade | G | Alta | `GuilhermeAlmeidadaLuz` | Backend de autenticação + identificador pseudônimo (LGPD); fez cifra e HMAC no PR #53. | +| #133 | funcionalidade/segurança | M | Alta | `GuilhermeAlmeidadaLuz` | Continua a #128 (invalidação da credencial no servidor); sequencial, sem troca de contexto. | +| #131 | funcionalidade/LGPD | M | Alta | `GuilhermeAlmeidadaLuz` | Expurgo e retenção, como a rotina LGPD-RF07 que ele entregou; usa `PatientLocalDatabase.deleteEverything()`. | +| #137 | UI/UX + testes | G | Alta | `sarahw3b` (mantém) | Já atribuída; autora da avaliação WCAG (`spec/ux_accessibility_assessment.md`). | +| #130 | UI/UX | M | Alta | `sarahw3b` | Copy e apresentação das três saídas sem cor clínica: decisão de UX que ela já registra no plano de testes. **Ver Pendência 2.** | +| #114 | testes | P | Média | `sarahw3b` | Teste de interface no emulador (SnackBar sobre o botão); afinidade com o plano de testes de UX. **Ver Pendência 2.** | +| #125 | UI/conteúdo | P | Alta | `Rosialdo` | Texto canônico + tela simples, reaproveitando `LocalProtectionNotice`; boa porta de entrada no código. **Ver Pendência 2.** | +| #126 | funcionalidade/conteúdo | M | Alta | `Rosialdo` | Conteúdo com fontes e licença CC BY 4.0; experiência com produção de conteúdo (`docs/showcase`). **Ver Pendência 2.** | +| #129 | UI/conteúdo | M | Média | `Rosialdo` | Troca de texto nos três apps + testes de widget; tocou os três apps no PR #35. | +| #152 | correção/segurança | P | Média | `Rosialdo` | Espelha arquivos já prontos do paciente (#136); autor da análise de segurança NIST. | +| #81, #83, #90, #94 | — | — | — | `hbgit` (fechar) | Entregues; só o admin confere e fecha. | +| #100, #101, #111 | — | — | Baixa | — (mover para v1.0) | Ver A4. | +| #117 | segurança | M | Média | **Pendência 4** | Se ficar no Pilot: `GuilhermeAlmeidadaLuz` (backend/ACL), depois da #133. | + +**Carga resultante:** `vinimartinsufrr` 8 · `GuilhermeAlmeidadaLuz` 7 · `sarahw3b` 6 · `Rosialdo` 6 · `hbgit` 12 de regulamentação/deploy + #136. + +## A6. Pendências (decidir antes de aprovar) + +1. **Disponibilidade de cada colaborador.** O equilíbrio acima supõe a mesma dedicação semanal para todos. Se alguém tiver menos horas, a carga muda. +2. **Experiência em Flutter de `sarahw3b` e `Rosialdo`.** O histórico dos dois tem só documentação, análise e apresentação. Se não programarem em Flutter, #130 e #114 (Sarah) e #125, #126 e #129 (Rosialdo) passam para `vinimartinsufrr`. Os dois ficariam então com a parte de conteúdo e revisão: textos da #126 e #130 e revisão manual com leitor de tela da #137. +3. **Decisão da #149 (pilar B).** Se for "não", #128, #133, #151, #152 e #114 saem do Pilot. A carga de `GuilhermeAlmeidadaLuz` cai para 2, e ele pode assumir a #132 ou a #130. +4. **#111 e #117:** confirmar se vão para v1.0. A tabela propõe v1.0 para a #111 e deixa a #117 em aberto. +5. **Fechamento de #81, #83, #90 e #94:** confirmar se o dono quer fechá-las agora ou no próximo `develop` → `main`. + +**Aprovação (2026-11-04).** O dono aprovou a Tabela A5 como proposta. Leitura aplicada às pendências: +- Resolvida em 2026-11-04 (1 e 2): a tabela é aplicada como está; a troca para `vinimartinsufrr` fica para quando a disponibilidade ou a experiência em Flutter mostrarem a necessidade. +- Resolvida em 2026-11-04 (3): as issues do pilar B são atribuídas já; se a #149 sair "não", elas mudam de milestone e a atribuição é revista. +- Resolvida em 2026-11-04 (4): #100, #101 e #111 vão para v1.0; a #117 fica no Pilot, sem responsável, até decisão do dono. +- Resolvida em 2026-11-04 (5): #81, #83, #90 e #94 fecham agora, depois da conferência da Task B2. + +--- + +# Parte B: aplicação (somente após a aprovação) + +### Task B1: registrar a aprovação + +**Arquivos:** modificar `docs/superpowers/plans/2026-11-04-distribuicao-issues-pilot.md` (Tabela A5 e Pendências A6). + +- [ ] **Passo 1:** aplicar à Tabela A5 as respostas do dono às Pendências 1 a 5. Cada pendência resolvida vira uma linha `Resolvida em : `. +- [ ] **Passo 2:** commit. + +```bash +git add docs/superpowers/plans/2026-11-04-distribuicao-issues-pilot.md +git commit -m "docs(plano): tabela de atribuição do Pilot aprovada" +``` + +### Task B2: fechar as entregues e mover as adiadas + +- [ ] **Passo 1:** para #81, #83, #90 e #94, ler os critérios (`gh issue view `) e localizar cada um na seção correspondente do `PROGRESS.md`. Critério sem evidência = não fechar; listar. +- [ ] **Passo 2:** fechar as conferidas. + +```bash +for n in 81 83 90 94; do + gh issue close "$n" --repo hbgit/SinalACS --reason completed \ + --comment "Entregue e levado a main pelo PR #120. As partes restantes seguem nas issues próprias (#100, #101, #116, #117, #118)." +done +``` + +- [ ] **Passo 3:** mover as aprovadas para v1.0 (Pendência 4). + +```bash +for n in 100 101 111; do gh issue edit "$n" --repo hbgit/SinalACS --milestone "v1.0"; done +``` + +- [ ] **Passo 4:** conferir. `gh issue list --repo hbgit/SinalACS --milestone Pilot --state open --json number --jq 'length'` deve devolver 35 menos as fechadas e as movidas (28 com a proposta original). + +### Task B3: atribuir + +- [ ] **Passo 1:** rodar as atribuições da Tabela A5 aprovada. Com a proposta original: + +```bash +R=hbgit/SinalACS +for n in 141 142 143 144 145 146 147 148 149 124 134 135; do gh issue edit $n --repo $R --add-assignee hbgit; done +for n in 127 132 151 153; do gh issue edit $n --repo $R --add-assignee vinimartinsufrr; done +for n in 128 133 131; do gh issue edit $n --repo $R --add-assignee GuilhermeAlmeidadaLuz; done +for n in 130 114; do gh issue edit $n --repo $R --add-assignee sarahw3b; done +for n in 125 126 129 152; do gh issue edit $n --repo $R --add-assignee Rosialdo; done +# #136 (hbgit) e #137 (sarahw3b) já estão atribuídas. +``` + +Se a #149 ainda não estiver decidida, pular #128, #133, #151, #152 e #114, a menos que o dono tenha aprovado atribuí-las mesmo assim (Foco de revisão 4). + +- [ ] **Passo 2:** conferir. + +```bash +gh issue list --repo hbgit/SinalACS --milestone Pilot --state open --limit 100 \ + --json number,assignees --jq '.[] | select(.assignees|length==0) | .number' +``` + +Esperado: nenhuma saída, ou só as issues puladas no Passo 1 e as que dependem da Pendência 4 (#117). + +### Task B4: comentar nas issues de deploy e regulamentação + +- [ ] **Passo 1:** comentar em cada uma, sem duplicar. + +```bash +R=hbgit/SinalACS +MSG='Responsável: @hbgit (deploy e regulamentação do piloto ficam com o coordenador do projeto, conforme a distribuição do milestone Pilot em docs/superpowers/plans/2026-11-04-distribuicao-issues-pilot.md).' +for n in 141 142 143 144 145 146 147 148 149 124 134 135; do + gh issue view $n --repo $R --json comments --jq '.comments[].body' | grep -q 'distribuição do milestone Pilot' \ + || gh issue comment $n --repo $R --body "$MSG" +done +``` + +- [ ] **Passo 2:** na #134 e na #135, comentar que o critério de custódia fecha junto com a #148. Na #129, comentar que `legal_documents.dart` fica com a #124 (A4). +- [ ] **Passo 3:** conferir. Em cada uma das 12 issues, o comentário de responsabilidade aparece **uma** vez: + +```bash +for n in 141 142 143 144 145 146 147 148 149 124 134 135; do + echo "$n $(gh issue view $n --repo hbgit/SinalACS --json comments --jq '[.comments[].body|select(contains("distribuição do milestone Pilot"))]|length')" +done +``` + +Esperado: `1` em todas as linhas. + +### Task B5: fechar o plano + +- [ ] **Passo 1:** gerar o retrato final (`gh issue list --milestone Pilot --state open --json number,title,assignees`) e colar no fim deste arquivo, em "Resultado aplicado", com a data. +- [ ] **Passo 2:** commit em branch própria (`docs/distribuicao-pilot`) e PR contra `develop`. + +--- + +## Resultado aplicado (2026-11-04) + +- Fechadas (Task B2): #81, #83, #90, #94, cada uma com comentário que aponta a prova no `PROGRESS.md`. +- Movidas para v1.0: #100, #101, #111. +- Pilot: 28 issues abertas. +- Comentário de responsabilidade do `hbgit` nas 12 issues de deploy e regulamentação (uma vez em cada); notas de dependência na #134, #135 e #129. + +| Issue | Responsável | +|---|---| +| #114 acs_full_e2e.sh: primeiro teste falha no tap em sync_visits coberto por SnackBar (regressão pós-#83) | sarahw3b | +| #117 [P2] ACK com identidade de aparelho: %c na ACL ou deviceId no payload validado contra a microárea do alerta (continuação da #94) | — (Pendência 4) | +| #124 [C-01] Texto legal do app do paciente: controlador, encarregado e aviso educativo | hbgit | +| #125 [C-02] Aviso educativo na primeira abertura e em "Sobre" | Rosialdo | +| #126 [C-03] Biblioteca de conteúdo educativo offline (pilar A) | Rosialdo | +| #127 [C-04] Pedido de contato sem rótulo de urgência e saída "Ligar 192" sem envio | vinimartinsufrr | +| #128 [C-05] Acesso do participante sem CPF, SMS ou e-mail (RF24) | GuilhermeAlmeidadaLuz | +| #129 [C-06] Trocar "UBS" nos textos dos apps por grupo e coordenação do piloto | Rosialdo | +| #130 [C-08] Autoavaliação com três saídas, sem classificação de risco | sarahw3b | +| #131 [C-10] "Apagar meus dados" e retenção local de 30 dias | GuilhermeAlmeidadaLuz | +| #132 [C-11] Autoavaliação local no pilar A, sem sessão nem registro no servidor | vinimartinsufrr | +| #133 [C-12] Recuperação de acesso que invalida a credencial do aparelho anterior | GuilhermeAlmeidadaLuz | +| #134 [RNF07] APK assinado publicado em GitHub Releases | hbgit | +| #135 [RNF07] Compose do piloto: um host, Let's Encrypt e documentação única | hbgit | +| #136 [RNF03] Cifra local dos dados do app do paciente com PIN | hbgit | +| #137 [RNF05] Acessibilidade WCAG AA dos fluxos do piloto no app do paciente | sarahw3b | +| #141 [Ação P-02] Contato com o encarregado de dados da UFRR | hbgit | +| #142 [Ação P-03] Confirmação com a coordenação do PET-Saúde | hbgit | +| #143 [Ação P-04] Submissão na Plataforma Brasil | hbgit | +| #144 [Ação P-05] Definição do território com o PET-Saúde | hbgit | +| #145 [Ação P-07] Lista de temas e revisores do conteúdo educativo | hbgit | +| #146 [Ação P-11] Pedido de parecer à Procuradoria Federal junto à UFRR | hbgit | +| #147 [Ação P-12] Instrumentos dos questionários e serviço de aplicação | hbgit | +| #148 [Ação P-13] Custódia do repositório e da chave de assinatura do APK | hbgit | +| #149 [Ação P-14] Decidir se o pilar B entra no piloto | hbgit | +| #151 [ACS] open_failed ambíguo pode tornar ilegíveis visitas não enviadas | vinimartinsufrr | +| #152 [ACS] Excluir dados da transferência entre aparelhos (dataExtractionRules) | Rosialdo | +| #153 [Paciente] Primeira abertura presa ao diálogo de permissão de notificações | vinimartinsufrr | From 0da67c20ade7426712f6c24f56f4eb9a6b018a03 Mon Sep 17 00:00:00 2001 From: Herbert Rocha Date: Thu, 12 Nov 2026 22:49:34 -0400 Subject: [PATCH 2/3] =?UTF-8?q?docs(plano):=20revis=C3=A3o=20e=20coment?= =?UTF-8?q?=C3=A1rios=20da=20PR=20#155=20(C-02)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plans/2026-11-12-pr-155-comentarios.md | 115 +++++++++ ...26-11-12-pr-155-revisao-aviso-educativo.md | 234 ++++++++++++++++++ 2 files changed, 349 insertions(+) create mode 100644 docs/superpowers/plans/2026-11-12-pr-155-comentarios.md create mode 100644 docs/superpowers/plans/2026-11-12-pr-155-revisao-aviso-educativo.md diff --git a/docs/superpowers/plans/2026-11-12-pr-155-comentarios.md b/docs/superpowers/plans/2026-11-12-pr-155-comentarios.md new file mode 100644 index 00000000..9ef1e9e6 --- /dev/null +++ b/docs/superpowers/plans/2026-11-12-pr-155-comentarios.md @@ -0,0 +1,115 @@ +# PR #155 (C-02, aviso educativo): parecer e comentários a publicar + +Textos da revisão da PR #155 (`feat/c-02-aviso-educativo`, autor `Rosialdo`, base `develop`, commit `eb78c64`). Publicar só depois da aprovação do dono, com `gh pr review` (parecer) e `gh api repos/hbgit/SinalACS/pulls/155/comments` (inlines). Plano: `2026-11-12-pr-155-revisao-aviso-educativo.md`. + +Veredito proposto: **Aprovar com observações** (`gh pr review --approve`). Não há bloqueante. Os dois pedidos são pequenos (texto do `PROGRESS.md` e mensagem do commit) e não precisam de nova rodada. + +--- + +## Parecer + +Revisei a PR contra a issue #125, o escopo (`spec/escopo_projeto.md#aviso-educativo`) e o pedido de reaproveitar o `LocalProtectionNotice`. Os três critérios de aceite estão atendidos e provados por teste: + +| Critério da #125 | Evidência | +|---|---| +| Primeira abertura exibe o aviso curto e só segue após confirmação | `test/educational_notice_test.dart` nos dois apps: "mostra o aviso curto e só segue para o login depois de Entendi" afirma que o login **não** está montado antes do toque e está depois, e que a loja gravou uma vez. | +| "Sobre" exibe o aviso longo, copiado literalmente | Os testes "as duas versões são cópia literal de spec/escopo_projeto.md" leem o escopo e comparam; no ACS, "o texto é o mesmo do app do paciente" compara as duas cópias. | +| Teste de widget para as duas telas nos dois apps | 9 `testWidgets` no paciente e 8 no ACS: primeira abertura, já confirmado, leitura que falha, ida e volta para "Sobre", "Sobre" pelo login (paciente) e pelo menu "Mais", 200 % de fonte nas duas telas. | + +O `LocalProtectionNotice` entra em "Sobre" do paciente pelo mesmo widget de "Lembretes" e "Meus dados", como pedido na issue; no ACS fica de fora por desenho, e concordo. + +**O que rodei em Linux** (Flutter estável, worktree limpo da branch): + +- `flutter test` completo: paciente 347 passam; ACS 826 passam. `test/mqtt_tls_refused_test.dart` passa aqui (7/7), o que confirma que a falha descrita na PR é só do ambiente Windows. +- `flutter analyze` nos dois apps: só o aviso `asset_directory_does_not_exist` de `assets/certs/`, que é o diretório gitignorado que `scripts/dev/sync_dev_ca.sh` cria; não é desta PR. +- `bash scripts/qa/check_documentation_links.sh`: nada novo (o único "ausente" é `graphify-out`, gitignorado, em `AGENTS.md`, já assim em `develop`). +- CI: 9 de 9 verdes, inclusive `android-e2e`. + +**Pontos que conferi no código e aprovo:** + +- Portão no `home` do `MaterialApp`: no ACS, depois de `_WipeHold` (a limpeza remota da #81 não espera o aviso) e antes de `_loginScreen()`; o `AppLockGate` fica no `builder`, acima, e a recriação do gate por `_gateGeneration` não desmonta o `EducationalNoticeGate`, então a confirmação em memória sobrevive. +- Semântica de falha: leitura que falha mostra o aviso; gravação que falha não prende a pessoa (o estado muda antes do `await`). As duas metades têm teste (`_FailingStore`). +- O seam `educationalNoticeStoreFactory` só é atribuído na declaração e nos quatro `flutter_test_config.dart`; o teste "nada em lib/ a troca" prende o lado de produção. `geofence_gps_e2e.dart` é mesmo o único que roda por `flutter drive`. +- Backup Android: `sharedpref` continua excluído de cloud-backup e device-transfer; a confirmação some num aparelho novo, coerente com a #136. +- Acessibilidade: alvos 48×52/48×48, `Semantics(header: true)` nos títulos, só `onSurface`/`onSurfaceVariant` como cor de texto (nenhum fill clínico como texto). +- Duas cópias de `educational_notice.dart` sem pacote comum, travadas por teste: aceito, como `totp.dart`. + +**Pedidos (pequenos, nesta PR):** ver os comentários inline em `PROGRESS.md` e o comentário sobre a mensagem do commit. + +**Sugestões (opcionais):** prender `educationalNoticeVersion` ao texto; link "Sobre" no login do ACS. + +**Registros (só documentam):** o portão de um toque antes da aba de urgência é decisão consciente que vale registrar; a regra do escopo "toda tela inicial" fica para a issue de continuação que abro ao aprovar. + +--- + +## Inline 1 — PROGRESS.md:1936 — pedido + +O `CONTRIBUTING.md` pede para não gravar contagens de testes nos documentos ("elas envelhecem a cada PR"). Sugiro deixar esta linha assim, e manter as contagens só no corpo da PR: + +> - `flutter analyze` limpo e suítes verdes nos dois apps em Windows e em Linux (a diferença do Windows em `test/mqtt_tls_refused_test.dart` é do ambiente: a recusa TLS chega como `NoConnectionException`; a C-02 não toca no MQTT). + +Rodei a suíte do ACS em Linux e `mqtt_tls_refused_test.dart` passa (7/7). + +--- + +## Inline 2 — apps/patient/lib/core/legal/educational_notice.dart:31 — sugestão + +`educationalNoticeVersion` é mantida à mão. O teste do escopo pega um texto divergente, mas não um *bump* esquecido: quem trocar o texto e não a versão deixa quem já confirmou sem ver o texto novo. Uma forma barata de prender as duas, sem mudar a API, é um teste em cada app que falhe quando o texto mudar sem a versão: + +```dart +// `package:crypto` já é dependência dos dois apps. +test('trocar o texto exige trocar a versão', () { + // Atualize os dois valores juntos quando o escopo mudar. + expect(educationalNoticeVersion, '2026-11-01'); + final digest = sha256.convert(utf8.encode(educationalNoticeLong + educationalNoticeShort)).toString(); + expect(digest.substring(0, 12), ''); +}); +``` + +Alternativa: derivar a versão de um hash curto do texto em tempo de compilação. Opcional; pode ficar para depois. + +--- + +## Inline 3 — apps/patient/lib/app/educational_notice_screens.dart:5 — registro + +Só para deixar escrito: a aceitação dos termos foi feita como *prompt*, não portão, para o alerta de emergência nunca esperar. Aqui o portão vem antes de tudo, inclusive da aba de urgência, e acho que está certo: a #125 pede "só segue após confirmação", é um toque, e o texto curto já traz "Emergência: ligue 192". Vale uma frase no bloco do `PROGRESS.md` registrando essa decisão, para quem ler a #153/#137 não a tomar por descuido. + +--- + +## Inline 4 — apps/acs/lib/app/app.dart:1040 — registro + +Conferi a ordem: `_WipeHold` → `EducationalNoticeGate` → `_loginScreen()`, com o `AppLockGate` no `builder`, acima do Navigator. A recriação do gate por `ValueKey(_gateGeneration)` não toca no `home`, então o `State` do portão (e a confirmação em memória) sobrevive a "Entrar com senha". Nada a mudar. + +--- + +## Geral — pedido e sugestão + +**Pedido: mensagem do commit.** O corpo do commit `eb78c64` está truncado ("A confir..."). Antes do merge, um `git commit --amend` com o texto completo (pode ser o resumo da PR) e `push --force-with-lease`; ou, se preferir, faço o merge por *squash* com o corpo da PR como mensagem. + +**Sugestão (opcional): "Sobre" no login do ACS.** O paciente tem o link no login (pilar A, sem sessão); no ACS, "Sobre" só aparece depois do login. A C-02 não exige, mas um `TextButton` igual ao do paciente deixaria o aviso longo alcançável antes de entrar. + +**Registro (UX, sem pedido):** no paciente, a primeira abertura encadeia o diálogo de permissão de notificação (#153) e depois o aviso. Nada quebra; fica como nota para a #137. + +--- + +## Issues de continuação + +### Issue 1 — Aviso curto em toda tela inicial dos apps (RF21, regra do escopo) + +## Objetivo +`spec/escopo_projeto.md#aviso-educativo` diz: "toda tela inicial dos apps, o texto legal e toda página de entrada da documentação exibem uma das duas versões, copiada literalmente". A C-02 (#125, PR #155) cobre a primeira abertura e "Sobre"; a tela de login dos apps do paciente e do agente segue sem o aviso nas aberturas seguintes. + +## Critério de aceite +- [ ] A tela de login do paciente e a do agente mostram `educationalNoticeShort` (rodapé), copiado literalmente da constante já existente em `lib/core/legal/educational_notice.dart`. +- [ ] Teste de widget em cada app: o texto está no login e não estoura a 200 % de fonte. +- [ ] Pilar A: no paciente, visível sem sessão. + +## Referências +IDs: RF21, C-02 (continuação) +Escopo: https://github.com/hbgit/SinalACS/blob/develop/spec/escopo_projeto.md#aviso-educativo +Origem: revisão da PR #155 +Bloqueado por: merge da #155 + +### Issue 2 — (só se o dono pedir) Versão do aviso presa ao texto + +Transformar a sugestão do Inline 2 em pedido: teste em cada app que falha quando `educationalNoticeLong`/`Short` mudam sem `educationalNoticeVersion`. Sem corpo até o dono decidir. diff --git a/docs/superpowers/plans/2026-11-12-pr-155-revisao-aviso-educativo.md b/docs/superpowers/plans/2026-11-12-pr-155-revisao-aviso-educativo.md new file mode 100644 index 00000000..558a827a --- /dev/null +++ b/docs/superpowers/plans/2026-11-12-pr-155-revisao-aviso-educativo.md @@ -0,0 +1,234 @@ +# PR #155 (C-02, aviso educativo) — Plano de Revisão e Comentário + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. + +**Goal:** Revisar a PR #155 (`feat/c-02-aviso-educativo`, autor `Rosialdo`, base `develop`) contra a issue #125 e o escopo, e publicar no GitHub um parecer com comentários inline, depois de o dono aprovar o texto. + +**Architecture:** Três fases: (1) verificação mecânica em Linux (testes, analyze, links, critérios de aceite); (2) leitura guiada do diff com uma lista fechada de pontos a conferir, cada um com arquivo, linha e resultado esperado; (3) redação dos comentários num arquivo de rascunho, checkpoint do dono e publicação com `gh`. Nada é empurrado para a branch do autor: achados viram comentários, não commits. + +**Tech Stack:** `gh` CLI (pr view/diff/review, `gh api` para comentários inline), Flutter 3.x (`flutter test`, `flutter analyze`), `bash scripts/qa/check_documentation_links.sh`, git worktree. + +**Spec:** issue #125 (critérios de aceite), corpo da PR #155, `spec/escopo_projeto.md#aviso-educativo` (texto canônico e regra), `spec/requisitos_piloto.md` linha RF21, `docs/escopo/mudancas-de-codigo-recomendadas.md` linha C-02, comentário do dono na #125 de 2026-11-04 (reaproveitar `LocalProtectionNotice`). + +## Levantamento já feito (não refazer) + +| Fato | Valor | +|---|---| +| Branch | `feat/c-02-aviso-educativo`, 1 commit (`eb78c64`), base = `develop` (`7511255`), 0 atrás | +| CI | 9/9 jobs verdes em 2026-11-08, inclusive `android-e2e`; GitGuardian verde | +| Arquivos | 15 (+1116/−6): 2× `lib/core/legal/educational_notice.dart`, 2× `lib/app/educational_notice_screens.dart`, 2× `app.dart`, 2× `test/educational_notice_test.dart`, 4× `flutter_test_config.dart` (novos), `geofence_gps_e2e.dart`, `android_backup_manifest_test.dart`, `PROGRESS.md` | +| Diff salvo | `/tmp/claude-1000/-home-rock-Documents-Dev-APPs-SinalACS/db87bd4e-f587-42f6-b307-c1e7658bb3fa/scratchpad/pr155.diff` (refazer com `gh pr diff 155` se sumir) | +| Corpo do commit | truncado: "A confir..." seguido de `Closes #125` | +| `PROGRESS.md` | grava contagens de testes (347/347; 824 e 2) — `CONTRIBUTING.md` pede para evitar | +| Coluna "Não" de RF21 em `requisitos_piloto.md` | é "Depende de instituição ou serviço pago?", **não** "entregue" — não pedir mudança nessa linha | +| ACS `_more` | já é `SingleChildScrollView` (`apps/acs/lib/app/app.dart:2683`); o paciente passou a ser nesta PR | +| `AppLockGate` | no `builder`, acima do Navigator (`app.dart:1013-1021`); tranca após 30 s fora mesmo sem sessão (já era assim no login) | +| Backup Android (paciente) | `sharedpref` excluído de cloud-backup e device-transfer; a confirmação some num aparelho novo (coerente) | +| `flutter drive` | só `scripts/qa/acs_gps_e2e.sh` (geofence) ignora `flutter_test_config.dart`; os outros `*_e2e.dart` rodam por `flutter test` | +| Push tap no paciente | não há navegação por toque em notificação (nenhum `navigatorKey`/`onDidReceiveNotificationResponse` em `lib/`) | + +## Global Constraints + +- Idioma dos comentários e do parecer: português, como a PR e a issue. +- Nenhum comentário, commit ou parecer leva atribuição de IA ("Generated with", "Co-Authored-By") — regra do `CLAUDE.md` da raiz. +- Nada é publicado no GitHub antes do checkpoint do dono (Task 6); prática do repositório desde a #136 (`docs/superpowers/plans/2026-11-03-issue-136-comentarios.md`). +- Não fazer push na branch do autor; não fechar a #125 (o `Closes #125` da PR fecha no merge). +- Dado sintético apenas: o CPF `123.456.789-09` dos testes é o mesmo de `patient_app_mvp_test.dart`. +- Texto canônico: qualquer diferença entre `educationalNoticeLong`/`Short` e `spec/escopo_projeto.md` é bloqueante (regra "copiada literalmente, sem paráfrase"). + +## Review Focus + +Condições que o diff implica e que nenhum teste da PR exerce; cada uma vira um item da Task 4 e, se procedente, um comentário na Task 5: + +1. **Texto muda e a versão não.** `educationalNoticeVersion = '2026-11-01'` é mantida à mão; o teste do escopo pega o texto divergente, mas não um bump esquecido. Esperado: ou uma versão derivada do texto, ou um teste que prenda a versão ao conteúdo. (Sugestão, não bloqueio.) +2. **Primeira abertura em emergência.** O portão é a primeira tela antes da aba de urgência; a aceitação dos termos foi feita como *prompt* e não *gate* para "o alerta de emergência nunca esperar". Esperado: decisão consciente — o critério da #125 pede portão; o texto curto traz "ligue 192"; um toque. Registrar a razão no `PROGRESS.md`, não mudar o comportamento. +3. **Regra do escopo "toda tela inicial"**. A PR cobre primeira abertura e "Sobre" e deixa a tela de login sem o aviso curto a cada abertura. Esperado: issue de continuação (rodapé com a versão curta nos dois logins), não bloqueio desta PR. +4. **ACS: `AppLockGate` tranca a tela do aviso** após 30 s fora. Esperado: mesmo regime do login hoje (sem sessão, "Entrar com senha" recria o portão). Conferir que a recriação por `_gateGeneration` não remonta `EducationalNoticeGate` com `_acknowledged` perdido — o portão está no `home`, abaixo do `builder`, então o `State` sobrevive. +5. **Dois cabeçalhos de "primeira abertura" em sequência no paciente** (#153: diálogo de permissão de notificação em `main.dart` antes do `runApp`; depois o aviso). Esperado: nada quebra; registrar como nota de UX para a #137/#153, sem pedido nesta PR. + +--- + +### Task 1: Worktree da branch e verificação mecânica + +**Files:** +- Worktree: `.worktrees/pr-155` (ou o que `superpowers:using-git-worktrees` criar) na branch `feat/c-02-aviso-educativo` +- Saída: `/tmp/claude-1000/-home-rock-Documents-Dev-APPs-SinalACS/db87bd4e-f587-42f6-b307-c1e7658bb3fa/scratchpad/pr155-verificacao.log` + +**Interfaces:** +- Produces: o log de verificação que a Task 5 cita por nome; o worktree que as Tasks 2–4 leem. + +- [ ] **Step 1: Criar o worktree na branch da PR** + +```bash +git fetch origin feat/c-02-aviso-educativo +git worktree add .worktrees/pr-155 origin/feat/c-02-aviso-educativo +``` +Esperado: `HEAD` em `eb78c64`; `git -C .worktrees/pr-155 merge-base --is-ancestor origin/develop HEAD && echo ok` imprime `ok`. + +- [ ] **Step 2: Rodar os testes novos nos dois apps** + +```bash +cd .worktrees/pr-155/apps/patient && flutter pub get >/dev/null && flutter test test/educational_notice_test.dart test/android_backup_manifest_test.dart +cd ../acs && flutter pub get >/dev/null && flutter test test/educational_notice_test.dart +``` +Esperado: `All tests passed!` nos dois. Falha no grupo `texto canônico` = bloqueante. + +- [ ] **Step 3: Rodar `flutter analyze` e as suítes completas (Linux)** + +```bash +cd .worktrees/pr-155/apps/patient && flutter analyze && flutter test 2>&1 | tail -3 +cd ../acs && flutter analyze && flutter test 2>&1 | tail -3 +``` +Esperado: `No issues found!` e `All tests passed!` nos dois — em particular `test/mqtt_tls_refused_test.dart` passa aqui, o que confirma que a falha relatada é só do Windows. Se falhar em Linux, é achado para a Task 5 (a PR não toca MQTT; seria regressão de ambiente a investigar, não bloqueio da PR). + +- [ ] **Step 4: Conferir links da documentação e grep de atribuição** + +```bash +cd .worktrees/pr-155 && bash scripts/qa/check_documentation_links.sh | tail -2 +git log -1 --format=%B | grep -iE 'co-authored|generated with|claude' ; echo "grep exit=$?" +``` +Esperado: nenhum `link local ausente`; `grep exit=1` (nada encontrado). + +- [ ] **Step 5: Guardar o log** + +Redirecionar a saída dos Steps 2–4 para `pr155-verificacao.log` no scratchpad (caminho completo acima). Não commitar nada. + +--- + +### Task 2: Critérios de aceite da #125, um a um + +**Files:** +- Read: `apps/patient/test/educational_notice_test.dart`, `apps/acs/test/educational_notice_test.dart`, `apps/{patient,acs}/lib/core/legal/educational_notice.dart`, `spec/escopo_projeto.md:50-62` + +**Interfaces:** +- Produces: tabela "critério → evidência (arquivo:teste)" que entra no parecer da Task 5. + +- [ ] **Step 1: Critério "primeira abertura exibe o aviso curto e só segue após confirmação"** + +Evidência esperada: teste `mostra o aviso curto e só segue para o login depois de "Entendi"` nos dois apps, com `expect(find.byType(PatientLoginScreen), findsNothing)` antes do toque (paciente) e o equivalente no ACS. Conferir que o ACS também afirma que o login **não** está montado antes do "Entendi" (não só que o aviso está). Se faltar, pedir a asserção. + +- [ ] **Step 2: Critério "Sobre exibe o aviso longo, copiado literalmente"** + +```bash +cd .worktrees/pr-155 && grep -n '^> ' spec/escopo_projeto.md | sed -n 1,2p +grep -n "educationalNoticeLong =\|educationalNoticeShort =" -A 7 apps/patient/lib/core/legal/educational_notice.dart +``` +Esperado: as duas citações do escopo e as duas constantes dizem o mesmo (conferência visual; a prova mecânica são os testes `as duas versões são cópia literal de spec/escopo_projeto.md` nos dois apps e `o texto é o mesmo do app do paciente` no ACS, verdes na Task 1 Step 2). Divergência = bloqueante. + +- [ ] **Step 3: Critério "teste de widget para as duas telas nos dois apps"** + +Contar `testWidgets(` por arquivo: esperado ≥ 8 no paciente e ≥ 7 no ACS, cobrindo primeira abertura, "Sobre" via menu, ida e volta, 200 % de fonte. Anotar qualquer caminho de entrada sem teste: no ACS, o `more_about` do painel é testado (`abre pelo menu "Mais" do painel`); no paciente, `login_about_link` e `more_about` são testados. + +- [ ] **Step 4: Pedido do dono na #125 (reaproveitar `LocalProtectionNotice`)** + +Esperado: `apps/patient/lib/app/educational_notice_screens.dart` monta `const LocalProtectionNotice()` em `AboutScreen` e o teste `mostra o aviso longo literal e reaproveita o aviso da cifra local` procura `Key('local_protection_notice')`. No ACS, ausente de propósito (não há cifra do paciente lá). Marcar como atendido. + +--- + +### Task 3: Testes que a PR mexeu ou contornou + +**Files:** +- Read: `apps/{patient,acs}/test/flutter_test_config.dart`, `apps/{patient,acs}/integration_test/flutter_test_config.dart`, `apps/acs/integration_test/geofence_gps_e2e.dart:59-66`, `apps/patient/test/android_backup_manifest_test.dart:45-60` + +- [ ] **Step 1: Confirmar que o seam global é o único caminho e está guardado** + +```bash +cd .worktrees/pr-155 && grep -rn "educationalNoticeStoreFactory\s*=[^=]" apps/patient/lib apps/acs/lib apps/*/test apps/*/integration_test +``` +Esperado: exatamente 1 atribuição por `lib/` (a declaração) e 1 por cada `flutter_test_config.dart` (4 no total em test/integration_test). O teste `em produção, a loja padrão é a de shared_preferences e nada em lib/ a troca` já prende o lado de `lib/`. + +- [ ] **Step 2: Listar os `integration_test` que sobem `SinalAcsApp` e como rodam** + +```bash +cd .worktrees/pr-155 && grep -ln "SinalAcsApp(" apps/patient/integration_test/*.dart apps/acs/integration_test/*.dart +grep -rn "flutter drive" scripts/qa/*.sh +``` +Esperado: só `geofence_gps_e2e.dart` roda por `flutter drive` e é o único que injeta `educationalNotice:` à mão; os outros 8 passam pelo `flutter_test_config.dart`. Se aparecer outro `flutter drive`, é achado (o e2e pararia no aviso). + +- [ ] **Step 3: Backup Android** + +Esperado: o teste `shared_preferences só é importado pelo tema e pelo aviso educativo` lista os dois arquivos ordenados; a regra `data_extraction_rules.xml` continua excluindo `sharedpref`. Nada a pedir; registrar no parecer que a confirmação não vai para backup (coerente com #136) e que no ACS não há teste equivalente (o manifesto do ACS tem `allowBackup="false"`, `android_manifest_test.dart`) — sem pedido. + +--- + +### Task 4: Leitura guiada do código (lista fechada) + +**Files:** +- Read: `apps/patient/lib/app/educational_notice_screens.dart`, `apps/acs/lib/app/educational_notice_screens.dart`, `apps/{patient,acs}/lib/core/legal/educational_notice.dart`, `apps/patient/lib/app/app.dart:214-222,660-669,3264`, `apps/acs/lib/app/app.dart:566-570,1035-1041,2702`, `PROGRESS.md` (bloco novo) + +Cada item: conferir, anotar "ok" ou o achado com `arquivo:linha` para a Task 5. + +- [ ] **Step 1: Portão e semântica de falha** — `_EducationalNoticeGateState`: `knownAcknowledged` evita o spinner quando a loja já sabe; `isAcknowledged()` com `onError` → `false`; `_confirm()` muda o estado **antes** do `await acknowledge()` e engole a exceção. Esperado: ok (falha de leitura mostra o aviso; falha de gravação não prende). Conferir que `_FailingStore` nos testes exercita os dois lados. + +- [ ] **Step 2: Posição no ACS** — `home: ValueListenableBuilder(... ready ? EducationalNoticeGate(store:, child: _loginScreen()) : _WipeHold())`. Esperado: `_WipeHold` segue antes (limpeza remota #81 não espera o aviso), e `AppLockGate` está no `builder`, acima. Review Focus 4: a recriação do `AppLockGate` por `ValueKey(_gateGeneration)` não toca no `home`, logo o `State` do portão sobrevive. Ok se confirmado. + +- [ ] **Step 3: Versão do texto** (Review Focus 1) — `educationalNoticeVersion` é literal; nenhum teste a prende ao texto. Achado de sugestão: no teste de cada app, `expect(educationalNoticeVersion, '')` ou derivar a versão do texto. Redigir como sugestão opcional. + +- [ ] **Step 4: Acessibilidade e tema** — `FilledButton` 48×52 e `TextButton` 48×48 (WCAG 2.5.5 como no resto dos apps); `Semantics(header: true)` nos títulos; ícone sem rótulo (decorativo, ok); cores só `onSurface`/`onSurfaceVariant` (nenhum fill clínico como texto — regra do `CLAUDE.md`); `fontSize` literal segue o padrão do `app.dart` (13 e 16 ocorrências) — não pedir `textTheme`. Esperado: ok, sem comentário. + +- [ ] **Step 5: Entradas no app** — paciente: `login_about_link` dentro da mesma coluna do link "Política de Privacidade e Termo de Uso" (sem sessão, pilar A) e `more_about` ao fim da folha "Mais", que virou `SingleChildScrollView`; ACS: `more_about` ao fim da folha já rolável. Esperado: ok. Nota: o ACS não tem link "Sobre" no login — aceitável (a C-02 pede "Sobre", não "no login"); mencionar como opcional. + +- [ ] **Step 6: Privacidade da chave** — `aviso_educativo_confirmado` guarda só a string da versão; nome em português como `theme_mode`? (`theme_mode` é inglês.) Esperado: inconsistência cosmética, não pedir. O ACS justifica que o wipe (#81) não precisa apagá-la — concordar no parecer. + +- [ ] **Step 7: `PROGRESS.md` e commit** — (a) o bloco grava contagens de testes e um resultado de Windows: pedir que as contagens saiam (ficam na PR) e que o parágrafo do Windows vire uma linha "rodado também em Linux pela revisão" depois da Task 1; (b) corpo do commit truncado ("A confir..."): pedir amend com a mensagem completa, ou avisar que o merge será *squash* com o corpo da PR. (c) Review Focus 2 e 3: pedir uma frase no bloco registrando a decisão "portão de um toque, com 192 no texto" e a issue de continuação para "toda tela inicial". + +- [ ] **Step 8: Duplicação entre apps** — duas cópias idênticas de `educational_notice.dart` (sem pacote comum, como `totp.dart`), travadas por teste no ACS. Esperado: aceitar; registrar no parecer que um pacote `sinalacs_shared` fica fora desta PR. + +--- + +### Task 5: Redigir o parecer e os comentários + +**Files:** +- Create: `docs/superpowers/plans/2026-11-12-pr-155-comentarios.md` + +**Interfaces:** +- Produces: um arquivo com (a) o corpo do parecer (`## Parecer`), (b) uma seção por comentário inline (`## Inline N — : — `) com o texto exato, (c) a seção `## Issues de continuação` com título e corpo propostos. Tipos: **bloqueante**, **pedido** (muda nesta PR), **sugestão** (opcional), **registro** (só documenta). + +- [ ] **Step 1: Escrever o parecer** — estrutura fixa: resumo (o que a PR entrega contra os 3 critérios da #125, cada um com o teste que o prova); verificação feita pela revisão (Task 1: comandos e resultado, citando o log do scratchpad e que `mqtt_tls_refused_test` passa em Linux); achados por tipo; veredito proposto. Veredito padrão se não houver bloqueante: **Aprovar com observações** (os pedidos do Step 7 da Task 4 são pequenos e não exigem nova rodada de revisão). + +- [ ] **Step 2: Escrever os comentários inline** — um por achado procedente das Tasks 2–4, mínimo esperado: + - `PROGRESS.md` (bloco novo, linha das contagens) — **pedido**: tirar contagens e o detalhe do Windows (`CONTRIBUTING.md`: "Evite gravar contagens de testes nos documentos"). + - `apps/patient/lib/core/legal/educational_notice.dart` (linha de `educationalNoticeVersion`) — **sugestão**: prender a versão ao texto, com o trecho de teste proposto. + - `apps/patient/lib/app/educational_notice_screens.dart` (doc de `EducationalNoticeGate`) — **registro**: portão antes da urgência é decisão consciente; pedir uma frase no `PROGRESS.md`. + - `apps/acs/lib/app/app.dart:1035-1041` — **registro**: ordem `_WipeHold` → aviso → login confirmada; `AppLockGate` acima, `State` sobrevive à recriação do gate. + - Comentário geral (não inline) — **pedido**: commit truncado; **sugestão**: link "Sobre" no login do ACS (opcional); **registro** (Review Focus 5): no paciente, a primeira abertura encadeia o diálogo de permissão de notificação (#153) e o aviso — nada quebra; nota de UX para a #137, sem pedido nesta PR. + +- [ ] **Step 3: Escrever as issues de continuação** — dentro de `## Issues de continuação`, uma subseção `### Issue N — ` por issue, com o corpo pronto para `gh issue create`. (1) "Aviso curto em toda tela inicial (RF21, regra do escopo)": rodapé com `educationalNoticeShort` nos dois logins, teste de widget, pilar A; (2) só se a Task 4 Step 3 virar pedido do dono: "Versão do aviso derivada do texto". Não criar ainda: a criação é o Step 3 da Task 6. + +- [ ] **Step 4: Reler contra as Global Constraints** — português, sem atribuição de IA, sem dado real, nenhum pedido que dependa de unidade de saúde ou serviço pago. Corrigir inline. + +--- + +### Task 6: Checkpoint do dono e publicação + +**Files:** +- Read: `docs/superpowers/plans/2026-11-12-pr-155-comentarios.md` + +- [ ] **Step 1: Checkpoint** — apresentar ao dono o arquivo da Task 5 e o veredito proposto. Esperar aprovação explícita do texto e do veredito (`--approve`, `--comment` ou `--request-changes`). **Parar aqui se o dono não responder.** + +- [ ] **Step 2: Publicar os comentários inline e o parecer** + +```bash +SHA=$(gh pr view 155 --json headRefOid -q .headRefOid) +# um por comentário inline; path e line vêm do arquivo da Task 5 +gh api repos/hbgit/SinalACS/pulls/155/comments -f commit_id="$SHA" -f path="PROGRESS.md" -F line= -f side=RIGHT -f body="$(sed -n '/^## Inline 1/,/^## Inline 2/p' docs/superpowers/plans/2026-11-12-pr-155-comentarios.md | sed '1d;$d')" +# parecer +gh pr review 155 -- --body-file <(sed -n '/^## Parecer/,/^## Inline 1/p' docs/superpowers/plans/2026-11-12-pr-155-comentarios.md | sed '1d;$d') +``` +Esperado: `gh pr view 155 --json reviews,comments -q '.reviews|length'` ≥ 1 e `gh api repos/hbgit/SinalACS/pulls/155/comments -q 'length'` = número de inlines do arquivo. Se um inline falhar por linha fora do diff, trocar por comentário geral com `arquivo:linha` no texto. + +- [ ] **Step 3: Abrir as issues de continuação aprovadas** + +```bash +gh issue create --title "" --body-file <(sed -n '/^### Issue 1/,/^### Issue 2/p' docs/superpowers/plans/2026-11-12-pr-155-comentarios.md | sed '1d;$d') --milestone Pilot --label enhancement +``` +Esperado: número da issue devolvido; colar o número num comentário geral da PR ("continuação: #"). + +- [ ] **Step 4: Commit do rascunho e limpeza** + +```bash +git add docs/superpowers/plans/2026-11-12-pr-155-revisao-aviso-educativo.md docs/superpowers/plans/2026-11-12-pr-155-comentarios.md +git commit -m "docs(plano): revisão e comentários da PR #155 (C-02)" +git worktree remove .worktrees/pr-155 +``` +Esperado: commit na branch de trabalho do dono (hoje `docs/distribuicao-pilot`), sem atribuição de IA; worktree removido. From 9dc4ca5a25fbe04f418998aba097a4f26e1a9ec5 Mon Sep 17 00:00:00 2001 From: Herbert Rocha Date: Fri, 13 Nov 2026 00:09:57 -0400 Subject: [PATCH 3/3] =?UTF-8?q?docs(plano):=20revis=C3=A3o=20e=20coment?= =?UTF-8?q?=C3=A1rios=20das=20PRs=20#156=E2=80=93#163?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plans/2026-11-13-pr-156-comentarios.md | 173 +++++++++ .../plans/2026-11-13-pr-157-comentarios.md | 336 ++++++++++++++++++ .../plans/2026-11-13-pr-158-comentarios.md | 88 +++++ .../plans/2026-11-13-pr-159-comentarios.md | 113 ++++++ .../plans/2026-11-13-pr-160-comentarios.md | 166 +++++++++ .../plans/2026-11-13-pr-161-comentarios.md | 115 ++++++ .../plans/2026-11-13-pr-162-comentarios.md | 52 +++ .../plans/2026-11-13-pr-163-comentarios.md | 176 +++++++++ .../plans/2026-11-13-prs-156-163-revisao.md | 188 ++++++++++ .../plans/2026-11-13-prs-156-163-sintese.md | 146 ++++++++ 10 files changed, 1553 insertions(+) create mode 100644 docs/superpowers/plans/2026-11-13-pr-156-comentarios.md create mode 100644 docs/superpowers/plans/2026-11-13-pr-157-comentarios.md create mode 100644 docs/superpowers/plans/2026-11-13-pr-158-comentarios.md create mode 100644 docs/superpowers/plans/2026-11-13-pr-159-comentarios.md create mode 100644 docs/superpowers/plans/2026-11-13-pr-160-comentarios.md create mode 100644 docs/superpowers/plans/2026-11-13-pr-161-comentarios.md create mode 100644 docs/superpowers/plans/2026-11-13-pr-162-comentarios.md create mode 100644 docs/superpowers/plans/2026-11-13-pr-163-comentarios.md create mode 100644 docs/superpowers/plans/2026-11-13-prs-156-163-revisao.md create mode 100644 docs/superpowers/plans/2026-11-13-prs-156-163-sintese.md diff --git a/docs/superpowers/plans/2026-11-13-pr-156-comentarios.md b/docs/superpowers/plans/2026-11-13-pr-156-comentarios.md new file mode 100644 index 00000000..b2d39d74 --- /dev/null +++ b/docs/superpowers/plans/2026-11-13-pr-156-comentarios.md @@ -0,0 +1,173 @@ +# PR #156 (C-03, biblioteca educativa): parecer e comentários a publicar + +Textos da revisão da PR #156 (`feat/c-03-biblioteca-educativa`, autor `Rosialdo`, base `feat/c-02-aviso-educativo` (#155), commit `4b10e56`). Publicar só depois da aprovação do dono, com `gh pr review` (parecer) e `gh api repos/hbgit/SinalACS/pulls/156/comments` (inlines, um por chamada). Plano: `2026-11-13-prs-156-163-revisao.md`. + +Veredito proposto: **Aprovar com observações** (`gh pr review --approve`). Não há bloqueante. Os três pedidos ao autor são pequenos (duas linhas do `PROGRESS.md` e um teste a 200 % de fonte, que rodei por fora e passa) e não precisam de nova rodada. O conteúdo clínico não é avaliado aqui: as afirmações listadas no comentário geral vão para a revisão dos preceptores (P-07), e os dois temas continuam `rascunho`, com selo na tela. + +--- + +## Parecer + +Revisei a PR contra a issue #126, o escopo (`docs/escopo/mudancas-de-codigo-recomendadas.md`, linha C-03; `spec/escopo_projeto.md`, P-01 e P-07) e o padrão da C-02. Os três primeiros critérios estão atendidos e provados por teste; o quarto fica aberto de propósito, e a PR usa `Refs #126` (o GitHub não lista a #126 como fechada por ela). + +| Critério da #126 | Evidência | +|---|---| +| Conteúdo disponível sem conta e sem rede | `test/educational_library_test.dart` "abre pelo login, sem sessão e sem nenhuma chamada ao backend": sobe o `SinalAcsApp` com um `PatientBackend` que recusa e registra qualquer chamada, abre pelo `login_library_button` e lê o asset real pelo `rootBundle`; nenhuma chamada nova. A tela não recebe o backend (`EducationalLibraryScreen` só tem `source`). O mesmo roteiro está em `integration_test/educational_library_test.dart`. | +| Cada tema cita a fonte (MS ou BVS) | O parser recusa o arquivo inteiro (`EducationalLibraryFormatException`) se um tema não tem fonte, se o órgão não é MS/BVS, se o endereço não é `https` ou está fora dos hosts do órgão; um teste por regra no grupo "parser recusa conteúdo fora da P-07", e "temas.json é válido..." passa o asset real por ele. | +| `LICENCA.md` CC BY 4.0 com atribuição; "Sobre" com MIT e CC BY 4.0 | "a pasta traz a licença CC BY 4.0 com a atribuição" compara a `LICENCA.md` com a mesma constante `contentAttribution` que o app mostra; "\"Sobre\" indica código MIT e conteúdo CC BY 4.0". A `LICENSE` da raiz é MIT, o que bate com `codeLicenseLabel`. | +| Temas e revisores conforme a P-07 | Aberto, como a PR diz. "nenhum tema se declara revisado enquanto a P-07 não define revisores" prende os dois temas em `rascunho`; o selo aparece na lista e no tema; "revisado" sem revisores ou sem data é recusado. | + +**O que rodei em Linux** (worktree limpo da branch, `4b10e56`): + +- `flutter test test/educational_library_test.dart`: 17 passam. +- `flutter test` completo do paciente: todos passam. +- `flutter analyze`: só o aviso `asset_directory_does_not_exist` de `assets/certs/` (diretório gitignorado; não é desta PR). +- `bash scripts/qa/check_documentation_links.sh`: só o `graphify-out` de `AGENTS.md`, que já é assim na base. +- 200 % de fonte: como a PR não traz teste para isso, rodei uma sonda descartável (não commitada) que abre a lista, desce até o rodapé de cada um dos dois temas e até as licenças de "Sobre", em 360×640 e 320×568. Nenhum overflow. +- Não rodei `integration_test/educational_library_test.dart` (sem emulador nesta máquina). Segundo o painel da PR (`gh pr checks 156`, consultado em 2026-11-13), os 9 jobs da CI estão verdes, inclusive `android-e2e`. + +**Pontos que conferi no código e aprovo:** + +- Offline por construção: `AssetEducationalLibrarySource` só chama `rootBundle.loadString`; a lista e o tema não pegam `BackendScope` nem sessão. O botão do login fica antes de qualquer sessão (pilar A, RF22). +- Falha não derruba o app: uma exceção do parser ou da leitura cai no `FutureBuilder` e vira `_LibraryError` ("Não foi possível abrir a biblioteca neste aparelho.", com `liveRegion`) e "Tentar de novo", que lê de novo (teste com `_FailingSource`). O `..ignore()` em `_load()` só cala o erro não tratado; o `FutureBuilder` continua a recebê-lo. +- A lista e o tema mostram `educationalNoticeShort` pela constante da C-02, sem cópia do texto (RF21). +- `pubspec.yaml` registra só a pasta `assets/conteudo_educativo/`. +- Chaves e testes: `login_library_button` (login) e `more_library` (menu "Mais") têm `Key` e teste cada um. +- Conteúdo, no que cabe ao revisor de código: português simples; nenhuma orientação que dispense atendimento ("procure um serviço de saúde", "procure atendimento de urgência na hora"); "ligue 192 (SAMU)" nos dois temas; nenhum "UBS" (D4) nem marca de protocolo (M-05), com teste; fontes `https` em `www.gov.br` e `bvsms.saude.gov.br`, com data de consulta; a `LICENCA.md` diz que os textos são paráfrases com citação e que a CC BY 4.0 não cobre o material original. +- Acessibilidade: só `onSurface`/`onSurfaceVariant`/`outline` como cor (nenhum fill clínico), seções com `Semantics(header: true)`, alvos de 48×52, selo com ícone e texto. +- A mensagem do commit está completa (o "…" na lista da PR é só o corte do título pelo GitHub). Esse pedido da #155 não se repete aqui. + +**Pedidos (pequenos, nesta PR):** tirar as contagens de testes do `PROGRESS.md` (o mesmo pedido da #155); corrigir o nome do campo na instrução de publicação da revisão; um teste a 200 % de fonte nas duas telas, como a C-02 fez. + +**Pedido aos preceptores (P-07, não ao autor):** as afirmações listadas no comentário geral. + +**Sugestões (opcionais):** restringir o caminho das URLs do MS a `/saude/`; validar `consultadoEm` e `revisao.data` como datas; mostrar a data da revisão no mesmo formato da data de consulta. + +**Registros:** o botão no login fica na mesma região que a #161 e a #157 mexem; quem mesclar depois resolve o conflito. + +--- + +## Inline 1 — PROGRESS.md:1952 — pedido + +O mesmo pedido da #155: o `CONTRIBUTING.md` pede para não gravar contagens de testes nos documentos ("elas envelhecem a cada PR"). Esta linha e a linha 1949 ("tem 17 casos") têm contagens. Sugiro: + +> - Rodado em 2026-11-08 no Windows: `flutter analyze` limpo; suíte do paciente verde; `integration_test/educational_library_test.dart` passou no `emulator-5554` (API 37). + +e, na 1949, "`test/educational_library_test.dart` cobre o asset real (...)", sem o número. As contagens podem ficar no corpo da PR. + +--- + +## Inline 2 — PROGRESS.md:1954 — pedido + +O campo está trocado: `revisao` é o objeto, e quem muda é `revisao.situacao`. O corpo da PR já diz certo. Sugiro: + +> Para publicar a revisão, trocar `"situacao": "rascunho"` por `"revisado"` em `revisao`, com `revisores` e `data`, e atualizar o teste "nenhum tema se declara revisado". + +--- + +## Inline 3 — apps/patient/test/educational_library_test.dart:298 — pedido + +Falta um teste a 200 % de fonte para a lista e o tema, como a C-02 fez em `test/educational_notice_test.dart` ("a 200% de fonte, \"Sobre\" não estoura"). Rodei uma sonda por fora em 360×640 e 320×568 e nada estoura, então é só prender isso. Esboço, no padrão da C-02 e com o asset lido do disco para não depender do tempo do `rootBundle`: + +```dart +testWidgets('a 200% de fonte, a lista e os temas não estouram', (tester) async { + tester.view.physicalSize = const Size(360, 640) * 3; + tester.view.devicePixelRatio = 3; + tester.platformDispatcher.textScaleFactorTestValue = 2.0; + addTearDown(tester.view.reset); + addTearDown(tester.platformDispatcher.clearTextScaleFactorTestValue); + final library = parseEducationalLibrary(_assetText('temas.json')); + await tester.pumpWidget(MaterialApp(home: EducationalLibraryScreen(source: _FixedSource(library)))); + await tester.pumpAndSettle(); + final list = find.byType(Scrollable).first; + await tester.scrollUntilVisible(find.byKey(const Key('library_short_notice')), 200, scrollable: list); + for (final topic in library.topics) { + await tester.scrollUntilVisible(find.byKey(Key('library_topic_${topic.id}')), 200, scrollable: list); + await tester.tap(find.byKey(Key('library_topic_${topic.id}'))); + await tester.pumpAndSettle(); + final scroll = find.descendant(of: find.byType(EducationalTopicScreen), matching: find.byType(Scrollable)).first; + await tester.scrollUntilVisible(find.byKey(const Key('library_license')), 300, scrollable: scroll); + await tester.pageBack(); + await tester.pumpAndSettle(); + } + expect(tester.takeException(), isNull); +}); +``` + +Atenção ao detalhe: a 200 % numa tela de 320×568, o `library_short_notice` fica abaixo da área construída pelo `ListView`; um `expect(find.byKey(...), findsOneWidget)` sem rolar falha mesmo sem estouro. + +--- + +## Inline 4 — apps/patient/lib/core/education/educational_library.dart:25 — sugestão + +`www.gov.br` e `gov.br` cobrem todo o governo federal: uma fonte marcada "Ministério da Saúde" com `https://www.gov.br//...` passa no parser. Para a regra da P-07 ficar presa ao órgão, dá para exigir também o prefixo de caminho `/saude/` quando o host é `www.gov.br`/`gov.br` (e um teste com `https://www.gov.br/anvisa/...` recusado). Opcional; com dois temas, quem edita vê. + +--- + +## Inline 5 — apps/patient/lib/core/education/educational_library.dart:186 — sugestão + +`consultadoEm` e `revisao.data` aceitam qualquer texto não vazio; `_dataBr` deixa passar um formato diferente "como veio". Como a data de consulta é parte da citação, dá para recusar o que não for `AAAA-MM-DD` válido (`DateTime.tryParse` mais a regex que `_dataBr` já tem), com um teste. Opcional. + +--- + +## Inline 6 — apps/patient/lib/app/educational_library_screens.dart:144 — sugestão + +A data da revisão aparece em ISO ("Revisado por ... em 2026-12-01."), e a data de consulta logo abaixo em `dd/mm/aaaa` ("Consultado em 08/11/2026."). Passar `topic.review.date` por `_dataBr` deixa as duas iguais; o teste da linha 263 muda junto. + +--- + +## Inline 7 — apps/patient/lib/app/app.dart:661 — registro + +Nota para quem mesclar: este botão entra logo abaixo de "Escanear QR Code do ACS". A #161 acrescenta "Autoavaliação (sem cadastro)" na mesma região e a #157 reescreve a tela de login inteira. Quem mesclar por último precisa manter o `login_library_button` (e o teste que o usa) na tela nova. Nada a mudar nesta PR. + +--- + +## Inline 8 — apps/patient/assets/conteudo_educativo/temas.json:47 — registro + +**Para os preceptores (P-07), não para o autor:** o tema diz "O risco é maior entre outubro e maio." O piloto é em Boa Vista. Pergunta ao preceptor: esse período vale para Roraima? A frase fica como está, ganha uma versão regional ou sai? + +--- + +## Inline 9 — apps/patient/assets/conteudo_educativo/temas.json:61 — registro + +**Para os preceptores (P-07), não para o autor:** A segunda fonte do tema Dengue é um *Dicas em Saúde* da BVS de novembro de 2007. Perguntas ao preceptor: uma página de 2007 serve como fonte deste tema? Alguma afirmação do tema se apoia só nela, e não também na página atual do MS? Se for preciso trocar ou retirar essa fonte, o autor ajusta o `temas.json` depois da resposta. + +--- + +## Geral — pedido aos preceptores (P-07) + +Não avaliei o conteúdo clínico (P-07 dá essa revisão aos preceptores do PET-Saúde). Os dois temas estão `rascunho`, com selo na tela, e as fontes são oficiais. Não afirmo nada sobre a correção dos trechos abaixo; só aponto o que peço ao preceptor confirmar antes de trocar `rascunho` por `revisado`, além das duas perguntas dos inlines 8 e 9: + +- `temas.json:12`: o preceptor confirma que "Ela não passa de uma pessoa para outra pelo contato, nem pela água ou pelos alimentos." é adequado como está escrito? +- `temas.json:19` e `:26`: o preceptor confirma "febre alta, de 39 °C a 40 °C, que começa de repente, junto com pelo menos dois destes sinais" e a lista de sinais de alarme? A lista está completa para o propósito educativo, e a linguagem serve a leigos? +- `temas.json:33`: o preceptor confirma os grupos de "Quem precisa de mais atenção" ("bebês e crianças de até 2 anos", "pessoas com mais de 65 anos")? +- `temas.json:39–40`: o preceptor confirma "O cuidado é repouso e beber bastante líquido" e o aviso sobre AAS e anti-inflamatórios? O texto deve dizer mais sobre o que tomar, ou fica só em "conforme a orientação do profissional de saúde"? +- `temas.json:48`: o preceptor confirma "A vacina contra a dengue foi incorporada ao SUS em dezembro de 2023" e a orientação de perguntar quem pode tomar? +- `temas.json:80`: o preceptor confirma o valor "140/90 mmHg (14 por 9) ou mais"? +- `temas.json:87–88`: depois dos sintomas de "Quando a pressão sobe muito", o texto traz só "Em caso de risco de vida, ligue 192 (SAMU)." O preceptor acha que cabe também "procure atendimento de urgência", como no tema Dengue? +- `temas.json:94`: o preceptor confirma a frequência de medição ("A partir dos 20 anos, meça pelo menos uma vez por ano. Se há casos de pressão alta na família, meça pelo menos duas vezes por ano.")? +- `temas.json:100`: o preceptor confirma a frase sobre remédios gratuitos e o programa Farmácia Popular "com receita dentro da validade"? +- `temas.json:106`: o preceptor confirma a orientação "beba álcool com moderação"? + +Nenhuma dessas é bloqueante para o merge: o texto está marcado como rascunho e a issue continua aberta. Fica como entrada para a issue de continuação abaixo. + +--- + +## Issues de continuação + +### Issue 1 — Revisão dos temas Dengue e Pressão alta pelos preceptores (P-07) + +**Objetivo** +A C-03 (#126, PR #156) entregou a biblioteca de saúde do app do paciente com dois temas em `rascunho` (Dengue e Pressão alta), parafraseados de páginas do Ministério da Saúde e da BVS. Pela P-07, cada versão do conteúdo passa pela revisão dos preceptores do PET-Saúde antes de ser publicada. Esta issue registra a revisão desses dois temas e as afirmações que a revisão de código separou para o preceptor. + +**Critério de aceite** +- [ ] Lista de revisores definida na P-07 (`spec/escopo_projeto.md`). +- [ ] Cada afirmação listada no comentário geral da revisão da PR #156 conferida pelo preceptor (inclusive as perguntas sobre o período "entre outubro e maio" em Roraima e sobre a fonte da BVS de 2007). +- [ ] Temas revisados com `"situacao": "revisado"`, `revisores` e `data` em `apps/patient/assets/conteudo_educativo/temas.json`, e o teste "nenhum tema se declara revisado" atualizado. +- [ ] Nenhuma versão do app com tema em `rascunho` chega a participantes do piloto sem decisão registrada do dono. + +**Referências** +IDs: C-03, RF20, P-07 +Escopo: https://github.com/hbgit/SinalACS/blob/develop/spec/escopo_projeto.md +Origem: revisão da PR #156 +Bloqueado por: P-07 (lista de temas e revisores) diff --git a/docs/superpowers/plans/2026-11-13-pr-157-comentarios.md b/docs/superpowers/plans/2026-11-13-pr-157-comentarios.md new file mode 100644 index 00000000..66d8af85 --- /dev/null +++ b/docs/superpowers/plans/2026-11-13-pr-157-comentarios.md @@ -0,0 +1,336 @@ +# PR #157 (C-05, convite QR + PIN): parecer e comentários a publicar + +Textos da revisão da PR #157 (`feat/issue-128-login-convite-pin`, base `develop`, commit `bfa5815`). A revisão teve duas partes, servidor (backend, migração, scripts e docs) e app do paciente (PIN e criptografia), fundidas aqui. Publicar só depois da aprovação do dono, com `gh pr review` (parecer) e `gh api repos/hbgit/SinalACS/pulls/157/comments` (inlines, um por chamada). Plano: `2026-11-13-prs-156-163-revisao.md`; síntese: `2026-11-13-prs-156-163-sintese.md`. + +Veredito proposto: **Pedir mudanças (bloqueante)** (`gh pr review --request-changes`). Um bloqueante, no servidor: a exclusão atendida pela LGPD (#42) não revoga a credencial nova de dispositivo, e o aparelho do titular anonimizado continua entrando (Inline 1). Os demais pedidos são pequenos, mas dois deles, no app, são defeitos reais: a tela de criação do PIN fica presa se a gravação no Keystore falhar (provado com teste) e o PIN digitado entra no `toString` de uma exceção, o que a D3 da #136 proíbe. A PR não toca a triagem (INV-02) nem o caminho do pedido enviado (INV-03). Corrigido o bloqueante e atendidos os pedidos, o parecer passa a **Aprovar com observações**. + +--- + +## Parecer + +Revisei a issue #128 (RF24/C-05) dos dois lados: o servidor (a migração `20261109144551146`, os scripts de e2e e a documentação) e o app do paciente, este contra a decisão D3 do plano da #136 (`docs/superpowers/plans/2026-11-03-issue-136-cifra-local-paciente.md`) e contra o que as PRs abertas do paciente acrescentam na mesma tela. A migração está limpa, as duas suítes passam inteiras e o desenho da credencial e do envelope é bom. O problema principal está na fronteira com a #42. + +**Critérios da #128, lado servidor:** + +| Critério | Evidência | +|---|---| +| Credencial criada na mesma transação do consumo do convite; convite de uso único | `OnboardingEndpoint.completeEnrollment` abre a transação e passa a mesma `Transaction` às duas stores (`alert_runtime.dart`, `onboardingServiceFor`); em `onboarding_endpoint_test.dart`, "segundo uso do mesmo token falha com EnrollmentException" e o teste de corrida ("duas chamadas concorrentes com o mesmo token…", linha 490) conferem uma credencial só; `device_credential_login_test.dart` "deviceId fora do formato UUID não consome o convite". | +| `loginDevice` emite JWT de 1 h com `device_id` e recusa credencial inexistente ou errada | `device_credential_login_test.dart` "convite concluído cria a credencial e auth.loginDevice devolve a sessão" (`tokenLifetime == patientSessionLifetime`, `user.deviceId`) e "segredo errado, aparelho desconhecido e deviceId malformado recebem a MESMA recusa". **A credencial revogada não tem teste** (nenhum código grava `revokedAt`). | +| Backend sobe no perfil do piloto sem `SMS_GATEWAY`; `requestOtp` recusa | `device_credential_login_test.dart` "o backend sobe sem SMS_GATEWAY…" (`AppConfig.fromMap` com `APP_ENV=production` e sem a variável, `health.check` ok, `requestOtp` → `EndpointDisabledException`); `app_config_test.dart`, grupo `SMS_GATEWAY`. **`verifyOtp` sem gateway dá `StateError` (500)**, ver Inline 2. | +| `users.cpfHash` anulável (P-10) sem quebrar o `cpf-hash-seed` | `migration.sql`: só `DROP NOT NULL`; `seed_cpf_hashes.dart` só escreve a coluna, não depende de ela ser obrigatória; o seed do teste grava `cpfHash: null` e a conclusão do convite passa. | +| RF09/RF10 fora | Nenhum campo de endereço ou ponto de referência entrou no modelo, na migração nem nos endpoints. | + +**Critérios da #128, lado app:** + +| Critério | Evidência | +|---|---| +| Nenhum campo de CPF, telefone ou e-mail no login | `test/device_login_test.dart:28` afirma `cpf_field`, `birth_date_field` e `otp_code_field` ausentes e nenhum texto com "CPF", "e-mail" ou "telefone"; `lib/app/app.dart` não tem mais `_CpfInputFormatter`, `requestOtp` nem `verifyOtp`. | +| Credencial no aparelho protegida pelo PIN e vinculada ao identificador pseudônimo | `lib/core/security/device_credential_store.dart:113-133` (envelope do PIN no `flutter_secure_storage`), `lib/app/app.dart:1077-1088` (envelope gravado antes de `completeEnrollment`, que leva `deviceId` + segredo ao servidor). Testes: `test/device_credential_store_test.dart:23`, `test/onboarding_flow_test.dart:166` e `:248`. | +| Sessão expirada leva à tela de PIN, não ao login completo | `test/device_login_test.dart:181` ("oferece 'Entrar novamente' e volta para a tela do PIN"); texto em `lib/app/app.dart` (`session_expired_notice`) e em `BackendClient._requireToken`. | + +**O que rodei** (Linux, worktree limpo em `bfa5815`): + +- Migração contra o append-only da #82: `grep` de `audit_logs|audit_exports|audit_chain_checkpoints` em `migration.json` não acha nada. `definition.sql` traz o bloco do trigger e do `REVOKE` (5 linhas; a migração anterior também tem 5, e o bloco é idêntico byte a byte). Fora os comentários, o `diff` contra `20261028025257928/definition.sql` mostra só a tabela nova, os dois índices, `cpfHash` anulável, a FK e a versão. `migration.sql` não toca em auditoria. +- `dart analyze` em `backend/`: 103 issues contra 98 em `develop`. Os 5 novos são `prefer_initializing_formals`, o mesmo lint de 96 dos 98 existentes. +- `docker compose --profile test up -d postgres-test` e `dart test -j 1` no backend: **`+1669: All tests passed!`**. +- `python3 scripts/qa/otp_relay_test.py`: `OK`. Com `-I` o import falha também em `develop`, porque `-I` tira o diretório do script do `sys.path`; não é da PR. `bash scripts/qa/lib_rele_test.sh`: `ok: lib_rele`. `bash scripts/qa/mqtt_resiliencia_e2e_test.sh`: `ok`. +- `bash scripts/qa/check_documentation_links.sh`: só o `graphify-out` de `AGENTS.md`, que já falta em `develop`. +- App do paciente (Flutter 3.44.8, o mesmo da CI): `flutter analyze` só com o aviso `asset_directory_does_not_exist` de `assets/certs/`, o diretório gitignorado; `flutter test` completo: 355 passam. Testes novos um a um: `pin_envelope_test` 7, `pin_policy_test` 8, `device_credential_store_test` 5, `device_login_test` 9, `onboarding_flow_test` 21; `android_backup_manifest_test` 8. Todos verdes. +- Bancada do Argon2id com os parâmetros da D3 (m = 19 MiB, t = 2, p = 1) num desktop x86_64: 84 a 157 ms em JIT e 69 a 85 ms em AOT por derivação. +- Sondas descartáveis, apagadas depois e sem registro no log: (1) `auth.verifyOtp` no perfil do piloto lança `StateError: SMS_GATEWAY ausente…`; (2) depois de `OrmDataSubjectCaseStore.decide(… anonymize: true)`, `DeviceCredentialService.login` com a credencial do titular devolveu login concedido. A prova do bloqueante não depende da sonda: é a leitura de `_anonimizar` em `orm_data_subject_case_store.dart:309-424`, que não toca `patient_device_credentials` (nenhuma referência a `PatientDeviceCredential` no arquivo). +- Teste temporário, apagado depois, com o `failEnroll` que o duplo já oferece: ver Inline 11. + +**Testes removidos ou encolhidos** (deleções maiores que adições, pelo `--stat` do diff): `test/passwordless_login_test.dart` (−230, apagado: a tela de OTP saiu e os 2 testes de sessão expirada passam para `device_login_test.dart`); `test/e2e_login_test.dart` (+48/−60); `test/support/e2e_login_core.dart` (+20/−78), `test/support/fake_patient_backend.dart` (+33/−49) e `integration_test/support/e2e_login.dart` (+5/−7), que são suporte. `backend_client_otp_test.dart` foi renomeado para `backend_client_device_login_test.dart`. Nenhum outro arquivo de teste tem mais deleções que adições. As remoções fazem sentido, mas o corpo da PR não as explica (ver Geral). + +**Lista fechada da criptografia (D3 da #136):** + +| Item | Onde | +|---|---| +| Argon2id com parâmetros nomeados (memória, iterações, paralelismo) | `lib/core/security/pin_envelope.dart:36-41` (`memory: 19456`, `iterations: 2`, `parallelism: 1`, `hashLength: 32`), iguais à D3. | +| Salt aleatório de 16 B ou mais | `pin_envelope.dart:57`: 16 B de `Random.secure()` (`:31`, `:134-135`), sorteado **por envelope**, não só por aparelho, o que é mais forte. Teste: `test/pin_envelope_test.dart:32`. | +| AES-GCM com nonce aleatório de 12 B por cifra, nunca reutilizado para a mesma chave | `pin_envelope.dart:62-68` (`AesGcm.with256bits()`, nonce de 12 B). Cada envelope deriva uma chave nova (salt novo), então cada chave cifra uma vez só e o nonce não se repete. Teste: `pin_envelope_test.dart:32`. | +| Segredo cifrado e salt no `flutter_secure_storage`, nunca em `shared_preferences` | `lib/core/security/device_credential_store.dart:86-92` (`encryptedSharedPreferences: true`, Keychain `first_unlock_this_device`) e `:123-131`; o salt vai dentro do envelope (`pin_envelope.dart:69-75`). `shared_preferences` continua só em `lib/core/services/theme_controller.dart`. | +| PIN nunca gravado nem logado | Não é gravado: `device_credential_store.dart:122-131` grava só o envelope, e o teste `device_credential_store_test.dart:35-40` confere o registro cru. Nenhum `print`/`debugPrint`/`log` em `lib/core/security` nem nas telas novas. **Mas** `pin_envelope.dart:54` e `device_credential_store.dart:120` põem o PIN no `toString` de `ArgumentError.value` (Inline 10). | +| PIN de 6+ dígitos com as proibições da D3 (repetido, sequência, alternância), com teste | `lib/core/security/pin_policy.dart:23-41`; teste `test/pin_policy_test.dart` (8 casos, incluindo os que **não** devem ser barrados, como `112233`). Defesa em profundidade na cifra: `pin_envelope.dart:52-55`. | +| Bloqueio 5 tentativas → 30 s dobrando até 15 min, no aparelho | Limiar: `device_credential_store.dart:64` e `:179`. Prazo: `:70-75`. **Contador:** persistido no `flutter_secure_storage` (`_attemptsKey`, `:97`, gravado em `:185-191`), então sobrevive a reiniciar o app; não fica só em RAM. **Teto:** 30 × 2⁵ = 960 s = **16 min**, não 15 (Inline 9). Sem teste da progressão. | +| `cryptography` é a única dependência nova e está em `spec/stack.md` | É a única direta nova (`pubspec.yaml:25`; resolve para 2.9.0). `spec/stack.md:85` a cita, mas só para o backend (`health_data_cipher.dart`); o uso no app não está registrado (Inline 17). | + +**Pontos que conferi no código e aprovo:** + +*Servidor:* + +- O servidor guarda só `SHA-256("sinalacs-pdc-v1:" + segredo)`. Um vazamento do banco não permite login, desde que o segredo tenha os 256 bits que o app sorteia (o app gera 32 bytes de `Random.secure()` em base64url). Hash rápido é aceitável nessa condição, o mesmo parecer do `tokenHash` do convite. A comparação é em tempo constante. +- Recusa uniforme: segredo errado, aparelho desconhecido e credencial revogada recebem a mesma `DeviceCredentialException` com a mesma mensagem, e o `deviceId` malformado é recusado com ela antes do banco. +- A microárea do JWT é relida de `users` no login (`JOIN`), nunca vem de parâmetro (INV-01). O `LIMIT 2` funciona como asserção barata do índice único. +- `touchLastUsed` não ressuscita credencial revogada. +- Trilha: `granted`, `denied_credential` (só com titular conhecido) e `denied_no_territory` entram em `audit_logs` por `recordSafely`. O `deviceId` desconhecido não gera linha, porque não há titular a quem atribuí-la; concordo. +- `loginDevice` está na allowlist de `endpoint_auth_posture_test.dart` com justificativa. +- `openssl_device_ca.dart`: o `return await` dentro do `try` corrige uma corrida real com o `finally` que apaga o diretório temporário. Boa correção de passagem. +- Seed de e2e: 6 convites por paciente, só o sha256 no banco, o texto claro só no manifesto 0600, e a recusa a rodar fora de `sinalacs_e2e` continua. +- `backend/CLAUDE.md` descreve `loginDevice`, a criação na mesma transação e o `SMS_GATEWAY` opcional. `.env.example`, `spec/stack.md`, `AGENTS.md`, `inventario-vinculo-institucional.md` (I-31) e `mudancas-de-codigo-recomendadas.md` foram atualizados. +- `spec/lgpd_data_audit.md` classifica as 7 colunas de `patient_device_credentials`. +- `spec/requisitos_piloto.md` já traz RF01 como Futuro e RF24 como Essencial em `develop`, então a PR não precisa mexer nele. + +*App:* + +- Ordem "envelope local primeiro, servidor depois, desfaz o envelope se o servidor recusar" (`app.dart:1077-1094`): nunca fica credencial local para um convite não consumido. O caso "o servidor gravou e a resposta se perdeu" cai na recuperação por convite novo, sem perda de dado. +- Recusa local de PIN fraco **antes** de gastar o convite (`app.dart:1054-1065`), provada no `full_journey_test.dart` contra o backend real e em `onboarding_flow_test.dart:191`. +- Erro de derivação e envelope corrompido produzem a mesma `WrongPinException` (`pin_envelope.dart:85-121`), com teste. +- O bloqueio é consultado antes de verificar o PIN, e o PIN certo não o fura (`device_credential_store_test.dart:56`). +- Falha de rede no login **não** descarta a credencial (`device_login_test.dart:135`). +- QR: `QrScannerScope` e `parseEnrollmentQr` seguem iguais (`app.dart:771` e `:781`); o formato do convite não muda e `apps/acs` não é tocado. +- O aceite do termo continua obrigatório no cadastro (`app.dart:806`, antes de abrir `PinSetupScreen`), e a checagem pós-login (`_needsTerms`) segue como convite ao aceite, não como portão. +- `PatientLocalDatabase` e `LocalProtectionNotice` (#136) não têm nenhuma linha alterada. +- `android_backup_manifest_test.dart` não é tocado e passa (8/8). O envelope mora em `sharedpref`, que as regras de backup da #136 já excluem da nuvem e da transferência entre aparelhos. +- Acessibilidade: alvos 48×52 e 48×48, `liveRegion` no aviso de bloqueio e no erro do PIN, `dangerOnSurface` no erro sobre `Card`. + +**Bloqueante:** a exclusão atendida (#42) não revoga nem apaga a credencial de dispositivo (Inline 1). + +**Pedidos (nesta PR):** + +- Servidor: `verifyOtp` sem gateway (Inline 2); validar o formato do `deviceSecret` no servidor (Inline 3); `acs_telemetria_e2e.sh` quebrado pela remoção de `/code` (Inline 4); textos que descrevem a C-12 como existente (Inlines 5 e 6); comentário velho do `.env.example` (Inline 7); `PROGRESS.md` (Inline 8). +- App: teto de 16 min sem teste (Inline 9); PIN no `toString` da exceção (Inline 10); tela presa quando o `enroll` lança (Inline 11); credencial apagada por recusa que não é de credencial (Inline 12); links da tela de login só num dos dois estados, que também define onde #155, #156 e #161 entram (Inline 13). +- Rebase sobre as PRs do paciente que entram antes desta (Geral). + +**Sugestões (opcionais):** teste da credencial revogada (coberto pelo teste do Inline 1); leitura do Keystore e bloqueio na abertura da tela (Inline 14); Argon2id na thread da UI (Inline 15); lockfile e `spec/stack.md` (Inline 17); auditar a emissão da credencial (Issue 1). + +**Registros:** bloqueio medido pelo relógio de parede (Inline 16). O critério "backend sobe sem `SMS_GATEWAY`" é provado por `AppConfig.fromMap` com `overrideConfig` e `health.check` no harness, e não por um boot de processo; é suficiente, porque `fromEnvironment` passa pelo mesmo `fromMap`. A C-12 ficou fora, e o modelo a comporta (`revokedAt` e o índice por `patientId`). O `deviceId` desconhecido responde sem calcular hash (tempo menor); não é oráculo útil, porque o `deviceId` é um UUID aleatório. A contagem de tabelas de domínio no `definition.sql` foi de 29 para 30 (`CREATE TABLE` sem prefixo `serverpod_`); o `CLAUDE.md` da raiz ainda diz 27, número que já estava defasado antes desta PR. + +--- + +## Inline 1 — backend/sinalacs_server/lib/src/application/auth/device_credential_service.dart:106 — bloqueante + +Esta guarda só olha `revokedAt`, e hoje nenhum caminho grava essa coluna. Em particular, a exclusão atendida da #42 (`OrmDataSubjectCaseStore._anonimizar`, `orm_data_subject_case_store.dart:309-424`) apaga `user_credentials`, `otp_challenges` e `push_tokens`, mas não toca em `patient_device_credentials`. Logo, depois de `decide(…, anonymize: true)`, a credencial do titular continua válida e o `login` devolve a sessão com o id e a microárea do titular removido (conferi também numa sonda descartável contra o Postgres de teste). O JWT emitido permite abrir "Meus Dados" e criar alerta depois de a exclusão ter sido dada como atendida, o que contradiz o próprio contrato de `_anonimizar` ("some … o que liga aparelho/login a ele"). + +Peço, nesta PR, na mesma transação da anonimização: `UPDATE patient_device_credentials SET "revokedAt" = now() WHERE "patientId" = @id AND "revokedAt" IS NULL` (ou `deleteWhere`, que bate com o que já se faz com `user_credentials`). Peço também um caso em `data_subject_case_store_test.dart`: depois de `excluir(_pedA1)`, `DeviceCredentialService.login` recusa com a mensagem única. O mesmo teste cobre o ramo de `revokedAt` que hoje está sem prova. + +--- + +## Inline 2 — backend/sinalacs_server/lib/src/runtime/alert_runtime.dart:767 — pedido + +"Inalcançável" vale para `requestOtp`, mas não para `verifyOtp`: ele constrói o `PasswordlessAuthService` direto, sem a guarda. No perfil do piloto, `auth.verifyOtp(cpf: …, code: …)` cai aqui e sai `StateError: SMS_GATEWAY ausente…`, um erro interno (500), em vez da recusa explícita (visto numa sonda descartável). Peço a mesma guarda de `requestOtp` no começo de `verifyOtp` (`EndpointDisabledException`) e um caso a mais no grupo "perfil do piloto" de `device_credential_login_test.dart`. + +--- + +## Inline 3 — backend/sinalacs_server/lib/src/endpoints/onboarding_endpoint.dart:53 — pedido + +O SHA-256 rápido de `credentialHash` só é seguro porque o segredo tem 256 bits, e quem garante isso hoje é o app. O servidor aceita qualquer `deviceSecret`, inclusive `"1"` ou uma string vazia. Um cliente com defeito, ou um cliente alternativo, gravaria uma credencial que um vazamento do banco quebraria por força bruta em segundos. Peço validar o formato no servidor, antes de consumir o convite e com a mesma recusa do `deviceId`: base64url sem padding com exatamente 43 caracteres, que é o que `generateDeviceSecret` produz. Em `auth.loginDevice` a mesma checagem pode devolver a `DeviceCredentialException` única. Basta um teste por endpoint. + +--- + +## Inline 4 — scripts/qa/acs_telemetria_e2e.sh:12 — pedido + +O relé perdeu `/code` nesta PR, mas `apps/acs/integration_test/telemetry_e2e.dart:144` (`_dispararAlerta`) ainda faz `requestOtp` + `_rele('/code', …)` + `verifyOtp` para o paciente `telemetry` disparar o alerta. Com o relé novo esse pedido recebe 404 quarenta vezes, e o teste para em "o relé não devolveu o código do OTP". O script não roda na CI, por isso o `android-e2e` verde não pegou a quebra. Peço trocar o login do paciente nesse teste por um convite do manifesto (`inviteTokens`) com `completeEnrollment`, como fizeram `mqtt_resiliencia_e2e.sh` e o `live_check.dart`, e acertar o comentário desta linha. + +--- + +## Inline 5 — backend/sinalacs_server/lib/src/models/patient_device_credential.spy.yaml:12 — pedido + +O texto está no presente ("um convite novo vinculado ao mesmo paciente **revoga** as credenciais anteriores"), mas isso é a C-12 (#133) e não existe no código: nada grava `revokedAt`. Quem ler o modelo vai supor que a reemissão já invalida o aparelho antigo. Peço o futuro, como o próprio campo `revokedAt` já diz mais abaixo ("Preenchido pela C-12"). Algo como: "`revokedAt` é a invalidação que a C-12 (#133) vai preencher; hoje nenhum caminho a grava — ver a anonimização da #42". + +--- + +## Inline 6 — spec/lgpd_data_audit.md:47 — pedido + +Vale o mesmo do Inline 5: "A reemissão de convite para o mesmo identificador revoga as credenciais anteriores (C-12)" descreve como entregue algo que não está. Peço "revogará (C-12, #133; ainda não implementado)". Se a correção do Inline 1 entrar, vale acrescentar que a exclusão atendida (#42) revoga a credencial. A linha da `patients`/`users` em §1 também deveria citar `patient_device_credentials` entre o que a anonimização apaga ou revoga. + +--- + +## Inline 7 — .env.example:213 — pedido + +As linhas 212–215 ("Limite atual: fora de development o servidor ainda exige este campo para subir…; retirar essa exigência é a mudança C-05") ficaram, e o bloco novo logo abaixo diz o contrário. Peço trocar as quatro linhas por uma só: "Não usado no piloto (P-10 em spec/escopo_projeto.md: sem CPF e sem SMS)." + +--- + +## Inline 8 — PROGRESS.md:1929 — pedido + +"Nada commitado ainda (o usuário faz o commit manual)" descreve o estado da máquina do autor antes do commit. Peço "**Estado:** entregue na PR #157." Na linha 1955, o `CONTRIBUTING.md` pede para não gravar contagens de testes nos documentos, porque elas envelhecem a cada PR (aqui já são 1669, não 1667). Basta "suíte completa `dart test` verde". + +--- + +## Inline 9 — apps/patient/lib/core/security/device_credential_store.dart:73 — pedido + +O corpo da PR e o comentário acima dizem "30 s dobrando até 15 min", mas `extra.clamp(0, 5)` dá 30 × 2⁵ = 960 s, ou seja, **16 min** de teto. Não é uma falha de segurança: 16 min deixa o bloqueio um pouco mais rígido, não mais fraco. O pedido é pela divergência entre o que a D3 e a PR dizem e o que o código faz, e pela falta de um teste da progressão, que é o que deixaria passar essa diferença. Sugiro limitar pelo prazo, e não pelo expoente, e prender a progressão num teste (ou, se preferir 16 min, corrigir o texto e prender esse valor): + +```dart +static Duration lockDuration(int failures) { + final extra = failures - maxAttempts; + if (extra < 0) return Duration.zero; + final seconds = 30 * (1 << extra.clamp(0, 5)); + return Duration(seconds: seconds > 900 ? 900 : seconds); +} +``` + +```dart +test('5ª falha: 30 s, dobrando até 15 min', () { + expect(DeviceCredentialStore.lockDuration(4), Duration.zero); + expect(DeviceCredentialStore.lockDuration(5), const Duration(seconds: 30)); + expect(DeviceCredentialStore.lockDuration(9), const Duration(minutes: 8)); + expect(DeviceCredentialStore.lockDuration(10), const Duration(minutes: 15)); + expect(DeviceCredentialStore.lockDuration(50), const Duration(minutes: 15)); +}); +``` + +--- + +## Inline 10 — apps/patient/lib/core/security/pin_envelope.dart:54 — pedido + +`ArgumentError.value(pin, 'pin', weakness)` guarda o PIN na exceção, e o `toString` dela sai como `Invalid argument (pin): : "123456"`. A D3 da #136 diz: "A chave, o PIN, a KEK e o salt nunca aparecem em log, em `toString` de exceção". O mesmo vale para `device_credential_store.dart:120`. + +Hoje a tela valida antes, então essa exceção só sobe se a validação da tela e a de `enroll` divergirem (uma mudança futura na política, por exemplo). Mas o caminho até um log é concreto: a exceção sobe por `_concluir`, que não tem `catch` para ela (Inline 11), e o Android grava no logcat as exceções Dart não tratadas, também em build release. Basta não passar o valor: + +```dart +throw ArgumentError(weakness, 'pin'); +``` + +E um caso no teste de quem lança (`pin_envelope_test.dart` e `device_credential_store_test.dart`), como `expect(() => …, throwsA(predicate((e) => !e.toString().contains('123456'))))`. + +--- + +## Inline 11 — apps/patient/lib/app/app.dart:1121 — pedido + +`_concluir` só captura `BackendFailure`. Se `store.enroll` lançar (uma `PlatformException` do Keystore ou do EncryptedSharedPreferences, o caso transitório que a D2 da #136 descreve; ou o `ArgumentError` do Inline 10), ou se `completeEnrollment` lançar algo que não seja `BackendFailure`, a exceção escapa. Então `_busy` fica `true`, o botão "Concluir cadastro" fica desabilitado com o indicador girando e nenhuma mensagem aparece. A pessoa fica presa na tela, e a exceção vai para o log do sistema. + +Provei com um teste temporário que usa o `failEnroll` que `FakeDeviceCredentialStore` já tem (nenhum teste o usa): `StateError` não tratado, `pin_setup_confirm_button` com `onPressed == null` e `pin_setup_error` ausente. Sugestão, com uma mensagem neutra, que vale tanto para a falha local quanto para a do servidor, e sem interpolar a exceção: + +```dart + } on BackendFailure catch (failure) { + if (!mounted) return; + setState(() { + _busy = false; + _error = failure.message; + }); + } catch (_) { + if (!mounted) return; + setState(() { + _busy = false; + _error = 'Não foi possível concluir o cadastro agora. Tente de novo.'; + }); + } +``` + +Acrescente um teste em `onboarding_flow_test.dart` com `failEnroll = true`: a mensagem aparece, o botão volta e `completeEnrollment` **não** é chamado (o convite continua utilizável). O mesmo cuidado vale para `_entrarComPin` (`:441`): `unlock` pode lançar algo além de `WrongPinException` se a gravação do contador falhar. + +--- + +## Inline 12 — apps/patient/lib/app/app.dart:475 — pedido + +`credentialRefused` apaga a credencial local em **qualquer** `DeviceCredentialException`. No servidor, porém, essa mesma exceção também sai para "Este acesso não está vinculado a uma microárea" (`backend/sinalacs_server/lib/src/application/auth/device_credential_service.dart:133`, `denied_no_territory`). Esse é um estado administrativo do paciente, não uma credencial inválida, e pode ser transitório (troca de microárea, por exemplo). Do jeito que está, o aparelho perde a credencial e a pessoa precisa de um convite novo, que pela C-12 revoga a anterior. Proposta: o servidor distingue os dois casos (um campo na exceção ou uma exceção própria para o território), e o app só destrói a credencial na recusa de credencial. Acrescente um teste de widget para cada lado. + +--- + +## Inline 13 — apps/patient/lib/app/app.dart:660 — pedido + +A tela tem agora dois estados. "Política de Privacidade e Termo de Uso" só existe em `_camposDoConvite()` (`:652`). Quem já tem credencial vê só o PIN e "Esqueceu o PIN?", sem o link legal, que antes ficava sempre na tela inicial. Além disso, as PRs abertas acrescentam à tela de login exatamente no bloco que esta PR apaga (`if (_step == _LoginStep.credenciais) ...[ start_onboarding_button, login_legal_link ]`): + +- #155: link `login_about_link` "Sobre o SinalACS" logo depois de `login_legal_link`, e o `EducationalNoticeGate` em volta de `home: PatientLoginScreen(...)`, a mesma linha que esta PR reindenta dentro do `DeviceCredentialScope`; +- #156: botão `login_library_button` "Biblioteca de saúde (sem cadastro)", ancorado no rótulo "Escanear QR Code do ACS", que esta PR troca; +- #161: botão `login_self_assessment_button` "Autoavaliação (sem cadastro)", com a mesma âncora. + +Esses links do pilar A e o "Sobre" valem para quem tem credencial também: quem esqueceu o PIN ainda pode ler a biblioteca e fazer a autoavaliação (RNF07/RNF09: o pilar A não depende de conta nem de lembrar o PIN). Sugiro tirar o link legal de `_camposDoConvite()` e pôr um bloco comum **depois** dos dois estados, por exemplo `..._linksDaTelaInicial()`, renderizado sempre que `_loaded`. Assim o rebase sobre #155, #156 e #161 tem um único lugar onde entrar. E acrescentar, no teste do estado do PIN em `device_login_test.dart`, a afirmação de `login_legal_link` (e, depois do rebase, das três chaves acima). + +--- + +## Inline 14 — apps/patient/lib/app/app.dart:386 — sugestão + +Duas coisas na carga da tela: + +1. Uma leitura do Keystore que lança, ou que passa de 5 s, vira "sem credencial", e a tela manda pedir um convite novo. A D2 da #136 tratou o mesmo caso no banco local como "falha fechada, tenta de novo, nunca destrói sozinho". Aqui nada é apagado, mas a pessoa é orientada a pedir um convite que revoga a credencial que ainda existe (C-12). Vale distinguir "indisponível" de "ausente" (`_readCredentialRecord` engole a exceção em `device_credential_store.dart:206`) e mostrar "Não foi possível ler o acesso deste aparelho. Tente de novo." com um botão de tentar de novo. +2. O bloqueio só é lido no toque. Quem reabre o app durante o bloqueio vê o botão "Entrar" habilitado e só recebe a contagem depois de tocar. Chamar `_refreshLockout()` ao fim de `_carregarCredencial` quando houver credencial resolve isso. + +--- + +## Inline 15 — apps/patient/lib/core/security/pin_envelope.dart:36 — sugestão + +O `package:cryptography` sem o `cryptography_flutter` roda o Argon2id em Dart puro e, com `parallelism: 1`, na thread da UI. Medi 69 a 85 ms por derivação em AOT num desktop x86_64. Num Android de entrada isso pode passar de 1 s, com o indicador "girando" congelado na criação do PIN e a cada login. A D3 pede bancada no aparelho e, acima de 2 s, `cryptography_flutter`, sem reduzir os parâmetros. Não pude medir (sem emulador nem aparelho). Proposta barata: derivar dentro de `Isolate.run`, que não muda o formato do envelope. A medida em aparelho fica na Issue 2. + +--- + +## Inline 16 — apps/patient/lib/core/security/device_credential_store.dart:170 — registro + +Só para deixar escrito no residual (`spec/lgpd_design.md` §0, junto do "com root"): + +- `lockedUntilMs` é comparado com o relógio de parede, e trocar a data do aparelho nas Configurações (sem root) encerra o bloqueio. +- `_readAttempts` (`:218-232`) falha **aberto**: uma leitura que lança ou um registro ilegível valem "sem bloqueio". + +Com Argon2id na casa de 1 s por tentativa, o custo de 10⁶ PINs digitados no app continua alto. Mesmo assim, o comentário de `lockDuration` ("contra a digitação insistida com o aparelho em mãos sem root") promete um pouco mais do que entrega. + +--- + +## Inline 17 — apps/patient/pubspec.yaml:25 — sugestão + +Duas coisas pequenas da dependência nova: + +1. O `pubspec.lock` da PR sobe `matcher` 0.12.19 → 0.12.20, `meta` 1.18.0 → 1.19.0 e `test_api` 0.7.11 → 0.7.12, que são fixados pelo SDK. No Flutter 3.44.8 da CI, `flutter pub get` desfaz os três, e o lock fica modificado no worktree. Parece gerado com outro Flutter. Sugiro regerar com o 3.44.8, para o diff ficar só com `cryptography` (e `vector_math`, se o 3.44.8 o mantiver). +2. `spec/stack.md:85` registra `package:cryptography ^2.7.0` só no backend. Uma linha dizendo que o app do paciente o usa para o envelope do PIN (D3) fecha o rastro. + +--- + +## Geral — bloqueante e migração + +**Bloqueante (resumo do Inline 1).** A credencial de dispositivo é o novo "o que liga aparelho/login ao titular", e a exclusão atendida da #42 precisa revogá-la na mesma transação. Sem isso, o titular anonimizado continua com acesso. A correção é de poucas linhas e tem teste óbvio. + +**Migração.** Nada a pedir: `migration.json` não cita nenhuma tabela de auditoria, o `definition.sql` mantém o bloco append-only da #82 idêntico ao da migração anterior, e o SQL de upgrade é aditivo (tabela, índices, FK e `DROP NOT NULL`). A FK `ON DELETE NO ACTION` para `patients` é coerente com a anonimização da #42, que não apaga a linha de `patients`. + +**CI e e2e (registro).** O `PROGRESS.md` diz que, sem manifesto, o `android-e2e` segue pelo fallback `developmentLogin`. Ou seja, o fluxo de convite + `loginDevice` não passa por nenhum e2e da CI, só pela integração do backend e pelos scripts manuais. `full_journey_test.dart` cobre convite → PIN → painel contra o backend real, mas nenhum teste de integração **reentra pelo PIN** (`auth.loginDevice` a partir do app); fica na Issue 3. + +## Geral — corpo da PR e mensagem do commit + +- A #128 pede que remoções de teste sejam explicadas. Sugiro uma linha no corpo: "`passwordless_login_test.dart` apagado (a tela de OTP saiu; os 2 testes de sessão expirada foram para `device_login_test.dart`); `backend_client_otp_test.dart` renomeado para `backend_client_device_login_test.dart`; `e2e_login_core.dart`/`fake_patient_backend.dart` encolhem porque o relé de OTP do paciente saiu". +- A mensagem do commit `bfa5815` perdeu os identificadores entre crases ("o servidor cria na mesma transação", "anulável (P-10)" sem `users.cpfHash`), provavelmente por substituição do shell. Vale corrigir no squash. +- "Apagar e recomeçar" (#136) não apaga a credencial de dispositivo: são custódias separadas, e "Esqueceu o PIN?" é o caminho para isso. Acho certo; só registro para a C-10. + +## Geral — rebase sobre as PRs do paciente que entram antes desta + +Pela ordem de merge proposta (`#162 → #163 → #158 → #159 → #155 → #156 → #160 → #161 → #157`), esta PR entra por último no app do paciente e precisa de rebase sobre `develop` depois da #161. O `git merge-tree` dá conflito com #155, #156, #158, #159, #160, #161 e #163, em `apps/patient/lib/app/app.dart`, `patient_app_mvp_test.dart`, `integration_test/full_journey_test.dart` e `PROGRESS.md` (este só por acréscimo no mesmo ponto: manter as duas seções). Além do que o `git` aponta, há quebras que não aparecem como conflito: + +1. **Testes novos das outras PRs entram pelo login por CPF/OTP**, que esta PR remove. São arquivos novos, então o merge é limpo e a suíte quebra: `apps/patient/test/educational_notice_test.dart:151` e `:155` (#155), `apps/patient/test/educational_library_test.dart:284` e `:288` (#156), `apps/patient/test/main_notification_permission_test.dart:68` (#159, que espera `cpf_field` como prova de que a tela inicial foi desenhada), `apps/patient/test/call_192_test.dart:55` e `:59` (#160) e `apps/patient/test/local_self_assessment_test.dart:79`, `:135` e `:139` (#161, testes 2 e 5). No rebase, trocar a entrada por CPF/OTP pelo PIN (ou por uma chave que exista nos dois estados da tela, como `start_onboarding_button` ou `login_library_button`). +2. **Botões do pilar A e "Sobre" na tela de login** (#155, #156, #161): entram no bloco comum do Inline 13, visível com ou sem credencial, mantendo as chaves `login_about_link`, `login_library_button` e `login_self_assessment_button`. +3. **Escopos em volta de `home:`/`MaterialApp`:** `EducationalNoticeGate` (#155) e `Call192Scope` (#160) envolvem a mesma linha que esta PR põe dentro do `DeviceCredentialScope`; o conflito se resolve aninhando os três. +4. **Texto da tela de OTP da #158:** o hunk que troca "enviado pela sua unidade de saúde" por "que você recebeu" fica obsoleto, porque esta PR apaga a frase inteira e os textos novos dizem "agente de saúde", sem "UBS". No conflito, fica a versão desta PR. As outras trocas da #158 no paciente (diálogo de exclusão e consentimento de avisos, hoje "A equipe da UBS analisa…" e "Avisos da UBS…" nesta branch) não conflitam e devem permanecer. +5. **Pedido de permissão de notificação (#159):** se a #159 passar a pedir `POST_NOTIFICATIONS` ao conceder o consentimento de avisos no cadastro, esse ponto, que hoje está na tela de onboarding, passa nesta PR para `PinSetupScreen._concluir`, junto do `registerPushDevice`. Conferir que o pedido continua lá, sem `await`, depois do rebase. + +--- + +## Issues de continuação + +### Issue 1 — Auditar a emissão da credencial de dispositivo do participante (C-05) + +**Contexto.** Desde a #128 (PR #157), `onboarding.completeEnrollment` cria em `patient_device_credentials` uma credencial de longa duração, que é a única prova do login do participante (`auth.loginDevice`). O login já é auditado (`granted`/`denied_credential`/`denied_no_territory`), mas a **emissão** não: o fluxo de onboarding não chama `AuditTrail` (`spec/lgpd_data_audit.md`, linha de `enrollment_tokens.createdByAcsId`). Para comparar: o token de envio diferido do ACS audita `upload_token_issued`. + +**O que fazer.** +- Gravar em `audit_logs`, na mesma transação do consumo do convite, uma linha `write`/`patient_device_credential`/`issued` com o titular e o id da credencial (nunca o segredo nem o hash). +- Quando a C-12 (#133) e a anonimização da #42 revogarem credenciais, auditar `revoked` com o motivo. +- Atualizar `spec/lgpd_data_audit.md` (a frase "o fluxo de onboarding não escreve em `audit_logs`") e `backend/CLAUDE.md`. + +**Critério de aceite.** Teste de integração: concluir um convite deixa exatamente uma linha `issued` encadeada em `audit_logs`, e uma recusa que desfaz a transação não deixa nenhuma. + +**Refs:** #128, #133, #42. + +### Issue 2 — Medir o Argon2id do envelope do PIN em aparelho de entrada e tirá-lo da thread da UI + +**Contexto.** A PR #157 (C-05) deriva a chave do envelope do PIN com Argon2id (m = 19 MiB, t = 2, p = 1; D3 do plano da #136) pelo `package:cryptography` em Dart puro, na thread da UI, a cada criação do PIN e a cada login. Num desktop x86_64 em AOT, cada derivação leva 69 a 85 ms. Em Android de entrada isso não foi medido. + +**O que fazer.** +- Medir a derivação num aparelho de entrada (ou no emulador API 24/36 como aproximação) em build release. +- Derivar dentro de `Isolate.run`, sem mudar o formato `{v, salt, nonce, ct, mac}`. +- Se passar de 2 s, adotar `cryptography_flutter` (implementação nativa), como a D3 manda, **sem** reduzir os parâmetros. + +**Critérios de aceite.** +- [ ] Tempo medido registrado no `PROGRESS.md`, com aparelho/API e build. +- [ ] Indicador de progresso anima durante a criação do PIN e o login (derivação fora da thread da UI). +- [ ] Parâmetros do Argon2id inalterados; envelopes existentes continuam abrindo. + +**Refs:** #128, #136. + +### Issue 3 — e2e: reentrar pelo PIN contra o backend real + +**Contexto.** Na #157, `integration_test/full_journey_test.dart` cobre convite → criação do PIN → painel. Nenhum teste de integração exercita `auth.loginDevice` a partir do app, que é o caminho diário do participante (reentrada depois da sessão de 1 h). + +**O que fazer.** Depois do cadastro, voltar à tela de login ("Entrar novamente" ou reabertura), digitar o PIN e chegar ao painel; também PIN errado não entra e não gasta convite. + +**Critérios de aceite.** +- [ ] Passo novo no `full_journey_test.dart` (ou arquivo próprio) verde em `scripts/qa/patient_full_e2e.sh`. +- [ ] Só dados sintéticos; PIN e segredo nunca impressos. + +**Refs:** #128. diff --git a/docs/superpowers/plans/2026-11-13-pr-158-comentarios.md b/docs/superpowers/plans/2026-11-13-pr-158-comentarios.md new file mode 100644 index 00000000..37b4ecbe --- /dev/null +++ b/docs/superpowers/plans/2026-11-13-pr-158-comentarios.md @@ -0,0 +1,88 @@ +# PR #158 (C-06, "UBS" para grupo do piloto): parecer e comentários a publicar + +Textos da revisão da PR #158 (`chore/c-06-ubs-para-grupo-piloto`, autor `Rosialdo`, base `develop`, commit `5595467`). Publicar só depois da aprovação do dono, com `gh pr review` (parecer) e `gh api repos/hbgit/SinalACS/pulls/158/comments` (inlines, um por chamada). + +Veredito proposto: **Aprovar com observações** (`gh pr review --approve`). Não há bloqueante. Os pedidos são pequenos (restos de "UBS" que o participante ou o ACS ainda podem ler) e cabem nesta PR ou numa continuação. + +--- + +## Parecer + +Revisei a PR contra a issue #129 (C-06) e a linha C-06 de `docs/escopo/mudancas-de-codigo-recomendadas.md`. Todas as ocorrências citadas na linha C-06 foram trocadas, o texto novo é coerente ("grupo do piloto" no backoffice, "coordenação do piloto" para quem atende) e os testes novos prendem a ausência de "UBS" nos três apps. + +| Critério da #129 | Evidência | +|---|---| +| Nenhum texto visível cita "UBS" nas linhas da C-06 | Paciente `app.dart:2020,2089` (diálogo de exclusão e consentimento de avisos); ACS `device_wiped_screen.dart:46-47`; admin `app.dart:341,716`, `admin_accounts.dart:421,507,681`, `audit_log_screen.dart:498`. Conferidos no diff. | +| Texto legal fica fora (#124) | `legal_documents.dart` não está no diff (8 ocorrências de "UBS" seguem lá, como a PR declara). | +| Testes de widget atualizados | `patient_app_mvp_test.dart` (diálogo de exclusão sem "UBS"), `escalation_ubs_test.dart` e `remote_wipe_ui_test.dart` (ACS), `admin_home_shell_test.dart` (percorre os seis destinos), `alerts_screen_test.dart`, `admin_mobile_smoke_test.dart`. | + +**O que rodei em Linux** (worktree limpo do commit `5595467`): + +- `flutter pub get`, `flutter analyze` e `flutter test` nos três apps. Analyze: só o aviso `asset_directory_does_not_exist` de `assets/certs/` (diretório gitignorado, não é da PR). Testes: paciente 334 passam; admin 483 passam; ACS 814 passam (8 min 29 s). +- Varredura residual nos três apps (`grep UBS|unidade de saúde|Unidade Básica`, sem `legal_documents.dart`): nenhuma string de interface restante nos apps, só comentários de código e identificadores. Ver pedido 1 para o que o ACS ainda lê por vias indiretas. +- `mqtt_tls_refused_test.dart` passa em Linux; a falha citada na PR é do ambiente Windows. +- CI: 9 de 9 verdes. + +**Pontos que conferi e aprovo:** + +- A troca de "enviado pela sua unidade de saúde" por "que você recebeu" na tela do código é coerente com a D4 e a PR explica o motivo. +- "Ligar para a coordenação do piloto": rótulo e mensagem de falha do contato trocados; o teste novo prende o rótulo. Botão só renomeado, a retirada fica na C-07 (declarado). +- Nome do arquivo `escalation_ubs_test.dart` e identificadores (`ubsId`, `ubsName`, `UbsContact`, `_callUbs`) não são texto visível; manter está certo, a tabela `ubs` fica para a C-06b. +- O teste novo do admin percorre Indicadores, Microáreas, Alertas, Auditoria, Pedidos do titular e Avisos com `find.textContaining('UBS')` igual a nada; é o tipo de guarda que evita regressão. +- Mock do admin "UBS Vila Nova" para "Grupo Vila Nova": dado sintético, sem efeito em produção. + +**Pedidos (pequenos):** ver inlines 1 e 2. + +**Sugestões:** inline 3. + +**Registros (só documentam):** + +- A tela do código de acesso que a PR edita (`apps/patient/lib/app/app.dart:600`) é reescrita pela #157 (C-05): a linha "Digite o código de 6 dígitos enviado pela sua unidade de saúde." some e dá lugar a "Digite o PIN deste aparelho para entrar." A #158 e a #157 conflitam nesse trecho; quem entrar depois resolve ficando com a versão da #157 (sem "unidade de saúde"). A troca desta PR nesse ponto perde efeito sem perda de cobertura. +- O nome fictício que o admin local mostra ("Grupo do piloto: UBS Desenvolvimento") vem do seed e de `ubsName`; some com a C-06b. + +--- + +## Inline 1 — apps/acs/lib/app/app.dart:4017 — pedido + +A mensagem de falha do contato foi trocada (linha 4017), mas dois caminhos ainda levam "UBS" ao ACS: + +1. A linha 4008, logo acima, usa `contato.name`, que vem do servidor (hoje "UBS ..." no seed e em qualquer cadastro existente). Sugiro que o texto não dependa do nome: `'A coordenação do piloto ainda não cadastrou um telefone. Acione a coordenação.'` (o teste `escalation_ubs_test.dart:64,116` passa a procurar `A coordenação do piloto ainda não cadastrou um telefone`). +2. Quando o backend recusa, o `catch (BackendFailure)` mostra `falha.message`, e o servidor devolve `'Somente ACS consultam o contato da UBS.'` e `'UBS do ACS não encontrada.'` (`backend/sinalacs_server/lib/src/application/ubs/ubs_contact_service.dart:30,35`, repassados por `ubs_endpoint.dart:15`). São strings de backend, fora dos "três apps" da issue, mas chegam à tela. Ou entram aqui (duas linhas e o teste do backend que as compara, se houver) ou viram o item de continuação. + +--- + +## Inline 2 — apps/acs/lib/app/device_wiped_screen.dart:46 — sugestão + +O comentário de documentação da linha 12 ainda diz "com a equipe da UBS". Não é texto visível, mas descreve o texto desta tela, que a PR trocou; vale alinhar para "com a coordenação do piloto" para o próximo leitor não achar que a tela e o comentário divergem. O mesmo vale, se quiser, para os comentários `///` em `apps/acs/lib/app/app.dart:3978,3997`, `backend_client.dart:255` e `apps/admin/lib/core/data/admin_data_source.dart:696,703`. Nenhum é bloqueante. + +--- + +## Inline 3 — apps/admin/lib/core/data/mock_admin_data_source.dart:112 — sugestão + +`_ubsSintetica = 'Grupo Vila Nova'` está bem. O comentário logo acima (linha 111, "UBS sintética das linhas criadas pelo mock (nenhuma UBS real)") continua dizendo UBS; mesma observação do inline 2, só comentário. + +--- + +## Geral — conflito com a #157 e ordem de merge + +A #157 (C-05, QR + PIN) reescreve a tela de login do paciente e conflita com a #158 em `apps/patient/lib/app/app.dart`. Sugiro mergear a #158 primeiro (é pequena e sem dependência) e a #157 resolver o conflito ficando com o texto dela na tela de acesso. Nenhuma das duas depende da outra de outra forma. + +## Geral — critério "nenhum texto visível" e `legal_documents.dart` + +O corpo marca o critério como cumprido "exceto `legal_documents.dart`". Concordo, desde que a #124 (versão legal nova) o feche; vale a #129 só fechar quando as duas estiverem em `develop`, ou a issue declarar que fecha com a exceção. + +--- + +## Issues de continuação + +### Issue 1 — Textos de erro do backend que citam "UBS" chegam ao ACS (C-06) + +Só abrir se o autor não incluir o pedido 1.2 nesta PR. + +Corpo: + +> **Contexto.** A C-06 (#129, PR #158) trocou "UBS" nos três apps, mas o ACS ainda lê duas mensagens do servidor: `'Somente ACS consultam o contato da UBS.'` e `'UBS do ACS não encontrada.'` (`backend/sinalacs_server/lib/src/application/ubs/ubs_contact_service.dart:30,35`), repassadas por `ubs_endpoint.dart` como `AlertPermissionException` e mostradas pelo botão "Ligar para a coordenação do piloto". +> +> **O que fazer.** Trocar por "coordenação do piloto" / "grupo do piloto", ajustar os testes do backend que comparam o texto e rodar `grep -rn "UBS" backend/sinalacs_server/lib` para listar outras strings devolvidas ao cliente. A tabela e os identificadores `ubs` ficam com a C-06b. +> +> **Critério.** Nenhuma mensagem devolvida por endpoint contém "UBS" no corpo; testes do backend verdes. diff --git a/docs/superpowers/plans/2026-11-13-pr-159-comentarios.md b/docs/superpowers/plans/2026-11-13-pr-159-comentarios.md new file mode 100644 index 00000000..5755f738 --- /dev/null +++ b/docs/superpowers/plans/2026-11-13-pr-159-comentarios.md @@ -0,0 +1,113 @@ +# PR #159 (#153, permissão de notificação na partida): parecer e comentários a publicar + +Textos da revisão da PR #159 (`fix/issue-153-permissao-notificacao`, autor `vinimartinsufrr`, base `develop`, commit `db1b330`). Publicar só depois da aprovação do dono, com `gh pr review` (parecer) e `gh api repos/hbgit/SinalACS/pulls/159/comments` (inlines, um por chamada). Plano: `2026-11-13-prs-156-163-revisao.md`. + +Veredito proposto: **Comentar (pedidos antes do merge)** (`gh pr review --comment`). Não há bloqueante: a correção da #153 está certa, provada por teste e não relaxa o INV-03. Os dois pedidos são de escopo pequeno. O mais importante é que, ao tirar o pedido da partida, os avisos da equipe (RF14, push FCM) ficaram sem nenhum caminho que peça a permissão. O outro é a frase errada sobre o manifest, que a PR edita sem corrigir. + +--- + +## Parecer + +Revisei a PR contra a issue #153 (achado da verificação da #136, PR #150), o INV-03 do piloto ("pedido enviado nunca some") e o botão "Ligar 192". Os três critérios de aceite estão atendidos e provados por teste: + +| Critério da #153 | Evidência | +|---|---| +| O `runApp` não espera a resposta da permissão; o pedido acontece depois do primeiro quadro ou ao criar um lembrete | `apps/patient/lib/main.dart`: o `await ...requestNotificationsPermission()` saiu e nada mais na partida chama o plugin para isso. O único ponto de pedido agora é `ReminderScheduler.requestPermission()` (`lib/core/reminders/reminder_scheduler.dart:221`), chamado sem `await` em `lib/app/app.dart:2890` (reativar) e `:2948` (criar/editar), sempre **depois** de salvar, agendar e do `setState`. | +| Recusa ou adiamento não bloqueia nenhuma tela, em especial a de urgência | O pedido só nasce de um ato da pessoa na tela de Lembretes, nunca na partida nem sobre a aba de urgência. `requestPermission()` engole qualquer falha (`reminder_scheduler.dart:221-228`), provado por `test/reminders/reminder_scheduler_test.dart` ("requestPermission repassa ao canal e nunca lança"). O reagendamento do aquecimento (`rescheduleAll`) não pede: `test/storage/startup_warmup_test.dart` afirma `permissionRequests == 0`. | +| Teste que prova que a tela inicial é desenhada com o pedido pendente | `test/main_notification_permission_test.dart` sobe o `main()` **real**, com Android simulado e `requestNotificationsPermission` pendente para sempre, e acha `cpf_field`. Pus o `main.dart` da `develop` no lugar e o teste **reprova** com a mensagem esperada ("o main() não pode esperar o diálogo de permissão"); com o da PR, passa. | + +**O que rodei em Linux** (Flutter estável, worktree limpo da branch, `apps/patient`; log em `pr159-verificacao.log`): + +- `flutter test test/main_notification_permission_test.dart`: `+1: All tests passed!` +- `flutter test test/reminders/reminder_scheduler_test.dart test/storage/startup_warmup_test.dart`: `+12: All tests passed!` +- `flutter test` completo: `+336: All tests passed!` (bate com o corpo da PR). +- Prova do vermelho: o mesmo teste novo com `lib/main.dart` da `develop` reprova (exit 1, mensagem do `reason`). Restaurei o arquivo; nada foi commitado. +- `flutter analyze`: só o aviso `asset_directory_does_not_exist` de `assets/certs/`, diretório gitignorado criado por `scripts/dev/sync_dev_ca.sh`; não é desta PR. +- `bash scripts/qa/check_documentation_links.sh`: só o "link local ausente: graphify-out (AGENTS.md)", gitignorado e já assim em `develop`. +- CI: 9 de 9 verdes, inclusive `android-e2e`. +- **Emulador: não rodei.** Não havia aparelho ligado e a prova desta revisão é a mesma do autor, a de VM. O comportamento real do `GrantPermissionsActivity` no Android 13+ (diálogo só ao criar/reativar, nenhum na primeira abertura) continua sem prova em aparelho. + +**Pontos que conferi no código e aprovo:** + +- A escolha "no lembrete, não depois do primeiro quadro" é melhor que a alternativa da issue: um diálogo logo após o primeiro quadro ainda cobriria a aba de urgência (destino inicial `PatientDestination.emergency`) até a resposta. +- `unawaited(...)` depois do `setState` e dentro do `try`: a lista já mostra o lembrete antes do diálogo, e uma recusa não desfaz nada. Como `requestPermission()` nunca lança, o `catch` da tela não vira mensagem de erro falsa. +- Pausar e excluir não pedem; reativar pede. Os testes de `patient_app_mvp_test.dart` cobrem os quatro casos. +- Os duplos de `ReminderScheduler` em quatro arquivos de teste ganharam `requestPermission()`; o `_ThrowingReminderScheduler` não lança nele, coerente com o contrato. +- O teste do `main()` não espera o `main()` antes da asserção, de propósito: com o defeito de volta ele reprova em vez de ficar pendurado. Os mocks de canal são desfeitos no `tearDown`, e `debugPrint`/`debugDefaultTargetPlatformOverride` no `finally`. + +**Pedidos (nesta PR):** + +1. **Avisos da equipe (RF14) ficaram sem pedido de permissão.** O pedido da partida também servia ao push FCM: o próprio `AndroidManifest.xml` do paciente (linhas 18-21) diz que, sem `POST_NOTIFICATIONS`, "o token ainda é obtido e registrado, mas a notificação do aviso comunitário não é exibida (RF14)", e que "quem a pede em tempo de execução é `main.dart`". Com a PR, quem consente com "Avisos da equipe de saúde" e nunca cria um lembrete nunca vê o diálogo, e os avisos somem em silêncio no Android 13+. O `scripts/qa/push_e2e.sh:200` concede a permissão por `pm grant`, então a CI não pega isso. Peço pedir a permissão também quando o consentimento de push é concedido (em `_changeConsent`, junto do `registerPushDevice` de `app.dart:1964`; no cadastro, onde `_pushConsent` dispara `registerPushDevice`), sem `await`, como nos lembretes. Se preferir não fazer agora, registre o limite no `PROGRESS.md` e no comentário do manifest e abra a issue de continuação abaixo. +2. **A frase sobre o manifest continua errada.** `docs/publicacao-google-play.md` diz que "o manifest principal não declara" `POST_NOTIFICATIONS`, mas `apps/patient/android/app/src/main/AndroidManifest.xml:22` a declara desde a #136 (`ded26f3`). A PR edita as duas frases e mantém o erro; é uma linha em cada uma (inlines 1 e 2). + +**Sugestões (opcionais):** atualizar o comentário do manifest (fora do diff, ver Geral); ajustar as outras menções do mesmo erro no guia. + +**Registros:** quem atualiza com lembretes ativos e nunca respondeu ao diálogo só o verá ao mexer num lembrete. Está no `PROGRESS.md` e é aceitável. Junto do pedido 1, cabe na mesma issue de continuação, e não pede issue própria. A prova é só de VM. + +--- + +## Inline 1 — docs/publicacao-google-play.md:130 — pedido + +Esta frase continua dizendo que o manifest principal não declara `POST_NOTIFICATIONS`, mas `apps/patient/android/app/src/main/AndroidManifest.xml:22` já a declara (entrou na #136, `ded26f3`). Como a PR já edita a frase, sugiro corrigir aqui mesmo: + +> - **`POST_NOTIFICATIONS`:** o Paciente declara a permissão no manifest principal e chama `requestNotificationsPermission()` ao criar ou ativar um lembrete (desde a #153, não mais em `lib/main.dart`). Conferir no manifest mesclado. + +--- + +## Inline 2 — docs/publicacao-google-play.md:523 — pedido + +O mesmo erro do inline 1. Proposta: + +> **Notificações (Paciente).** O app depende de `flutter_local_notifications`, declara `POST_NOTIFICATIONS` no manifest principal e chama `requestNotificationsPermission()` ao criar ou ativar um lembrete (#153). Com `targetSdk = 36`, em Android 13 ou superior as notificações só aparecem depois que a pessoa concede a permissão. Conferir no manifest mesclado do release (seção 2.6). + +As linhas 503, 697, 805, 853, 889 e 919 repetem a premissa ("não declarada no `main`"). Estão fora do diff; se for corrigir, vale passar por elas no mesmo commit. + +--- + +## Inline 3 — apps/patient/lib/core/reminders/reminder_scheduler.dart:25 — pedido + +"Só é chamada por um ato da pessoa na tela de lembretes": hoje este é o **único** ponto que pede `POST_NOTIFICATIONS`, e a mesma permissão vale para o push dos avisos (RF14). O comentário do `AndroidManifest.xml` (linhas 18-21) ainda diz que o pedido está em `main.dart` e que, sem ele, "a notificação do aviso comunitário não é exibida". Quem dá o consentimento "Avisos da equipe de saúde" e não cria lembrete nunca vê o diálogo. Proponho chamar `unawaited(reminders.scheduler.requestPermission())` também quando `segmentedPush` é concedido (`app.dart:1964`, e no cadastro, onde `_pushConsent` dispara `registerPushDevice`). É um ato da pessoa, fora da aba de urgência. Se ficar para depois, ajuste este comentário e o do manifest para dizer que o RF14 depende do pedido feito nos lembretes. + +--- + +## Inline 4 — apps/patient/test/main_notification_permission_test.dart:68 — registro + +Conferi o vermelho: com o `lib/main.dart` da `develop` no lugar, este teste reprova com "o main() não pode esperar o diálogo de permissão"; com o da PR, passa. A tela desenhada é o login (`cpf_field`), a primeira para quem não tem sessão, o que basta para o critério "nenhuma tela presa ao diálogo". A prova continua só de VM: nem o autor nem esta revisão rodaram em emulador. + +--- + +## Inline 5 — PROGRESS.md:1933 — registro + +Concordo com o limite de quem atualiza com lembretes ativos. Se o pedido do inline 3 ficar para depois, vale acrescentar aqui o segundo limite: "quem consente com os avisos (RF14) e não cria lembrete não recebe o diálogo, e os avisos não aparecem no Android 13+ (o `push_e2e.sh` concede a permissão por `pm grant`, então não pega isso)". + +--- + +## Geral — comentário do manifest fora do diff + +`apps/patient/android/app/src/main/AndroidManifest.xml:18-21` diz "Quem a pede em tempo de execução é `main.dart`, por `requestNotificationsPermission()`". Isso deixou de ser verdade com esta PR. O arquivo não está no diff, por isso o comentário vai aqui: vale trocar para "a tela de lembretes (`ReminderScheduler.requestPermission`, #153)" e, se o pedido 1 for feito, citar também o consentimento de avisos. + +## Geral — conflitos + +A PR conflita com a #160 e a #157 só no `PROGRESS.md` (as duas acrescentam uma seção no mesmo ponto; basta manter as duas). A ordem de merge fica com o dono. + +--- + +## Issues de continuação + +### Issue 1 — Paciente: pedir POST_NOTIFICATIONS fora dos lembretes (avisos RF14 e quem já tem lembretes) + +Só abrir se o pedido 1 da PR #159 não for feito nela. + +**Objetivo** +Depois da #153, o app do paciente só pede `POST_NOTIFICATIONS` ao criar, editar ou reativar um lembrete. A mesma permissão vale para o push dos avisos da equipe (RF14, FCM). No Android 13+, quem consente com "Avisos da equipe de saúde" e nunca cria um lembrete nunca vê o diálogo, e os avisos não aparecem na bandeja. Quem atualiza o app com lembretes ativos e nunca respondeu ao diálogo também não é perguntado. + +**Critério de aceite** +- [ ] Conceder o consentimento `segmentedPush` (Meus Dados e cadastro) pede a permissão sem `await`, nunca sobre a aba de urgência. +- [ ] A tela de Lembretes, com lembrete ativo e a permissão negada ou não respondida (`areNotificationsEnabled()` do plugin), mostra um aviso com ação para pedir, sem bloquear a lista. +- [ ] O comentário de `apps/patient/android/app/src/main/AndroidManifest.xml` sobre quem pede a permissão está atualizado. +- [ ] Teste de widget para os dois pontos. A prova em emulador sem `pm grant` (o `push_e2e.sh` concede a permissão hoje) fica registrada como feita ou pendente. + +**Referências** +IDs: RF06, RF14, INV-03 +Origem: revisão da PR #159 (#153) +Bloqueado por: — diff --git a/docs/superpowers/plans/2026-11-13-pr-160-comentarios.md b/docs/superpowers/plans/2026-11-13-pr-160-comentarios.md new file mode 100644 index 00000000..86523697 --- /dev/null +++ b/docs/superpowers/plans/2026-11-13-pr-160-comentarios.md @@ -0,0 +1,166 @@ +# PR #160 (C-04): parecer e comentários a publicar + +Textos da revisão da PR #160 (`feat/issue-127-pedido-de-contato-192`, autor `vinimartinsufrr`, base `develop`, commit `16b33b2`). Publicar só depois da aprovação do dono, com `gh pr review` (parecer) e `gh api repos/hbgit/SinalACS/pulls/160/comments` (inlines, um por chamada). Plano: `2026-11-13-prs-156-163-revisao.md`. + +Veredito proposto: **Comentar (pedidos antes do merge)** (`gh pr review --comment`). Não há bloqueante: a INV-03 está preservada e a orientação "Ligar 192" não chama o backend. Os três pedidos são pequenos: o rótulo de risco que ainda aparece ao lado do "Pedido de contato" em "Meus dados", a ordem da orientação com fonte grande e a contagem de testes no `PROGRESS.md`. A #161 está empilhada nesta PR; um ajuste aqui pede rebase lá. + +--- + +## Parecer + +Revisei a PR contra a issue #127, o escopo (`spec/requisitos_piloto.md` §INV-03 no piloto) e as duas regras que não podem ceder: o pedido enviado nunca some (INV-03) e o participante não vê cor nem rótulo clínico. Os quatro critérios de aceite estão atendidos e provados por teste: + +| Critério da #127 | Evidência | +|---|---| +| "Ligar 192" aparece antes de qualquer pedido de contato | `test/call_192_test.dart`, "\"Ligar 192\" aparece antes do pedido de contato": compara os retângulos (`call_192_button.bottom < panic_button.top`) e confere que o discador recebe `192`. | +| A saída "Ligar 192" exige escolha explícita para fechar e grava um evento local cifrado | "não fecha pelo voltar do sistema; só pela escolha explícita" (`handlePopRoute`, sem `BackButton`/`CloseButton`); "mostra a orientação, grava o evento local…" (tipo, UTC, `selfAssessmentEngineVersion`); `test/events/sqflite_local_event_log_test.dart` prova a tabela no banco da #136. | +| O status não usa "Atendido" como promessa | `patient_app_mvp_test.dart`, "pedido concluído pelo agente aparece como \"Encerrado\", nunca \"Atendido\"", e "nenhum rótulo de urgência nem promessa de atendimento na tela". | +| INV-03 segue verde; a saída 192 grava o evento e não chama `alerts.createRedAlert` | Os testes de INV-03 de `patient_app_mvp_test.dart` (idempotência em duas tentativas, localização de reserva para cada `LocationUnavailableReason`, `liveRegion`) só trocaram textos de busca; a lógica e as asserções sobre `idempotencyKeys`/`locationHashes` são as mesmas. A chave continua `_attemptKey ??= newIdempotencyKey()`, sem mudança no diff. Escrevi um teste extra (abaixo) com um backend que registra **qualquer** chamada: a orientação, o "Ligar 192" e o fechar não fazem nenhuma. | + +**O que rodei em Linux** (Flutter estável, worktree limpo da branch, `16b33b2`): + +- `flutter analyze` em `apps/patient`: só o aviso `asset_directory_does_not_exist` de `assets/certs/`, que é o diretório gitignorado criado por `scripts/dev/sync_dev_ca.sh`; não é desta PR. +- `flutter test` completo: 350 passam. +- `bash scripts/qa/check_documentation_links.sh`: nada novo (o único "ausente" é `graphify-out`, gitignorado, em `AGENTS.md`). +- `grep -rn "Atendido\|Risco:" apps/patient/lib`: sobram `app.dart:1715–1725` (`_TriageResult`, amarelo e verde, declarado como C-08), `app.dart:2150` ("Atendido" de um pedido LGPD do titular, não do pedido de contato, correto), `app.dart:2343` ("Meus dados", ver Inline 1) e dois comentários. +- Três testes que escrevi em `test/call_192_test.dart` (não commitados; diff no Geral): os três passam, e a suíte completa com eles fica em 353. +- CI: 9 de 9 verdes, inclusive `android-e2e` (`gh pr checks 160`, consultado em 2026-11-13). + +**Pontos que conferi no código e aprovo:** + +- INV-03: o envio continua pelo mesmo `alerts.createRedAlert`, com a mesma chave por confirmação e a mesma reserva de localização. Só mudou o que a pessoa vê. +- `triage.evaluate` no backend (`TriageSessionService.evaluateAndRecord`) não cria alerta; o único caminho para um pedido é a aba Contato. A orientação é empurrada só depois que a avaliação volta. +- Migração v1 → v2: só `CREATE TABLE local_events`, ligada a `onUpgrade` nos dois caminhos de abertura (cifrado e o de teste); o v1 escrito no teste é igual ao `_create` de `develop`. `onDowngrade` continua `onDatabaseDowngradeDelete`. +- `local_events` tem só `id`, `kind`, `occurred_at` (UTC) e `engine_version` (teste de `PRAGMA table_info`); nenhuma resposta da autoavaliação. `deleteEverything()` leva a trilha junto. Um tipo desconhecido é ignorado na leitura, e isso tem teste. +- A gravação do evento não segura a tela, e o erro é descartado sem log (a causa pode carregar material da custódia, como na #136). A orientação abre e fecha igual com o banco quebrado, e isso tem teste. +- `selfAssessmentEngineVersion = 'arvore-v1'` nasce aqui, com a regra de subir junto com a árvore. A #161 reaproveita a constante. +- Manifesto: ``, sem `CALL_PHONE`. `tel:` abre o discador e nunca liga sozinho; quando o discador não abre, a pessoa vê um aviso para ligar 192 pelo telefone. +- `url_launcher` ^6.3.0, a mesma versão do ACS, registrado em `spec/stack.md`. O `apps/patient/pubspec.lock` já era versionado em `develop`; a PR só acrescenta os pacotes `url_launcher*`. +- `PopScope(canPop: false)` com `automaticallyImplyLeading: false` e o botão "Fechar esta orientação" sempre presente: aceito. O fechamento explícito é o que a §INV-03 item 2a pede, e a saída existe. +- Botão "Pedir contato ao agente" sem `Semantics` em volta (um nó, nome = texto visível) e sem `PatientColors.danger`. +- Rótulos de status: mapa servidor → texto sem promessa. "Repassado à coordenação do piloto" usa exatamente a expressão da #158 (C-06). +- `docs/telas-paciente.md`: a captura `01-emergencia.png` foi marcada como anterior à C-04, sem captura inventada. + +**Pedidos (pequenos, nesta PR):** "Meus dados" (Inline 1); ordem da orientação com fonte grande (Inline 2); contagem no `PROGRESS.md` (Inline 3). + +**Sugestões (opcionais):** cor do estado do pedido (Inline 4); consentimento na prova da migração (Inline 5); levar os três testes da revisão (Geral). + +**Registros (só documentam):** rótulo "Repassado…" sem escritor (Inline 6); disciplina da versão do motor (Inline 7); o que fica para C-08/C-10 e para o lado do agente (Geral). + +--- + +## Inline 1 — apps/patient/lib/app/app.dart:2223 — pedido + +A linha já mostrava "· Risco: Vermelho" antes desta PR ("Alerta de urgência · Risco: Vermelho"); com o novo rótulo, o histórico de "Meus dados" passa a dizer **"Pedido de contato · Risco: Vermelho"** (linha 2343, `'${_sourceLabel(event.source)} · Risco: ${_riskLabel(event.riskLevel)}'`). O teste `mostra os consentimentos e o histórico de risco…` (`patient_app_mvp_test.dart:1830–1831`) passou a fixar essa combinação. + +O pedido de contato não é uma classificação: o servidor grava `riskLevel = red` em todo pedido porque o envio é o `createRedAlert`. Para o participante, a linha diz que pedir contato o classificou como vermelho. É o rótulo clínico que a C-04 tira do Status e da aba Contato, voltando por outra tela. + +Proposta mínima: para `source == 'alert'`, mostrar só "Pedido de contato" e a data, sem o risco, e trocar o `expect(find.textContaining('Vermelho'), findsOneWidget)` por `findsNothing`. O risco da triagem (`source == 'triage'`) fica como está até a C-08. Se preferir deixar "Meus dados" inteiro para a C-08, peço só uma linha no `PROGRESS.md` (seção "Abertos e limites") dizendo que a combinação existe, e a issue de continuação 1 abaixo. + +--- + +## Inline 2 — apps/patient/lib/app/call_192.dart:146 — pedido + +Com fonte a 200 %, numa tela de 360×640, o botão "Ligar 192" fica abaixo do parágrafo explicativo e só aparece depois de rolar. Medi com um teste temporário: o `ListView` nem chega a construir o `call_192_button` sem rolar (o parágrafo termina em y = 1092 numa viewport de 584). + +A fonte de teste do Flutter é mais larga que a Roboto, então no aparelho a distância é menor. Mesmo assim, a ação que a orientação existe para provocar não deveria depender de rolagem para quem usa fonte grande. Pela §INV-03 item 2a, a orientação com o botão de discagem é exibida "antes de qualquer outra ação". + +Proposta: subir `const Call192Button()` para logo depois do título e deixar o parágrafo e o "Se não conseguir ligar…" abaixo dele. Os testes atuais continuam verdes, porque nenhum depende da ordem dentro da orientação. Um teste a 2.0× que afirme `getRect(call_192_button).bottom <= altura da tela` sem rolar prende a correção. + +--- + +## Inline 3 — PROGRESS.md:1935 — pedido + +O `CONTRIBUTING.md` (linha 250) pede para não gravar contagens de testes nos documentos, porque "elas envelhecem a cada PR". Sugiro trocar "`flutter analyze` sem avisos e 350 testes (eram 334)." por "`flutter analyze` sem avisos e suíte verde." e manter as contagens só no corpo da PR. Foi o mesmo pedido feito na #155. + +--- + +## Inline 4 — apps/patient/lib/app/app.dart:1507 — sugestão + +O estado do pedido ("Pedido enviado ao agente…", "Enviando pedido…") continua com `context.patientRisk.accentOnSurface`. Pelo `patient_theme.dart`, `accent` "só pode significar `RiskLevel`", e no `_TriageResult` esse tom é o do verde. O tema também usa esse tom como semente da marca, então a leitura não é inequívoca. Como a PR tira toda cor clínica da aba, `Theme.of(context).colorScheme.onSurface` em negrito fecha a questão sem perder contraste. Opcional. + +--- + +## Inline 5 — apps/patient/test/events/sqflite_local_event_log_test.dart:111 — sugestão + +O texto da PR e o `PROGRESS.md` dizem que a migração preserva lembretes **e consentimento**, mas o teste só insere e lê um lembrete. Duas linhas fecham a prova: `await v1.insert('consent_preferences', {'purpose': 'reminders', 'granted': 1});` antes do `close()`, e a leitura de volta depois do `open()`. O mesmo vale para uma linha de `local_meta`, que guarda o estado do banco da #136. + +--- + +## Inline 6 — apps/patient/lib/app/app.dart:2653 — registro + +Conferi o texto contra a #158 (C-06), revisada em paralelo: lá o texto é "Ligar para a coordenação do piloto", "a pedido da coordenação do piloto". A expressão é a mesma, então as duas PRs juntas não divergem. O estado `escalated` não tem escritor hoje: escalonar mantém `pending`, pela #44. O comentário diz isso, e está certo trocar o "Encaminhado para o SAMU" antigo, que prometia o que o projeto não faz. Nada a mudar. + +--- + +## Inline 7 — apps/patient/lib/core/triage/self_assessment.dart:8 — registro + +Só para deixar escrito: a constante nasce aqui, mas hoje a árvore que produz o vermelho é a do backend (`TriageEngine`); a #161 (C-11, empilhada nesta) traz o motor para o aparelho e reaproveita `selfAssessmentEngineVersion`. A regra do comentário ("quem mudar as regras… sobe esta versão no mesmo commit") depende de disciplina enquanto não houver teste que a prenda; o teste de paridade da #161 é o lugar natural para isso. Nada a mudar aqui. + +--- + +## Geral — sugestão e registros + +**Sugestão: levar os três testes da revisão.** Escrevi em `apps/patient/test/call_192_test.dart` (worktree local, não commitado) e todos passam: + +1. `'a 200% de fonte, "Fechar esta orientação" continua visível e tocável'`: tela de 360×640 e `textScaleFactor` 2.0 aplicados depois do login, que fica fora do escopo. Rola até o botão de fechar e afirma que ele fica na tela, com 48dp ou mais de altura, que o toque fecha a orientação e que não há exceção de layout. **Verde.** +2. `'a orientação tem Semantics de cabeçalho e o botão de fechar tem rótulo'`: o título é `isHeader` e contém "Ligue 192"; o fechar tem rótulo "Fechar esta orientação", papel de botão e ação de toque. **Verde.** +3. `'a orientação e o fechar não fazem chamada nenhuma ao backend'`: um `_RecordingBackend extends FakePatientBackend` registra todos os 19 métodos de `PatientBackend`. Depois da orientação, do "Ligar 192" e do fechar, a lista de chamadas é a mesma de quando a avaliação voltou. **Verde.** + +Posso enviar o diff (cerca de 230 linhas) se quiser incluí-los. O terceiro prova o critério "não chama o backend" de forma mais forte que o `idempotencyKeys` vazio atual. + +**Registros:** + +- **Fora da PR, como declarado:** amarelo e verde ainda mostram "Risco: …" e prometem uma solicitação que não é enviada (C-08, #130). O ramo vermelho de `_TriageResult` ficou inalcançável e sem a promessa antiga. A retenção de 30 dias e "Apagar meus dados" da trilha são da C-10 (#131). +- **Não verificado no aparelho**, como a própria PR diz: a cifra do arquivo com a tabela nova, o voltar preditivo do Android 14+ com `PopScope` e o discador real. O `integration_test/full_journey_test.dart` foi ajustado e não roda na CI (o smoke do `android-e2e` não depende desses textos); não o rodei por falta de emulador. +- **`docs/telas-paciente.md:23`** ainda termina com "A confirmação de recebimento pela equipe aparece na aba Status". Pelo resto da PR seria "pelo agente". Fica junto com o refazer da captura. +- **Lado do agente:** o ACS e o backoffice continuam chamando o pedido de "alerta vermelho" / "Risco: Vermelho". Como a PR diz, a #127 não pede isso; deixo como issue para o dono decidir (abaixo). + +--- + +## Issues de continuação + +### Issue 1 — "Meus dados" do paciente: pedido de contato sem rótulo de risco (C-04/C-08, continuação) + +> Abrir só se o Inline 1 não for resolvido na própria PR #160. + +**Objetivo** +O histórico de "Meus dados" sempre mostrou "· Risco: Vermelho" ao lado do alerta; desde a C-04 (#127, PR #160) a linha diz "Pedido de contato · Risco: Vermelho", o que contradiz a própria C-04. Isso acontece porque o servidor grava `riskLevel = red` em todo pedido feito por `alerts.createRedAlert`. Para o participante, a linha diz que pedir contato o classificou como vermelho, que é o rótulo clínico que a C-04 tirou do Status e da aba Contato. + +**Critério de aceite** +- [ ] Em "Meus dados", uma entrada de origem `alert` mostra "Pedido de contato" e a data, sem "Risco:" e sem cor clínica. +- [ ] O teste de widget de "Meus dados" afirma a ausência de "Vermelho" para a origem `alert`. +- [ ] A origem `triage` segue a decisão da C-08 (#130). + +**Referências** +IDs: C-04, C-08, RF05, P-09 +Escopo: https://github.com/hbgit/SinalACS/blob/develop/spec/requisitos_piloto.md#inv-03-no-piloto +Origem: revisão da PR #160 + +### Issue 2 — Lado do agente e backoffice: "alerta vermelho" vira "pedido de contato" (decisão do dono) + +**Objetivo** +A C-04 (#127) mudou só o app do paciente. O app do ACS e o backoffice continuam chamando o pedido de contato de "alerta vermelho" e mostrando "Risco: Vermelho". O participante não vê esses textos, mas o agente participante vê, e a fila prioriza o pedido como risco máximo. Cabe ao dono decidir se o piloto renomeia isso, e como, sem mexer na entrega com ACK, na reserva HTTP e no escalonamento (INV-03). + +**Critério de aceite** +- [ ] Decisão registrada (manter ou renomear) em `docs/escopo/`. +- [ ] Se renomear: textos do ACS e do backoffice trocados, com testes de widget; nenhuma mudança em `alerts.*`, `AlertQueue` ou na semântica de ACK, reserva e escalonamento. + +**Referências** +IDs: C-04, P-09, INV-03, RF19 +Origem: revisão da PR #160 (seção "Fora deste PR" do corpo da PR) + +### Issue 3 — Refazer a captura `docs/screenshots/patient/01-emergencia.png` depois da C-04 + +**Objetivo** +A captura da aba Contato em `docs/telas-paciente.md` ainda mostra o botão circular "EMERGÊNCIA", de antes da C-04 (#127). A PR marcou a imagem como antiga. Falta refazê-la no emulador com dados sintéticos e incluir uma captura da orientação "Ligue 192 (SAMU) agora". + +**Critério de aceite** +- [ ] `01-emergencia.png` substituída pela aba Contato atual ("Ligar 192" acima de "Pedir contato ao agente"). +- [ ] Captura nova da orientação "Ligar 192", referenciada na seção "Triagem rápida". +- [ ] A frase "confirmação de recebimento pela equipe" passa a "pelo agente". +- [ ] Só dados sintéticos. + +**Referências** +IDs: C-04 +Origem: revisão da PR #160 diff --git a/docs/superpowers/plans/2026-11-13-pr-161-comentarios.md b/docs/superpowers/plans/2026-11-13-pr-161-comentarios.md new file mode 100644 index 00000000..93fe7c52 --- /dev/null +++ b/docs/superpowers/plans/2026-11-13-pr-161-comentarios.md @@ -0,0 +1,115 @@ +# PR #161 (C-11, autoavaliação local): parecer e comentários a publicar + +Textos da revisão da PR #161 (`feat/issue-132-autoavaliacao-local`, autor `vinimartinsufrr`, base `feat/issue-127-pedido-de-contato-192` — empilhada sobre a #160 —, commit `15fd57b`). Diff revisado: `gh pr diff 161` (só a C-11). Publicar só depois da aprovação do dono, com `gh pr review` (parecer) e `gh api repos/hbgit/SinalACS/pulls/161/comments` (inlines, um por chamada). Log: `pr161-verificacao.log` no scratchpad da sessão. + +Veredito proposto: **Comentar (pedidos antes do merge)** (`gh pr review --comment`). Não há bloqueante: o motor do aparelho é idêntico ao do backend nas 64 combinações e a paridade reprova com mutação dos dois lados. O pedido principal é um teste da **ligação** entre as respostas da tela e o motor, que hoje nenhum teste prende (mutação conferida abaixo). O segundo é tirar contagens de testes do `PROGRESS.md`. + +--- + +## Parecer + +Revisei a PR contra a issue #132, a INV-02 (determinismo da triagem, mesma entrada → mesmo resultado, nunca alterável) e a regra do escopo (pilar A sem conta e sem rede, RNF07/RNF09). Os três critérios de aceite estão atendidos: + +| Critério da #132 | Evidência | +|---|---| +| Sem login, o resultado é o mesmo do motor do backend nas 64 combinações | `backend/sinalacs_server/test/unit/self_assessment_parity_test.dart`: laço `mask` 0..63, comparação por `name` (não por índice) e `expect(seen, {'red','yellow','green'})` — dois motores constantes não passam. O segundo teste prende que os nomes de `SelfAssessmentLevel` e `RiskLevel` são os mesmos, o que protege o `RiskLevel.values.byName` da tela. A tela usa esse motor (`_evaluateOnDevice`, `apps/patient/lib/app/app.dart:1632`). | +| Nenhuma chamada de rede no pilar A | `apps/patient/test/local_self_assessment_test.dart`: `_NetworkSentinel` registra **qualquer** método de `PatientBackend` por `noSuchMethod` e lança; testes 1 e 3 afirmam a lista inalterada. `PatientBackend` é o único caminho de rede do app (`grep` por `HttpClient`/`http`/`WebSocket`/`mqtt` em `apps/patient/lib`: nada). | +| A paridade roda no CI a cada mudança de qualquer motor | `.github/workflows/ci.yml:121`: `dart test` sem filtro em `backend/sinalacs_server`, job `serverpod-backend` (check obrigatório), sem filtro de caminho (garantido por `ci_invariants.sh`). | + +**O que rodei em Linux** (worktree limpo da branch, `15fd57b`): + +- **Mutação 1, motor do app:** tirar `bleeding` do vermelho em `self_assessment.dart` → `dart test test/unit/self_assessment_parity_test.dart` reprova (exit 1) na **combinação 16**, `Expected: 'red' / Actual: 'green'`. Revertido com `git checkout --`. +- **Mutação 2, motor do backend:** tirar `persistentVomiting` do amarelo em `triage_engine.dart` → reprova na **combinação 8**. Revertido. A paridade pega mudança dos dois lados. +- **Mutação 3, ligação da tela:** em `_evaluateOnDevice`, passar a resposta de falta de ar no lugar da de dor no peito → `flutter test test/local_self_assessment_test.dart` **passa** (5/5). Revertido. Ver Inline 1. +- `dart test test/unit/self_assessment_parity_test.dart test/unit/triage_engine_test.dart`: `+11: All tests passed!`. +- `dart analyze` no backend: 98 issues, nenhuma nos arquivos da PR (o `ignore: avoid_relative_lib_imports` funciona). +- Paciente: `flutter analyze` só com o aviso `asset_directory_does_not_exist` de `assets/certs/` (diretório gitignorado, não é da PR); `flutter test` completo: `+355: All tests passed!`. +- `bash scripts/qa/check_documentation_links.sh`: só o `graphify-out` ausente em `AGENTS.md`, gitignorado, já assim antes. + +**Pontos que conferi e aprovo:** + +- `self_assessment.dart` é Dart puro, sem nenhum `import` (só `library;`), com a árvore idêntica à do `TriageEngine` linha a linha; o comentário explica por que não pode importar nada. +- No modo local, o único `BackendScope.of` do `_TriageScreenState` fica no ramo `false` do ternário; `Call192OrientationScreen` também não lê o `BackendScope` (só `Call192Scope`). Nada no modo local depende de servidor. +- Resultado local: o texto diz que nada foi enviado e o botão é "Concluir" (teste 2 afirma também a ausência de "solicitação" e "entrará em contato"); o vermelho abre a orientação "Ligar 192" da C-04, grava `call192OrientationShown` com `selfAssessmentEngineVersion` e recomeça do passo 1 sem guardar as respostas (teste 3). +- INV-02 na tela: nenhum caminho altera o resultado — `_risk` só é escrito com a saída do motor, não há campo editável, e o vermelho nunca vira cartão. +- O `ignore: avoid_relative_lib_imports` está justificado em comentário, e mover o arquivo do app quebra a compilação do teste (o job fica vermelho, não verde em silêncio). +- `AGENTS.md` e `apps/CLAUDE.md` registram a exceção à regra "sem regra de risco no cliente" e a obrigação de mudar os dois motores no mesmo PR com `selfAssessmentEngineVersion` novo. `spec/lgpd_design.md` corrige a frase que dizia que a autoavaliação era enviada ao servidor. +- Pilar B inalterado: o teste 5 prova que, com sessão, a triagem continua indo a `triage.evaluate`. + +**Pedidos (nesta PR):** teste da ligação respostas → motor (Inline 1); contagens fora do `PROGRESS.md` (Inline 2). + +**Sugestões (opcionais):** prender `selfAssessmentEngineVersion` à tabela das 64 saídas (Inline 4); frase "Classificação feita pelo protocolo da equipe de saúde" no modo local (Inline 5); dois comentários de `app.dart` que ficaram desatualizados (Geral). + +**Registros:** import relativo aprovado (Inline 3); o botão novo e os testes 2 e 5 precisam de ajuste quando a #156 e a #157 entrarem (Geral). + +--- + +## Inline 1 — apps/patient/lib/app/app.dart:1634 — pedido + +A paridade prova que o **motor** do aparelho é igual ao do backend, mas nada prova que a **tela** entrega a resposta certa a cada parâmetro. Conferi por mutação: trocando esta linha por `chestPain: _answers[TriageSymptom.difficultyBreathing] ?? false,`, a pessoa que responde só "dor no peito" recebe **verde** no modo local, e `test/local_self_assessment_test.dart` continua 5/5 verde. A amostra do teste 4 cobre só febre, vômitos e nenhum sinal; dor no peito, falta de ar e fraqueza nunca são respondidos sozinhos. + +Como a INV-02 agora depende também desta ligação, peço um teste que responda cada sinal sozinho (mais "nenhum"; hoje faltam dor no peito, falta de ar e fraqueza, que nenhum teste responde isolados) e compare a saída da tela com `SelfAssessmentEngine` — o vermelho aparece como `call_192_title`, amarelo e verde como o rótulo do cartão. São sete execuções curtas e pegam qualquer resposta perdida ou trocada de classe. Se quiser ir além, as 64 combinações com o motor como oráculo também cabem num `testWidgets`. + +--- + +## Inline 2 — PROGRESS.md:1950 — pedido + +O `CONTRIBUTING.md` pede para não gravar contagens de testes nos documentos ("elas envelhecem a cada PR"). Sugiro tirar "355 testes", "(5)" e "4 dos 5" desta linha e deixar as contagens só no corpo da PR, por exemplo: + +> - **Provas.** Paciente: `flutter analyze` sem avisos novos e suíte verde. `test/local_self_assessment_test.dart` usa um backend que registra **qualquer** método chamado: nenhum na autoavaliação local; forçar o modo remoto na tela reprova o teste. Backend: `dart analyze` sem issue nova; o teste de paridade e o `triage_engine_test.dart` verdes. + +--- + +## Inline 3 — backend/sinalacs_server/test/unit/self_assessment_parity_test.dart:20 — registro + +Aprovo o import relativo: é o que permite ao job `serverpod-backend` compilar o motor do app sem trazer Flutter para o backend, e o comentário acima justifica o `ignore`. Conferi as duas pontas por mutação: tirar `bleeding` do vermelho no app reprova na combinação 16, e tirar `persistentVomiting` do amarelo no backend reprova na combinação 8. Fica registrado que mover ou renomear `apps/patient/lib/core/triage/self_assessment.dart` quebra a compilação deste teste — é o comportamento desejado, e quem mover o arquivo atualiza este caminho no mesmo PR. + +--- + +## Inline 4 — backend/sinalacs_server/test/unit/self_assessment_parity_test.dart:60 — sugestão + +A paridade não pode pegar uma mudança feita **igual** nos dois motores (é para isso que ela existe), e é justamente nesse caso que `selfAssessmentEngineVersion` tem de subir — senão o evento local "Ligar 192" passa a dizer `arvore-v1` para uma regra que não é a v1. Uma forma barata de prender a versão, sem versão no backend: guardar a tabela das 64 saídas por versão e exigir que a versão corrente bata. + +```dart +// Cada versão publicada da árvore e as 64 saídas dela (máscara 0..63; r/y/g). +const _arvores = { + 'arvore-v1': 'grrryrrryrrryrrr' 'rrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrr', +}; + +test('a versão do motor corresponde à árvore em vigor', () { + final saidas = [ + for (var mask = 0; mask < 64; mask++) + const TriageEngine().evaluate(/* mesmos seis bits do laço acima */).name[0], + ].join(); + expect(_arvores[app.selfAssessmentEngineVersion], saidas, + reason: 'a árvore mudou: suba selfAssessmentEngineVersion e acrescente a linha nova'); +}); +``` + +Mudou a árvore sem subir a versão, o teste reprova; a troca da tabela fica visível no diff para quem revisa. + +--- + +## Inline 5 — apps/patient/lib/app/app.dart:1801 — sugestão + +No modo local esta frase continua aparecendo: "Classificação feita pelo protocolo da equipe de saúde." No pilar A não há equipe nem sessão, o projeto não tem vínculo com unidade de saúde, e o RF04 do piloto pede "nunca 'classificação de risco'". Como esta PR já troca a frase de orientação quando `local` é `true`, sugiro esconder esta também no modo local (ou trocar por algo como "Orientação educativa, calculada neste aparelho."). O texto final das saídas é da C-08 (#130); se preferir deixar para lá, basta citar esta frase na #130. + +--- + +## Geral — comentários desatualizados e convivência com a #156 e a #157 + +**Comentários em `app.dart` fora do diff (sugestão).** Dois comentários perto da tela ficaram desatualizados com a C-11 e podem enganar quem mexer na tela depois: + +- `app.dart:1554-1556`, no `enum TriageSymptom`: diz que calcular risco no cliente era "duas regras de risco no mesmo produto, o que viola o determinismo exigido pelo PRD (INV-02)". Agora existem dois motores por desenho, com paridade provada; vale citar a exceção e o teste de paridade. +- `app.dart:1579-1581`, em `_risk`: "Risco devolvido pelo servidor" e "Não existe cálculo de risco neste arquivo". No modo local o risco vem do aparelho. A segunda frase continua verdadeira (o cálculo está em `self_assessment.dart`), mas vale dizer de onde vem `_risk` em cada modo. + +**Convivência com a #156 e a #157 (registro, para quem fizer o rebase).** O botão "Autoavaliação (sem cadastro)" entra no mesmo bloco da tela de entrada em que a #156 acrescenta "Biblioteca de saúde (sem cadastro)" (`login_library_button`), e a #157 reescreve essa tela (convite QR + PIN): o bloco `if (_step == _LoginStep.credenciais) ...[...]` deixa de existir e vira `_camposDoConvite()` (sem credencial no aparelho) ou `_camposDoPin()` (com credencial). Para o botão sobreviver às duas: + +- Manter a chave `login_self_assessment_button` e colocar o botão **fora** das duas ramificações da #157, ao lado do botão da biblioteca, para aparecer com ou sem credencial: o pilar A não pode depender de conta, nem de lembrar o PIN (RNF07/RNF09). +- `test/local_self_assessment_test.dart` depende do login antigo: o teste 2 espera `cpf_field` depois de "Concluir" (linha 79), e o teste 5 entra por CPF + OTP (linhas 135–141). Com a #157 os dois precisam mudar — o 2 para uma chave que exista nas duas versões da entrada (por exemplo, a própria `login_self_assessment_button`), o 5 para o login por PIN. + +--- + +## Issues de continuação + +nenhuma diff --git a/docs/superpowers/plans/2026-11-13-pr-162-comentarios.md b/docs/superpowers/plans/2026-11-13-pr-162-comentarios.md new file mode 100644 index 00000000..9f3aa5a2 --- /dev/null +++ b/docs/superpowers/plans/2026-11-13-pr-162-comentarios.md @@ -0,0 +1,52 @@ +# PR #162 (#152, dataExtractionRules do ACS): parecer e comentários a publicar + +Veredito proposto: **Aprovar com observações** + +## Parecer + +Escopo: 3 arquivos, +64/−0. Reproduz no app do ACS a regra que o paciente já usa desde a #136. + +### Critério da issue → evidência + +| Critério da #152 | Evidência | +|---|---| +| `android:dataExtractionRules` e `android:fullBackupContent="false"` no `` | `apps/acs/android/app/src/main/AndroidManifest.xml` linhas 13-14; testes "fullBackupContent=\"false\"..." e "dataExtractionRules aponta para @xml/data_extraction_rules" em `apps/acs/test/android_manifest_test.dart` | +| Cinco domínios excluídos nas duas seções | `data_extraction_rules.xml`: `root`, `file`, `database`, `sharedpref`, `external` em `` e `` | +| Teste cobre atributos e regras e recusa `` | terceiro teste novo (regex por seção e por domínio; falha se houver ``; 14/14 no arquivo, suíte do ACS 816/816 e `flutter analyze` limpo. A única ressalva é a sugestão de registrar o roteiro `bmgr` para reaproveitar. + +## Issues de continuação + +nenhuma diff --git a/docs/superpowers/plans/2026-11-13-pr-163-comentarios.md b/docs/superpowers/plans/2026-11-13-pr-163-comentarios.md new file mode 100644 index 00000000..dc818528 --- /dev/null +++ b/docs/superpowers/plans/2026-11-13-pr-163-comentarios.md @@ -0,0 +1,176 @@ +# PR #163 (#151, `open_failed` ambíguo no ACS): parecer e comentários a publicar + +Textos da revisão da PR #163 (`fix/issue-151-open-failed-ambiguo`, autor `vinimartinsufrr`, base `develop`, commit `01985f1`). Publicar só depois da aprovação do dono, com `gh pr review` (parecer) e `gh api repos/hbgit/SinalACS/pulls/163/comments` (inlines, um por chamada). Plano: `2026-11-13-prs-156-163-revisao.md`, Task 4. + +Veredito proposto: **Aprovar com observações** (`gh pr review --approve`). Não há bloqueante. O teste pedido pela revisão sobre o `_persist` (a visita enviada não ressuscita) foi escrito e passa; o único pedido é tirar uma contagem de testes do `PROGRESS.md`. + +--- + +## Parecer + +Revisei a PR contra a issue #151, a decisão D2d do app do paciente (`docs/superpowers/plans/2026-11-03-issue-136-cifra-local-paciente.md`) e as decisões D1–D9 da fila por dono (`docs/superpowers/plans/2026-10-03-fila-de-visitas-por-dono-e-corrida-do-login.md`). Como a PR mexe em `offline_visit_queue.dart`, conferi em especial a regra do `CLAUDE.md`: a semântica de retentativa, fila e conflito tem de ser preservada. Ela é preservada. Além disso, a PR fecha uma perda de dado que já existia: com o `restore()` falho, o primeiro `save` apagava do disco as visitas que nunca tinham sido carregadas. + +| Critério da #151 | Evidência | +|---|---| +| Com a chave presente, um erro de abertura nunca move a fila de lado nem apaga a chave sem um sinal inequívoco | No diff, só três chamadas movem para `.recuperado` ou apagam a chave. (1) `sqlcipher_visit_store.dart:95`, `_moveAside`, guardada por `stored == null && arquivo existe`. Não há `delete` nesse ramo, e a chave nova só é criada depois de mover. (2) e (3) `:156` `_moveAside` e `:157` `_keyStore.delete()`, alcançadas só quando `kind == wrongKey && secondKind == wrongKey`, ou seja, código 26 ou "file is not a database" nas duas tentativas. Se mover falhar, o erro sobe antes do `delete`. O `delete` do `_destroyOnce` (`:241`) não foi alterado e só roda pela limpeza remota (#81) ou pelo "Limpar este aparelho" depois do `WipeBlocked`. | +| Teste que simula `open_failed` por E/S ou permissão e prova que a fila e a chave continuam intactas | `test/open_failed_ambiguity_test.dart`: "open_failed persistente (E/S ou permissão): falha fechada, fila e chave intactas" compara o arquivo byte a byte (`readAsBytes()` antes e depois), confere a chave e a ausência de `.recuperado`. No aparelho, `integration_test/encrypted_storage_test.dart` "#151: arquivo sem permissão…" faz `chmod 000` de verdade (não rodado aqui, ver Registros). | +| Decisão registrada em `apps/CLAUDE.md` e `PROGRESS.md` | O parágrafo do `database_key_store.dart` em `apps/CLAUDE.md` foi reescrito. No `PROGRESS.md` há a seção nova "`open_failed` ambíguo no app do ACS (#151)", e o item aberto da revisão de 2026-10-04 foi riscado. | + +**O que rodei em Linux** (Flutter estável, worktree limpo da branch, commit `01985f1`): + +- `flutter analyze` (ACS): só o aviso `asset_directory_does_not_exist` de `assets/certs/`, que é o diretório gitignorado; não vem desta PR. +- `flutter test test/open_failed_ambiguity_test.dart test/visit_storage_owner_test.dart`: 42 passam. +- `flutter test` completo (ACS): 822 passam em 8 min 47 s, inclusive `mqtt_tls_refused_test.dart`. Isso confirma que as falhas descritas no corpo da PR são do ambiente Windows. +- `bash scripts/qa/check_documentation_links.sh`: nada novo. O único "ausente" é `graphify-out`, em `AGENTS.md`, que já está assim em `develop`. +- **Teste escrito na revisão** (não commitado; o texto está no Inline 3): "visita enviada e apagada do disco nesta execução não ressuscita no próximo `_persist`". Disco com A e B; o `restore` falha; A entra pela RAM com o mesmo `localId` e nada é gravado; A sobe, e só então o `_persist` lê o disco e junta. Esperado: B volta para a fila, A não volta, e o disco fica só com B. **Passa** (`flutter test test/open_failed_ambiguity_test.dart`: `+11: All tests passed!`). + - Para conferir que o teste pega o defeito, tirei `_synced` do conjunto `known` em `_readUnreadDisk`: o teste reprova com `Expected ['B'], Actual ['A', 'B']`. + - Com a `offline_visit_queue.dart` da `develop`, ele reprova com `Expected ['B'], Actual []`, junto com "não grava por cima…" da PR, porque o `save` às cegas apaga B do disco. Isso confirma o "achado no caminho" que a PR descreve. +- CI: 9 de 9 verdes, inclusive `android-e2e`. + +**Pontos que conferi no código e aprovo:** + +- **Classificação** (`classifyDatabaseOpenError`): código 26 e "file is not a database" contam como `wrongKey`; `isOpenFailedError()` conta como `ambiguousOpenFailure`; todo o resto conta como `other`, que sobe na hora sem nova tentativa. Sinais mistos falham fechado: código 26 seguido de `open_failed` lança `VisitDatabaseOpenFailed`, e `open_failed` seguido de `other` relança o `other`. Há teste para os dois casos. +- **`SQLITE_NOTADB` nas duas tentativas** (ponto (b) do plano): a condição em `:129` exige os dois `wrongKey`, e a mecânica antiga (single-flight, cópia única, falha ao mover) continua exercitada pelo código 26 em `visit_storage_owner_test.dart`. +- **Fusão no `_persist`:** + - `known` junta pendentes, conflitos, recusadas e `_synced`, e é calculado **depois** do `await load()`, de modo que um `_applyOutcomes` concorrente já está refletido nele. + - A segunda checagem de `_diskUnread` evita juntar duas vezes. + - O `_sealed` é conferido de novo depois da leitura, o que preserva a #81. + - O `_applyOutcomes` refaz `_pending` como `stillPending + arrived`, e as visitas que vieram do disco durante um envio em voo entram em `arrived`; o C-1 de 2026-10-04 continua fechado. + - Conflitos e recusadas que vêm do disco voltam para as próprias listas, porque a separação é a mesma do `restore`. +- **`storage_error`** (ponto (d)): continua vindo só de `persistenceFailed` (`app.dart:1994`) e tem banner próprio, separado do banner do broker. `login_flow_test.dart` segue verde. +- **`VisitDatabaseOpenFailed` não é tratado como chave errada por ninguém** (ponto (e)): + - `DeferredFlushService` usa `_safe(...)`, que devolve `null`, e com `null` não revoga o token nem apaga nada. + - "Limpar este aparelho" (`care.wipe` → `wipeAllData` → `open()`) cai no `catch` genérico e mostra "não limpou". É o comportamento certo, porque o disco não lido pode ter visitas. + - A limpeza remota (`_eraseDevice` → `destroyAll` → `destroy`) não abre o banco, então é de fato a saída para uma chave presente e errada, como dizem a PR e o `apps/CLAUDE.md`. +- **Asserções alteradas em `visit_storage_owner_test.dart`** (ponto (c)): todas têm motivo no corpo da PR. + - Chave presente em vez de custódia vazia: com o arquivo existente, chave ausente agora é o sinal 1. + - Mecânica de recuperação pelo código 26: o `open_failed` não recupera mais. + - "`open_failed` duas vezes recupera" foi removido do laço e virou o oposto no arquivo novo. + - "não perde nada" passou a conferir o disco e a ordem `['sobrevive', 'em-campo']`. + - O laço "UMA vez" continua cobrindo o `open_failed`. + - Em `visit_pull_service_test.dart`, as duas custódias passaram a ser uma só, com o motivo escrito no comentário. + +**Pedidos (pequenos, nesta PR):** tirar a contagem "(10)" do `PROGRESS.md` (Inline 6). + +**Sugestões (opcionais):** +- O sinal 1, depois da #162 (Inline 1). +- Ler o disco não lido também no início do `sync` (Inline 3). +- Não deixar o caso `chmod 000` passar em silêncio (Inline 5). + +**Registros (só documentam):** +- O caso do emulador (`chmod 000`) não foi rodado nesta revisão: não havia emulador ligado. +- Custódia que devolve string vazia (Inline 4). +- A limpeza local falha fechada com o disco ilegível (Inline 2). + +--- + +## Inline 1 — apps/acs/lib/core/database/sqlcipher_visit_store.dart:94 — sugestão + +Sobre o sinal 1 ("chave comprovadamente ausente com o arquivo presente"): a PR #162 (em revisão) passa a excluir o banco e as SharedPreferences do ACS da transferência entre aparelhos e do backup. Depois dela, os cenários que o comentário cita (reinstalação com restauração, transferência entre aparelhos) deixam de trazer o arquivo. Restam casos raros: +- reinstalação com um backup antigo feito antes da #162; +- o Keystore apagado com os dados do app mantidos; +- e o caso que a própria PR lista em "Limites": uma custódia que devolve `null` ou vazio por defeito, sem lançar. Por exemplo, o `flutter_secure_storage` 9.x com `encryptedSharedPreferences`, que eu não verifiquei como se comporta quando a chave-mestra do Keystore some. + +Pergunta, não bloqueio: o sinal 1 ainda deve pôr a fila de lado na primeira leitura `null`? Concordo que falhar fechado aqui não ajuda: sem a chave, o arquivo é ilegível de qualquer jeito, e o app ficaria preso em RAM até a limpeza remota. Uma mitigação barata, no espírito da nova tentativa do `open_failed`, é ler a custódia **duas vezes**, com o mesmo `_retryDelay`, antes de mover. Assim, um `null` passageiro não custa a fila. Se ficar como está, sugiro atualizar o comentário e o `apps/CLAUDE.md` com os cenários que restam depois da #162. + +--- + +## Inline 2 — apps/acs/lib/core/database/sqlcipher_visit_store.dart:129 — registro + +Conferi as condições de cada chamada que move ou apaga: +- `:95` só roda com chave `null` e arquivo presente; +- `:156` e `:157` só rodam com `wrongKey` nas duas tentativas; +- o `delete` do `_destroyOnce` não foi alterado e só roda por limpeza. + +Com a chave presente e um `open_failed`, nenhum caminho toca no arquivo nem na chave. Isso vale também para o "Limpar este aparelho": ele abre o banco primeiro (`wipeAllData` → `open()`), recebe `VisitDatabaseOpenFailed` e mostra "não limpou". É o certo, porque o disco não lido pode ter visitas. A única saída sem reinstalar é mesmo a limpeza remota (`_eraseDevice` → `destroyAll`), que não abre o banco. Vale deixar isso explícito no nome do teste "saída para uma chave de fato perdida", que chama `db.destroy()` direto. + +--- + +## Inline 3 — apps/acs/lib/core/services/offline_visit_queue.dart:527 — sugestão + +A fusão está correta. Escrevi na revisão o teste abaixo, para o caso "a visita enviada não ressuscita", e ele passa. Ele reprova se `_synced` sair de `known` (`Expected ['B'], Actual ['A', 'B']`) e reprova com a fila da `develop` (`Expected ['B'], Actual []`). Fica à disposição para entrar em `test/open_failed_ambiguity_test.dart`, se quiser; usa os helpers que o arquivo já tem (`database`, `_openFailed`, `_visit`, `key`, `name`): + +```dart +test('visita enviada e apagada do disco nesta execução não ressuscita no próximo _persist', () async { + // Disco de uma execução anterior com A e B, gravado com a chave presente. + final storage = SqlCipherVisitStorage( + keyStore: InMemoryDatabaseKeyStore(initialKey: key), + databaseName: name, + allowUnencryptedForTesting: true, + ); + await storage.forOwner('acs-a').save([_visit('A'), _visit('B')]); + await storage.close(); + + final keys = InMemoryDatabaseKeyStore(initialKey: key); + // restore (2) + gravação do add (2): o disco segue ilegível até o envio. + final db = database([for (var i = 0; i < 4; i++) _openFailed()], keys: keys); + final store = SqlCipherVisitStore.on(db, owner: 'acs-a'); + final queue = OfflineVisitQueue( + store: store, + synchronizer: FakeVisitSynchronizer(statusFor: (v) => v.localId == 'A' ? 'synced' : 'error'), + ); + + await queue.restore(); + expect(queue.persistenceFailed, isTrue); + await queue.add(_visit('A')); // nada gravado: disco não lido + await queue.sync(); // A sobe; o _persist lê o disco agora e junta + + expect(queue.syncedVisits.map((v) => v.localId), contains('A')); + expect(queue.pendingVisits.map((v) => v.localId), ['B'], reason: 'B do disco volta; A não'); + expect((await store.load()).map((v) => v.localId), ['B'], reason: 'disco só com B'); + await db.close(); +}); +``` + +A sugestão é sobre o momento da leitura. Hoje `_readUnreadDisk` só roda numa **gravação**. Se o `restore` falhou e o ACS não registra nem resolve nada, as visitas que estão só no disco não entram na RAM. Nesse caso o "Sincronizar agora" devolve `empty`, porque `_syncOnce` olha só `_pending`, e o contador mostra 0 pendentes, mesmo depois de o banco voltar a abrir. Nada se perde, e a `develop` era pior: lá essas visitas eram apagadas. Mas o ACS recebe orientações contraditórias: o aviso `storage_error` continua aceso (`persistenceFailed` só apaga num `save` bem-sucedido) e diz "Sincronize antes de fechar o aplicativo", enquanto o "Sincronizar agora" responde que não há nada a enviar. Chamar `_readUnreadDisk()` no começo de `_syncOnce` (ignorando o `false`) faria essas visitas subirem assim que o banco abrir. Se preferir fora desta PR, propus uma issue de continuação. + +--- + +## Inline 4 — apps/acs/lib/core/security/database_key_store.dart:78 — registro + +`read()` trata uma string vazia como ausente, e então o sinal 1 põe a fila de lado. É coerente com o `readOrCreate`, que também trata vazio como "criar". O registro serve para lembrar que "ausente" aqui significa "`null` ou vazio, lido sem erro", e não uma prova de que a chave nunca existiu (ver o Inline 1). + +--- + +## Inline 5 — apps/acs/integration_test/encrypted_storage_test.dart:218 — sugestão + +Não rodei este caso: não havia emulador ligado. Ele também não entra no `android-e2e` da CI, só no `--full`. Sobre o desenho: se o `chmod` não existir ou for recusado, o teste chama `markTestSkipped` e a bateria `--full` fica verde sem ter provado nada. No Android, o `chmod` do toybox existe e o app é dono do próprio arquivo, então uma recusa aqui indicaria um problema do ambiente, que vale ver vermelho. Sugiro `fail(...)` em vez de pular, ou ao menos um `print` que apareça no relatório do `e2e.sh`. + +--- + +## Inline 6 — PROGRESS.md:1936 — pedido + +O `CONTRIBUTING.md` (linha 250) pede para não gravar contagens de testes nos documentos, porque elas envelhecem a cada PR. Peço trocar "`test/open_failed_ambiguity_test.dart` (10):" por "`test/open_failed_ambiguity_test.dart`:" e manter o número só no corpo da PR. + +--- + +## Geral — conferência da semântica da fila + +Conferi a regra do `CLAUDE.md` sobre `offline_visit_queue.dart` (retentativa, fila, conflito): +- **Retentativa:** `error` e falha de rede continuam pendentes. +- **Conflito:** sai da retentativa e é persistido com a cópia do servidor; com o disco não lido, um conflito antigo volta para `_conflicts` pela mesma separação do `restore`. +- **Recusada:** continua visível até o descarte explícito. +- **`_sealed`:** é conferido antes e depois da leitura do disco. + +A única mudança de comportamento é a pretendida: com o disco ilegível, nada é gravado, e a fila segue em RAM com o `storage_error` aceso. Obrigado também por ter achado e corrigido o `save` às cegas depois de um `restore()` falho. Era perda silenciosa de visita não enviada, e o teste antigo não a via porque olhava só a RAM. + +--- + +## Issues de continuação + +### Issue 1 — Fila do ACS: ler o disco não lido também ao sincronizar, não só ao gravar + +**Objetivo** + +Depois da #151 (PR #163), quando o `restore()` da fila falha, `OfflineVisitQueue` só lê o disco e junta com a RAM (`_readUnreadDisk`) na próxima **gravação**. Se o ACS não registra nem resolve nenhuma visita, as visitas que estão só no disco continuam fora da RAM. Nesse caso o "Sincronizar agora" devolve `empty` e o contador mostra 0 pendentes, mesmo depois de o banco voltar a abrir. Nada se perde (a fila não grava sobre o disco não lido), mas o ACS recebe orientações contraditórias: o aviso `storage_error` continua aceso (`persistenceFailed` só apaga num `save` bem-sucedido, `app.dart:1994`) e diz "Sincronize antes de fechar o aplicativo", enquanto o "Sincronizar agora" responde que não há nada a enviar e o contador mostra 0 pendentes. + +**Critério de aceite** + +- [ ] `_syncOnce` (ou um gatilho equivalente, como o retorno do app ao primeiro plano) tenta `_readUnreadDisk()` antes de montar o lote; se o disco continuar ilegível, segue como hoje. +- [ ] Teste: `restore` falho com uma visita no disco, o banco volta a abrir, e um `sync()` sem gravação anterior envia essa visita. +- [ ] A semântica de retentativa, fila e conflito continua a mesma (`CLAUDE.md`). + +**Referências** + +- `apps/acs/lib/core/services/offline_visit_queue.dart` (`_readUnreadDisk`, `_persist`, `_syncOnce`) +- PR #163, comentário inline em `offline_visit_queue.dart:527` diff --git a/docs/superpowers/plans/2026-11-13-prs-156-163-revisao.md b/docs/superpowers/plans/2026-11-13-prs-156-163-revisao.md new file mode 100644 index 00000000..d42bd626 --- /dev/null +++ b/docs/superpowers/plans/2026-11-13-prs-156-163-revisao.md @@ -0,0 +1,188 @@ +# PRs #156–#163 — Plano de Revisão e Comentário (em paralelo) + +> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking. As Tasks 1–9 são independentes entre si e devem ser despachadas em **ondas paralelas** (superpowers:dispatching-parallel-agents), no máximo 4 subagentes por onda; as Tasks 10 e 11 rodam depois, no orquestrador. + +**Goal:** Revisar as oito PRs abertas #156–#163 contra as issues e o escopo, redigir um parecer e comentários por PR, decidir a ordem de merge e publicar no GitHub depois do aval do dono. + +**Architecture:** Cada PR é uma task de revisão autocontida, executada por um subagente num worktree próprio da branch da PR, que verifica em Linux, lê o diff com uma lista fechada de pontos e escreve um arquivo de comentários num formato fixo. A #157 é grande (96 arquivos, backend + app + scripts) e se divide em duas tasks paralelas. Uma task de síntese junta os achados, mede os conflitos entre branches e propõe a ordem de merge. A publicação é sequencial, pelo orquestrador, só depois do checkpoint do dono. + +**Tech Stack:** `gh` (pr view/diff/review, `gh api` para inline), Flutter/Dart (`flutter test`, `flutter analyze`, `dart test`), `git worktree`, `git merge-tree --write-tree` (git 2.56), `bash scripts/qa/check_documentation_links.sh`. + +**Spec:** issues #126, #127, #128, #129, #132, #151, #152, #153 (critérios de aceite); corpos das PRs; `docs/escopo/mudancas-de-codigo-recomendadas.md` (linhas C-03, C-04, C-05, C-06, C-11); `spec/requisitos_piloto.md` (RF20, RF21, RF24, §INV-03 no piloto); `spec/escopo_projeto.md` (aviso educativo, P-07, P-09, P-10); `docs/superpowers/plans/2026-11-04-distribuicao-issues-pilot.md` (atribuição); o precedente `docs/superpowers/plans/2026-11-12-pr-155-comentarios.md` (formato dos comentários). + +## Levantamento já feito (não refazer) + +| PR | Issue | Autor | Base | Tamanho | Commits | Dependência / conflito | +|---|---|---|---|---|---|---| +| #156 C-03 biblioteca educativa | #126 (`Refs`, não `Closes`: P-07 aberta) | Rosialdo | `feat/c-02-aviso-educativo` (#155) | +1169/−1, 10 arq. | 1 | empilhada na #155; conflita com #160 e #157 em `apps/patient/lib/app/app.dart` | +| #157 C-05 convite QR + PIN | #128 | GuilhermeAlmeidadaLuz | `develop` | +15606/−1939, 96 arq. | 1 | conflita com **todas** as outras do paciente (#156, #158, #159, #160); migração nova `20261109144551146`; dep. nova `cryptography ^2.7.0` | +| #158 C-06 "UBS" → piloto | #129 | Rosialdo | `develop` | +44/−19, 13 arq. | 1 | conflita com #157; sem conflito com #160 | +| #159 permissão de notificação | #153 | vinimartinsufrr | `develop` | +186/−10, 11 arq. | 2 | conflita com #160 e #157 | +| #160 C-04 pedido de contato + 192 | #127 | vinimartinsufrr | `develop` | +1108/−152, 22 arq. | 3 | base da #161; conflita com #156, #159, #157; dep. nova `url_launcher` | +| #161 C-11 autoavaliação local | #132 | vinimartinsufrr | `feat/issue-127-pedido-de-contato-192` (#160) | +363/−14, 10 arq. | 3 | empilhada na #160; teste de paridade em `backend/.../test/unit`, que o job `serverpod-backend` roda por `dart test` | +| #162 ACS dataExtractionRules | #152 | Rosialdo | `develop` | +64/−0, 3 arq. | 1 | independente | +| #163 ACS open_failed ambíguo | #151 | vinimartinsufrr | `develop` | +566/−76, 9 arq. | 2 | independente de #162 (sem arquivo em comum) | + +Fatos comuns: CI 9/9 verde em todas (inclusive `android-e2e`); nenhuma review ou comentário ainda; nenhum commit com atribuição de IA; autores batem com a tabela A5 do plano de distribuição; nenhum emulador ligado nesta máquina (`adb devices` vazio; binário em `~/Android/Sdk/platform-tools/adb`). Na #157, `definition.sql` da migração nova ainda contém o trigger `sinalacs_audit_append_only`/`REVOKE` (7 ocorrências); `migration.json` não os cita (0), o que é esperado se a migração só acrescenta. + +Lições da revisão da #155 (reaproveitar): um worktree novo sem `assets/certs/` dá 1 warning de `flutter analyze` (`asset_directory_does_not_exist`) e sem `graphify-out/` dá 1 "link local ausente" em `AGENTS.md`; nenhum dos dois é da PR. `for` com `gh api` sob o hook RTK devolve exit 127: **um comentário por chamada**. A suíte do ACS leva ~8 min; a do paciente ~15 s. `mqtt_tls_refused_test.dart` passa em Linux (as PRs #158 e #163 citam a falha no Windows). + +## Global Constraints + +- Idioma: português em pareceres, comentários e issues. +- Nenhum comentário, commit ou PR leva atribuição de IA ("Generated with", "Co-Authored-By", "Claude"). +- Nada é publicado no GitHub antes do checkpoint do dono (Task 11); os subagentes revisores **nunca** chamam `gh pr review`, `gh pr comment`, `gh api ... /comments` nem `gh issue create`. +- Nenhum push na branch de autor; nenhum commit nos worktrees das PRs; nunca `git stash` (stack compartilhado). +- Dado sintético apenas; nenhum dado real de paciente em teste, log ou comentário. +- Regra do escopo (RNF07/RNF08): um achado não pode pedir dependência de unidade de saúde, sistema oficial ou serviço pago sem alternativa gratuita. +- Determinismo da triagem (INV-02) e "pedido enviado nunca some" (INV-03) são invioláveis: qualquer PR que os relaxe é **bloqueante**. +- Texto canônico do aviso educativo copiado literalmente (RF21); nenhum nome de protocolo clínico registrado como marca em texto de produto (M-05). +- Mudanças em `SyncFsm`/`offline_visit_queue.dart` preservam a semântica de retentativa, fila e conflito (`CLAUDE.md`). + +## Review Focus + +Condições que as PRs implicam e que os testes delas não exercem, cada uma atribuída a uma task: + +1. **Ordem de merge e conflitos em `app.dart` do paciente.** Cinco PRs tocam o mesmo arquivo; `git merge-tree` já mostra conflito entre #157 e todas, e entre #160 e #156/#159. Quem fizer merge na ordem errada vai resolver conflito em código de login/urgência. → Task 9. +2. **#157 remove o OTP como caminho de entrada** (`auth.requestOtp` recusa sem gateway; RF01 vira Futuro). A #158 muda o texto da "tela do código de acesso" e a #156/#161 acrescentam botões "sem cadastro" na tela de login que a #157 reescreve. Esperado: as três continuam fazendo sentido depois da #157, ou a síntese diz o que fica obsoleto. → Tasks 2, 6, 7b, 8 (notas) e 9 (síntese). +3. **Migração gerada da #157 contra o append-only da #82.** Uma migração do Serverpod pode recriar tabelas de auditoria e perder trigger/REVOKE montados à mão. Esperado: `migration.json` não toca `audit_logs`/`audit_exports`/`audit_chain_checkpoints`, e `definition.sql` preserva trigger e REVOKE. → Task 7a. +4. **#163 muda quando a fila do ACS vai para `.recuperado`** e altera `_persist` para fundir disco e RAM por `localId`. Esperado: uma visita já enviada e apagada do disco nesta execução não volta; uma visita só no disco não é apagada pela RAM; os 42/30 de `visit_storage_owner_test.dart` mudaram por motivo declarado. → Task 4. +5. **#160: orientação "Ligue 192" com `PopScope(canPop: false)`.** Esperado: leitor de tela anuncia a tela e encontra o botão "Fechar esta orientação"; a 200 % de fonte o botão continua alcançável; o botão "Ligar 192" abre o discador e nunca liga (`ACTION_DIAL`, sem `CALL_PHONE`). → Task 5. + +--- + +## Formato comum (todas as tasks de revisão) + +**Worktree:** `git fetch origin && git worktree add .worktrees/pr- origin/` a partir de `/home/rock/Documents/Dev/APPs/SinalACS`. Diff de revisão: `gh pr diff ` (já é contra a base declarada, inclusive nas empilhadas). + +**Saída (obrigatória):** `/home/rock/Documents/Dev/APPs/SinalACS/docs/superpowers/plans/2026-11-13-pr--comentarios.md`, com exatamente estas seções, no formato de `2026-11-12-pr-155-comentarios.md`: + +``` +# PR # (): parecer e comentários a publicar +Veredito proposto: **Aprovar com observações** | **Comentar (pedidos antes do merge)** | **Pedir mudanças (bloqueante)** +## Parecer + (tabela "critério da issue → evidência (arquivo:teste)", "O que rodei" com comandos e resultado, "Pontos que conferi e aprovo", "Pedidos", "Sugestões", "Registros") +## Inline N — : — bloqueante|pedido|sugestão|registro + (a linha tem de estar no diff da PR, lado RIGHT) +## Geral — ... +## Issues de continuação +### Issue N — + (corpo pronto para `gh issue create`; "nenhuma" se não houver) +``` + +**Log:** `/tmp/claude-1000/-home-rock-Documents-Dev-APPs-SinalACS/db87bd4e-f587-42f6-b307-c1e7658bb3fa/scratchpad/pr-verificacao.log` com cada comando e sua última linha. + +**Mínimo de verificação por task:** testes novos da PR; `flutter analyze` (ou `dart analyze`) do(s) app(s) tocado(s); suíte completa do(s) app(s) tocado(s); `bash scripts/qa/check_documentation_links.sh` quando a PR toca `.md`. Resultado esperado em cada uma: `All tests passed!` / `No issues found!` (descontando o warning de `assets/certs/` e o link `graphify-out`). + +**Fecho da task:** `git worktree remove .worktrees/pr-`; devolver ao orquestrador um resumo de ≤ 12 linhas: veredito, bloqueantes, pedidos, nº de inlines, issues propostas, o que não foi possível verificar. + +--- + +### Task 1: Revisar #162 (ACS dataExtractionRules, #152) — onda A + +**Files:** `apps/acs/android/app/src/main/res/xml/data_extraction_rules.xml`, `apps/acs/android/app/src/main/AndroidManifest.xml`, `apps/acs/test/android_manifest_test.dart`; referência: `apps/patient/android/app/src/main/res/xml/data_extraction_rules.xml`, `apps/patient/test/android_backup_manifest_test.dart`. + +- [ ] **Step 1: Verificação** — `cd apps/acs && flutter test test/android_manifest_test.dart` → 14 passam; `diff` do XML do ACS contra o do paciente → só o comentário de cabeçalho difere (ou nada). +- [ ] **Step 2: Critérios da #152** — os três atributos no ``; cinco domínios nas duas seções; teste cobre atributos e regras e recusa ``. +- [ ] **Step 3: Pontos fixos** — (a) a evidência com `bmgr` no corpo da PR é coerente (tabela "o que o Android mediu"); (b) `flutter_secure_storage` com `encryptedSharedPreferences` fica fora da transferência: registrar que isso é o desejado (a chave do Keystore não migra); (c) a suíte completa do ACS não foi rodada pelo autor: rodar aqui (`flutter test`, ~8 min) e registrar. +- [ ] **Step 4: Escrever o arquivo de comentários.** Veredito esperado: Aprovar com observações, sem inline se nada falhar. + +### Task 2: Revisar #158 (C-06 "UBS" → piloto, #129) — onda A + +**Files:** os 13 do diff; `docs/escopo/mudancas-de-codigo-recomendadas.md:20` (linha C-06 com as ocorrências listadas). + +- [ ] **Step 1: Verificação** — `flutter analyze` e `flutter test` nos três apps (paciente, ACS, admin); testes novos/alterados listados no corpo. +- [ ] **Step 2: Varredura residual** — nos três apps: `grep -rn "UBS\|unidade de saúde\|Unidade Básica" apps/*/lib --include=*.dart | grep -v "ubsId\|ubs\.\|Ubs[A-Z]\|legal_documents.dart"`. Esperado: nenhuma string visível; identificadores (`ubsId`, `UbsContact`) podem ficar (a issue diz que a tabela `ubs` não muda). Cada linha restante é um **pedido** com `arquivo:linha`. +- [ ] **Step 3: Conferir as linhas da C-06** — cada ocorrência citada na linha C-06 do doc de mudanças foi trocada (paciente `app.dart`, ACS `device_wiped_screen.dart`, admin `app.dart`, `admin_accounts.dart`, `audit_log_screen.dart`). +- [ ] **Step 4: Pontos fixos** — (a) "Ligar para a coordenação do piloto" (RF13): o telefone vem de `ubs.myContact`; confirmar que a mensagem "sem telefone cadastrado" também não diz "UBS"; (b) `escalation_ubs_test.dart` ganhou linhas: conferir que o nome do arquivo não é texto visível (ok manter); (c) Review Focus 2: a "tela do código de acesso" que a #158 edita existe depois da #157? Registrar como nota para a síntese, sem pedido; (d) `docs/telas-*.md` e `spec/` fora do escopo (só apps). +- [ ] **Step 5: Escrever o arquivo de comentários.** + +### Task 3: Revisar #159 (permissão de notificação na partida, #153) — onda A + +**Files:** `apps/patient/lib/main.dart`, `apps/patient/lib/core/reminders/reminder_scheduler.dart`, `apps/patient/lib/app/app.dart` (+4), `apps/patient/test/main_notification_permission_test.dart`, `docs/publicacao-google-play.md`, `PROGRESS.md`. + +- [ ] **Step 1: Verificação** — `cd apps/patient && flutter analyze && flutter test` → verde; `flutter test test/main_notification_permission_test.dart` isolado. +- [ ] **Step 2: Critérios da #153** — (1) `main.dart` não espera a permissão (ler o diff: o `await` saiu e o `runApp` vem antes de qualquer pedido); (2) recusa/adiamento não bloqueia tela (o pedido só nasce ao criar/editar/reativar lembrete, sem `await`); (3) teste com o canal pendente para sempre desenha o login. +- [ ] **Step 3: Pontos fixos** — (a) `requestPermission()` nunca lança (teste `reminder_scheduler_test`); (b) `rescheduleAll` do aquecimento não pede (teste `startup_warmup_test`); (c) quem atualiza com lembretes ativos só vê o diálogo ao mexer num lembrete: o `PROGRESS.md` registra; avaliar se merece issue (nota, não pedido); (d) o autor diz que `docs/publicacao-google-play.md` afirma que `POST_NOTIFICATIONS` não está no manifest, mas está: conferir `apps/patient/android/app/src/main/AndroidManifest.xml` e, se a frase ainda estiver errada no doc tocado pela PR, **pedido** de corrigir a frase na mesma PR (é uma linha); (e) sem emulador: registrar que a prova é só na VM, igual ao autor. +- [ ] **Step 4: Escrever o arquivo de comentários.** + +### Task 4: Revisar #163 (ACS open_failed ambíguo, #151) — onda A + +**Files:** `apps/acs/lib/core/database/sqlcipher_visit_store.dart`, `apps/acs/lib/core/services/offline_visit_queue.dart`, `apps/acs/lib/core/security/database_key_store.dart`, `apps/acs/test/open_failed_ambiguity_test.dart`, `apps/acs/test/visit_storage_owner_test.dart`, `apps/acs/integration_test/encrypted_storage_test.dart`, `apps/CLAUDE.md`, `PROGRESS.md`; contexto: `docs/superpowers/plans/2026-11-03-issue-136-cifra-local-paciente.md` (D2d) e `docs/superpowers/plans/2026-10-03-fila-de-visitas-por-dono-e-corrida-do-login.md` (D1–D9). + +- [ ] **Step 1: Verificação** — `cd apps/acs && flutter analyze && flutter test` (~8 min) → verde; `flutter test test/open_failed_ambiguity_test.dart test/visit_storage_owner_test.dart` isolados. +- [ ] **Step 2: Critérios da #151** — (1) com chave presente, nenhum caminho chama o que move para `.recuperado` nem `DatabaseKeyStore.delete`: listar no diff cada chamada dessas e a condição que a guarda; (2) teste de `open_failed` por E/S com arquivo comparado byte a byte; (3) decisão em `apps/CLAUDE.md` e `PROGRESS.md`. +- [ ] **Step 3: Review Focus 4 (`_persist` funde disco e RAM)** — escrever, se faltar, o teste `apps/acs/test/open_failed_ambiguity_test.dart::'visita enviada e apagada do disco nesta execução não ressuscita no próximo _persist'`: salva A e B, sincroniza A (removida de RAM e disco), simula abertura falha e depois boa, chama `_persist`; esperado: disco tem só B. Se o teste já existir com outro nome, apontar. Se não existir e o comportamento estiver errado, **bloqueante**. +- [ ] **Step 4: Pontos fixos** — (a) sinal 1 "chave ausente com arquivo presente": depois da #162 a transferência entre aparelhos não traz o arquivo; sobra reinstalação com `allowBackup=false` (improvável) e Keystore apagado; perguntar se o sinal ainda deve mover para `.recuperado` ou também falhar fechado (sugestão, não bloqueio); (b) `SQLITE_NOTADB` nas duas tentativas; (c) cada asserção alterada em `visit_storage_owner_test.dart` tem motivo no corpo da PR ou no commit; (d) `storage_error` continua separado do banner do broker; (e) `VisitDatabaseOpenFailed` não é tratado como chave errada por `DeferredFlushService` nem por `wipeAllData`; (f) o teste de emulador (`chmod 000`) não pôde rodar aqui: registrar. +- [ ] **Step 5: Escrever o arquivo de comentários.** + +### Task 5: Revisar #160 (C-04 pedido de contato + "Ligar 192", #127) — onda B + +**Files:** `apps/patient/lib/app/call_192.dart`, `apps/patient/lib/app/app.dart`, `apps/patient/lib/core/events/{local_event_log,sqflite_local_event_log}.dart`, `apps/patient/lib/core/storage/patient_local_database.dart` (v1→v2), `apps/patient/lib/core/services/emergency_dialer.dart`, `apps/patient/lib/core/triage/self_assessment.dart`, `apps/patient/android/app/src/main/AndroidManifest.xml`, `apps/patient/test/call_192_test.dart`, `apps/patient/test/events/sqflite_local_event_log_test.dart`, `apps/patient/integration_test/full_journey_test.dart`, `spec/lgpd_design.md` §0, `spec/requisitos_piloto.md` §INV-03, `spec/stack.md`, `docs/telas-paciente.md`, `apps/CLAUDE.md`, `PROGRESS.md`. + +- [ ] **Step 1: Verificação** — `cd apps/patient && flutter analyze && flutter test` → verde; `bash scripts/qa/check_documentation_links.sh`. +- [ ] **Step 2: Critérios da #127** — (1) "Ligar 192" acima do pedido (teste de ordem na aba); (2) orientação exige fechamento explícito e grava evento cifrado; (3) nenhum "Atendido" e nenhum "Risco:" em `lib/` (`grep -rn "Atendido\|Risco:" apps/patient/lib` → vazio fora de comentários); (4) testes de INV-03 inalterados (`git diff origin/develop..HEAD --stat -- apps/patient/test | grep -i inv\|alert`) e `alerts.createRedAlert` com a mesma chave de idempotência; a orientação não chama o backend (teste com backend que registra qualquer chamada). +- [ ] **Step 3: Review Focus 5** — escrever, se faltar, em `apps/patient/test/call_192_test.dart`: `'a 200% de fonte, "Fechar esta orientação" continua visível e tocável'` (physicalSize 360×640, textScaleFactor 2.0, `ensureVisible` + tap fecha) e `'a orientação tem Semantics de cabeçalho e o botão de fechar tem rótulo'`. Conferir no manifesto `` e ausência de `CALL_PHONE`. +- [ ] **Step 4: Pontos fixos** — (a) migração v1→v2 aditiva com teste que preserva lembretes/consentimento; (b) `local_events` guarda só tipo, instante UTC e versão do motor (nenhuma resposta); `deleteEverything()` apaga; (c) `selfAssessmentEngineVersion = 'arvore-v1'` nasce aqui e a #161 reaproveita; (d) rótulos de status: mapa servidor→texto sem promessa; "Repassado à coordenação do piloto" sem escritor hoje (registro); (e) `url_launcher` registrado em `spec/stack.md` e `pubspec.lock` do paciente passa a ser versionado (confirmar que é intencional, como o admin); (f) `PopScope(canPop:false)`: aceitar com o botão de fechar visível; (g) `docs/telas-paciente.md` I-10 sem captura inventada. +- [ ] **Step 5: Escrever o arquivo de comentários.** + +### Task 6: Revisar #161 (C-11 autoavaliação local, #132) — onda B + +**Files:** `apps/patient/lib/core/triage/self_assessment.dart` (`SelfAssessmentEngine`), `apps/patient/lib/app/app.dart` (`TriageScreen(local: true)`), `apps/patient/test/local_self_assessment_test.dart`, `backend/sinalacs_server/test/unit/self_assessment_parity_test.dart`, `AGENTS.md`, `apps/CLAUDE.md`, `spec/requisitos_piloto.md`, `spec/lgpd_design.md`, `docs/telas-paciente.md`, `PROGRESS.md`. Diff = `gh pr diff 161` (só a C-11; a base é a #160). + +- [ ] **Step 1: Verificação** — `cd apps/patient && flutter analyze && flutter test`; `cd backend/sinalacs_server && dart test test/unit/self_assessment_parity_test.dart test/unit/triage_engine_test.dart` → verde; mutação: trocar uma condição em `self_assessment.dart` (ex.: retirar `bleeding` do vermelho), rodar o teste de paridade → **falha** na combinação 16; reverter (`git checkout -- apps/patient/lib/core/triage/self_assessment.dart`). +- [ ] **Step 2: Critérios da #132** — (1) paridade nas 64 combinações por nome do nível, com as três saídas presentes; (2) nenhuma chamada de rede: o backend-espião do teste registra qualquer método; (3) o teste roda em `dart test` do job `serverpod-backend` (`.github/workflows/ci.yml:121`) em todo PR. +- [ ] **Step 3: Pontos fixos** — (a) `SelfAssessmentEngine` é Dart puro sem import (`head -5`); (b) a tela local nunca lê `BackendScope` (grep na classe); (c) resultado local diz que nada foi enviado e o botão é "Concluir"; vermelho abre a orientação da C-04 e grava o evento; (d) `ignore: avoid_relative_lib_imports` justificado em comentário; mover o arquivo quebra a compilação (registrar); (e) `AGENTS.md`/`apps/CLAUDE.md` registram a exceção à regra "sem regra de risco no cliente" e a obrigação de mudar os dois motores no mesmo PR com `selfAssessmentEngineVersion` novo; (f) INV-02: nenhum caminho da tela altera o resultado; (g) Review Focus 2: o botão "Autoavaliação (sem cadastro)" na tela de login sobrevive à #157? nota para a síntese. +- [ ] **Step 4: Escrever o arquivo de comentários.** + +### Task 7a: Revisar #157 — backend, migração, scripts e docs (C-05, #128) — onda B + +**Files:** `backend/sinalacs_server/migrations/20261109144551146/{migration.json,definition.sql}`, `backend/sinalacs_server/lib/src/application/auth/device_credential_service.dart`, `.../endpoints/auth_endpoint.dart` (`loginDevice`, `requestOtp`), `.../config/app_config.dart` (SMS opcional), `backend/sinalacs_server/test/integration/device_credential_login_test.dart`, `backend/sinalacs_client/lib/src/protocol/patient_device_credential.dart`, `scripts/qa/{otp_relay.py,otp_relay_test.py,lib_rele.sh,e2e_stack.sh,patient_full_e2e.sh,push_e2e.sh,…}`, `.env.example`, `backend/CLAUDE.md`, `spec/lgpd_data_audit.md`, `spec/stack.md`, `docs/escopo/*.md`, `AGENTS.md`, `PROGRESS.md`. + +- [ ] **Step 1: Verificação** — `cd backend/sinalacs_server && dart analyze | tail -1` (comparar o nº de infos com `develop`: 98) e `docker compose --profile test up -d postgres-test` na raiz e depois `cd backend/sinalacs_server && dart test -j 1` (unit + integração; `backend/CLAUDE.md:12-21`); se o Postgres de teste não subir, rodar `dart test test/unit` e registrar o que não rodou; `python3 -I scripts/qa/otp_relay_test.py` e `bash scripts/qa/lib_rele_test.sh`; `bash scripts/qa/check_documentation_links.sh`. +- [ ] **Step 2: Review Focus 3** — `grep -n "audit_logs\|audit_exports\|audit_chain_checkpoints" backend/sinalacs_server/migrations/20261109144551146/migration.json` → esperado vazio; `grep -c "sinalacs_audit_append_only\|REVOKE" .../definition.sql` → ≥ 7. Se `migration.json` recriar qualquer tabela de auditoria, **bloqueante**. +- [ ] **Step 3: Critérios da #128 (lado servidor)** — (1) `patient_device_credentials` criada na mesma transação do consumo do convite (convite de uso único: segundo consumo recusado, teste); (2) `loginDevice` emite JWT de 1 h com `device_id`; recusa credencial revogada/inexistente; (3) `SMS_GATEWAY` opcional fora de `development` e `requestOtp` recusa sem gateway (teste `device_credential_login_test.dart` sobe sem gateway); (4) `users.cpfHash` anulável (P-10) sem quebrar `cpf-hash-seed`; (5) RF09/RF10 fora (confirmar que nada de endereço entrou). +- [ ] **Step 4: Pontos fixos** — (a) `spec/lgpd_data_audit.md` classifica cada coluna da tabela nova (o `CLAUDE.md` raiz exige: contar as tabelas no `definition.sql` e atualizar o número); (b) o que o servidor guarda da credencial (hash? chave pública? segredo?) e se um vazamento do banco permite login: registrar a classe do segredo; (c) trilha de auditoria: login por credencial, consumo do convite e recusa escrevem em `audit_logs`?; (d) o relé deixa de servir o OTP do paciente: `patient_full_e2e.sh` e `push_e2e.sh` continuam coerentes (o `android-e2e` passou); (e) `spec/requisitos_piloto.md` RF01 → Futuro e RF24 Essencial: a PR muda a tabela? Se não, **pedido**; (f) `backend/CLAUDE.md` descreve `loginDevice` e a variável nova do `.env.example`; (g) C-12 (reemissão invalida a credencial anterior) fica fora, mas o modelo permite (coluna de revogação ou `ON DELETE`): registrar. +- [ ] **Step 5: Escrever `docs/superpowers/plans/2026-11-13-pr-157-comentarios.md` com o sufixo `## Parte A — backend` nos títulos das seções** (`## Parecer — Parte A`, `## Inline A1 …`). A Task 10 funde as partes. + +### Task 7b: Revisar #157 — app do paciente, PIN e criptografia (C-05, #128) — onda B + +**Files:** `apps/patient/lib/core/security/{device_credential_store,pin_envelope}.dart`, `apps/patient/lib/app/app.dart` (+515/−373: telas de acesso/PIN, sessão expirada → PIN), `apps/patient/test/device_login_test.dart` e os outros 20 testes tocados, `apps/patient/integration_test/*` (4), `apps/patient/pubspec.yaml` (`cryptography ^2.7.0`), `apps/patient/test/android_backup_manifest_test.dart` (se tocado). + +- [ ] **Step 1: Verificação** — `cd apps/patient && flutter analyze && flutter test` → verde; contar testes removidos/renomeados: `git diff origin/develop..HEAD --stat -- apps/patient/test` e listar cada arquivo com deleções > adições (cada um precisa de motivo no corpo da PR). +- [ ] **Step 2: Critérios da #128 (lado app)** — (1) nenhum campo de CPF, telefone ou e-mail no fluxo de login (teste de widget: `cpf_field`, `otp_code_field`, `birth_date_field` ausentes); (2) credencial no aparelho protegida pelo PIN e vinculada ao identificador pseudônimo; (3) sessão expirada → tela de PIN, não login completo. +- [ ] **Step 3: Criptografia (lista fechada)** — em `pin_envelope.dart`: Argon2id com parâmetros nomeados (memória, iterações, paralelismo) e **salt aleatório por aparelho** (16 B+); AES-GCM com **nonce aleatório de 12 B por cifra** e nunca reutilizado para a mesma chave; o segredo cifrado e o salt ficam em `flutter_secure_storage`, nunca em `shared_preferences`; o PIN nunca é gravado nem logado; política de PIN de 6+ dígitos com as proibições D3 da #136 (repetido, sequência, alternância) com teste; bloqueio 5 tentativas → 30 s dobrando até 15 min **no aparelho** (onde fica o contador? sobrevive a reiniciar o app? se só em RAM, **pedido**); `cryptography` é a única dependência nova e está em `spec/stack.md`. Para cada item, `arquivo:linha` ou "ausente". +- [ ] **Step 4: Pontos fixos** — (a) leitura do QR reaproveita `QrScannerScope`/`parseEnrollmentQr` (formato de 43 chars) ou muda o formato (se muda, `invite_screen.dart` do ACS acompanha?); (b) aceitação dos termos continua obrigatória no primeiro acesso; (c) a cifra local da #136 (`PatientLocalDatabase`) e o aviso `LocalProtectionNotice` continuam; (d) `android_backup_manifest_test.dart`: `shared_preferences` continua importado só por tema e aviso; (e) Review Focus 2: a tela de login nova mantém espaço para os botões "sem cadastro" da #156 e da #161 e o link "Sobre" da #155? listar o que a #157 apaga de `app.dart` que outra PR adiciona. +- [ ] **Step 5: Escrever a Parte B no mesmo arquivo da Task 7a** (`## Parecer — Parte B`, `## Inline B1 …`). Se o arquivo não existir ainda, criá-lo; a Task 10 ordena. + +### Task 8: Revisar #156 (C-03 biblioteca educativa, #126) — onda B + +**Files:** `apps/patient/assets/conteudo_educativo/{temas.json,LICENCA.md}`, `apps/patient/lib/core/education/educational_library.dart`, `apps/patient/lib/app/educational_library_screens.dart`, `apps/patient/lib/app/educational_notice_screens.dart` (seção "Licenças"), `apps/patient/lib/app/app.dart`, `apps/patient/test/educational_library_test.dart`, `apps/patient/integration_test/educational_library_test.dart`, `apps/patient/pubspec.yaml`, `PROGRESS.md`. Diff = `gh pr diff 156` (base `feat/c-02-aviso-educativo`). + +- [ ] **Step 1: Verificação** — `cd apps/patient && flutter analyze && flutter test` → verde; `flutter test test/educational_library_test.dart` isolado. +- [ ] **Step 2: Critérios da #126** — (1) sem conta e sem rede: botão no login e carga por `rootBundle`, nenhuma chamada de rede (teste com backend-espião ou ausência de `BackendScope`); (2) cada tema cita fonte MS ou BVS, validado em código (arquivo recusado se faltar); (3) `LICENCA.md` CC BY 4.0 com atribuição e "Sobre" com MIT + CC BY 4.0 (a `LICENSE` da raiz é MIT: conferir); (4) P-07 aberta: `Refs #126`, temas `rascunho` com selo "aguardando revisão" na tela; confirmar que a PR não fecha a issue. +- [ ] **Step 3: Conteúdo** — ler `temas.json` inteiro: português claro; nenhuma orientação que substitua atendimento; "ligue 192" onde couber; nenhum nome de protocolo registrado como marca (M-05); fontes `https` em `gov.br`/`bvsms.saude.gov.br` com data de consulta; "paráfrase com citação" e não cópia literal de terceiros. Qualquer afirmação clínica duvidosa vira **pedido** de revisão pelo preceptor (P-07), não correção pelo revisor. +- [ ] **Step 4: Pontos fixos** — (a) a lista mostra o aviso curto literal (`educationalNoticeShort`); (b) 200 % de fonte nas duas telas (teste); (c) o item "Biblioteca de saúde" no menu "Mais" e o botão no login têm `Key` e teste; (d) o JSON inválido não derruba o app (tela de erro amigável, teste); (e) Review Focus 2: o botão no login conflita com a #161 (mesma região) e com a #157 (tela reescrita): nota para a síntese; (f) `pubspec.yaml` registra só a pasta. +- [ ] **Step 5: Escrever o arquivo de comentários.** + +### Task 9: Síntese cruzada e ordem de merge — depois das ondas A e B + +**Files:** +- Read: os oito `docs/superpowers/plans/2026-11-13-pr--comentarios.md` +- Create: `docs/superpowers/plans/2026-11-13-prs-156-163-sintese.md` + +- [ ] **Step 1: Matriz de conflitos** — para cada par de branches (28 pares), `git merge-tree --write-tree origin/ origin/ >/dev/null 2>&1; echo $?` (0 = sem conflito). Esperado, pelo levantamento: #157 conflita com #156, #158, #159, #160; #160 com #156 e #159; o resto limpo. Tabela no arquivo. +- [ ] **Step 2: Ordem de merge proposta** — regra: pequenas e sem conflito primeiro, empilhadas logo depois da base, a #157 por último com rebase. Proposta inicial a validar com a matriz: `#162 → #163 → #158 → #159 → #155 → #156 → #160 → #161 → #157`. Para cada PR que vem depois de uma com conflito, uma linha "rebase sobre `develop` depois de #". +- [ ] **Step 3: Contradições entre PRs** (Review Focus 2) — listar, com as notas das Tasks 2, 6, 7b e 8: o que a #157 apaga na tela de login que #155/#156/#161 adicionaram; o texto da tela de OTP da #158 que deixa de existir; rótulo "coordenação do piloto" usado pela #160 e pela #158 (iguais?). Cada item vira um comentário geral na PR que precisa agir (normalmente a #157, por vir depois). +- [ ] **Step 4: Fundir as partes A e B da #157** num só arquivo com um único veredito (o mais restritivo das duas partes) e inlines renumerados. +- [ ] **Step 5: Tabela final** — PR, veredito, bloqueantes, pedidos, nº de inlines, issues a abrir; e um parágrafo para o dono com as decisões que são dele (ex.: aceitar "chave ausente" como sinal na #163; RF01 → Futuro na #157). + +### Task 10: Checkpoint do dono + +- [ ] **Step 1:** apresentar a tabela final da Task 9 e a ordem de merge; para cada PR, o veredito proposto. Esperar aprovação explícita, PR a PR (o dono pode aprovar umas e segurar outras). **Parar aqui sem resposta.** + +### Task 11: Publicação e registro (orquestrador, sequencial) + +- [ ] **Step 1: Por PR aprovada para publicação**, na ordem da Task 9: um `gh api repos/hbgit/SinalACS/pulls//comments -f commit_id=$(gh pr view --json headRefOid -q .headRefOid) -f path=… -F line=… -f side=RIGHT -f body="$(…)"` **por inline, em chamada própria** (nunca em `for`); depois `gh pr review -- --body-file `; depois `gh pr comment --body-file `. Esperado por PR: `gh api .../pulls//comments --jq length` = nº de inlines do arquivo; `gh pr view --json reviews --jq '.reviews[-1].state'` = o veredito. +- [ ] **Step 2: Issues de continuação aprovadas** — `gh issue create --title … --body-file … --milestone Pilot --label enhancement` (ou `bug`), uma por chamada; colar o número num comentário na PR de origem. +- [ ] **Step 3: Commit dos arquivos** na branch de trabalho do dono: `git add docs/superpowers/plans/2026-11-13-pr*-comentarios.md docs/superpowers/plans/2026-11-13-prs-156-163-{revisao,sintese}.md && git commit -m "docs(plano): revisão e comentários das PRs #156–#163"`; remover worktrees restantes (`git worktree list`); gravar na memória do agente o estado por PR (pedidos pendentes, ordem de merge). diff --git a/docs/superpowers/plans/2026-11-13-prs-156-163-sintese.md b/docs/superpowers/plans/2026-11-13-prs-156-163-sintese.md new file mode 100644 index 00000000..11206088 --- /dev/null +++ b/docs/superpowers/plans/2026-11-13-prs-156-163-sintese.md @@ -0,0 +1,146 @@ +# PRs #156–#163: síntese da revisão, conflitos e ordem de merge + +Síntese das oito revisões (`2026-11-13-pr--comentarios.md`; a #157 já fundida num arquivo só). Nada foi publicado no GitHub. Base medida: `origin/*` depois de `git fetch origin` em 2026-11-13, todas as branches com 0 commits atrás de `develop` e mesclagem limpa contra `develop`. + +| PR | Branch | Commit | Base | +|---|---|---|---| +| #155 (referência) | `feat/c-02-aviso-educativo` | `eb78c64` | `develop` | +| #156 | `feat/c-03-biblioteca-educativa` | `4b10e56` | #155 | +| #157 | `feat/issue-128-login-convite-pin` | `bfa5815` | `develop` | +| #158 | `chore/c-06-ubs-para-grupo-piloto` | `5595467` | `develop` | +| #159 | `fix/issue-153-permissao-notificacao` | `db1b330` | `develop` | +| #160 | `feat/issue-127-pedido-de-contato-192` | `16b33b2` | `develop` | +| #161 | `feat/issue-132-autoavaliacao-local` | `15fd57b` | #160 | +| #162 | `fix/acs-data-extraction-rules` | `5f0c654` | `develop` | +| #163 | `fix/issue-151-open-failed-ambiguo` | `01985f1` | `develop` | + +--- + +## 1. Matriz de conflitos + +Comando por par: `git merge-tree --write-tree origin/ origin/ >/dev/null 2>&1; echo $?` (git 2.56; 0 = sem conflito). Os arquivos vêm de `--name-only`. + +| | #156 | #157 | #158 | #159 | #160 | #161 | #162 | #163 | +|---|---|---|---|---|---|---|---|---| +| **#155** | ✓ (empilhada) | ✗ app.dart, PROGRESS | ✓ | ✗ PROGRESS | ✗ app.dart, PROGRESS | ✗ app.dart, PROGRESS | ✓ | ✗ PROGRESS | +| **#156** | | ✗ app.dart, PROGRESS | ✓ | ✗ PROGRESS | ✗ app.dart, PROGRESS | ✗ app.dart, PROGRESS | ✓ | ✗ PROGRESS | +| **#157** | | | ✗ app.dart | ✗ PROGRESS | ✗ app.dart, mvp_test, full_journey, PROGRESS | ✗ app.dart, mvp_test, full_journey, PROGRESS | ✓ | ✗ PROGRESS | +| **#158** | | | | ✓ | ✓ | ✓ | ✓ | ✓ | +| **#159** | | | | | ✗ PROGRESS | ✗ PROGRESS | ✓ | ✗ PROGRESS | +| **#160** | | | | | | ✓ (empilhada) | ✓ | ✗ PROGRESS | +| **#161** | | | | | | | ✓ | ✗ PROGRESS | +| **#162** | | | | | | | | ✓ | + +`app.dart` = `apps/patient/lib/app/app.dart`; `mvp_test` = `apps/patient/test/patient_app_mvp_test.dart`; `full_journey` = `apps/patient/integration_test/full_journey_test.dart`. + +**Totais:** entre as oito PRs revisadas, 15 de 28 pares conflitam; 6 em código e 9 só em `PROGRESS.md`. A #155 (base da #156) conflita com mais 5: #157, #160 e #161 em `app.dart` e `PROGRESS.md`; #159 e #163 só em `PROGRESS.md`. É por isso que a #155 rebaseia depois da #159 (§2). Os empilhados são limpos, como esperado: #156 × #155 = 0 e #161 × #160 = 0. + +**Tamanho dos conflitos de código** (blocos e linhas entre marcadores, no `app.dart`): #156×#157 4/91; #156×#160 5/60; #156×#161 6/86; #157×#158 1/12; #157×#160 5/45 (+1/7 em `full_journey`, +1/9 em `mvp_test`); #157×#161 6/88 (idem). Os conflitos de #156 e de #161 vêm em parte da base: #155 sozinha já conflita com #157, #160 e #161 em `app.dart`, e a #161 carrega a #160. + +**`PROGRESS.md`:** #156, #157, #159, #160, #161 e #163 acrescentam uma seção nova logo depois da linha 1924 de `develop`. O conflito é sempre o mesmo e se resolve mantendo as duas seções. Mesmo assim, cada uma dessas PRs precisa de rebase depois que a anterior entrar. A #158 e a #162 não tocam o `PROGRESS.md`. + +**Diferenças do levantamento inicial:** + +- Os conflitos só no `PROGRESS.md` não estavam previstos: a #163 conflita com cinco PRs, e a #159 com quatro. +- A #159 não conflita em `app.dart` com a #160 nem com a #157; só no `PROGRESS.md`. O "Geral — conflitos" do arquivo da #159 diz `app.dart` (ver §6). +- A #158 conflita com a #157 só em `app.dart`. O arquivo da #158 cita também `patient_app_mvp_test.dart`, que mescla limpo. + +**Quebras que o `merge-tree` não mostra.** Cinco PRs acrescentam arquivos de teste novos que entram pelo login por CPF/OTP (`cpf_field`/`otp_code_field`). A #157 remove esse login. Como os arquivos são novos, o merge sai limpo, mas a suíte quebra: + +- `apps/patient/test/educational_notice_test.dart:151` e `:155` (#155); +- `apps/patient/test/educational_library_test.dart:284` e `:288` (#156); +- `apps/patient/test/main_notification_permission_test.dart:68` (#159); +- `apps/patient/test/call_192_test.dart:55` e `:59` (#160); +- `apps/patient/test/local_self_assessment_test.dart:79`, `:135` e `:139` (#161). + +## 2. Ordem de merge proposta + +A matriz confirma a proposta inicial: + +**`#162 → #163 → #158 → #159 → #155 → #156 → #160 → #161 → #157`** + +| # | PR | Como entra | +|---|---|---| +| 1 | #162 | Direto: limpa com todas. Vem antes da #163 porque o sinal 1 da #163 ("chave ausente com arquivo presente") se apoia na exclusão de backup da #162 (#163, Inline 1). | +| 2 | #163 | Direto: limpa com `develop` + #162. | +| 3 | #158 | Direto: não toca `PROGRESS.md` e só conflita com a #157. | +| 4 | #159 | Rebase sobre `develop` depois de #163 (`PROGRESS.md`). | +| 5 | #155 | Rebase sobre `develop` depois de #159 (`PROGRESS.md`). | +| 6 | #156 | Mudar a base para `develop` quando a #155 entrar; rebase sobre `develop` depois de #155 (`PROGRESS.md`). | +| 7 | #160 | Rebase sobre `develop` depois de #156: `app.dart` (aninhar `EducationalNoticeGate` e `Call192Scope` em volta de `home:`) e `PROGRESS.md`. | +| 8 | #161 | Mudar a base para `develop` quando a #160 entrar; rebase sobre `develop` depois de #160: `app.dart` (o botão `login_self_assessment_button` ao lado do `login_library_button` da #156) e `PROGRESS.md`. | +| 9 | #157 | Rebase sobre `develop` depois de #161: `app.dart`, `patient_app_mvp_test.dart`, `full_journey_test.dart`, `PROGRESS.md`, mais os cinco testes que entram por CPF/OTP (§1) e o bloco comum da tela de login (#157, Inline 13). Entra por último também porque é a única com bloqueante. | + +**Se um autor atrasar:** + +- #159, #160 e #161 estão em "Comentar". Se a #159 não voltar a tempo, #155 e #156 podem passar à frente: não dependem dela, e o custo é só trocar quem rebaseia o `PROGRESS.md`. +- Um ajuste na #160 pede rebase da #161. +- A #157 só entra depois do bloqueante corrigido, qualquer que seja a posição. + +## 3. Contradições entre PRs + +Cada item diz em que PR o comentário cai. Na #157 eles entraram como "Geral — rebase sobre as PRs do paciente que entram antes desta". + +1. **Tela de login.** A #157 apaga o bloco `if (_step == _LoginStep.credenciais) ...[...]`, que é onde a #155 põe o `login_about_link` (e o `EducationalNoticeGate` em `home:`), a #156 o `login_library_button` e a #161 o `login_self_assessment_button`. + - Ação na #157: um bloco comum visível com e sem credencial (Inline 13 e item 2 do Geral). A #156 (Inline 7) e a #161 (Geral) já avisam do outro lado. +2. **Testes que entram por CPF/OTP.** São os cinco arquivos novos de #155, #156, #159, #160 e #161; a #157 tira esse login sem conflito textual. + - Ação na #157: item 1 do Geral. Achado desta síntese; só a revisão da #161 o tinha visto, para os próprios testes. +3. **Texto da tela de OTP (#158).** "Digite o código de 6 dígitos que você recebeu" deixa de existir, porque a #157 apaga a frase. Conflito de 12 linhas; fica a versão da #157. + - Ação na #157: item 4 do Geral. A #158 registra o mesmo. + - As trocas da #158 que tiram "UBS" desses textos do paciente ("A equipe da UBS analisa…" e "Avisos da UBS…", ainda com "UBS" na branch da #157) não conflitam e continuam valendo depois da #157. +4. **"Coordenação do piloto".** A #158 usa "Ligar para a coordenação do piloto" e "a pedido da coordenação do piloto"; a #160 usa "Repassado à coordenação do piloto". A expressão é a mesma. Sem contradição (conferido no diff das duas; a #160 registra isso no Inline 6). +5. **Permissão de notificação no cadastro (#159 × #157).** O pedido 1 da #159 põe o pedido de `POST_NOTIFICATIONS` "no cadastro, onde `_pushConsent` dispara `registerPushDevice`". Com a #157, esse ponto passa para `PinSetupScreen._concluir`. + - Ação na #157: item 5 do Geral. +6. **Escopos de `home:`.** `EducationalNoticeGate` (#155), `Call192Scope` (#160) e `DeviceCredentialScope` (#157) envolvem a mesma linha. Não se contradizem; aninhar os três. + - Resolve-se no rebase da #160 (dois escopos) e da #157 (três). +7. **Sinal "chave ausente" (#163 × #162).** É dependência, não contradição: a #163 fica mais segura com a #162 em `develop`, daí #162 → #163. +8. **Versão do motor (#160 × #161).** A #160 cria `selfAssessmentEngineVersion` e diz que o teste de paridade da #161 é o lugar de prendê-la (Inline 7); a #161 sugere exatamente isso (Inline 4). As duas apontam o mesmo caminho. +9. **Contagens de testes no `PROGRESS.md`.** O mesmo pedido aparece em #156, #157, #160, #161 e #163. É coerente com o `CONTRIBUTING.md`. + +## 4. Fusão da #157 + +As Partes A (servidor) e B (app) viraram `2026-11-13-pr-157-comentarios.md`, com veredito único **Pedir mudanças** (o mais restritivo: bloqueante A1), 17 inlines renumerados (A1–A8 → 1–8, B1–B9 → 9–17) e 3 issues (A1 → 1, B-1 → 2, B-2 → 3). Os arquivos `-A.md` e `-B.md` foram apagados. Os minors aplicados e as conferências estão no relatório da task. + +## 5. Tabela final + +| PR | Veredito | Bloqueantes | Pedidos | Inlines | Issues a abrir | +|---|---|---|---|---|---| +| #162 | Aprovar com observações | — | nenhum (sugestão: guardar o roteiro `bmgr`) | 0 | nenhuma | +| #163 | Aprovar com observações | — | tirar "(10)" do `PROGRESS.md` | 6 | "Fila do ACS: ler o disco não lido também ao sincronizar, não só ao gravar" | +| #158 | Aprovar com observações | — | ACS: mensagem do contato sem `contato.name`
ACS: strings "UBS" do backend chegam à tela (aqui ou na issue) | 3 | "Textos de erro do backend que citam 'UBS' chegam ao ACS (C-06)" (só se o pedido 1.2 não entrar) | +| #159 | Comentar | — | pedir `POST_NOTIFICATIONS` ao conceder os avisos (RF14), ou registrar o limite e abrir a issue
corrigir "o manifest não declara" em `docs/publicacao-google-play.md` (2 linhas) | 5 | "Paciente: pedir POST_NOTIFICATIONS fora dos lembretes (avisos RF14 e quem já tem lembretes)" (só se o pedido 1 não entrar) | +| #155 | (revisada antes; Aprovar com observações) | — | ver `2026-11-12-pr-155-comentarios.md` | — | — | +| #156 | Aprovar com observações | — | tirar contagens do `PROGRESS.md`
corrigir o nome do campo para `revisao.situacao`
teste a 200 % de fonte na lista e no tema
(aos preceptores, P-07: Inlines 8–9 e Geral) | 9 | "Revisão dos temas Dengue e Pressão alta pelos preceptores (P-07)" | +| #160 | Comentar | — | "Meus dados": "Pedido de contato" sem "Risco: Vermelho" (ou registrar e abrir a issue)
"Ligar 192" antes do parágrafo, a 200 % de fonte
tirar a contagem do `PROGRESS.md` | 7 | "'Meus dados' do paciente: pedido de contato sem rótulo de risco (C-04/C-08, continuação)" (condicional)
"Lado do agente e backoffice: 'alerta vermelho' vira 'pedido de contato' (decisão do dono)"
"Refazer a captura `docs/screenshots/patient/01-emergencia.png` depois da C-04" | +| #161 | Comentar | — | teste da ligação respostas da tela → motor (sinais isolados)
tirar contagens do `PROGRESS.md` | 5 | nenhuma | +| #157 | **Pedir mudanças** | anonimização da #42 não revoga `patient_device_credentials` (Inline 1) | guarda em `verifyOtp` sem gateway
validar o formato do `deviceSecret` no servidor
`acs_telemetria_e2e.sh` sem `/code`
C-12 descrita como existente (`.spy.yaml` e `lgpd_data_audit.md`)
`.env.example` velho
`PROGRESS.md` (estado e contagem)
teto do bloqueio de 16 min sem teste
PIN no `toString` da exceção
tela do PIN presa quando o `enroll` lança
credencial apagada por `denied_no_territory`
links da tela de login nos dois estados
rebase sobre as PRs do paciente (§3) | 17 | "Auditar a emissão da credencial de dispositivo do participante (C-05)"
"Medir o Argon2id do envelope do PIN em aparelho de entrada e tirá-lo da thread da UI"
"e2e: reentrar pelo PIN contra o backend real" | + +**Totais:** 52 inlines; 10 issues, 3 delas condicionais (#158, #159, #160-1). + +**Ordem de merge e rebases:** #162 (direto) → #163 (direto) → #158 (direto) → #159 (rebase depois de #163) → #155 (rebase depois de #159) → #156 (base → `develop`; rebase depois de #155) → #160 (rebase depois de #156) → #161 (base → `develop`; rebase depois de #160) → #157 (rebase depois de #161, com §3 itens 1, 2, 3, 5 e 6). + +### Decisões do dono + +Estas decisões a revisão não toma: + +- **#163.** Aceitar "chave comprovadamente ausente com o arquivo presente" como sinal inequívoco para pôr a fila de lado. A alternativa barata é ler a custódia duas vezes antes de mover (Inline 1). O risco residual é uma custódia que devolve `null` sem lançar. +- **#157, RF01 → Futuro.** A PR tira do app o login por CPF + OTP e deixa `requestOtp`/`verifyOtp` recusados sem `SMS_GATEWAY`. O `spec/requisitos_piloto.md` já diz isso em `develop`. O dono confirma que o piloto sai sem RF01 e que os testes de OTP removidos não voltam. +- **#157, escopo.** Quais pedidos entram nesta PR e quais viram issue. O Inline 12 (`denied_no_territory`) mexe no servidor e no app; o Inline 3 muda o contrato de `completeEnrollment`. +- **#156.** Publicar com os dois temas em `rascunho`, com selo na tela, enquanto a P-07 não define revisores, e só abrir a issue dos preceptores. O critério da issue proposta impede que uma versão com rascunho chegue a participantes sem decisão registrada. +- **#159.** Exigir nesta PR o pedido de permissão para os avisos (RF14) ou aceitar o limite registrado e abrir a issue. Sem isso, quem só consente com os avisos não os vê no Android 13+. +- **#160.** Se "Meus dados" perde o rótulo de risco agora ou na C-08. E se o ACS e o backoffice renomeiam "alerta vermelho" para "pedido de contato" (Issue 2, sem tocar a semântica da INV-03). +- **#158.** Se a #129 fecha com a exceção do `legal_documents.dart` ou só depois da #124. +- **Ordem.** Se #159, #160 ou #161 não voltarem a tempo, seguir a ordem pulando-as (§2) ou esperar. + +**Discordâncias com os vereditos:** nenhuma. Mantive os oito vereditos propostos. + +## 6. Inconsistências de formato nos arquivos (não corrigidas, exceto na #157) + +- **Atribuição de IA:** nenhuma. `grep -il "claude\|co-authored\|generated with"` acha só citações aos arquivos `CLAUDE.md`, `backend/CLAUDE.md` e `apps/CLAUDE.md` (#157, #161 e #163). Não há "Co-Authored-By" nem "Generated with". +- **`## Inline` com `path:linha`:** todos os 52 conferem. +- **#156:** os Inlines 8 e 9 usam o tipo "pedido (preceptores, P-07)", fora das quatro categorias. +- **#156, #160 e #163:** o corpo das issues usa `## Objetivo`, `## Critério de aceite` e `## Referências`. São títulos de nível 2 dentro de `### Issue N`, o que quebra a hierarquia do arquivo. Para o `gh issue create` é só o corpo, então não atrapalha. +- **#162:** falta a linha de cabeçalho (branch, base, commit, como publicar). O parecer usa subtítulos `###`. Tem 0 inlines (coerente: não há pedidos). +- **#160:** o título "PR #160 (C-04)" não tem o nome curto da mudança, ao contrário dos demais. +- **#159:** o "Geral — conflitos" diz que a PR conflita com a #160 e a #157 em `app.dart`. Pela matriz, o conflito é só no `PROGRESS.md`. Vale corrigir o texto antes de publicar. +- **#158:** o "Geral — conflito com a #157" cita também `patient_app_mvp_test.dart`. Pela matriz, esse arquivo mescla limpo; o conflito é só em `app.dart`.