Sistema de gerenciamento de chamados inspirado no Jira Service Management.

A aplicação organiza os atendimentos através de uma estrutura hierárquica de Portais, Categorias e Subtópicos, permitindo que diferentes áreas da empresa possuam seus próprios catálogos de serviços.

Todas as requisições são autenticadas através de JWT emitido pelo Authentication Service.

Porta padrão: 8082

• Java 17 + Spring Boot 3
• Spring Security OAuth2 Resource Server (validação de JWT)
• Spring Data JPA + Hibernate
• MySQL
• Lombok

src/main/java/com/example/jira/
├── config/
│   └── SecurityConfig.java
├── controller/
│   ├── ChamadoController.java
│   ├── TimeController.java
│   └── ConfigChamadoController.java
├── dto/
│   ├── CategoriaResumoDTO.java
│   ├── ChamadoRequestDTO.java
│   ├── ChamadoResponseDTO.java
│   ├── ComentarioDTO.java
│   ├── ComentarioRequestDTO.java
│   └── SubtopicoRequestDTO.java
├── enums/
│   ├── Escopo.java
│   ├── Prioridade.java
│   └── Status.java
├── model/
│   ├── Portal.java
│   ├── Categoria.java
│   ├── Subtopico.java
│   ├── Chamado.java
│   ├── Comentario.java
│   └── Time.java
├── repository/
│   ├── PortalRepository.java
│   ├── CategoriaRepository.java
│   ├── SubtopicoRepository.java
│   ├── ChamadoRepository.java
│   └── TimeRepository.java
└── service/
    ├── ChamadoService.java
    └── ChamadoConfigService.java

spring.application.name=jira

spring.datasource.url=jdbc:mysql://localhost:3306/jira_db
spring.datasource.username=${DB_USER}
spring.datasource.password=${DB_PASS}

spring.security.oauth2.resourceserver.jwt.secret-key=${JWT_SECRET_BASE64}

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=false

Importante: a chave JWT deve ser exatamente a mesma utilizada pelo Authentication Service.

Os chamados seguem uma estrutura hierárquica.

Portal
 ├── Categoria
 │      ├── Subtópico
 │      ├── Subtópico
 │      └── Subtópico
 │
 ├── Categoria
 │      └── Subtópico
 │
 └── Categoria

Ao abrir um chamado o usuário seleciona:

• Portal
• Categoria
• Subtópico

Essa arquitetura facilita a organização de serviços por departamento, área de negócio ou produto.

• BAIXA
• NORMAL
• ALTA

Todos os endpoints exigem:

Authorization: Bearer <token>

Base:

/chamados

{
  "portalId": 1,
  "categoriaId": 3,
  "subtopicoId": 8,
  "outroSubtopico": null,
  "prioridade": "ALTA",
  "titulo": "Notebook não liga",
  "descricao": "Após atualização o equipamento não inicializa.",
  "escopo": "TODOS"
}

"EM_PROGRESSO"

{
  "mensagem": "Problema identificado e em análise."
}

Base:

/times

{
  "userId": 42
}

Base:

/config/chamados

{
  "nome": "Tecnologia",
  "descricao": "Portal destinado às solicitações de TI."
}

{
  "nome": "Hardware",
  "portalId": 1
}

{
  "nome": "Notebook",
  "categoriaId": 3
}

Portal (1)
   │
   └────────────── (N) Categoria
                        │
                        └────────────── (N) Subtopico
                                              │
                                              │
                                   (N) Chamado (1)
                                              │
                                              │
                                       (N) Comentario

Time
 └── membros

• Um Portal pode possuir várias Categorias.
• Uma Categoria pertence obrigatoriamente a um Portal.
• Uma Categoria pode possuir vários Subtópicos.
• Um Subtópico pertence obrigatoriamente a uma Categoria.
• Um Chamado referencia Portal, Categoria e Subtópico.
• Chamados são criados automaticamente com status ABERTO.
• Comentários não podem ser adicionados em chamados FECHADO.
• O método fechar() impede fechamento duplicado.
• Deletar um Portal remove todas as Categorias e Subtópicos associados.
• Deletar uma Categoria remove todos os seus Subtópicos.
• O usuário autenticado é obtido através do JWT; apenas o userId é armazenado no chamado.

git clone https://github.com/ranixx1/tessitura_jira.git

cd tessitura

export DB_USER=root
export DB_PASS=sua_senha
export JWT_SECRET_BASE64=sua_chave_base64

./mvnw spring-boot:run

O serviço estará disponível em:

http://localhost:8082

O Authentication Service deve estar em execução para validação dos JWTs.

• CRUD de chamados
• Comentários
• Portais
• Categorias
• Subtópicos
• Upload de anexos
• Campos personalizados
• Histórico de alterações
• SLA por chamado

• Responsável pelo chamado
• Atribuição automática por regras
• Observadores
• Menções (@usuário)
• Comentários internos

• Permissões por Portal
• Formulários personalizados por Portal
• Base de Conhecimento (Knowledge Base)
• Artigos vinculados às Categorias

• Dashboard
• Chamados por Portal
• Chamados por Categoria
• Chamados por Prioridade
• Tempo médio de atendimento
• Cumprimento de SLA