Consola
A superfície autenticada: para que serve cada página, quem pode alterar o quê, e o que diz uma implementação sem consola alojada em vez de ligar a uma rota que daria 404.
Para que serve cada página da consola
| Página | Caminho | Finalidade |
|---|---|---|
| Painel | /app | Saldo, gasto hoje, totais de chamadas, rastreios recentes e a residência predefinida da organização. |
| Modelos | /app/models | Endpoints candidatos divididos em chamáveis, bloqueados pela política em vigor e apenas de catálogo; uma linha bloqueada apresenta o motivo do próprio router. |
| Chaves de API | /app/keys | Criar uma chave com os respetivos âmbitos, copiar o segredo uma vez e revogar chaves. |
| Playground | /app/playground | Enviar um prompt através do router real; a consola chama a API do lado do servidor, pelo que a chave nunca chega ao navegador. |
| Rastreios | /app/traces | Metadados por chamada: modelo, região, motivo da rota, latência e custo, com a retenção em vigor apresentada ao lado da lista. |
| Utilização | /app/usage | Chamadas, tokens e gasto por dia e por modelo. |
| Políticas | /app/policies | Residência, listas de permissão/negação de fornecedores e modelos, limites de preço e o valor de retenção que uma política armazena. |
| Definições | /app/settings | Nome da organização, residência predefinida, retenção predefinida e o idioma da consola. |
| Residência | /app/settings/residency | Que endpoints a política em causa admite e quais o router excluiu, com a justificação do router. |
| Exportações | /app/exports | Descarregar traces.json, usage.json, policies.json, o modelo de DPA e o pacote de auditoria NDJSON. |
| Perfil | /app/profile | A sua própria conta: nome, idioma, email, palavra-passe, verificação, sessões e eliminação da conta. |
| Faturação | /app/billing | Saldo, gastos deste mês e plano. Adicionar crédito é um formulário que só aparece quando a implementação o ativa. |
| Equipa | /app/team | Membros e funções, e convites; a ligação de convite é apresentada para poder ser copiada manualmente. |
Quem pode alterar o quê
A consola aplica dois conjuntos de funções. owner e admin governam; developer pode escrever; viewer é só de leitura.
- Governar (owner, admin): políticas, equipa, definições, crédito, revogação de chaves e emissão de uma chave com o âmbito platform_write.
- Escrita (developer): criar chaves de inferência e gastar crédito da organização através do playground, mas não governar.
- Só de leitura (viewer): as páginas e os rastreios podem ser lidos; o playground é recusado.
- Os descarregamentos em massa da organização (traces.json, usage.json, policies.json, audit.ndjson) exigem uma função de escrita; me.json é a exportação da própria conta de quem chama e está aberta a todos os membros.
A sua própria conta
Estas ações escrevem apenas linhas indexadas pelo id de utilizador da sessão, pelo que nenhum campo de formulário as pode apontar para outra pessoa.
- Nome a apresentar e idioma da consola.
- Endereço de email: alterá-lo exige a palavra-passe atual, e o novo endereço fica por verificar, porque a prova antiga pertencia ao endereço antigo.
- Palavra-passe: pelo menos 12 caracteres, o mínimo em packages/shared/src/limits.mjs; alterá-la termina todas as outras sessões e invalida as ligações de reposição pendentes.
- Verificação de email: um pedido requer um transporte de correio configurado; sem um, a página indica que esta instalação não o pode processar.
- A lista de sessões iniciadas, cada uma revogável, mais um controlo que termina a sessão em todos os outros navegadores e mantém esta; a sessão atual não pode ser revogada a partir da lista.
- Eliminação da conta: recusada enquanto for o único proprietário de uma organização que ainda tenha outros membros ou um saldo de crédito não nulo, e a recusa identifica a organização.
A consola é uma implementação
A consola é um facto da implementação, não uma página pública. O seu URL base vem de PUBLIC_CONSOLE_URL, e o renderer nunca o adivinha.
consoleHref(’/signup’) é a forma da ligação: devolve a origem da consola mais a rota, ou null quando não está configurada nenhuma consola.
Os pagamentos com cartão precisam da flag stripe_enabled da implementação. A página de segurança regista que o gestor de crédito aceita um montante submetido sem verificar um pagamento, e que a flag deve permanecer desligada até isso ser corrigido e testado.