Base de Conhecimento
portal-do-aluno.md

Alterações salvas aqui passam a ser usadas pelos agentes nas próximas conversas/qualificações.
# Base de Conhecimento — Portal do Aluno

## Visão geral

O **Portal do Aluno** é um portal online utilizado pelos alunos para consultar informações acadêmicas.

## Público usuário

- Alunos.

## Principais funcionalidades

O portal permite ao aluno consultar:

- notas;
- faltas;
- disciplinas;
- abrir cases/solicitações para atendimento da Afya.

## Relação com sistemas internos

O Portal do Aluno pode depender de informações acadêmicas oriundas do **RM** ou de integrações relacionadas.

Também é canal de abertura de **cases** que seguem para o atendimento da Afya. Esse fluxo pode ter relação com Salesforce ou outro sistema de atendimento/CRM, a validar tecnicamente.

> Observação: validar tecnicamente quais dados vêm diretamente do RM e quais passam por integrações, camadas intermediárias ou outros sistemas.

## Exemplos de demandas relacionadas

### Incidentes / Sustentação

Demandas que indicam falha em funcionalidade já existente.

Exemplos:

- aluno não consegue visualizar notas;
- faltas não aparecem no portal;
- disciplinas não carregam;
- portal apresenta erro ao acessar informações acadêmicas;
- informação aparece incorreta ou divergente;
- dados aparecem no RM, mas não aparecem no Portal do Aluno;
- lentidão ou indisponibilidade do portal;
- aluno não consegue abrir case;
- case aberto no portal não chega ao atendimento da Afya;
- status do case não atualiza para o aluno.

### Manutenção

Demandas de ajuste simples em funcionalidade existente, sem mudança relevante de processo.

Exemplos:

- ajuste de texto em tela;
- ajuste simples de layout;
- inclusão de campo informativo simples;
- correção pontual de exibição.

### Evolução de produto/processo

Demandas que ampliam ou modificam funcionalidades existentes.

Exemplos:

- exibir novo tipo de informação acadêmica;
- alterar regra de visualização de notas;
- criar nova visão de disciplinas;
- melhorar experiência de consulta do aluno;
- adicionar filtros, histórico ou detalhamento.

### Transformação Digital / Novo Produto

Demandas que criam uma nova capacidade ou canal, não apenas ajuste do portal atual.

Exemplos:

- criação de novo portal;
- nova jornada digital para acompanhamento acadêmico;
- nova automação de comunicação acadêmica com alunos.

## Regras de leitura para os agentes

### Regra 1 — Portal já existe

Se a demanda menciona erro, ausência ou divergência em notas, faltas ou disciplinas no Portal do Aluno, considerar inicialmente:

```txt
Hipótese: Incidente / Sustentação ou falha de integração
Motivo: portal já existente apresenta problema em funcionalidade ou dado acadêmico.
```

### Regra 2 — Dado divergente entre RM e Portal

Se o dado está correto no RM, mas incorreto ou ausente no Portal do Aluno:

```txt
Hipótese: falha de integração, sincronização ou camada de exibição
```

### Regra 3 — Nova informação no portal

Se o pedido é exibir algo novo no Portal do Aluno:

```txt
Hipótese: Evolução de produto/processo
```

### Regra 4 — Novo canal ou nova jornada

Se a demanda propõe criar um novo portal, nova jornada ou nova automação de relacionamento acadêmico:

```txt
Hipótese: Transformação Digital / Novo Produto
```

## Perguntas direcionadas para o Agente 1

Quando o PO mencionar Portal do Aluno, notas, faltas ou disciplinas, o agente deve evitar perguntas genéricas e direcionar melhor a conversa.

Perguntas úteis:

- O problema acontece com todos os alunos ou apenas alguns casos?
- A informação afetada é nota, falta, disciplina ou acesso ao portal?
- O dado está correto no RM ou no sistema de origem?
- O problema é ausência de informação, informação divergente ou erro de acesso?
- Desde quando isso acontece?
- Ocorre em algum período específico, como fechamento de notas, matrícula ou rematrícula?
- Existe mensagem de erro?
- O aluno consegue acessar o portal, mas não vê a informação, ou nem consegue acessar?

## Saída esperada em uma demanda estruturada

Quando a demanda envolver Portal do Aluno, o Agente 1 deve tentar preencher:

```txt
Sistema/portal envolvido: Portal do Aluno
Informação afetada: notas | faltas | disciplinas | acesso | outra
Sistema de origem: RM ou outro, se conhecido
Tipo de problema: ausência | divergência | erro de acesso | lentidão | indisponibilidade | melhoria
Público impactado: todos os alunos | grupo específico | curso/unidade/período
Resultado esperado:
Benefício esperado:
Urgência/período crítico:
```

## Exemplo

Entrada do PO:

```txt
Os alunos não estão conseguindo ver as notas no Portal do Aluno.
```

Resposta esperada do Agente 1:

```txt
Entendi. Como o Portal do Aluno já é o canal usado para consulta de notas, precisamos entender se é uma falha de exibição, integração ou origem do dado. Isso acontece com todos os alunos ou só alguns casos? E as notas aparecem corretamente no RM?
```

Possível qualificação do Agente 2:

```txt
Classificação sugerida: Incidente / Sustentação ou falha de integração
Justificativa: O Portal do Aluno já existe e uma informação acadêmica esperada não está sendo exibida corretamente.
Evidências: portal existente; funcionalidade de consulta de notas; impacto para alunos.
Perguntas pendentes: confirmar se o dado está correto no RM e se o erro afeta todos os alunos.
```
Voltar