Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ Não violar estes pontos sob qualquer hipótese:
- Ambos usam o cliente gerado `sinalacs_client` por dependência local e não devem depender diretamente de detalhes de implementação do servidor em widgets.
- O app ACS é o mais crítico em termos de offline-first e sincronização: guarda visitas locais, tenta sincronizar em fila e trata conflitos sem perder registros.
- O tema visual é dark mode, com foco em legibilidade e uso de cor restrito a sinal clínico (vermelho, amarelo, verde).
- O app do paciente não deve reintroduzir regras de risco no cliente; a classificação deve vir do backend via `triage.evaluate`.
- O app do paciente não deve reintroduzir regras de risco no cliente, com **uma** exceção (C-11, #132): no pilar A, sem login, a autoavaliação roda no aparelho por `SelfAssessmentEngine` (`apps/patient/lib/core/triage/self_assessment.dart`), cópia da árvore do `TriageEngine`. A INV-02 passa a depender das duas serem iguais, e `backend/sinalacs_server/test/unit/self_assessment_parity_test.dart` as compara nas 64 combinações em todo PR (job `serverpod-backend`). Mudou um motor, mude o outro no mesmo PR e suba `selfAssessmentEngineVersion`. Com sessão (pilar B), a classificação continua vindo do backend via `triage.evaluate`.
- [apps/admin](apps/admin) (`sinalacs_admin`) é o backoffice administrativo — deixou de ser um esqueleto de pubspec e hoje é um app navegável real, com 4 telas somente leitura (Indicadores, Microáreas, Alertas, Auditoria) atrás de `AdminHomeShell`. Ainda não consome `sinalacs_client`: usa a interface `AdminDataSource`, hoje implementada só por `MockAdminDataSource`, seguindo o mesmo padrão de DI de `PatientBackend`/`AcsBackend`. O login é local e não chama `auth.developmentLogin` (o backend só aceita `role: 'patient'`/`role: 'acs'` hoje). Toda tela que exibe dado sensível registra o próprio acesso via `recordAccess()` antes de renderizar, por exigência de auditoria do PRD §4.2.2. É o único dos três apps com suporte a Flutter Web, e desde a adição da plataforma Android também roda em celular e tablet (`flutter run -d emulator-5554`). O layout segue desktop-first: os pontos de quebra ficam em `lib/app/admin_layout.dart` e o layout compacto é complemento, nunca substituição — os dez testes de widget originais continuam passando sem edição, o que é o que prova isso.

### Infraestrutura local
Expand Down
9 changes: 9 additions & 0 deletions PROGRESS.md
Original file line number Diff line number Diff line change
Expand Up @@ -1941,6 +1941,15 @@ Branch `feat/issue-127-pedido-de-contato-192`. Pré-requisito do portão do pilo
- **Lado do agente e backend:** o ACS e o backoffice continuam chamando o pedido de alerta vermelho ("Risco: Vermelho"). A issue não pediu mudança lá; fica para decisão do dono.
- **Captura de tela** `docs/screenshots/patient/01-emergencia.png` é anterior à C-04.

## Autoavaliação local no pilar A (C-11, #132) — 2026-11-10

Branch `feat/issue-132-autoavaliacao-local`, **empilhada sobre a #127** (o vermelho local precisa da orientação "Ligar 192"; sem ela apareceria a promessa antiga "Sua equipe de saúde foi avisada").

- **O que mudou.** A tela de entrada ganhou **Autoavaliação (sem cadastro)** (`LocalSelfAssessmentScreen`), que roda a árvore no aparelho por `SelfAssessmentEngine` (`apps/patient/lib/core/triage/self_assessment.dart`, Dart puro sem import): sem `accessToken`, sem rede, sem `triage_sessions`, sem gravar as respostas. O resultado local diz que nada foi enviado e troca "Acompanhar solicitação" por "Concluir"; o vermelho abre a orientação "Ligar 192" e grava o evento local (C-04). Com sessão (pilar B), nada muda: `triage.evaluate`. Backend sem mudança.
- **Paridade (INV-02 com dois motores).** `backend/sinalacs_server/test/unit/self_assessment_parity_test.dart` importa o motor do app por caminho relativo e o compara com o `TriageEngine` nas 64 combinações, por nome do nível, e exige que as três saídas apareçam. Roda no `dart test` do job `serverpod-backend` (check obrigatório) em **todo** PR — o workflow não tem filtro de caminho, garantido por `ci_invariants.sh` —, seja qual for o motor alterado. Mutação conferida: tirar `bleeding` do vermelho do app reprova na combinação 16. Mover o arquivo do app quebra a compilação do teste, em vez de desligá-lo em silêncio.
- **Provas.** Paciente: `flutter analyze` sem avisos, 355 testes. `test/local_self_assessment_test.dart` (5) usa um backend que registra **qualquer** método chamado: nenhum na autoavaliação local; forçar o modo remoto na tela reprova 4 dos 5. Backend: `dart analyze` sem issue nova; o teste de paridade e o `triage_engine_test.dart` verdes.

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

- **Limites.** A regra de "mudou um motor, mude o outro e suba `selfAssessmentEngineVersion`" está documentada (`AGENTS.md`, `apps/CLAUDE.md`) e a paridade é testada, mas a versão não é: o backend não tem versão do motor. Os textos das três saídas seguem os antigos ("Risco: …") até a C-08 (#130). Não verificado no aparelho.

## Aviso educativo na primeira abertura e em "Sobre" (C-02, #125) — 2026-11-08

Branch `feat/c-02-aviso-educativo`. RF21 nos apps do paciente e do agente.
Expand Down
2 changes: 1 addition & 1 deletion apps/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ The onboarding QR (RF02) now exists on both sides: the ACS's "Mais › Convidar

The UI depends on the interface, never on the generated `Client`, which is what keeps the widget tests hermetic; the live path is checked by `tool/live_check.dart` in each app and by `integration_test/`.

Risk classification now comes **only** from `triage.evaluate`: the patient app's client-side string-matching rule is gone, and its triage form asks the six symptoms the server's engine actually takes. The ACS dashboard is fed by `AlertQueue`, which receives alerts over MQTT and orders them deterministically by risk and then by age; it rejects alerts from another micro-area and de-duplicates re-deliveries (QoS 1 is at-least-once).
Risk classification in the patient app comes from `triage.evaluate` when there is a session (pilar B): the old client-side string-matching rule is gone, and the triage form asks the six symptoms the server's engine actually takes. **Only exception, C-11 (#132):** without login (pilar A) the self-assessment runs on the device — `LocalSelfAssessmentScreen` (login screen button `login_self_assessment_button`) mounts `TriageScreen(local: true)`, which calls `SelfAssessmentEngine` (`lib/core/triage/self_assessment.dart`, pure Dart with **no imports**, translated to `RiskLevel` by name), never reads `BackendScope`, sends nothing and writes nothing to `triage_sessions`; its result says nothing was sent ("Concluir" instead of "Acompanhar solicitação"), and red still opens the "Ligar 192" orientation (C-04). Two implementations of one closed tree: `backend/sinalacs_server/test/unit/self_assessment_parity_test.dart` imports the app file by relative path and compares it with `TriageEngine` over the 64 combinations, in the `serverpod-backend` job of every PR — change both engines in the same PR and bump `selfAssessmentEngineVersion`. `test/local_self_assessment_test.dart` proves the no-network path with a backend that records any call. The ACS dashboard is fed by `AlertQueue`, which receives alerts over MQTT and orders them deterministically by risk and then by age; it rejects alerts from another micro-area and de-duplicates re-deliveries (QoS 1 is at-least-once).

Color is a clinical signal only in these apps: red/yellow/green map strictly to `RiskLevel`, never used decoratively.

Expand Down
83 changes: 77 additions & 6 deletions apps/patient/lib/app/app.dart
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,7 @@ import 'package:sinalacs_patient/core/storage/local_data_control.dart';
import 'package:sinalacs_patient/core/storage/local_database_key.dart'
show LocalDatabaseUnavailableException;
import 'package:sinalacs_patient/core/services/emergency_dialer.dart';
import 'package:sinalacs_patient/core/triage/self_assessment.dart';
import 'package:sinalacs_patient/core/services/theme_controller.dart';

class SinalAcsApp extends StatefulWidget {
Expand Down Expand Up @@ -687,6 +688,21 @@ class _PatientLoginScreenState extends State<PatientLoginScreen> {
label: const Text('Biblioteca de saúde (sem cadastro)'),
),
),
const SizedBox(height: 12),
// Pilar A (C-11, RF22): a autoavaliação roda no
// aparelho, sem conta e sem rede.
SizedBox(
width: double.infinity,
child: OutlinedButton.icon(
key: const Key('login_self_assessment_button'),
style: OutlinedButton.styleFrom(minimumSize: const Size(48, 52)),
onPressed: () => Navigator.of(context).push(
MaterialPageRoute(builder: (_) => const LocalSelfAssessmentScreen()),
),
icon: const Icon(Icons.assignment_outlined),
label: const Text('Autoavaliação (sem cadastro)'),
),
),
const SizedBox(height: 4),
TextButton(
key: const Key('login_legal_link'),
Expand Down Expand Up @@ -1550,9 +1566,15 @@ class _EmergencyScreenState extends State<EmergencyScreen> {
}

class TriageScreen extends StatefulWidget {
const TriageScreen({super.key, this.onComplete, this.onFailure});
const TriageScreen({super.key, this.onComplete, this.onFailure, this.local = false});
final VoidCallback? onComplete;

/// Pilar A (C-11, #132): `true` roda a árvore no aparelho
/// ([SelfAssessmentEngine]), sem `accessToken`, sem rede e sem gravar em
/// `triage_sessions`. `false` (pilar B, com sessão) chama `triage.evaluate`.
/// No modo local a tela nunca lê o `BackendScope`.
final bool local;

/// Relata ao shell a falha capturada nesta tela. Ver
/// `_PatientHomeShellState._reportFailure`.
final ValueChanged<BackendFailure>? onFailure;
Expand Down Expand Up @@ -1612,7 +1634,7 @@ class _TriageScreenState extends State<TriageScreen> {
});

try {
final risk = await BackendScope.of(context).evaluateTriage(
final risk = widget.local ? _evaluateOnDevice() : await BackendScope.of(context).evaluateTriage(
chestPain: _answers[TriageSymptom.chestPain] ?? false,
difficultyBreathing: _answers[TriageSymptom.difficultyBreathing] ?? false,
fever: _answers[TriageSymptom.fever] ?? false,
Expand All @@ -1639,6 +1661,22 @@ class _TriageScreenState extends State<TriageScreen> {
}
}

/// Mesma árvore do `TriageEngine` do backend, no aparelho (C-11). A paridade
/// nas 64 combinações é provada por
/// `backend/sinalacs_server/test/unit/self_assessment_parity_test.dart`.
/// A tradução para [RiskLevel] é por **nome**, nunca por índice.
RiskLevel _evaluateOnDevice() {
final level = const SelfAssessmentEngine().evaluate(
chestPain: _answers[TriageSymptom.chestPain] ?? false,

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

difficultyBreathing: _answers[TriageSymptom.difficultyBreathing] ?? false,
fever: _answers[TriageSymptom.fever] ?? false,
persistentVomiting: _answers[TriageSymptom.persistentVomiting] ?? false,
bleeding: _answers[TriageSymptom.bleeding] ?? false,
severeWeakness: _answers[TriageSymptom.severeWeakness] ?? false,
);
return RiskLevel.values.byName(level.name);
}

/// Saída de maior gravidade: só a orientação "Ligar 192" (P-09, C-04).
///
/// **Nenhum pedido de contato sai daqui** — nada de `createRedAlert`; o
Expand All @@ -1660,7 +1698,9 @@ class _TriageScreenState extends State<TriageScreen> {
@override
Widget build(BuildContext context) {
final risk = _risk;
if (risk != null) return _TriageResult(risk: risk, onContinue: widget.onComplete);
if (risk != null) {
return _TriageResult(risk: risk, onContinue: widget.onComplete, local: widget.local);
}

final symptom = _symptoms[_step];
final answer = _answers[symptom];
Expand Down Expand Up @@ -1731,11 +1771,16 @@ class _TriageScreenState extends State<TriageScreen> {
/// A cor é sinal clínico, nunca decoração: vermelho/amarelo/verde mapeiam
/// estritamente o [RiskLevel].
class _TriageResult extends StatelessWidget {
const _TriageResult({required this.risk, this.onContinue});
const _TriageResult({required this.risk, this.onContinue, this.local = false});

final RiskLevel risk;
final VoidCallback? onContinue;

/// Resultado da autoavaliação local (C-11): nada foi enviado, então a tela
/// não pode falar de "solicitação" nem de agente que entrará em contato.
/// Os textos finais das três saídas são da C-08 (#130).
final bool local;

@override
Widget build(BuildContext context) {
// `color` só é usada como texto/ícone sobre o card (nenhum botão herda
Expand Down Expand Up @@ -1780,7 +1825,13 @@ class _TriageResult extends StatelessWidget {
style: TextStyle(fontSize: 22, fontWeight: FontWeight.bold, color: color),
),
const SizedBox(height: 12),
Text(guidance, textAlign: TextAlign.center),
Text(
local
? 'Esta autoavaliação ficou só neste aparelho: nada foi enviado ao agente nem ao servidor.'
: guidance,
key: const Key('triage_guidance'),
textAlign: TextAlign.center,
),
const SizedBox(height: 8),
Text(
'Classificação feita pelo protocolo da equipe de saúde.',

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

Expand All @@ -1796,13 +1847,33 @@ class _TriageResult extends StatelessWidget {
key: const Key('triage_continue'),
onPressed: onContinue,
style: FilledButton.styleFrom(minimumSize: const Size(48, 52)),
child: const Text('Acompanhar solicitação'),
child: Text(local ? 'Concluir' : 'Acompanhar solicitação'),
),
],
);
}
}

/// Autoavaliação do pilar A, aberta pela tela de entrada sem conta (C-11, #132;
/// RF04, RF22, RNF09): roda no aparelho, sem sessão, sem rede e sem registro no
/// servidor. A saída de maior gravidade é a orientação "Ligar 192" (C-04).
class LocalSelfAssessmentScreen extends StatelessWidget {
const LocalSelfAssessmentScreen({super.key});

@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: const Text('Autoavaliação')),
body: SafeArea(
child: TriageScreen(
local: true,
onComplete: () => Navigator.of(context).pop(),
),
),
);
}
}

/// Catálogo de condições que a tela oferece para marcar/desmarcar — mesmo
/// conjunto que `spec/idea.md` documenta como a origem do produto ("Perfil
/// Clínico e Cadastro de Crônicos"): diabetes, hipertensão, uso contínuo de
Expand Down
57 changes: 54 additions & 3 deletions apps/patient/lib/core/triage/self_assessment.dart
Original file line number Diff line number Diff line change
@@ -1,8 +1,59 @@
/// Motor de autoavaliação no aparelho (C-11, #132; RF04, RF16, INV-02).
///
/// No pilar A (sem login) a autoavaliação roda **aqui**, sem rede, sem
/// `accessToken` e sem gravar em `triage_sessions`. No pilar B (com sessão) o
/// app continua chamando `triage.evaluate`, que roda o `TriageEngine` do
/// backend e grava a sessão.
///
/// São, portanto, **duas implementações da mesma árvore de decisão fechada**, e
/// a INV-02 passa a depender de elas serem iguais. Quem prova isso é
/// `backend/sinalacs_server/test/unit/self_assessment_parity_test.dart`, que
/// importa ESTE arquivo e compara as duas nas 64 combinações dos seis sinais.
/// Ele roda no job `serverpod-backend` do CI em todo PR, seja qual for o motor
/// alterado.
///
/// **Este arquivo não pode importar nada** — nem Flutter, nem
/// `sinalacs_client`: o teste de paridade o carrega na VM do backend, que não
/// tem esses pacotes.
library;

/// Versão da árvore de decisão da autoavaliação (RF16, INV-02).
///
/// Vai no evento local da saída "Ligar 192" (C-04, `spec/requisitos_piloto.md`
/// §INV-03 no piloto: "evento com data, hora e versão do motor"). Quem mudar
/// as regras da árvore — no backend (`TriageEngine`) ou no aparelho — sobe
/// esta versão no mesmo commit, para que um evento antigo continue dizendo
/// qual regra o produziu.
/// as regras da árvore — no backend (`TriageEngine`) ou aqui — sobe esta
/// versão no mesmo commit, para que um evento antigo continue dizendo qual
/// regra o produziu.
const selfAssessmentEngineVersion = 'arvore-v1';

/// Saída do motor. Os nomes são os mesmos do `RiskLevel` do backend e do
/// cliente gerado; a tela traduz por **nome**, nunca por índice.
enum SelfAssessmentLevel { red, yellow, green }

/// Mesma árvore do `TriageEngine` do backend
/// (`backend/sinalacs_server/lib/src/application/triage/triage_engine.dart`).
///
/// Determinística: mesma entrada, mesma saída, sem estado, relógio, sorteio ou
/// campo editável (INV-02).
class SelfAssessmentEngine {
const SelfAssessmentEngine();

SelfAssessmentLevel evaluate({
required bool chestPain,
required bool difficultyBreathing,
required bool fever,
required bool persistentVomiting,
required bool bleeding,
required bool severeWeakness,
}) {
if (chestPain || difficultyBreathing || severeWeakness || bleeding) {
return SelfAssessmentLevel.red;
}

if (fever || persistentVomiting) {
return SelfAssessmentLevel.yellow;
}

return SelfAssessmentLevel.green;
}
}
Loading