1. Primeiros passos e organização
O Priorix, na versão 1.0.8, organiza o trabalho em ambientes. Cada ambiente reúne grupos, subgrupos e blocos de notas. Use ambientes para separar equipes ou projetos; grupos e subgrupos organizam os assuntos; os blocos guardam tarefas, decisões, informações e anexos.
Após o cadastro, conclua a configuração de acesso. Uma conta sem ambientes deve criar seu primeiro ambiente antes de começar. O envio da criação é protegido contra duplicação; se a conexão demorar, aguarde o resultado antes de tentar outra vez. Títulos de ambientes são salvos em letras maiúsculas, preservando acentos.
O modal de boas-vindas apresenta a organização e as novidades no primeiro acesso e após uma atualização. A versão já apresentada fica registrada por usuário. Consulte novamente as novidades e este manual pelo menu de ajuda. A versão 1.0.8 permanece em validação: a cópia externa do backup ainda precisa de configuração e verificação.
2. Ambientes pessoais e compartilhados
Na lista de ambientes, use Entrar para abrir um ambiente e o botão de fixação para mantê-lo no topo. Um ambiente fixado recebe a indicação Fixado. Criar, renomear, convidar e administrar participantes depende das permissões da sua conta e do ambiente.
Em um ambiente compartilhado, participantes aprovados podem editar e concluir os blocos presentes, inclusive os criados por outra pessoa. A autoria original permanece registrada. A colaboração não concede automaticamente permissão para excluir blocos alheios, mover conteúdo para outro ambiente ou administrar grupos e participantes.
O chat do grupo fica no canto inferior direito, separado das ações rápidas. Clique no cabeçalho para minimizar ou reabrir. Mensagens do grupo permanecem no chat e não interrompem o trabalho com um modal de comunicado do sistema. Notificações fora do aplicativo dependem da permissão do navegador, do dispositivo e da configuração de notificações disponível.
3. Grupos, subgrupos e navegação
Use os botões de adicionar grupo e subgrupo na barra lateral. Dê um nome que identifique o assunto. Novos títulos e alterações de títulos aceitam até 50 caracteres; o formulário mostra um contador e o servidor também valida esse limite. Nomes antigos maiores permanecem preservados, sem truncamento automático.
Expanda ou recolha a árvore pelas setas. O submenu de opções reúne as ações disponíveis para o grupo ou subgrupo selecionado. A barra lateral mantém a largura escolhida; títulos extensos recebem quebra limitada e identificação completa no texto auxiliar. A navegação e a seleção por checkbox são operações distintas.
A criação atualiza a interface sem avisos repetitivos de salvamento. Erros de gravação continuam visíveis. Se aparecer um erro, preserve o conteúdo e confira o status de conexão antes de reenviar.
4. Seleção por checkbox
Marque os checkboxes de grupos, subgrupos e blocos para selecionar um ou vários itens. A seleção é hierárquica: selecionar uma área da árvore inclui seus descendentes e os blocos correspondentes; o estado parcial indica que apenas parte dos filhos está marcada. Os estados ficam sincronizados com as opções do submenu e a interface atualizada.
Selecionar ou desmarcar não altera nem exclui o conteúdo. Copiar, mover ou executar outra ação exige usar o comando correspondente. Antes de confirmar uma ação sobre vários itens, confira quais grupos, subgrupos e blocos estão selecionados.
5. Criar, editar e organizar blocos
Crie um bloco pelo botão de nova nota. Informe título, conteúdo, prioridade, grupo e subgrupo. Escolha a cor do papel ao criar ou editar. Os blocos preservam o papel amarelo padrão mesmo no modo escuro, com texto legível.
Clique duas vezes no título ou na área adequada do bloco para abrir a edição. Salvar confirma a alteração; Cancelar preserva o conteúdo anterior. Concluir move o bloco para os concluídos; Restaurar devolve o bloco concluído à lista ativa, conforme as permissões do ambiente.
Use o pino para manter um bloco no topo. A indicação Fixado identifica os blocos priorizados. A movimentação para outro ambiente usa a ação Mover e exige acesso ao destino e permissão sobre o bloco. Confira ambiente, grupo e subgrupo de destino antes de confirmar.
Anexe imagens, documentos ou áudio pelo editor. A gravação de áudio solicita permissão para o microfone; o ponto vermelho piscando indica a gravação em andamento. Pare a gravação e revise o anexo antes de salvar. O componente de imagem fixada permite ajustar o tamanho dentro dos limites da área, preservando a utilização em telas menores.
6. IA: consumo e configuração segura
Os recursos de IA podem consumir muitos tokens ou créditos e gerar custos no provedor, especialmente ao processar vários blocos. O ambiente mostra esse aviso antes das operações. Confira os limites e as condições da sua conta no provedor; o aplicativo não estima valores monetários sem informação confiável.
Abra Configurações > IA, selecione o provedor e modelo compatíveis, informe a URL HTTPS quando necessário e cole sua chave no campo de senha. Use o link Tutorial de configuração da IA para consultar as instruções. Clique em Validar e salvar. A validação permanece ativada por padrão e consulta a credencial sem gerar conteúdo.
Os estados apresentados são Não configurada, Validação necessária, Validando, Chave válida e Chave inválida. Uma validação bem-sucedida libera a configuração imediatamente. Uma chave já validada e salva pode ser reutilizada sem verificações repetitivas de geração. Alterações de provedor exigem uma credencial compatível.
A chave salva permanece criptografada no servidor e não é exibida novamente em páginas ou respostas públicas. O campo fica vazio com a indicação de chave salva; preencha-o apenas para trocar a credencial. Ativar ou desativar sua IA preserva a chave salva. O administrador também pode restringir provedores ou desligar a IA do sistema. Não cole chaves em notas, mensagens, logs ou capturas de tela.
7. Autocompletar e relatórios por IA
O botão Autocompletar fica disponível junto ao editor. O modal explica o processamento e o possível consumo. Clique em Gerar sugestão para consultar a IA; aguarde o estado de processamento. A resposta aparece como prévia e o conteúdo original permanece intacto.
Revise o título e o texto sugeridos. Aplicar sugestão confirma a substituição; Descartar ou o X fecha a prévia sem aplicar. Após aplicar, Desfazer permite restaurar o conteúdo anterior enquanto a ação estiver disponível. Se o bloco mudar durante o processamento, a sugestão não será aplicada sobre a alteração mais recente.
Requisições duplicadas para o mesmo autocompletar são bloqueadas. Fechar o modal durante o processamento descarta o resultado e mantém o bloqueio da requisição até a resposta terminar; o provedor ainda pode concluir a operação iniciada. Falhas são mostradas no modal e não apagam o original.
No submenu de um grupo ou subgrupo, abra Relatório de IA ou Resumo com IA para resumir todos os blocos daquele contexto. Uma barra azul apresenta o progresso da leitura e da preparação. O resultado reúne os assuntos e as pendências identificados; revise as informações antes de usar. É possível copiar, imprimir ou baixar o relatório em PDF. Operações em lote apresentam aviso de consumo e exigem confirmação antes de salvar alterações automaticamente.
8. Assinaturas Free e Premium
O ícone de coroa mostra o plano, a situação da assinatura, os benefícios, os limites efetivos e as opções configuradas pelo administrador. O plano Free é gratuito e utiliza os limites configurados. Premium 30 dias possui vencimento controlado no servidor. Premium para sempre não possui expiração programada.
Valores, benefícios, limites e informações de PIX são definidos no painel administrativo. Sem preço ou destinatário configurado, o aplicativo informa que o pagamento ainda não está disponível. Enviar uma referência ou solicitação de pagamento não confirma o PIX nem ativa uma assinatura automaticamente. A ativação depende da conferência administrativa.
O administrador pode conceder, renovar, revogar e consultar o histórico de assinaturas, além de aprovar ou rejeitar solicitações de pagamento. As ações registram o responsável e o resultado. Moderadores precisam dos atributos específicos de configuração e de conferência de pagamentos.
Quando o administrador desativa o sistema de assinaturas, o acesso Premium é liberado temporariamente enquanto a função permanecer desativada. Isso não transforma o plano persistido em uma assinatura vitalícia. Ao reativar, voltam a valer o plano e a expiração efetivos da conta.
9. Painel administrativo e atributos
O painel reúne usuários, aprovações, sessões, segurança, IA, assinaturas, comunicados e controles do servidor conforme o perfil. Administradores possuem acesso administrativo; moderadores recebem atributos individuais e veem somente os controles liberados. A autorização é conferida novamente no backend para cada operação.
Em Usuários > Atributos do moderador, marque as ações desejadas e salve. Sem configuração explícita, permanecem as três permissões anteriores: aprovar cadastros, banir ou desbanir usuários e liberar recuperação de senha. Novas permissões não são concedidas automaticamente. Os atributos não tornam a conta administradora.
O catálogo permite delegar as opções compatíveis do painel, incluindo sessões, planos, configurações e conferência de assinaturas, mensagens, proteção, comandos e acesso a contas privilegiadas. Conceder administração total e gerenciar os atributos de outros moderadores exige permissões específicas; um operador delegado não pode repassar poderes que não possui.
O username de uma conta administradora é imutável. No cartão de cada usuário, configure o limite de sessões simultâneas, consulte sessões e histórico de IPs e selecione endereços autorizados. Abas do mesmo navegador compartilham uma sessão; revogar sessões exige novo login. Backups completos do servidor permanecem restritos a administradores reais, pois incluem dados de todas as contas.
10. Comunicados e caixa de mensagens
No painel, abra o modal de mensagem do sistema e informe título, texto e público. Os públicos disponíveis são Todos os usuários, Apenas administradores, Apenas moderadores e Administradores e moderadores. Confira o público e confirme o envio. Moderadores só podem enviar quando receberem o atributo correspondente.
Cada destinatário recebe a mensagem em modal com X para fechar. Quem não estiver conectado a recebe após entrar. Fechar o aviso não apaga o comunicado: o ícone de carta no cabeçalho mantém o histórico e a indicação de mensagens não lidas.
Limpar todas as mensagens solicita confirmação e remove somente os comunicados da caixa da própria conta. Não apaga as mensagens de outros usuários nem as conversas do chat do ambiente. Os botões de notificações de blocos no painel têm outra finalidade: avisam sobre blocos marcados para notificação.
11. Backup e restauração de ambientes
Use o backup de ambiente para exportar seu conteúdo ou o backup de todos os seus ambientes quando essa opção estiver liberada. O administrador pode permitir ou negar a importação e exportação para usuários; administradores mantêm acesso conforme a política do sistema.
A importação de backup de ambiente é aditiva: acrescenta grupos e blocos importados com novas identificações e preserva os blocos atuais. Isso permite restaurar conteúdo de outro usuário sem substituir suas notas existentes, desde que o arquivo seja válido e você tenha acesso ao ambiente de destino.
Confira o arquivo JSON ou ZIP e o destino antes de confirmar. Anexos dependem da presença dos arquivos no backup e das permissões de acesso; um arquivo JSON sozinho não transporta todos os binários. Limites de tamanho, formato e plano são validados no servidor. A restauração de ambiente não equivale à restauração completa do servidor.
12. Backup diário obrigatório do servidor
Administração > Backups apresenta a rotina automática, última tentativa, último backup íntegro, próximo horário, histórico, tamanho, integridade e situação da cópia externa. A rotina funciona no servidor sem navegador ou administrador conectado. O horário inicial é 03:00, no fuso America/Sao_Paulo, com retenção inicial de 30 gerações diárias.
O agendador do servidor verifica tarefas a cada minuto, usa bloqueio contra concorrência e recupera execuções diárias perdidas quando seguro. Falhas transitórias recebem tentativas limitadas e não impedem a execução seguinte. O painel permite ajustar horário e retenção de 7 a 365 backups; não oferece desligamento silencioso da proteção diária.
O backup completo inclui dump lógico PostgreSQL em formato apropriado, usuários e autenticação, ambientes, notas, configurações, permissões, assinaturas, históricos, uploads e configuração de recuperação. O arquivo fica criptografado com AES-256-GCM fora da pasta pública; o manifesto registra hashes SHA-256. A chave de recuperação fica separada do arquivo criptografado.
Criar backup agora agenda uma operação no servidor. Acompanhe o resultado: Agendado ou Em execução ainda não significa Concluído. Verificar integridade examina o arquivo. Baixar exige autenticação administrativa, autorização e HTTPS. A exclusão pede confirmação e protege o backup íntegro mais recente e o único íntegro disponível. Falhas ficam no histórico e geram aviso para administradores pelos canais disponíveis.
Pendência crítica da implantação: o destino externo autorizado ainda não está configurado e uma cópia externa real não foi verificada. Um backup apenas no disco local não atende à proteção completa. A integração aceita armazenamento S3 compatível, mas não presume buckets, credenciais ou permissões. O painel informa a pendência. A versão não pode ser considerada pronta para produção enquanto a cópia externa e a recuperação correspondente não forem efetivamente verificadas.
13. Recuperação completa e proteção dos dados
A preparação de restauração pelo painel verifica o arquivo e executa uma restauração em contêiner descartável isolado, sem rede externa, portas ou volumes de produção. A validação desta implantação já exercitou a restauração real do banco isolado e a verificação dos arquivos. Isso não significa que o banco em produção foi substituído.
Após selecionar um backup, a confirmação RESTAURAR revalida a preparação e produz um plano com uma cópia de segurança verificada. O fluxo atual prepara a recuperação; não sobrescreve automaticamente o servidor em uso. A aplicação final exige operador autorizado, janela de manutenção, preservação dos volumes atuais e procedimento controlado.
O responsável pela infraestrutura deve guardar uma cópia externa segura da chave de recuperação, separada dos backups. Sem essa chave, os arquivos criptografados não podem ser recuperados. Credenciais e chaves não devem ser enviadas por mensagens nem armazenadas no diretório público. O procedimento operacional e o retorno aos volumes preservados estão em docs/BACKUP_RECOVERY.md, disponível ao responsável pelo servidor.
14. Segurança e acesso autorizado
As operações validam a conta, as permissões do usuário e o acesso ao ambiente. Consultas parametrizadas e validação no servidor protegem os dados; ações de alteração exigem o token de sessão apropriado contra CSRF. Não compartilhe credenciais, cookies, códigos de recuperação ou arquivos privados de configuração.
Uma tentativa de acesso de administrador ou moderador com autenticação válida, originada fora da política de rede ou IPs autorizados, registra bloqueio automático. Enquanto bloqueada, a conta tem a rede confiável como caminho de recuperação, até o desbloqueio por um operador autorizado. Administradores mantêm o caminho de login pela Tailnet reconhecida pelo servidor; isso não remove banimentos, desativação ou outras exigências da conta.
A mensagem pública da restrição permanece apenas: Esta conta encontra-se indisponível no momento. Não são exibidas instruções de VPN na tela de acesso. No painel, o operador autorizado consulta a origem e o motivo e pode remover o bloqueio automático. Essa ação não altera a política de IPs, as exigências de rede nem outros bloqueios.
A autorização de atributos é aplicada também nas APIs. Seleção de itens, edição do HTML da página ou alteração de um identificador no navegador não concede permissões administrativas nem acesso a backups completos de outras contas.
15. Conexão, erros e resolução de problemas
Ao detectar falha de comunicação com a sincronização, o aplicativo mostra Estabelecendo conexão... e realiza até duas tentativas de recuperação em uma etapa de até 10 segundos. Se falhar, mostra Perda de comunicação. Os detalhes de diagnóstico ficam disponíveis apenas a administradores e moderadores.
As alterações pendentes permanecem no navegador durante a falha. Use Tentar novamente após recuperar a conexão. Recarregar depende da situação e preserva a proteção contra perda de alterações não salvas; não limpe os dados do navegador enquanto houver mudanças pendentes. O fluxo evita recargas contínuas e diferencia rede indisponível, sessão expirada e acesso negado.
Se a sessão expirar, entre novamente na conta. Se o acesso for negado, procure um administrador; repetir o envio não concede permissão. Para chave de IA inválida, confira a chave, o provedor e as permissões e use Validar e salvar. Para quota de IA, consulte os limites do provedor; não gere várias solicitações iguais.
Avisos e erros utilizam modais do aplicativo com X, sem depender de alertas nativos do navegador. Em falhas de backup, consulte o histórico e o código da ocorrência. Não declare um arquivo recuperável somente porque um agendamento existe. Se um PDF não abrir, use o visualizador do aplicativo; a forma de abrir PDFs diretamente também depende das preferências do navegador.
16. Novidades e situação da versão 1.0.8
Esta versão acrescenta seleção hierárquica por checkbox, limite de 50 caracteres para títulos novos de grupos e subgrupos, estabilidade da barra lateral, aviso de consumo de IA, credenciais privadas validadas, autocompletar com prévia e proteção do original, apresentação de novidades por usuário e recuperação de falhas de comunicação.
O painel amplia o controle de assinaturas e pagamentos conferidos, mantém permissões delegadas e disponibiliza a administração do backup diário no servidor. Imagens fixadas permitem redimensionamento. Avisos redundantes de salvamento foram reduzidos, preservando a exibição de erros.
A documentação descreve os recursos efetivamente presentes. O funcionamento completo do destino externo de backup ainda está pendente de configuração autorizada e verificação real. A versão 1.0.8 permanece em validação e não recebe declaração de pronta para produção com essa pendência crítica.