Ir para o conteúdo

Casos de Uso

O que você vai encontrar aqui: Mapeamento formal dos casos de uso (UC-01 a UC-06) da extensão EvidencIA, com atores, pré-condições, fluxos principais, fluxos de exceção e rastreabilidade para requisitos e histórias.

Nesta página

Diagrama de Casos de Uso

Diagrama de Casos de Uso do Sistema Figura: Diagrama UML formal de Casos de Uso da extensão, detalhando os atores, limites do sistema e integrações com o Player do YouTube e o Backend de IA.

Mapeamento Estrutural e Atores

flowchart LR
    DonaLurdes((Dona Lurdes))
    Mariana((Mariana))
    CarlosAugusto((Carlos Augusto))
    Amanda((Amanda))
    Mayara((Mayara))
    Helena((Helena))

    subgraph Sistema["Extensão de Fact-Checking para YouTube"]
        UC01([UC-01: Analisar Vídeo])
        UC02([UC-02: Obter Transcrição])
        UC03([UC-03: Extrair Alegações e Evidências])
        UC04([UC-04: Inspecionar Fontes Originais])
        UC05([UC-05: Fornecer Retorno Reflexivo])
        UC06([UC-06: Alertar Incerteza Analítica])
    end

    IA[/Backend IA e Busca/]

    DonaLurdes --> UC01
    Mariana --> UC01
    Mariana --> UC06
    CarlosAugusto --> UC02
    Amanda --> UC03
    Mayara --> UC04
    Helena --> UC05

    UC01 -. "<<include>>" .-> UC02
    UC01 -. "<<include>>" .-> UC03
    UC03 -. "<<extend>>" .-> UC06
    UC03 --> IA

    style UC05 fill:#eee,stroke:#999,stroke-dasharray: 5 5

Evolução Arquitetural (ADR-006):

No planejamento inicial, o retorno reflexivo era classificado como Could Have (Fora do MVP). Com a homologação da arquitetura Evidence-First (ADR-006), as perguntas reflexivas (RF-05 / HU11) foram promovidas para Must Have (MVP), permanecendo fora do MVP apenas o canal voluntário de avaliação de precisão (RF-10 / HU12).

Especificação dos Casos de Uso Críticos

UC-01 — Analisar Vídeo

Campo Descrição
Ator principal Dona Lurdes (representativa dos usuários leigos)
Atores secundários —
Pré-condição Página de reprodução ativa no YouTube (/watch) e conexão à internet estabelecida
Pós-condição Síntese de alegações, evidências e fontes exibida na interface da extensão
Rastreabilidade Cenário 01, Cenário 07, Cenário 10 · RF-01, RNF-01, RNF-07 · HU01, HU03, HU06

Fluxo Principal

  1. A usuária aciona o botão da extensão para iniciar a checagem do vídeo.
  2. O sistema verifica a existência de dados prévios em cache local para o identificador do vídeo.
  3. O sistema obtém a transcrição do vídeo via YouTube (<<include>> UC-02).
  4. O sistema processa o texto e sintetiza as alegações via IA (<<include>> UC-03).
  5. O sistema renderiza o painel lateral com o resumo das evidências e fontes em linguagem clara.

Fluxos Alternativos / de Exceção

  • Cache Válido (Alternativo): se o vídeo foi analisado recentemente, exibe o resultado local imediatamente, sem novas requisições. → HU06
  • Sem Transcrição (Exceção): se o vídeo não possuir legendas/transcrição disponíveis, apresenta aviso orientador e encerra o fluxo. → HU10
  • Incerteza Analítica (Exceção): se houver evidências insuficientes ou fontes conflitantes, sinaliza a inconclusão analítica (<<extend>> UC-06).

UC-02 — Obter Transcrição

Campo Descrição
Ator principal Carlos Augusto
Atores secundários Player do YouTube
Pré-condição Página de vídeo ativa do YouTube (/watch)
Pós-condição Texto da transcrição formatado e disponível para o pipeline de análise
Rastreabilidade Cenário 02, Cenário 08 · RF-02, RF-08, RNF-06 · HU05, HU10

Fluxo Principal

  1. O sistema intercepta o identificador do vídeo ativo e requisita as legendas/transcrição ao player.
  2. O YouTube retorna as faixas de texto sincronizadas.
  3. O sistema higieniza, decodifica e estrutura a transcrição com marcações temporais para processamento.

Fluxos Alternativos / de Exceção

  • Transcrição Indisponível (Exceção): se o vídeo não contiver faixas de legenda nativas ou automáticas, o sistema emite alerta informativo e encerra a checagem.
  • Falha de Extração (Exceção): se ocorrer instabilidade de comunicação com o player do YouTube, o sistema sinaliza indisponibilidade temporária.

UC-03 — Extrair Alegações e Evidências

Campo Descrição
Ator principal Amanda
Atores secundários Backend / IA & Busca
Pré-condição Transcrição do vídeo obtida com sucesso (UC-02)
Pós-condição Alegações factuais e evidências mapeadas disponíveis para exibição no painel
Rastreabilidade Cenário 03, Cenário 09, Cenário 10 · RF-03, RF-06, RNF-01, RNF-02, RNF-06 · HU02, HU04

Fluxo Principal

  1. O sistema envia a transcrição ao backend intermediário autenticado.
  2. O modelo de IA segmenta o texto e isola as principais alegações factuais.
  3. O backend consulta motores de busca e bases de referência para contrapor cada alegação.
  4. O sistema gera uma síntese estruturada classificando as evidências que sustentam ou contradizem as alegações.

Fluxos Alternativos / de Exceção

  • Tempo Limite Excedido (Exceção): se a inferência ou a busca externa ultrapassar 10 segundos, o sistema interrompe a requisição e alerta sobre instabilidade temporária.
  • Falha no Backend (Exceção): se a API externa estiver fora do ar, o sistema degrada graciosamente e notifica o erro sem travar o navegador.

UC-04 — Inspecionar Fontes Originais

Campo Descrição
Ator principal Mayara
Atores secundários —
Pré-condição Síntese da análise gerada e cards de evidência visíveis no painel lateral
Pós-condição Página externa aberta em guia separada, mantendo player e painel intactos
Rastreabilidade Cenário 04 · RF-04, RNF-05, RNF-07 · HU07

Fluxo Principal

  1. A usuária clica na hiperligação ou cartão de uma fonte de referência listada.
  2. O sistema direciona o endereço e abre a página original em uma nova aba do navegador.
  3. A usuária consulta o conteúdo original para validação autônoma dos dados.

Fluxos Alternativos / de Exceção

  • Link Quebrado / Inacessível (Exceção): caso a página de destino retorne erro HTTP (ex.: 404), o navegador trata a falha na nova aba sem interferir na extensão.

UC-05 — Fornecer Retorno Reflexivo (Fora do MVP)

Campo Descrição
Ator principal Helena
Atores secundários —
Pré-condição Análise de alegações concluída ou em andamento no painel lateral
Pós-condição Estímulo ao pensamento crítico entregue sem constrangimento à autonomia decisória da usuária
Rastreabilidade Cenário 05, Cenário 11 · RF-05, RF-10 (OUT no MVP) · HU11, HU12

Fluxo Principal

  1. A usuária visualiza a análise no painel lateral.
  2. O sistema formula perguntas reflexivas para orientar o julgamento crítico da usuária.
  3. A usuária lê as orientações sem ter uma conclusão imposta pela IA.

Fluxos Alternativos / de Exceção

  • Ignorar Interação (Alternativo): se a usuária optar por não ler as orientações reflexivas, a navegação segue normalmente.

UC-06 — Alertar Incerteza Analítica

Campo Descrição
Ator principal Mariana
Atores secundários Backend de IA
Pré-condição Processamento de alegações ativo (UC-03) com detecção de carência de dados ou fontes conflitantes
Pós-condição Indicador de incerteza exibido no painel lateral, contendo o impulso de compartilhamento de afirmações não confirmadas
Rastreabilidade Cenário 06 · RF-07, RNF-06, RNF-07 · HU09

Fluxo Principal

  1. O backend analisa as fontes consultadas e identifica ausência de evidências conclusivas ou divergência factual aberta.
  2. O sistema classifica o resultado com status de inconclusão analítica.
  3. O sistema renderiza um badge visual de alerta e uma nota explicativa indicando que a alegação não possui consenso ou validação comprovada.

Fluxos Alternativos / de Exceção

  • Controvérsia Aberta (Alternativo): havendo referências legítimas com conclusões opostas, o sistema expõe ambos os lados sem arbitrar um vencedor absoluto.

Próximo: Priorização e MVP — sequência de entrega e estratégias técnicas por feature.
Ver também: Backlog e Histórias — critérios de aceitação detalhados em Gherkin.