Overview do domínio · Área de Trabalho

O que o domínio resolve

A Área de Trabalho registra o que o escritório tem para fazer e quem responde por isso. Ela reúne o trabalho com prazo a cumprir e o trabalho com hora marcada numa entidade única, o Trabalho, e organiza em torno dele o prazo, as pessoas ligadas ao registro, a conversa, os documentos anexados e a trilha do que aconteceu.

O Trabalho tem dois tipos, e o tipo decide o que faz sentido preencher:

Tipo	O que é	O que o distingue
Atividade	Tarefa interna ou prazo a cumprir	Tem vencimento contado por regra; não tem hora marcada
Compromisso	Ato com hora marcada	Tem data e hora, duração, local e formato do encontro

A categoria refina o tipo. Atividade aceita task, judicial_deadline e extrajudicial_deadline. Compromisso aceita service, meeting, hearing, expert_examination, oral_argument e orientation. Uma categoria fora do tipo é recusada.

Conceitos do domínio

Trabalho — o registro central, identificado por tipo e categoria, com título, descrição, etiquetas e prioridade.
Prazo — o vencimento da Atividade. Entra por data explícita ou por uma data-base somada a uma quantidade de dias, contada por uma regra de contagem que o servidor deriva da categoria ou do Modelo.
Regra de contagem — dias corridos, dias úteis, ou dias corridos com vencimento rolado para o próximo dia útil.
Calendário de Prazos — os feriados cadastrados que decidem quais dias são úteis.
Alcance — o resultado: quem enxerga um Trabalho e o que pode fazer com ele. Ninguém informa o alcance; o sistema o calcula a cada consulta, a partir dos vínculos que a pessoa tem com aquele Trabalho.
Designação — o ato de ligar um usuário, uma Pessoa, um núcleo ou subnúcleo, ou um Grupo de Trabalho a um Trabalho, num papel. É um dos vínculos que produzem alcance, e o único que alguém cria e desfaz por decisão.
Sigilo — a marca que restringe o Trabalho a quem tem ligação direta com ele. Com o sigilo ligado, quem enxergaria o Trabalho apenas por pertencer ao núcleo responsável ou ao grupo deixa de enxergá-lo; o dono e as pessoas ligadas nominalmente continuam enxergando.
Situação — o passo do quadro do núcleo em que a Atividade se encontra, cadastrado por núcleo.
Modelo de Trabalho — a forma do Trabalho: dias, regra de contagem, orientação, prioridade e designações padrão.
Grupo de Trabalho — conjunto de usuários que respondem juntos por Trabalhos. Tem dono, é criado por qualquer integrante e, quando desabilitado, deixa de dar alcance.
Agenda — organização pessoal da Área de Trabalho em listas. A lista manual reúne Trabalhos escolhidos, na ordem definida pela pessoa.
Visão salva — a lista ou o filtro pessoal de cada pessoa.
Trilha — a sequência imutável de eventos do Trabalho: criação, alterações, transições, adiamentos, designações, exclusão e restauração.
Preferências de uso — o vocabulário pessoal de etiquetas e os hábitos de uso, que registram o que cada pessoa usa com mais frequência.
Orientação — o texto que instrui quem executa; pode ser reutilizável do cadastro ou próprio daquele Trabalho.

Ciclo de vida do Trabalho

O Trabalho nasce pendente e pertence a quem o criou.

Criação. O autor informa tipo, categoria e título. Para Atividade com prazo, informa o vencimento ou a data-base com a quantidade de dias; o servidor calcula a data final pela regra e pelo calendário. Para Compromisso, informa a hora marcada.
Designação. Usuários, Pessoas, núcleos, subnúcleos e grupos são ligados ao Trabalho em papéis. Designar um núcleo ou subnúcleo como responsável ou envolvido o torna responsável pelo Trabalho, e é isso que o torna visível a quem pertence a ele.
Andamento. A Atividade percorre a sequência de Situações do seu núcleo. O Trabalho pode ser adiado, e o adiamento fica registrado com data anterior, data nova e motivo. Adiar um Compromisso o leva ao estado adiado; adiar uma Atividade move o vencimento e a mantém no estado em que estava, porque quem adia um prazo continua tendo o prazo a cumprir.
Encerramento. Concluir sela quem concluiu e quando. Cancelar exige motivo. O atendimento que não aconteceu é encerrado como não comparecimento.
Reabertura. Um Trabalho concluído ou cancelado pode voltar ao estado inicial, e a volta apaga os selos do encerramento anterior.
Exclusão. A exclusão é suave: o Trabalho sai das listas, permanece na lixeira e pode ser restaurado por quem tem autoridade para selar.

Estados publicados

Estado	Significado	Onde aparece
`pending`	Aguardando execução	Atividade e Compromisso
`in_progress`	Em execução	Atividade
`completed`	Concluído	Atividade e Compromisso
`cancelled`	Cancelado, com motivo registrado	Atividade e Compromisso
`postponed`	Adiado para nova hora marcada	Compromisso
`no_show`	Atendimento em que o cliente não compareceu	Compromisso de atendimento
`overdue`	Compromisso pendente cuja hora marcada já passou	Leitura apenas

overdue é calculado na leitura e nunca gravado: reagendar o Compromisso devolve o estado anterior sem nenhuma correção manual.

Como o alcance é decidido

Alcance e designação não são a mesma coisa: a designação é um ato, e o alcance é o resultado. Designar alguém é uma das formas de dar alcance, e não a única — ser o dono, pertencer ao núcleo responsável, participar de um grupo ligado e o próprio perfil da conta também dão.

De onde vem o alcance	Como surge
Ser o dono do Trabalho	Automático: quem cria o Trabalho é o dono.
Estar designado	Por decisão: alguém liga a pessoa ao Trabalho, num papel.
Pertencer ao núcleo responsável	Indireto: um núcleo ou subnúcleo foi designado, e a pessoa pertence a ele. Quem pertence a um núcleo também alcança o que foi atribuído aos subnúcleos vigentes desse núcleo.
Participar de um grupo ligado	Indireto: o Grupo de Trabalho habilitado foi designado, e a pessoa é membro dele.
Ter Acesso Global	Pelo perfil da conta, independente de vínculo com o Trabalho.

A decisão de acesso acontece registro a registro, na API, e vale igualmente para a listagem e para a leitura de um item.

Ação	Quem pode
Ler	O dono; quem está ligado ao Trabalho como usuário, em qualquer papel; quem pertence ao núcleo responsável; quem participa de grupo ligado; Acesso Global
Alterar	O dono; quem responde pelo Trabalho; quem pertence ao núcleo responsável; Acesso Global. O Operacional Restrito altera apenas o que lhe foi designado pessoalmente
Excluir e restaurar	O dono; o líder de núcleo responsável; Acesso Global

O sigilo corta os dois caminhos indiretos da tabela acima: quem alcançaria o Trabalho apenas por pertencer ao núcleo responsável ou ao grupo deixa de alcançá-lo. Os caminhos diretos permanecem — o dono e quem foi designado nominalmente continuam lendo. Quem não alcança um Trabalho recebe a mesma resposta de quem pede um registro inexistente.

O que não pertence ao domínio

O cadastro de pessoas, os processos, as entrevistas e o atendimento presencial são domínios próprios; a Área de Trabalho apenas referencia seus registros. O envio de mensagens, o histórico e os anexos são serviços compartilhados, usados pela Área de Trabalho e por outros domínios.

A Área de Trabalho no dia a dia

A pessoa chega à Entrada, que reúne os Trabalhos abertos no seu alcance. Hoje e Atrasadas recortam essa fila pela situação do prazo, e a Lixeira guarda o que foi excluído. As agendas pessoais organizam o trabalho em listas, e a fila pode ser agrupada, ordenada e filtrada.

A captura rápida registra uma tarefa pelo título. Ao abrir um Trabalho, o painel de contexto reúne prazo, estado, responsáveis, núcleos e grupos, classificação, pessoas por papel, sigilo, descrição, orientação, adiamentos, trilha e comentários. A conclusão, o adiamento, o cancelamento, a designação e a exclusão partem da fila ou do painel.