Relatório CAE — Estado do Projeto

C

CAE

Central de Apoio ao Estudante

Relatório de Estado do Projeto

Documento técnico para planeamento estratégico

Data: 22 de Setembro de 2026 · Versão 1.0

Índice

  1. Visão Geral
  2. O que está pronto e em produção (8 portais + sistemas transversais)
  3. O que falta para o CAE estar 100% funcional
  4. Plano recomendado para 100% de funcionalidade
  5. Base de dados — entidades ativas
1

Visão Geral

O CAE (Central de Apoio ao Estudante) é um ecossistema digital abrangente para Angola que centraliza a gestão académica, serviços estudantis e operações escolares numa única plataforma moderna.

A aplicação está publicada e em produção, com 8 portais completos a funcionar: Nacional, Escola, Estudante, Professor, Encarregado, Parceiro, Refeitório e Fornecedor — além de um marketplace partilhado, sistema de eventos, validação QR, moeda interna (PTT), CAE Score e feed social académico.

A base de dados nativa da plataforma tem +60 entidades ativas com dados reais a ser processados diariamente.

2

O que está pronto e em produção

🔐

2.1 · Autenticação & Onboarding

Login com username/password + Google OAuth
Recuperação de palavra-passe (token por email)
Página de boas-vindo com escolha de tipo de conta
Registo de Estudante (multi-passos: dados, foto, escola, académico, OTP)
Registo de Professor (multi-passos + verificação OTP)
Registo de Encarregado (multi-passos + ligação a educandos + OTP)
Redirecionamento automático por role após login
Perfil (foto, dados pessoais, académicos, alterar palavra-passe)
🏛️

2.2 · Portal Nacional

Home / Dashboard nacional
Gestão de Escolas, Estudantes, Professores e Aprovações
Twisco — concurso de professores (candidatos, votação, perfil)
Eventos nacionais (criar, editar, estatísticas, detalhe)
Fornecedor nacional (dashboard comercial, consumidor, stock, alertas, campanhas, mapa de Angola)
Cartões CAE (lista, detalhe, impressão em lote, reemissão, cancelamento)
Validação de cartão por código
🏫

2.3 · Portal da Escola

Home / Dashboard
Estudantes — gestão completa
Professores — gestão completa
Turmas (lista + detalhe com alunos e professores por disciplina)
Notas — lançamento de avaliações
Frequência / Presenças — chamada com marcação em massa
Desempenho docente — rankings
Eventos (home, detalhe, meu calendário)
Comunicados (com distribuição a encarregados)
Reclamações (com detalhe, estatísticas, estados)
🎓

2.4 · Portal do Estudante

Home = Feed social académico (estilo LinkedIn/Threads — posts, reações educativas, comentários, guardar, procurar, sugestões, tendências, eventos em destaque)
Salas de Estudo (criar, detalhe, membros, tarefas, materiais, chat, calendário, IA da sala, convites, partilha por link, pedidos de entrada)
Palavras Minhas (conversas privadas + calendário de estudo + calculadora)
Cartão CAE (frente/verso, QR, validação)
Notas — histórico de avaliações
Frequência — presenças em tempo real
Trabalhos — entregas de tarefas
Horário — agenda semanal, calendário mensal, pomodoro, planner
Marketplace (produtos + serviços, favoritos, carrinho, reservas)
Reservas de serviços (fluxo completo: serviço → profissional → data → hora → participantes → variações → pagamento → QR)
Refeitório — ementa, encomendas, pagamento PTT/Kz
Carteira / PTT — saldo, histórico de transações
CAE Score — cálculo automático a partir de atividade real + marcos de recompensa PTT
Avaliação de professores
Eventos (home, detalhe, calendário, concurso Twisco)
Reclamações e Comunicados
Mensagens (chat)
👨‍🏫

2.5 · Portal do Professor

Home / Dashboard
Gerir turma — chamada rápida, marcação em massa
Avaliações — lançar notas
Twisco — participação no concurso
Turmas (lista + detalhe)
Notas
Eventos
Marketplace (produtos + serviços + reservas)
Refeitório — encomendas como consumidor
👨‍👩‍👧

2.6 · Portal do Encarregado

Home / Dashboard
Filhos / Educandos (lista + perfil completo: resumo, notas, frequência, disciplina, trabalhos, comunicados, eventos, marketplace, cartão)
Adicionar / remover educando
Frequência — só dos filhos ligados, tempo real
Trabalhos
Mensagens
Eventos
Comunicados
Carteira / PTT
🏢

2.7 · Portal do Parceiro (Marketplace)

Home / Dashboard
Produtos — CRUD completo
Refeitório (dashboard, encomendas, cafeterias, stock, produtos)
Serviços — CRUD + variações + horários
Profissionais — gestão
Reservas — gestão + check-in por QR
Pedidos — produtos
Avaliações / Comentários
Relatórios / Financeiro
Configurações
🍽️

2.8 · Portal do Refeitório

Home / Dashboard
Pedidos — fila de encomendas, estados, validação QR
Refeições — CRUD + variações + avaliações
Stock — itens, movimentos, alertas de mínimo
Validar QR — scanner de pedidos/cartões
Fornecedor — lista de fornecedores + perfil
Pedidos a fornecedores (B2B)
Meu refeitório — dados do estabelecimento
Relatórios / Pagamentos — overview, refeições, estudantes, finanças
🚚

2.9 · Portal do Fornecedor (B2B)

Home / Dashboard
Refeitórios (lista + detalhe por refeitório)
Produtos — CRUD + variações + imagens + preços por quantidade
Pedidos — receção, confirmação, recusa, estados de entrega
Classificações / Avaliações
Perfil — dados da empresa
🛒

2.10 · Marketplace (partilhado)

Home com produtos, serviços, parceiros, destaques, pesquisa, filtros, ordenação, categorias, itens gratuitos
Detalhe de serviço (galeria, localização no mapa, políticas, horários, avaliações, calendário, variações, confirmação com QR)
Carrinho (sidebar)
Favoritos
Reservas do estudante
⚙️

2.11 · Sistema Transversal

Eventos (home, detalhe, calendário, inscrições, bilhete digital, avaliações)
QR Scanner / Validação (cartões, pedidos, bilhetes)
ScanLog — histórico de leituras
Notificações (dropdown + modal, por portal)
PTT — moeda interna, transações, recompensas
CAE Score — motor de cálculo automático + marcos
Assistente IA (no feed e na escola)
Landing page pública
Tema claro/escuro + identidade visual CAE (Navy-Lilac-Laranja)
Responsivo (mobile + desktop)
3

O que falta para 100% funcional

3.1 · Backend Functions paradas (bloqueadas pelo plano)

O plano atual não inclui backend functions. Estas 6 funções existem no código mas não executam:

FunçãoO que fazImpacto de estar parada
resolveLoginIdentifierConverte username → email no loginLogin por username pode falhar na resolução
checkPhoneExistsVerifica se telefone já está registadoRegisto não valida duplicação de telefone
distributeEventNotificationsEnvia notificações de eventosNotificações de eventos não chegam aos utilizadores
distributeAnnouncementNotificationsDistribui comunicadosComunicados da escola não notificam encarregados/estudantes
guardianNotifyNotifica encarregados (notas, presenças, trabalhos, cartão, PTT)Encarregados não recebem alertas automáticos
schoolAssistantAssistente IA do portal da escolaAssistente da escola não responde

3.2 · Conectores OAuth inativos (exigem Builder+)

Nenhum conector externo está ativo — todos exigem upgrade de plano:

Google Calendar
Gmail
Google Sheets
Google Drive
Google Docs
Slack
Notion
Salesforce
HubSpot
Outlook
Microsoft Teams
SharePoint
OneDrive
Linear
Airtable
Jira
Asana
Trello
Dropbox
Box
LinkedIn
Instagram Business
TikTok
Discord
ClickUp
Wrike
Calendly
Typeform
QuickBooks
Square
Snowflake
Databricks
+ 30 outros

Isto afeta qualquer integração externa (sincronizar calendários, enviar email por Gmail, exportar para Sheets, etc.).

3.3 · Problemas conhecidos (parciais)

•Verso do Cartão CAE: conteúdo a ser truncado — proporção ajustada, pode precisar de validação visual em alguns ecrãs.
4

Plano recomendado para 100% de funcionalidade

Builder+

O plano Builder+ desbloqueia tudo o que falta para o CAE estar 100% funcional:

Backend Functions

Reativa as 6 funções paradas — notificações automáticas de eventos, comunicados, alertas a encarregados, validação de telefone, resolução de username no login e assistente IA da escola.

Conectores OAuth

Ativa 60+ integrações externas — Google Calendar, Gmail, Sheets, Slack, Notion, Salesforce, Outlook, Teams, etc.

Domínio personalizado

Permite ligar um domínio próprio ao CAE (ex: cae.ao).

Email externo

Permite enviar emails a utilizadores não registados (com domínio personalizado).

Para fazer o upgrade: aceda a Plan and billing nas definições do workspace e selecione o plano Builder+.

5

Base de dados — entidades ativas

A base de dados é nativa da plataforma (sem servidores externos). Cada entidade tem campos automáticos: id, created_date, updated_date, created_by_id.

Student

Estudantes registados

Teacher

Professores registados

School

Escolas registadas

ClassRoom

Turmas

Grade

Notas / Avaliações

Attendance

Presenças / Frequência

Assignment

Trabalhos / Tarefas

AssignmentSubmission

Entregas de trabalhos

Announcement

Comunicados

Complaint

Reclamações

Occurrence

Ocorrências disciplinares

Event

Eventos

EventRegistration

Inscrições em eventos

Service

Serviços do marketplace

Booking

Reservas de serviços

Professional

Profissionais de serviços

Product

Produtos do marketplace

Partner

Parceiros do marketplace

MarketplaceItem

Itens do marketplace

MarketOrder

Pedidos do marketplace

CartItem

Itens do carrinho

Favorite

Favoritos

Meal

Refeições do refeitório

Order

Pedidos do refeitório

CafeteriaSupplier

Fornecedores B2B

SupplierProduct

Produtos do fornecedor

SupplierOrder

Pedidos a fornecedores

Refectory

Refeitórios

StockItem

Itens de stock

StockMovement

Movimentos de stock

MealReview

Avaliações de refeições

ProductReview

Avaliações de produtos

TeacherReview

Avaliações de professores

EventReview

Avaliações de eventos

StudyRoom

Salas de estudo

StudyRoomMember

Membros das salas

StudyRoomMessage

Mensagens das salas

StudyRoomTask

Tarefas das salas

StudyRoomMaterial

Materiais das salas

StudyRoomEvent

Eventos das salas

StudySession

Sessões de estudo

StudyTask

Tarefas de estudo

StudyConversation

Conversas (Palavras Minhas)

StudyMessage

Mensagens (Palavras Minhas)

AcademicPost

Publicações do feed social

AcademicComment

Comentários do feed

AcademicReaction

Reações do feed

StudentScore

CAE Score dos estudantes

PTTTransaction

Transações PTT

Notification

Notificações do sistema

ScanLog

Histórico de leituras QR

ScheduleItem

Itens de horário

CardHistory

Histórico do cartão CAE

TwiscoConfig

Configuração do Twisco

TwiscoCandidate

Candidatos do Twisco

TwiscoVote

Votos do Twisco

SupplyOrder

Encomendas de fornecimento

SupplyCampaign

Campanhas de fornecimento

CafeteriaExpense

Despesas do refeitório

Message

Mensagens diretas

AnnouncementRead

Comunicados lidos

SchoolEvent

Eventos da escola

📋 Resumo Executivo

✅ Pronto: 8 portais completos, marketplace, eventos, QR, PTT, CAE Score, feed social, salas de estudo, +60 entidades — tudo em produção.

❌ Em falta: Notificações automáticas, validações de registo, assistente IA da escola e integrações externas — tudo bloqueado pelo plano atual.

💡 Solução: Upgrade para o plano Builder+ reativa todas as backend functions e conectores OAuth, colocando o CAE a 100%.

CAE — Central de Apoio ao Estudante · Angola

Relatório gerado em 22 de Setembro de 2026 · Documento confidencial para planeamento interno