/* =========================================================
Rende+ — Painel de administração (Root/Admin)
---------------------------------------------------------
Quem tem role==="admin" entra aqui automaticamente ao carregar
a app (ver useEffect "entrouModoAdmin" em app.jsx) — deixou de
ser uma rota escondida. Tem a sua própria navegação (AdminSidebar,
mais abaixo), mas com o MESMO tema claro e os mesmos componentes
(.sidebar, .nav-item, .nav-label) do menu normal — a diferença
está só nos itens (Utilizadores/Métricas/Auditoria em vez de
Painel/Transações/...), na etiqueta "Modo Administrador" e no
mini-perfil do admin, nunca numa paleta escura à parte. A proteção
REAL continua sempre no backend (exigirLogin + exigirAdmin em
todas as rotas /api/admin/*) — esta verificação aqui é só para
nunca mostrar nada do painel a quem não é admin.
========================================================= */
// Agrupado por área (mesmo padrão visual dos grupos "Geral"/"Outros" da
// sidebar normal — ver NAV_GROUPS em components.jsx): Gestão (utilizadores e
// os seus números), Negócio (o que rende dinheiro/uso), Operações (o que
// precisa de atenção operacional: avisos aos utilizadores e erros técnicos).
const ADMIN_GRUPOS = [
{
label: "Gestão",
secoes: [
{ id: "utilizadores", label: "Utilizadores", ic: "users", desc: "Consulta, pesquisa e gere as contas registadas na plataforma." },
{ id: "metricas", label: "Métricas", ic: "chart", desc: "Números e evolução da plataforma em tempo real." },
],
},
{
label: "Negócio",
secoes: [
{ id: "receita", label: "Receita", ic: "wallet", desc: "Subscrições ativas, MRR estimado e renovações." },
{ id: "assistente", label: "Assistente IA", ic: "bot", desc: "Uso do assistente financeiro por utilizador, no mês atual." },
],
},
{
label: "Operações",
secoes: [
{ id: "anuncios", label: "Anúncios", ic: "bell", desc: "Avisos mostrados aos utilizadores dentro da app." },
{ id: "envio-email", label: "Envio de email", ic: "send", desc: "Campanhas de reativação para utilizadores registados que ainda não usaram o Rende+." },
{ id: "erros", label: "Erros", ic: "flag", desc: "Últimos erros capturados pelo backend." },
{ id: "auditoria", label: "Auditoria", ic: "history", desc: "Histórico de todas as ações administrativas." },
],
},
];
// Lista plana (todas as secções, sem grupo) — usada onde só interessa procurar
// por id (título/descrição da página, abas mobile, rota por omissão, etc.).
const ADMIN_SECOES = ADMIN_GRUPOS.flatMap((g) => g.secoes);
/* Navegação própria do Modo Administrador — substitui a Sidebar normal por
inteiro (nunca as duas ao mesmo tempo, ver app.jsx). Reaproveita a .sidebar
e os .nav-item tal e qual como a sidebar normal (mesmo tema claro), incluindo
o próprio botão de recolher/expandir (collapsed/onToggle vêm do Shell — é o
mesmo estado partilhado com a sidebar normal). */
function AdminSidebar({ route, go, account, collapsed, onToggle }) {
const tr = useT();
return (
);
}
function AdminPanel({ go, route }) {
const fin = useFinance();
const ehAdmin = fin.account && fin.account.role === "admin";
React.useEffect(() => {
if (!ehAdmin) go("dashboard");
}, [ehAdmin]);
if (!ehAdmin) return null;
const seccaoId = route.replace(/^admin-/, "") || "utilizadores";
const seccao = ADMIN_SECOES.find((s) => s.id === seccaoId) || ADMIN_SECOES[0];
return (
{seccao.label}
{seccao.desc}
{/* Em desktop a navegação já vive na AdminSidebar; estas abas só aparecem em
mobile (a sidebar esconde-se abaixo dos 860px — ver styles.css). */}
);
}
/* Paginação simples, reutilizada pelas 2 tabelas (utilizadores/auditoria). */
function AdminPaginacao({ pagina, totalPaginas, onChange }) {
if (totalPaginas <= 1) return null;
return (
Página {pagina} de {totalPaginas}
);
}
/* Cabeçalho de coluna clicável para ordenar — mostra a seta na direção atual
só na coluna que está a ordenar. */
function AdminThSort({ campo, sort, dir, onSort, children, align }) {
const ativo = sort === campo;
return (
)}
)}
);
}
/* Modal de confirmação para eliminar a conta de um utilizador (destrutivo e
irreversível) — só ativa o botão quando o admin escreve exatamente o email
da conta, tal como pedido: uma checkbox ou "sim, tenho a certeza" não seria
suficiente para uma ação desta gravidade. */
function AdminEliminarContaModal({ utilizador, onClose, onEliminado }) {
const [confirmarEmail, setConfirmarEmail] = React.useState("");
const [busy, setBusy] = React.useState(false);
const [erro, setErro] = React.useState("");
const emailCorreto = confirmarEmail.trim().toLowerCase() === utilizador.email.toLowerCase();
const eliminar = async () => {
setBusy(true); setErro("");
try {
await API.adminEliminarConta(utilizador.id, confirmarEmail.trim());
onEliminado();
} catch (e) {
setErro(e.message || "Não foi possível eliminar a conta.");
setBusy(false);
}
};
return (
!busy && onClose()}>
Vais apagar a conta {utilizador.email} e todos os dados associados — despesas, rendimentos, metas, contas e categorias. Esta ação não pode ser revertida.
);
}
/* ---------- Separador: Receita ----------
Estimativa a partir dos dados da própria base (não há webhook do Stripe
nem campo que diga se um premium é mensal ou anual — ver nota em
src/routes/admin.js, rota /receita). Números tratados como aproximação,
não como facturação exata. */
function AdminReceita() {
const [r, setR] = React.useState(null);
const [erro, setErro] = React.useState("");
React.useEffect(() => {
API.adminReceita().then(setR).catch((e) => setErro(e.message || "Não foi possível carregar a receita."));
}, []);
if (erro) return
{erro}
;
if (!r) return
A carregar…
;
return (
<>
Subscrições
Estimativa calculada a partir dos dados guardados (não há ligação em tempo real ao Stripe nem distinção entre plano mensal/anual). Preços de referência: {r.precoMensal.toLocaleString("pt-PT", { minimumFractionDigits: 2 })} €/mês · {r.precoAnual.toLocaleString("pt-PT", { minimumFractionDigits: 2 })} €/ano.
);
}
/* ---------- Separador: Assistente IA ---------- */
function AdminAssistenteUso() {
const [periodo, setPeriodo] = React.useState("");
const [linhas, setLinhas] = React.useState([]);
const [busy, setBusy] = React.useState(true);
const [erro, setErro] = React.useState("");
React.useEffect(() => {
API.adminAssistenteUso()
.then((resp) => { setPeriodo(resp.periodoAtual); setLinhas(resp.utilizadores || []); })
.catch((e) => setErro(e.message || "Não foi possível carregar o uso do assistente."))
.finally(() => setBusy(false));
}, []);
if (erro) return