Skip to content

chore(apps): troca "UBS" por grupo e coordenação do piloto (C-06, #129) - #158

Merged
hbgit merged 1 commit into
developfrom
chore/c-06-ubs-para-grupo-piloto
Nov 13, 2026
Merged

hbgit merged 1 commit into
developfrom
chore/c-06-ubs-para-grupo-piloto

Conversation

@Rosialdo

Copy link
Copy Markdown
Collaborator

Resumo

Troca a palavra "UBS" nos textos visíveis dos três apps (paciente, ACS e admin) por "grupo do piloto" ou "coordenação do piloto". O piloto não tem vínculo com unidade de saúde (D4): o que o modelo de dados chama de ubs é um grupo do piloto.

Closes #129 (C-06)

O que mudou

App do paciente

  • Diálogo "Solicitar exclusão dos seus dados": "A equipe da UBS analisa o pedido…" → "A coordenação do piloto analisa o pedido…"
  • Meus dados › consentimento de avisos: "Avisos da UBS para a sua microárea…" → "Avisos da coordenação do piloto para a sua microárea…"
  • Tela do código de acesso: "…enviado pela sua unidade de saúde." → "…que você recebeu." Não cita "UBS", mas afirma o mesmo vínculo que a C-06 quer retirar.

App do ACS

  • Tela de aparelho limpo: "a pedido da coordenação da UBS" e "Os alertas continuam com a equipe da UBS" → "coordenação do piloto"
  • Escalonamento: "Ligar para a UBS" → "Ligar para a coordenação do piloto". A mensagem de erro ao buscar o contato também mudou.

Backoffice (admin)

  • "Alertas da UBS" → "Alertas do grupo do piloto"
  • "Contadores por risco clínico da UBS" → "…do grupo do piloto"
  • Contas: "UBS: " → "Grupo do piloto: "
  • Formulário de ACS: "A UBS do ACS vem da microárea escolhida…" → "O grupo do piloto do ACS vem da microárea escolhida…"
  • Auditoria: a nota de escopo do coordenador agora diz "no seu grupo do piloto"
  • Modo de demonstração: o nome fictício "UBS Vila Nova" virou "Grupo Vila Nova"

Testes

  • Atualizados os testes que procuravam os textos antigos (alerts_screen_test, admin_home_shell_test, admin_mobile_smoke_test, remote_wipe_ui_test).
  • Novas verificações de que "UBS" não aparece:
    • no diálogo de exclusão do paciente;
    • nas telas de escalonamento e de aparelho limpo do ACS;
    • num teste novo do admin que percorre os seis destinos (Indicadores, Microáreas, Alertas, Auditoria, Pedidos do titular, Avisos).
  • flutter analyze sem apontamentos nos três apps.
  • Suítes inteiras: paciente 334/334 e admin 483/483.
  • ACS: os arquivos alterados passam (18/18). Na suíte completa, 2 testes de mqtt_tls_refused_test.dart falham neste ambiente Windows também sem esta mudança: é falha anterior a este PR.
  • Verificação manual no emulador (API 37) com o paciente sintético do seed: em "Meus dados" e no diálogo de exclusão aparece "coordenação do piloto", sem "UBS".

Critério de aceite

Fora do escopo

  • apps/patient/lib/core/legal/legal_documents.dart: texto legal com nova LegalVersion, fica com a [C-01] Texto legal do app do paciente: controlador, encarregado e aviso educativo #124.
  • Tabela ubs, campos ubsId/ubsName e o nome do seed "UBS Desenvolvimento": ficam com a C-06b (migração). Até lá, o admin local mostra "Grupo do piloto: UBS Desenvolvimento", que é dado do seed e não texto do app.
  • Botão de ligar do ACS: só foi renomeado aqui. A retirada, deixando só o 192, é da C-07.

O piloto não tem vínculo com unidade de saúde (D4): o que o modelo de
dados chama de `ubs` é um grupo do piloto. Esta mudança tira a palavra
"UBS" dos textos visíveis dos três apps e a substitui por "grupo do
piloto" ou "coordenação do piloto". A tabela `ubs`, os campos `ubsId`/
`ubsName` e o seed do backend não mudam aqui (C-06b).

Paciente:
- diálogo de exclusão: "A coordenação do piloto analisa o pedido...";
- consentimento de avisos: "Avisos da coordenação do piloto...";
- tela do código de acesso: "...que você recebeu." no lugar de
  "...enviado pela sua unidade de saúde.".

ACS:
- tela de aparelho limpo: "a pedido da coordenação do piloto" e "Os
  alertas continuam com a coordenação do piloto.";
- escalonamento: "Ligar para a coordenação do piloto" e a mensagem de
  erro do contato (a retirada do botão fica com a C-07).

Admin:
- "Alertas do grupo do piloto", "Contadores por risco clínico do grupo
  do piloto", "Grupo do piloto: <nome>" nas contas, aviso do formulário
  de ACS e nota de escopo da Auditoria;
- nome sintético do modo de demonstração: "Grupo Vila Nova".

Testes: atualizados os que procuravam os textos antigos e incluídas
asserções de que "UBS" não aparece (diálogo de exclusão do paciente,
telas do ACS e um teste novo que percorre os seis destinos do admin).

Fora do escopo: legal_documents.dart do paciente fica com a #124.
Comment thread apps/acs/lib/app/app.dart
aviso = falha.message;
} catch (_) {
aviso = 'Não foi possível obter o contato da UBS.';
aviso = 'Não foi possível obter o contato da coordenação do piloto.';

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

const Text(
'Os dados do SinalACS deste aparelho foram apagados a pedido da coordenação da UBS, '
'inclusive as visitas que ainda não tinham sido enviadas. Os alertas continuam com a equipe da UBS.',
'Os dados do SinalACS deste aparelho foram apagados a pedido da coordenação do piloto, '

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


/// UBS sintética das linhas criadas pelo mock (nenhuma UBS real).
static const _ubsSintetica = 'UBS Vila Nova';
static const _ubsSintetica = 'Grupo Vila Nova';

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

@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 #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.

@hbgit

hbgit commented Nov 13, 2026

Copy link
Copy Markdown
Owner

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.


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.

@hbgit
hbgit merged commit a152e6a into develop Nov 13, 2026
10 checks passed
@hbgit
hbgit deleted the chore/c-06-ubs-para-grupo-piloto branch November 13, 2026 13:12
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