Skip to content

Feat/c 03 biblioteca educativa - #156

Merged
hbgit merged 2 commits into
developfrom
feat/c-03-biblioteca-educativa
Nov 13, 2026
Merged

hbgit merged 2 commits into
developfrom
feat/c-03-biblioteca-educativa

Conversation

@Rosialdo

@Rosialdo Rosialdo commented Nov 9, 2026 •

Copy link
Copy Markdown
Collaborator

[C-03] Biblioteca de conteúdo educativo offline (pilar A) — Refs #126

Base deste PR: feat/c-02-aviso-educativo (#125). A seção "Licenças" entra na tela "Sobre", que a C-02 criou. Depois que a C-02 for mesclada em develop, a base deste PR passa a ser develop.

Resumo

O app do paciente ganhou uma Biblioteca de saúde que abre sem conta e sem internet. Cada tema cita a fonte (Ministério da Saúde ou BVS). O conteúdo vem com o aviso de licença CC BY 4.0 e a atribuição, e a tela "Sobre" mostra as duas licenças: código MIT e conteúdo CC BY 4.0.

Requisitos: RF20, RF22, RNF10. Decisão: P-07. Mudança recomendada: C-03 (docs/escopo/mudancas-de-codigo-recomendadas.md).

Critérios de aceite

  • Conteúdo disponível sem conta e sem rede.
  • Cada tema cita a fonte (Ministério da Saúde ou BVS).
  • A pasta do conteúdo traz o aviso de licença CC BY 4.0 com atribuição, e a tela "Sobre" indica código MIT e conteúdo CC BY 4.0.
  • Temas e revisores conforme a ação de P-07. Continua aberto: a lista de temas e revisores ainda está [A DEFINIR]. Por isso este PR usa Refs #126, e não Closes.

O que mudou

Conteúdo (apps/patient/assets/conteudo_educativo/)

  • temas.json: os temas da biblioteca, empacotados no APK. Cada tema tem título, resumo, seções, fontes e a situação da revisão (rascunho ou revisado).
  • LICENCA.md: licença CC BY 4.0 com o texto de atribuição. Separa a licença do conteúdo da licença do código (MIT) e diz que os textos são paráfrases com citação das fontes oficiais. O titular dos direitos ainda depende da P-01.
  • Dois temas-rascunho, parafraseados das páginas oficiais consultadas em 08/11/2026:
    • Dengue: Ministério da Saúde (Saúde de A a Z) e BVS (Dicas em Saúde).
    • Pressão alta (hipertensão): Ministério da Saúde (Saúde de A a Z).

Código

  • lib/core/education/educational_library.dart: modelo e leitura do conteúdo. As regras da P-07 são aplicadas pelo código, sem depender só de quem edita o arquivo. O arquivo inteiro é recusado se:
    • algum tema não cita fonte;
    • a fonte não é do Ministério da Saúde nem da BVS;
    • o endereço da fonte não é https no domínio do órgão;
    • um tema está marcado como "revisado" sem revisores ou sem data.
  • lib/app/educational_library_screens.dart: telas da lista de temas e do tema. A lista mostra o aviso educativo curto, o selo "Rascunho — aguardando revisão" nos temas não revisados e a licença no rodapé. O tema mostra as seções e as fontes (órgão, título, endereço e data da consulta).
  • lib/app/app.dart: botão "Biblioteca de saúde (sem cadastro)" na tela de login e item "Biblioteca de saúde" no menu "Mais".
  • lib/app/educational_notice_screens.dart: seção "Licenças" na tela "Sobre".
  • pubspec.yaml: registra a pasta assets/conteudo_educativo/.
  • PROGRESS.md: registro da entrega e do que fica aberto.

Como foi feito

  • Offline e sem cadastro por construção. O conteúdo é um asset do app, lido do próprio aparelho. A biblioteca não recebe o backend e não depende de sessão.
  • Fontes conferidas. Os endereços citados foram acessados antes de entrar no conteúdo, e o texto foi parafraseado do que as páginas dizem, sem acrescentar orientações de outras fontes.
  • Revisão visível. Enquanto a P-07 não definir os revisores, nenhum tema se declara revisado. O selo de rascunho aparece na lista e no tema, sempre com ícone e texto, sem depender só de cor.
  • Linguagem do escopo. O conteúdo não cita "UBS" (D4) nem marca de protocolo clínico (M-05). Orienta "procurar um serviço de saúde" e, em risco de vida, "ligue 192 (SAMU)".
  • Acessibilidade. Cores do tema, sem cor clínica; títulos de seção marcados como cabeçalho para leitor de tela; botões com área de toque de 48×52; mensagem de erro com liveRegion.

Testes

Automáticos

  • flutter analyze: sem problemas.
  • flutter test: 364/364 passando, 17 deles novos em test/educational_library_test.dart:
    • o temas.json real é válido e todo tema cita MS/BVS;
    • nenhum tema se declara revisado enquanto a P-07 estiver aberta;
    • o conteúdo não cita "UBS" nem marca de protocolo;
    • a LICENCA.md traz CC BY 4.0, o link da licença e a mesma atribuição mostrada no app;
    • o parser recusa: tema sem fonte, órgão não aceito, domínio errado, http, "revisado" sem revisores ou data, situação desconhecida, id repetido e JSON malformado;
    • a biblioteca abre pelo login sem nenhuma chamada ao backend (o teste usa um backend que recusa e registra qualquer chamada);
    • a biblioteca abre pelo menu "Mais" com sessão;
    • um tema revisado mostra os revisores e a data, sem o selo;
    • uma falha de leitura mostra o erro, e "Tentar de novo" lê de novo;
    • o "Sobre" mostra MIT, CC BY 4.0 e a atribuição.

No emulador (emulator-5554, API 37)

  • integration_test/educational_library_test.dart (hermético, sem stack): passou. Prova que o conteúdo está dentro do APK e que todos os temas mostram as fontes, sem chamar o backend.
  • Teste manual com o modo avião ligado, usando o APK de debug normal: aviso da primeira abertura (C-02) → login → "Biblioteca de saúde" → Dengue (selo, seções, as duas fontes, licença) → Pressão alta → "Sobre" com as duas licenças.
  • Também com fonte a 200% e no tema escuro: o layout se ajusta sem estourar.

Para rodar:

cd apps/patient
flutter analyze
flutter test test/educational_library_test.dart
flutter test integration_test/educational_library_test.dart -d emulator-5554

O que fica aberto

  • P-07: definir a lista de temas e os revisores (preceptores do PET-Saúde). Quando um tema for revisado, trocar no temas.json "situacao": "rascunho" por "revisado", com revisores e data, e atualizar o teste "nenhum tema se declara revisado".
  • P-01: confirmar o titular dos direitos citado na atribuição.
  • O endereço da fonte pode ser copiado, mas não abre o navegador: o app não tem url_launcher, e a biblioteca é offline.
  • Sem busca nem categorias por enquanto. Com poucos temas, não fazem falta.

…126)

Biblioteca de temas no app do paciente, empacotada no APK: abre sem conta e sem rede, pelo login e pelo menu Mais. Cada tema cita fonte do Ministério da Saúde ou da BVS, e o parser recusa tema sem fonte, de outro órgão ou fora do domínio. A pasta do conteúdo traz LICENCA.md (CC BY 4.0 com atribuição) e o Sobre mostra código MIT e conteúdo CC BY 4.0. Dois temas-rascunho (Dengue, Pressão alta) com selo de revisão pendente; temas e revisores dependem da P-07.
Comment thread PROGRESS.md
- **Testes.** `test/educational_library_test.dart` tem 17 casos. Cobre o asset real (todo tema cita MS/BVS, nenhum se diz revisado enquanto a P-07 estiver aberta, sem "UBS"), a `LICENCA.md` (CC BY 4.0, link e a mesma atribuição do app), as recusas do parser, a abertura pelo login com um backend que recusa e registra qualquer chamada (nenhuma acontece), a abertura pelo "Mais", o tema revisado, a falha de leitura com "Tentar de novo" e as licenças no "Sobre". `integration_test/educational_library_test.dart` é hermético e prova no aparelho que o asset está no APK e que todos os temas mostram as fontes.

**Abertos e limites.**
- Rodado em 2026-11-08 no Windows: `flutter analyze` limpo; paciente 364/364; `integration_test/educational_library_test.dart` passou no `emulator-5554` (API 37).

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread PROGRESS.md
**Abertos e limites.**
- Rodado em 2026-11-08 no Windows: `flutter analyze` limpo; paciente 364/364; `integration_test/educational_library_test.dart` passou no `emulator-5554` (API 37).
- Conferido no emulador com o **modo avião ligado** e o APK de debug normal: aviso da C-02 → login → "Biblioteca de saúde" → Dengue (selo, seções, duas fontes, licença) → Pressão alta → "Sobre" com as duas licenças. Também a 200% de fonte e no tema escuro, sem estouro.
- **Critério "Temas e revisores conforme a P-07" aberto.** A lista de temas e revisores segue `[A DEFINIR]`. Para publicar a revisão, trocar `revisao` para `revisado`, com revisores e data, e atualizar o teste "nenhum tema se declara revisado".

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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".

expect(find.byType(EducationalLibraryScreen), findsOneWidget);
});

testWidgets('"Sobre" indica código MIT e conteúdo CC BY 4.0', (tester) async {

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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:

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.


/// Órgãos aceitos como fonte (P-07) e os hosts que cada um publica.
const educationalSourceHosts = <String, Set<String>>{
'Ministério da Saúde': {'www.gov.br', 'gov.br', 'bvsms.saude.gov.br'},

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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/<outro órgão>/... 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ê.

organization: organization,
title: _text(raw, 'titulo', '$where.fonte'),
url: url,
consultedOn: _text(raw, 'consultadoEm', '$where.fonte'),

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

const SizedBox(height: 16),
] else ...[
Text(
'Revisado por ${topic.review.reviewers.join(', ')} em ${topic.review.date}.',

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

SizedBox(
width: double.infinity,
child: OutlinedButton.icon(
key: const Key('login_library_button'),

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

"titulo": "Como evitar",
"paragrafos": [
"O mosquito nasce em água parada. Tire a água de latas, pneus, vasos e outros recipientes, tampe a caixa d'água e mantenha calhas, lajes e ralos sem entupimento.",
"Telas nas janelas e repelente ajudam onde há transmissão. O risco é maior entre outubro e maio.",

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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?

},
{
"orgao": "Biblioteca Virtual em Saúde (BVS)",
"titulo": "Dengue — Dicas em Saúde (novembro de 2007)",

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@hbgit hbgit left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@hbgit

hbgit commented Nov 13, 2026

Copy link
Copy Markdown
Owner

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.


Continuação: #166.

Base automatically changed from feat/c-02-aviso-educativo to develop November 13, 2026 13:59
Mantém as seções novas do PROGRESS.md (#126 depois da #125, antes de #153 e #151).
@hbgit
hbgit merged commit ab0f592 into develop Nov 13, 2026
10 checks passed
@hbgit
hbgit deleted the feat/c-03-biblioteca-educativa branch November 13, 2026 14:21
hbgit pushed a commit that referenced this pull request Nov 19, 2026
…vo (#128)

RF24/C-05: o participante entra por convite de uso único e PIN local de
6+ dígitos (Argon2id + AES-GCM), sem e-mail/CPF/telefone; o servidor cria
`patient_device_credentials` na mesma transação do consumo do convite e
`auth.loginDevice` emite a sessão (JWT 1h com device_id). `SMS_GATEWAY`
virou opcional fora de development (perfil do piloto) e `auth.requestOtp`
recusa sem gateway (RF01 vira Futuro). `users.cpfHash` anulável (P-10).

Backend: modelo novo + migração 20261109144551146 (audit append-only),
DeviceCredentialService/OrmDeviceCredentialStore, boot piloto sem SMS.
App: política de PIN (bloqueio 5 tentativas → 30s dobrando até 15min),
envelope, store de credencial, telas de acesso/PIN; sessão expirada → PIN.
E2e: seed gera 6 convites/paciente no manifesto; relé deixa de servir o
OTP do paciente (só credenciais de ACS/staff).

Revisão: a exclusão atendida (#42) revoga a credencial de dispositivo e
apaga convites pendentes na mesma transação; `auth.verifyOtp` recusa sem
gateway (era StateError/500); `deviceSecret` é validado no servidor (43
caracteres base64url) no onboarding e no login; falta de microárea vira
`DeviceCredentialTerritoryException` e o app não descarta mais a
credencial local; PIN fora do `toString`/`ArgumentError`; catch-all nas
telas de PIN (não ficam presas quando o Keystore lança); link legal nos
dois estados da tela de acesso; teto do bloqueio limitado pelo prazo
(15 min) com teste da progressão; `telemetry_e2e` entra pelo convite do
manifesto. Docs: C-12 como pendente, `.env.example`, `PROGRESS.md`,
`spec/stack.md` e residual do bloqueio por relógio de parede. As fixtures
de `deviceSecret` usam literais de baixa entropia de propósito: o base64url
sintético de 43 caracteres disparava o scanner de segredos como falso
positivo.

Correção de CI: a leitura do PEM/CRL no openssl_device_ca agora completa
antes do finally apagar o diretório temp — corrida que dava
PathNotFoundException intermitente no job coverage-report (segunda
emissão do certificado do aparelho, #94; o SDK local já marcava os dois
pontos com unawaited_return_in_try_block).

Rebase sobre develop (depois de #155, #156, #160 e #161): escopos
aninhados DeviceCredentialScope → Call192Scope → EducationalNoticeGate;
biblioteca, autoavaliação e "Sobre" no bloco comum da tela inicial
(_linksDaTelaInicial), visível com e sem credencial; o amarelo da C-04 em
patient_app_mvp_test e a aba "Contato" na jornada e2e. Os testes novos das
PRs do paciente que entravam por CPF/OTP (call_192, educational_notice,
educational_library, local_self_assessment, main_notification_permission)
passam a entrar pelo PIN, com enrolledCredentialStore()/loginWithPin em
test/support/fake_device_credential_store.dart.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants