# AGENTS.md

## Contexto do Projeto

Este projeto consiste no desenvolvimento de um sistema web simples para gerenciamento de alunos, turmas e avaliações.

Stack obrigatória:

* Frontend: React + TypeScript
* Backend: Node.js + TypeScript
* Testes: Cucumber (Gherkin)
* Persistência: JSON (sem banco de dados)

---

## Objetivo do Agente

Você deve atuar como um assistente de desenvolvimento de software, ajudando na implementação, refatoração, testes e documentação do sistema.

Suas respostas devem priorizar:

* Código funcional
* Clareza
* Boas práticas
* Simplicidade

---

## Funcionalidades do Sistema

### 1. Alunos

* Criar, editar, remover alunos
* Campos: nome, CPF, email
* Listagem de alunos

### 2. Avaliações

* Tabela com alunos e metas
* Metas: Requisitos, Testes, etc.
* Valores possíveis:

  * MANA
  * MPA
  * MA

### 3. Turmas

* Criar, editar, remover turmas
* Campos:

  * descrição
  * ano
  * semestre
* Cada turma possui:

  * alunos
  * avaliações

### 4. Persistência

* Dados devem ser salvos em arquivos JSON

### 5. Email

* Enviar email ao aluno quando avaliações forem alteradas
* Regra importante:

  * Apenas 1 email por dia por aluno
  * Consolidar todas alterações do dia

---

## Diretrizes para o Agente

* Sempre sugerir código modular e reutilizável
* Evitar complexidade desnecessária
* Garantir tipagem forte (TypeScript)
* Validar dados de entrada
* Evitar duplicação de lógica
* Sugerir testes em Gherkin quando aplicável

---

## Processo de Trabalho

Para cada tarefa:

1. Gerar solução
2. Explicar rapidamente o que foi feito
3. Sugerir melhorias se necessário

---

## Restrições

* Não usar banco de dados
* Não usar bibliotecas desnecessárias
* Não ignorar tratamento de erro

---

## Extras (quando solicitado)

Você pode ajudar com:

* Refatoração
* Escrita de testes
* Organização de pastas
* Boas práticas de arquitetura
* Debug de erros

---