Organizações
Uma Organização é a entidade de nível mais alto no Axoria. Todos os projetos, membros, configurações, permissões e dados estão vinculados a uma organização. Sem uma organização, não é possível criar projetos ou colaborar com outras pessoas. Ao criar uma conta, você pode criar uma nova organização ou ingressar em uma existente por meio de convite.
Criando uma Organização
Qualquer usuário autenticado pode criar uma organização.
- Após o registro/login, clique em Criar Organização no painel inicial.
- Informe o nome da organização (mínimo 2 caracteres, máximo 100).
- O slug é gerado automaticamente com base no nome (letras minúsculas, números e hífens; 2-50 chars). O slug é imutável após a criação e compõe URLs da organização.
- Adicione um avatar (ícone embutido ou imagem, opcional).
- Confirme clicando em Criar.
Você se tornará automaticamente o Owner da organização criada.
Perfil da Organização
Onde: Configurações da Org → Geral
| Campo | Tipo | Regras |
|---|---|---|
| Nome | Texto | Max 100 chars. Obrigatório |
| Slug | Texto | [a-z0-9-]{2,50}. Único no sistema. Imutável após a criação |
| Descrição | Texto | Max 500 chars. Opcional |
| Logo | URL / Upload | Imagem da organização exibida no header |
| Ícone | String | Chave de ícone embutido (FontAwesome), alternativa ao logo |
| Status | Enum | ACTIVE, SUSPENDED ou DELETED |
Quem pode editar: membros com permissão MANAGE_ORGANIZATION (Owner, Admin ou via Grupo de Perfil).
Como é imposto: Todas as alterações no perfil da organização exigem a permissão adequada. Requisições não autorizadas são rejeitadas com HTTP 403.
Papéis da Organização
O Axoria possui quatro papéis organizacionais:
| Papel | Permissões |
|---|---|
| OWNER | Controle total: tudo que Admin pode + alterar plano + excluir organização. Não pode ser removido ou ter seu papel alterado |
| ADMIN | Equivale ao Owner em permissões operacionais - gerencia membros, projetos, configurações. Não pode excluir a org nem alterar o papel do Owner |
| MEMBER | Acesso somente aos projetos que foi adicionado. Sem acesso administrativo, a menos que receba permissões via Grupo de Perfil |
| GUEST | Papel mais restrito. Sem acesso padrão a projeto algum - somente o que for explicitamente concedido via grupo ou projeto |
Como as Permissões São Decididas
- OWNER → possui todas as
OrgPermissionautomaticamente - ADMIN → possui todas as
OrgPermissionautomaticamente - MEMBER / GUEST → possui somente as permissões atribuídas aos Grupos de Perfil dos quais faz parte
A resolução de permissões é executada no servidor a cada requisição: o sistema percorre os Grupos de Perfil do membro e verifica se algum grupo concede a permissão necessária. Se nenhum grupo concede → acesso negado.
Permissões da Organização (OrgPermission)
As permissões abaixo são as únicas que podem ser atribuídas via Grupos de Perfil:
| Permissão | O que permite |
|---|---|
MANAGE_ORGANIZATION |
Editar nome, descrição, logo, slugs e configurações gerais da org |
MANAGE_MEMBERS |
Adicionar, remover e alterar o papel de membros da org |
INVITE_MEMBERS |
Enviar convites para novos membros |
MANAGE_PROJECTS |
Criar, editar, arquivar projetos e configurar qualquer projeto da org |
MANAGE_PROJECT_MEMBERS |
Controlar o acesso de membros dentro de qualquer projeto |
MANAGE_BOARDS |
Configurar boards e colunas em qualquer projeto |
MANAGE_ISSUE_TYPES |
Criar e editar tipos de issue customizados em qualquer projeto |
MANAGE_WORKFLOWS |
Configurar workflows, status e transições em qualquer projeto |
MANAGE_SETTINGS |
Acessar a área de configurações da organização (grupos, plano) |
Importante: Owner e Admin não precisam de nenhum desses grupos - eles já possuem tudo. Os grupos servem para conceder poderes granulares a membros comuns.
Grupos de Perfil
Onde: Configurações da Org → Grupos de Perfil
Grupos de Perfil são categorias nomeadas que agrupam membros e compartilham um conjunto de permissões. Eles resolvem dois problemas:
- Permissões em lote: ao adicionar uma pessoa a um grupo, ela herda automaticamente todas as permissões do grupo.
- Acesso em lote a projetos: ao convidar um grupo inteiro para um projeto, todos os membros recebem o mesmo papel de projeto.
Criando um Grupo
Quem pode criar: membros com MANAGE_SETTINGS (Owner, Admin ou via outro grupo).
- Acesse Configurações → Grupos de Perfil → + Novo Grupo
- Informe o nome (único por organização)
- Selecione as permissões que os membros do grupo terão
- Confirme
Editando um Grupo
O nome e as permissões de um grupo podem ser editados a qualquer momento. A mudança de permissões é aplicada imediatamente a todos os membros do grupo.
Excluindo um Grupo
- Grupos criados pelo sistema não podem ser excluídos.
- Ao excluir um grupo, os membros perdem as permissões que o grupo concedia. O acesso individual a projetos onde foram adicionados diretamente não é removido automaticamente.
Adicionando e Removendo Membros de Grupos
Quem pode: membros com MANAGE_MEMBERS.
- Adicionar um membro a um grupo → ele herda as permissões do grupo imediatamente.
- Remover um membro de um grupo → ele perde as permissões do grupo, mas não perde o acesso a projetos onde foi adicionado individualmente.
Usando Grupos para Conceder Acesso a Projetos
Ao adicionar membros a um projeto (em Projeto → Configurações → Membros), você pode adicionar um grupo inteiro em vez de usuários individuais. Todos os membros do grupo recebem o mesmo papel no projeto.
Membros da Organização
Onde: Configurações da Org → Membros
Convidando um Membro
Quem pode: membros com MANAGE_MEMBERS ou INVITE_MEMBERS.
- Acesse Configurações → Membros → + Adicionar Membro
- Informe o e-mail do usuário
- Selecione o papel (
OWNER,ADMIN,MEMBERouGUEST) - Opcionalmente, atribua Grupos de Perfil ao novo membro
- Clique em Enviar Convite
O usuário recebe um e-mail com o link de convite. Ao aceitar, terá acesso à organização com o papel e grupos definidos.
Alterando o Papel de um Membro
Quem pode: membros com MANAGE_MEMBERS.
Regras obrigatórias:
- O papel do Owner não pode ser alterado por ninguém - nem mesmo por outro Owner.
- Um Admin pode alterar o papel de Members e Guests, mas não de outro Admin ou do Owner.
Se a tentativa for feita → HTTP 403 FORBIDDEN.
Removendo um Membro
Quem pode: membros com MANAGE_MEMBERS.
Regras obrigatórias:
- O Owner não pode ser removido da organização.
- Ao remover um membro da organização, ele perde acesso a todos os projetos da org automaticamente.
- Issues atribuídas ao membro removido não são reatribuídas automaticamente.
Atualizando os Grupos de um Membro
Quem pode: membros com MANAGE_MEMBERS.
Você pode adicionar ou remover grupos de um membro existente a qualquer momento pelo menu de ação ao lado do membro na lista.
Projetos da Organização
Onde: Configurações da Org → Projetos
A listagem de projetos da organização é visível para qualquer membro. A partir desta tela, membros autorizados podem:
- Criar novos projetos - requer
MANAGE_PROJECTSou ser Owner/Admin - Ver o status de projetos existentes (ativo, arquivado)
- Acessar configurações de um projeto - requer
MANAGE_PROJECTS,PROJECT_ADMINno projeto, ou ser Owner/Admin
Campos ao Criar um Projeto
| Campo | Tipo | Regras |
|---|---|---|
| Nome | Texto | Obrigatório |
| Key | Texto | 2-10 chars, [A-Z0-9]. Imutável após criação |
| Descrição | Texto | Opcional |
| Tipo | Enum | SOFTWARE, BUSINESS, KANBAN, SCRUM, CUSTOM |
| Visibilidade | Enum | PRIVATE, INTERNAL, PUBLIC |
| Líder | UUID | Usuário responsável pelo projeto (opcional) |
Plano e Cobrança
Onde: Configurações da Org → Plano e Cobrança
Cada organização está em um dos quatro planos:
| Plano | Características |
|---|---|
FREE |
Projetos e membros limitados; sem recursos avançados |
STARTER |
Limite maior de projetos e membros; relatórios básicos |
PROFESSIONAL |
Relatórios avançados, integrações, armazenamento expandido |
ENTERPRISE |
Sem limites práticos; suporte dedicado; SLA |
O plano atual define:
- Número máximo de projetos ativos
- Número máximo de membros
- Acesso a relatórios públicos (tokens de relatório)
- Integrações e capacidade de armazenamento de arquivos
Para verificar ou alterar o plano, acesse Configurações → Plano e Cobrança.
Zona de Perigo
Onde: Configurações da Org → Zona de Perigo
Suspender a Organização
Suspender muda o status da organização para SUSPENDED. Organizações suspensas:
- Permanecem acessíveis para o Owner gerenciar
- Bloqueiam o acesso de membros comuns
- Preservam todos os dados integralmente
Quem pode: somente Owner.
Excluir a Organização
⚠️ Ação completamente irreversível. Excluir uma organização remove permanentemente todos os projetos, issues, sprints, membros, configurações e arquivos associados. Esta ação não pode ser desfeita.
Quem pode: somente Owner.
Processo:
- Acesse Configurações → Zona de Perigo → Excluir Organização
- Confirme digitando o nome da organização no campo de verificação
- Clique em Excluir Permanentemente
Resumo Completo - Quem Pode Fazer o Quê
| Ação | MEMBER/GUEST sem grupo | MEMBER com grupo adequado | ADMIN | OWNER |
|---|---|---|---|---|
| Criar organização | ✅ (qualquer usuário) | ✅ | ✅ | ✅ |
| Ver lista de membros | ✅ | ✅ | ✅ | ✅ |
| Editar perfil da org | ❌ | MANAGE_ORGANIZATION |
✅ | ✅ |
| Convidar membros | ❌ | INVITE_MEMBERS |
✅ | ✅ |
| Gerenciar membros | ❌ | MANAGE_MEMBERS |
✅ | ✅ |
| Criar grupos de perfil | ❌ | MANAGE_SETTINGS |
✅ | ✅ |
| Gerenciar grupos | ❌ | MANAGE_SETTINGS |
✅ | ✅ |
| Criar projetos | ❌ | MANAGE_PROJECTS |
✅ | ✅ |
| Configurar projetos | ❌ | MANAGE_PROJECTS |
✅ | ✅ |
| Gerenciar boards | ❌ | MANAGE_BOARDS |
✅ | ✅ |
| Gerenciar workflows | ❌ | MANAGE_WORKFLOWS |
✅ | ✅ |
| Alterar papel do Owner | ❌ | ❌ | ❌ | ❌ (ninguém) |
| Remover o Owner | ❌ | ❌ | ❌ | ❌ (ninguém) |
| Suspender a org | ❌ | ❌ | ❌ | ✅ |
| Excluir a org | ❌ | ❌ | ❌ | ✅ |
Como as Regras São Impostas
Todas as verificações são executadas no backend, não no frontend:
| Cenário | Resposta do sistema |
|---|---|
| Usuário sem permissão tenta uma operação | HTTP 403 Forbidden |
| Usuário não autenticado tenta uma operação | HTTP 401 Unauthorized |
| Membro tenta alterar papel do Owner | HTTP 403 |
| Membro tenta remover o Owner | HTTP 403 |
| Membro não pertence à organização | HTTP 403 |
| Usuário acessa página sem permissão | Redirecionado para a página de erro |
O frontend oculta botões e menus para ações não autorizadas, mas toda a aplicação real das regras é realizada pelo backend a cada requisição.
Criando uma Organização
- Após o registro, clique em Criar Organização.
- Informe o nome da organização (mínimo de 2 caracteres).
- Adicione um avatar (opcional) arrastando uma imagem ou clicando em Selecionar Arquivo.
- Confirme clicando em Criar.
Você se tornará automaticamente o Owner da organização recém-criada.
Perfil da Organização
No painel de configurações você pode:
- Alterar o nome e slug da organização
- Atualizar o avatar (ícone embutido ou imagem personalizada)
- Adicionar uma descrição sobre a organização
Membros
Convidando Membros
Para convidar um novo membro:
- Acesse Configurações → Membros.
- Insira o e-mail do usuário que deseja convidar.
- Selecione o papel a ser atribuído ao convidado.
- Clique em Enviar Convite.
O usuário receberá um convite e, ao aceitar, terá acesso à organização com o papel definido.
Papéis na Organização
| Papel | Descrição |
|---|---|
| Owner | Controle total sobre a organização, membros, projetos e cobrança. |
| Admin | Pode gerenciar membros, projetos e configurações gerais. |
| Member | Acesso aos projetos conforme permissões concedidas pelos papéis. |
Removendo Membros
Um Admin ou Owner pode remover qualquer membro acessando Configurações → Membros e clicando em Remover.
Nota: o Owner não pode ser removido da organização por outros membros.
Grupos de Perfil
Grupos de Perfil permitem organizar membros em categorias personalizadas - como "Equipe de Produto", "QA" ou "Parceiros Externos". Eles simplificam a concessão de acesso a projetos em lote.
Criando um Grupo
- Acesse Configurações → Grupos de Perfil.
- Clique em Novo Grupo e defina um nome.
- Adicione os membros ao grupo.
Usando Grupos em Projetos
Ao gerenciar membros de um projeto, você pode adicionar um grupo inteiro em vez de cada pessoa individualmente, concedendo o mesmo papel a todos os membros do grupo.
Remover um membro de um grupo não remove automaticamente seu acesso a projetos onde ele foi adicionado individualmente.
Planos e Limites
Cada organização enquadra-se em um plano que define:
- Número máximo de projetos ativos
- Número máximo de membros
- Acesso a recursos avançados (relatórios públicos, integrações, armazenamento)
Para verificar ou alterar o plano, acesse Configurações → Plano e Cobrança.
Excluindo uma Organização
⚠️ Ação irreversível. Excluir uma organização remove permanentemente todos os projetos, issues, sprints e dados associados.
Somente o Owner pode excluir a organização em Configurações → Zona de Perigo → Excluir Organização.