Sitemap · Área de Trabalho
A Área de Trabalho é uma rota única. A fila, o trilho de agendas, o painel do registro e a lixeira convivem na mesma página; o estado da tela fica nos parâmetros da URL. Os endpoints ficam na API Reference.
Rotas
| Rota do front | Página e finalidade | Ator no fluxo |
|---|---|---|
/area-de-trabalho | Consultar a fila de Trabalhos no alcance, capturar atividades, organizar agendas e listas, abrir o painel de um registro e consultar a lixeira. | Qualquer integrante autenticado; cada operação respeita o alcance decidido pela API. |
/area-de-trabalho?item=work-items:<id> | Abrir o painel de contexto do Trabalho sobre a fila, para leitura e edição. | Quem alcança o Trabalho; a edição exige poder de alteração. |
A rota está publicada sob a funcionalidade area-de-trabalho, em validação. Com a funcionalidade desligada, o acesso é redirecionado para /app. Uma URL não concede autorização: a leitura e as ações dependem do alcance calculado pela API.
Parâmetros da URL
Valores inválidos voltam ao padrão, e o valor padrão não aparece na URL. Parâmetros de lista aceitam repetição ou valores separados por vírgula.
| Parâmetro | Valores | Padrão | Efeito |
|---|---|---|---|
agenda | Identificador da agenda | Entrada | Abre a agenda no trilho e carrega suas listas. |
lista | Identificador da lista | Primeira lista manual da agenda | Restringe a fila aos Trabalhos da lista. |
busca | Texto | Vazio | Busca por palavra no título, descrição, local e etiquetas. |
recurso | todos, activities, appointments | todos | Restringe a fila a Atividades ou a Compromissos. |
agrupar | situacao, especie, nucleo, responsavel, recurso, nenhum | situacao | Agrupa a fila por prazo, espécie, núcleo, responsável ou tipo de registro. |
ordenar | manual, prazo_asc, prazo_desc, criacao_desc, titulo_asc | prazo_asc | Ordena a fila; manual segue a ordem da lista ativa. |
densidade | compacta, padrao, confortavel | padrao | Altera a altura das linhas. |
concluidas | 1, true, 0, false | 0 | Preferência de exibição dos concluídos. |
situacao | atrasada, hoje, semana, futura, sem_prazo | Vazio | Filtra pela situação do prazo; as visões Hoje e Atrasadas usam este parâmetro. |
especie | task, judicial_deadline, extrajudicial_deadline, service, meeting, hearing, expert_examination, oral_argument, orientation | Vazio | Filtra pela categoria do Trabalho. |
nucleo | Siglas de núcleo | Vazio | Filtra pelos núcleos responsáveis. |
responsavel | Identificadores de usuário | Vazio | Filtra pelos responsáveis designados. |
etiqueta | Texto | Vazio | Filtra pelas etiquetas do Trabalho. |
item | work-items:<id> | Vazio | Abre o painel de contexto do Trabalho. |
Funções da página
| Função | O que oferece | Histórias relacionadas |
|---|---|---|
| Trilho | Entrada, Hoje, Atrasadas e Lixeira, com contagens, seguidas das agendas pessoais e suas listas. Cria agenda com listas, renomeia agenda, cria, reordena e exclui lista. | US-WORKSPACE-023, US-WORKSPACE-027 |
| Faixa de resumo | Contagem por situação do prazo; cada faixa alterna o filtro situacao. | US-WORKSPACE-023 |
| Fila | Linhas com título, espécie, prazo, responsáveis e núcleos ou grupos, contagem de subtarefas, envolvidos e comentários. Agrupamento, ordenação, densidade, filtros por situação e espécie e seção dobrável de concluídos. | US-WORKSPACE-006, US-WORKSPACE-023 |
| Captura rápida | Campo no cabeçalho da fila que cria uma tarefa pelo título e, com lista ativa, a inclui na lista. | US-WORKSPACE-028, US-WORKSPACE-027 |
| Ações da linha | Concluir ou reabrir pelo círculo, reordenar na lista manual, remover da lista, excluir e abrir o painel nas ações de edição. | US-WORKSPACE-010, US-WORKSPACE-013, US-WORKSPACE-027 |
| Painel de contexto | Título, prazo, estado, responsáveis, núcleos e grupos, classificação, pessoas por papel, sigilo, descrição, orientação, adiamentos, histórico e comentários. Cada campo editável grava ao ser alterado. | US-WORKSPACE-005, US-WORKSPACE-009, US-WORKSPACE-010, US-WORKSPACE-012, US-WORKSPACE-016, US-WORKSPACE-025 |
| Menu de atribuição | Busca de usuários, pessoas, núcleos, subnúcleos e grupos de trabalho, com criação e edição de grupo. | US-WORKSPACE-005, US-WORKSPACE-024 |
| Lixeira | Painel com os Trabalhos excluídos no alcance e a ação Restaurar. | US-WORKSPACE-014 |
| Central de comandos | Atalhos para focar a captura e a busca, limpar filtros e percorrer os registros abertos. | US-WORKSPACE-026 |
Percurso
O integrante abre Área de Trabalho na navegação principal e chega à Entrada, com todos os Trabalhos abertos no seu alcance. Hoje e Atrasadas recortam a mesma fila pela situação do prazo. Ao escolher uma agenda, a fila passa a mostrar os Trabalhos da lista manual selecionada; listas de consulta aparecem no trilho e ainda não são abertas.
A captura rápida cria uma tarefa com o título digitado. Uma falha mantém o texto no campo para correção. Clicar numa linha abre o painel de contexto sem sair da fila; as setas do painel e os atalhos percorrem os registros da fila. Adiar e cancelar abrem diálogos que exigem motivo. A exclusão leva o Trabalho para a lixeira, de onde ele volta pela restauração.
O cartão Prazos da semana da página inicial e a seção de atividades da ficha de Pessoa abrem o Trabalho diretamente no painel, pelo parâmetro item.
Estados da página
| Estado | Apresentação |
|---|---|
| Carregando | Esqueleto da fila. |
| Fila vazia | Entrada limpa, com convite para capturar uma atividade ou escolher outra agenda. |
| Sem resultado | Nenhum item com os filtros ativos, com convite para ajustá-los. |
| Falha da fila | Erro ao carregar a fila, com a mensagem da API. |
| Falha parcial | Aviso de que agendas, listas, catálogos de atribuição ou responsáveis não puderam ser carregados; o restante da fila permanece disponível. |
| Registro indisponível | Painel em erro quando o Trabalho não existe ou não está no alcance. |
| Lixeira negada | Aviso de que o perfil não pode consultar os Trabalhos excluídos. |
| Falha inesperada | Página de erro com referência da falha e opção de tentar novamente. |
Páginas e operações da API
| Função | Operações |
|---|---|
| Fila e Entrada | GET /v1/work-items; GET /v1/work-items/people |
| Lixeira | GET /v1/work-items?trashed=true; POST /v1/work-items/{id}/restore |
| Captura rápida | POST /v1/work-items; GET e PUT nas listas da agenda |
| Painel de contexto | GET /v1/work-items/{id}; GET /v1/work-items/{id}/people; GET /v1/work-items/{id}/comments; GET /v1/history/work-item/{id}; PATCH /v1/work-items/{id} |
| Concluir e reabrir | POST /v1/work-items/{id}/advance; PATCH /v1/work-items/{id} |
| Adiar | POST /v1/work-items/{id}/postpone |
| Excluir | DELETE /v1/work-items/{id} |
| Atribuição | POST e DELETE em /v1/work-items/{id}/people; GET /v1/users/directory; GET /v1/people; GET /v1/nuclei; GET /v1/organization/subnuclei |
| Grupos de trabalho | GET, POST, PATCH e DELETE em /v1/work-groups |
| Comentários | GET, POST, PATCH e DELETE em /v1/work-items/{id}/comments |
| Agendas e listas | /v1/agendas, /v1/agendas/{id}/lists, /v1/agendas/{id}/lists/{listId}/items e /v1/agendas/{id}/lists/{listId}/order |
Referências do fluxo
Histórias do usuário · Regras de negócio