Repository navigation
Feat/c 03 biblioteca educativa - #156
Conversation
…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.
| - **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). |
There was a problem hiding this comment.
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 analyzelimpo; suíte do paciente verde;integration_test/educational_library_test.dartpassou noemulator-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.
| **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". |
There was a problem hiding this comment.
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"emrevisao, comrevisoresedata, 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 { |
There was a problem hiding this comment.
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'}, |
There was a problem hiding this comment.
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'), |
There was a problem hiding this comment.
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}.', |
There was a problem hiding this comment.
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'), |
There was a problem hiding this comment.
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.", |
There was a problem hiding this comment.
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)", |
There was a problem hiding this comment.
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
left a comment
There was a problem hiding this comment.
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 testcompleto do paciente: todos passam.flutter analyze: só o avisoasset_directory_does_not_existdeassets/certs/(diretório gitignorado; não é desta PR).bash scripts/qa/check_documentation_links.sh: só ographify-outdeAGENTS.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, inclusiveandroid-e2e.
Pontos que conferi no código e aprovo:
- Offline por construção:
AssetEducationalLibrarySourcesó chamarootBundle.loadString; a lista e o tema não pegamBackendScopenem 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
FutureBuildere vira_LibraryError("Não foi possível abrir a biblioteca neste aparelho.", comliveRegion) e "Tentar de novo", que lê de novo (teste com_FailingSource). O..ignore()em_load()só cala o erro não tratado; oFutureBuildercontinua a recebê-lo. - A lista e o tema mostram
educationalNoticeShortpela constante da C-02, sem cópia do texto (RF21). pubspec.yamlregistra só a pastaassets/conteudo_educativo/.- Chaves e testes:
login_library_button(login) emore_library(menu "Mais") têmKeye 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
httpsemwww.gov.brebvsms.saude.gov.br, com data de consulta; aLICENCA.mddiz 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/outlinecomo cor (nenhum fill clínico), seções comSemantics(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.
|
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
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. |
…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.
[C-03] Biblioteca de conteúdo educativo offline (pilar A) — Refs #126
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
[A DEFINIR]. Por isso este PR usaRefs #126, e nãoCloses.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 (rascunhoourevisado).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.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:httpsno domínio do órgão;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 pastaassets/conteudo_educativo/.PROGRESS.md: registro da entrega e do que fica aberto.Como foi feito
liveRegion.Testes
Automáticos
flutter analyze: sem problemas.flutter test: 364/364 passando, 17 deles novos emtest/educational_library_test.dart:temas.jsonreal é válido e todo tema cita MS/BVS;LICENCA.mdtraz CC BY 4.0, o link da licença e a mesma atribuição mostrada no app;http, "revisado" sem revisores ou data, situação desconhecida, id repetido e JSON malformado;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.Para rodar:
O que fica aberto
temas.json"situacao": "rascunho"por"revisado", comrevisoresedata, e atualizar o teste "nenhum tema se declara revisado".url_launcher, e a biblioteca é offline.