Guia de Uso - Axoria v1.0.0

Este guia apresenta o fluxo completo desde o registro até a criação e gestão de issues no Axoria.

---

1. Criando sua Conta

Acesse /register e preencha:

Campo	Requisito
Nome de usuário	Único, sem espaços
Email	Deve ser de um provedor público (Gmail, Outlook etc.)
Senha	Mínimo 8 caracteres com ao menos 1 caractere especial

Após o cadastro, faça login em /login.

Nota: Domínios corporativos não são permitidos no registro direto. Entre em contato com o suporte Axoria para planos empresariais.

---

2. Criando uma Organização

Após o primeiro login, você será direcionado ao Dashboard. A partir daí:

1. Clique em "+ Nova Organização"
2. Preencha o nome e o slug (ex: minha-empresa)
3. Clique em "Criar Organização"

O slug é o identificador único na URL e não pode ser alterado após a criação.

---

3. Criando um Projeto

Dentro da organização:

1. Clique em "+ Novo Projeto"
2. Defina:
   • Nome: descritivo (ex: "Plataforma Web")
   • Chave: curta e em maiúsculas (ex: WEB) - prefixo das issues: WEB-1
   • Tipo: SOFTWARE, KANBAN, SCRUM, BUSINESS ou CUSTOM
3. Clique em "Criar Projeto"

---

4. Configurando o Projeto

Após criar o projeto, acesse Configurações para personalizar:

Workflow

Crie os status que descrevem o ciclo de vida das suas issues:

A Fazer → Em Andamento → Em Revisão → Concluído

Configure quais transições são permitidas entre os status.

Board

Configure as colunas e mapeie cada coluna para um ou mais status do workflow.

Tipos de Issue e Prioridades

Ative ou desative tipos (Task, Bug, Story etc.) e prioridades (Critical, High, Medium etc.) de acordo com as necessidades do seu time.

---

5. Adicionando Membros

1. Acesse Membros do projeto
2. Clique em "+ Adicionar Membro"
3. Informe o email do usuário (deve ter conta no Axoria e pertencer à organização)
4. Selecione o papel: PROJECT_ADMIN, DEVELOPER, REPORTER ou VIEWER
5. Confirme

---

6. Criando Issues

No Board do projeto:

1. Clique em "+ Create Issue"
2. Preencha:
   • Título (obrigatório)
   • Tipo: Task, Bug, Story, Epic etc.
   • Prioridade: Critical, High, Medium, Low, Trivial
   • Responsáveis: membros do projeto
   • Descrição com suporte completo a Markdown
3. Clique em "Criar"

A issue aparecerá no board no status inicial do workflow.

---

7. Gerenciando Issues no Board

Movendo Issues

Arraste cards entre colunas (drag-and-drop) ou altere o status no painel de detalhes.

Painel de Detalhes

Clique em qualquer card para abrir o painel lateral com:

• Editar título, tipo, prioridade e status
• Adicionar/remover responsáveis
• Definir datas de início e vencimento
• Adicionar comentários
• Ver histórico de alterações

Filtros

Use a barra de filtros do board para visualizar issues por:

• Responsável
• Tipo
• Prioridade
• Texto no título

---

8. Trabalhando com Sprints

Criando uma Sprint

No Backlog:

1. Clique em "+ Criar Sprint"
2. Defina nome, meta, data de início e data de fim
3. Arraste issues do backlog para a sprint

Iniciando a Sprint

Clique em "Iniciar Sprint" quando estiver pronto. Apenas uma sprint pode estar ativa por projeto.

Concluindo a Sprint

Clique em "Concluir Sprint". Issues não concluídas podem ser movidas para o backlog ou para a próxima sprint.

---

9. Importando e Exportando Issues

Importar

Prepare um CSV com colunas title, type, priority, description e envie na tela de Importação do projeto.

Exportar

Acesse a tela de Exportação do projeto, aplique filtros e baixe o arquivo em CSV ou Excel.

---

Próximos Passos

• Explore os Diferenciais da plataforma no Changelog
• Configure Webhooks em Configurações → Webhooks para integrações externas
• Crie Grupos de Perfil na organização para permissões granulares