StudyHub Brasil

Visão geral

A versão 3.0.0 é a edição brasileira do StudyHub. Toda a operação foi preparada para português do Brasil e a geração de IA é configurada para produzir conteúdo em PT-BR.

Requisitos

• PHP 8.1 ou superior.
• MySQL 5.7+ ou MariaDB compatível.
• PDO MySQL, cURL, JSON, Fileinfo e OpenSSL.
• HTTPS em produção.
• Permissão de escrita em /storage.
• Chave própria da OpenAI somente se usar geração com IA.

Instalação

1. Crie o banco.Crie um banco MySQL/MariaDB vazio e um usuário com acesso a ele.
2. Envie os arquivos.Coloque o conteúdo do ZIP no domínio ou subpasta escolhida.
3. Abra o instalador.Acesse /install.php pelo navegador.
4. Preencha os dados.Informe banco, URL, conta do professor e os dados iniciais do controlador de privacidade.
5. Entre no painel.Revise Configurações, OpenAI e Privacidade/LGPD.
6. Proteja a instalação.Depois de concluir, remova ou bloqueie install.php.

Atualização da versão 2.3.0

Faça backup do banco, do config.php e de /storage. Substitua os demais arquivos pelos da versão 3.0.0. Na primeira execução, o sistema adiciona automaticamente os novos campos de privacidade dos alunos.

Configurar OpenAI

Abra Configurações → OpenAI, cole a chave da API do comprador, selecione o modelo e use o botão de teste. A chave é criptografada antes de ser salva no banco.

Na geração, o StudyHub envia as imagens de origem e instruções pedagógicas para a API Responses. A aplicação usa store: false e não inclui automaticamente o nome do aluno nem seu histórico de questionários.

Fluxo do professor

1. Cadastre matérias.História, Geografia, Ciências etc.
2. Cadastre alunos.Use apenas os dados necessários e atribua as matérias.
3. Crie um material.Escolha matéria, alunos e imagens de origem.
4. Gere com IA ou edite manualmente.Revise sempre o conteúdo antes de publicar.
5. Publique.O material fica disponível somente para alunos atribuídos e, se configurado, a partir da data indicada.
6. Acompanhe resultados.Consulte tentativas e remova histórico quando necessário.

Alunos e links individuais

O aluno não precisa criar conta. Cada cadastro recebe um token aleatório e longo. O link deve ser tratado como credencial privada. Se for exposto, use Trocar link privado; o link anterior deixa de funcionar.

O cadastro padrão usa nome, série/ano opcional, faixa etária aproximada, matérias e foto opcional. Não exige CPF, endereço, telefone, geolocalização ou data de nascimento completa.

Materiais, cartões de estudo e questionários

Materiais podem permanecer em rascunho ou ser publicados. Conteúdo gerado pode ser revisado completamente: título, resumo, pontos importantes, cartões de estudo, alternativas, resposta correta, explicação e imagens.

A IA é auxiliar. O professor continua responsável pela revisão pedagógica e pela decisão de publicar.

LGPD e documentos públicos

O pacote inclui quatro páginas públicas: privacy.php, cookies.php, terms.php e children.php. Elas recebem automaticamente nome do controlador, canal de privacidade, data dos documentos e algumas configurações do painel.

Esses textos são modelos operacionais. O comprador deve conferir se a descrição corresponde à sua realidade, especialmente se adicionar analytics, pixels, plugins, serviços externos, novos tipos de dados ou novas finalidades.

Crianças e adolescentes

A plataforma pode ser usada por menores em contexto educacional. A versão Brasil prioriza minimização, acesso privado e ausência de publicidade/comportamental, chat público, geolocalização, compras e perfil público por padrão.

No cadastro, o professor pode registrar somente uma faixa etária aproximada e uma anotação interna sobre o fundamento avaliado. O sistema não coleta biometria ou documento para aferição de idade.

As regras de implementação do ECA Digital e as orientações de aferição de idade continuam sujeitas à regulamentação da ANPD. O comprador deve acompanhar mudanças e avaliar se sua operação exige controles adicionais.

Retenção, exportação e exclusão

Em Privacidade / LGPD, o administrador vê quantidade de alunos, menores marcados, tentativas e registros acima do prazo de referência. Pode limpar resultados antigos manualmente ou ativar a exclusão automática.

Na ficha do aluno existem ações para exportar dados em JSON, gerar novo link e excluir o cadastro com vínculos e histórico. Defina um prazo que faça sentido para sua finalidade e obrigações reais.

Segurança

• Use HTTPS e senha forte.
• Proteja cPanel/hosting e banco de dados.
• Mantenha PHP e servidor atualizados.
• Não compartilhe tokens de aluno em locais públicos.
• Realize cópias de segurança e teste restauração.
• Remova ou bloqueie o instalador após concluir.
• Revogue/troque credenciais quando houver suspeita de exposição.

Consulte também SECURITY.md.

Cópia de segurança e migração

Um backup completo precisa incluir o banco de dados, config.php e toda a pasta /storage. O banco contém cadastros e conteúdo estruturado; /storage contém logos, fotos, imagens e páginas de origem protegidas.

Ao migrar de domínio, atualize APP_URL em config.php e confirme HTTPS, permissões de escrita e acesso ao banco.

Problemas comuns