Entidade APROPRIACAO_HORAS

PROJET.APROPRIACAO_HORAS

Descrição

Registro histórico das atividades que foram executadas em um determinado horário por uma determinada pessoa. Os horários das apropriações não podem se sobrepor. Normalmente referem-se a uma atividade planejada e que está associada a um projeto.
As apropriações de horas são instrumento para vários propósitos:

Atributos

AtributoDomínioRegrasDescrição
IDID(18)Rqd PK Id:
Chave de identificação interna
PESSOA_IDID(18)Rqd FK Pessoa:
Indica a pessoa que exerceu a atividade.

Referência para PESSOAS
DATADATEData:
Data da apropriação. Se não informado e inicio for informado, a data será a mesma do início.
HORA_INICIODAY_TIME(5)Hora de início:
Hora em que a apropriação foi iniciada. Caso não informada, e início informado, então infere de lá.
HORA_TERMINODAY_TIME(5)Hora de término:
Hora em que encerrou a apropriação. Caso não informado e fim informado, infere dele.
INICIODATE_TIME_HMRqd AK Início:
Data e hora em que a atividade foi iniciada. Caso não informado e os campos data e hora inicial estiverem informados, então infere.

Não permite informar uma data futura maior do que a tolerância configurada em PROJET.APROPRIACAO_HORAS.TOLERANCIA_HORA_INICIO
FIMDATE_TIME_HMAK Fim:
Data e hora em que a apropriação foi encerrada. Caso não informado e atributos data e hora de término informados, infere.
INDICEVALUE(18)Rqd Índice:
Valor para multiplicação do valor da hora trabalhada. Este índice é utilizado, por exemplo, para compensar adicionais noturnos ou trabalhos em finais de semana ou execução de atividades paralelas. Exemplos:
  • 1,00 -> Hora padrão.
  • 1,50 -> Horas extras com 50% de adicional.
  • 2,00 -> Hora final de semana com 100% de adicional.
  • 0,50 -> Atividade realizada em paralelo com outras atividades.

Valor padrão = 1
TEMPODOUBLE(18)Tempo:
Tempo de apropriação do registro em horas. Calculado automaticamente quando os horários de início e fim estão preenchidos e já considera o índice de correção informado.
ATIVIDADE_IDID(18)FK Atividade:
Indica a atividade exercida durante a apropriação.

Referência para ATIVIDADES
DESCRICAOWIKIDescrição:
Texto livre para descrever o que foi feito na apropriação. Ao salvar a apropriação, o sistema interpreta o que foi escrito e atualiza a atividade conforme a seguinte convenção.
A interpretação da descrição da apropriação é realizada linha a linha e segue os seguintes critérios:
  • OK item-check-list: Quando uma linha da descrição começar com OK e incluir um item do checklist, marca este item como concluído.
  • NOK item-check-list: Quando uma linha da descrição começar com NOK e incluir um item do checklist, desmarca a conclusão deste item.
  • RESPONSAVEL = pessoa: Altera o responsável pela atividade
  • APROVADO: Aprova a atividade
  • ENCERRADO: Encerra a atividade
  • SUSPENSO: Suspende a atividade
  • CANCELADO: Cancela a atividade
  • TEMPO ESTIMADO = 999.9: Altera o tempo estimado da atividade
  • ACEITO: Registra o aceite da atividade
  • PRIORIDADE = [URGENTE|ALTA|MEDIA|BAIXA|MINIMA|SEM PRIORIDADE]: Altera a prioridade da atividade

Todos os demais textos são aceitos livremente e servem apenas como informação.
ACOESSELECTION_CHECK(10)Ações:
Ações adicionais a serem aplicadas sobre a atividade.

Valores permitidos:
  • A - Aprovar - Realiza a aprovação da apropriação por parte do cliente. Vai estar disponível apenas para tipos de atividades que precisam de aprovação e que ainda não foram aprovadas. A exclusão de aprovação só é possível na própria atividade.
  • E - Executar - Caso marcada, coloca a atividade em execução. Estará disponível apenas para atividades pendentes (aprovadas ou que não precisam de aprovação) ou que já estão em execução.
  • O - Concluir - Caso marcado, conclui a atividade. Só estará disponível se a atividade está pendente ou em execução. A conclusão pode ser revertida reabrindo a ocorrência.
  • V - Validar - Indica que o cliente validou a atividade (registro de aceite). Só vai estar disponível se a atividade estiver concluída.
  • S - Suspender - Suspende a atividade. A suspensão pode ser desfeita através da ação "Reabrir".
  • C - Cancelar - Caso marcado, cancela a atividade. Não estará disponível para atividade já cancelada ou aceita. O cancelamento pode ser desfeito através da ação "Reabrir".
  • U - Reabrir - Reabre a atividade, removendo as datas de cancelamento, aceite, suspensão e/ou conclusão. Somente estará disponível para atividades canceladas, suspensas, concluídas ou aceitas.
EXECUTA_ATIVIDADEFLAG(1)Rqd Executa a atividade:
Define se esta apropriação caracteriza a execução da atividade. Permite incluir apropriações de horas que não alteram a situação da mesma como "Em execução". Normalmente são apropriações de preparação, planejamento ou de estimativa da mesma.

Valor padrão = S
ENCERRA_ATIVIDADEFLAG(1)Rqd Encerra atividade:
Indica se esta apropriação encerra a atividade relacionada.

Valor padrão = N
TIPO_APROPRIACAO_IDID(18)FK Tipo de apropriação:
Indica o tipo de atividade exercida na apropriação.

Referência para TIPOS_APROPRIACOES
TIPO_ATIVIDADE_IDID(18)FK Tipo de atividade:
Classifica o tipo de atividade dessa apropriação.
É obrigatório quando não for informada uma atividade.
Quando não informado (e uma atividade foi informada), subentendesse que o tipo de atividade dessa apropriação é o mesmo da atividade informada.

Referência para TIPOS_ATIVIDADES
INTERVALOTIME(5)Intervalo:
Define um tempo de intervalo ocorrido durante a apropriação.
REGRA_CUSTEIO_IDID(18)FK Forma de calculo:
Forma para realizar o calculo do custeio da apropriação

Referência para REGRAS_CUSTEIO_APROPRIACOES
CUSTO_HORAVALUE(18)Custo hora:
Custo da hora do profissional.
CONTA_FATURAMENTO_IDID(18)FK Conta de faturamento:
Indica que esta apropriação está vinculada a uma conta de faturamento.

Referência para CONTAS_FATURAMENTO_ATIVIDADE
LANCAMENTO_FATURAMENTO_IDID(18)FK Lançamento de faturamento:
Determina qual o lançamento que contabilizou as horas desta apropriação na conta de faturamento.

Referência para LANCAMENTOS_FATURAMENTO_ATIVIDADE

Regras

Calcular horários de início e fim da apropriação

(Antes de inserir, Antes de alterar)
Quando a hora de início ou hora de fim forem informados, calcula a data/hora de início e fim e vice-versa.
Garante que os atributos data, inicio, fim, hora-inicio e hora-fim sejam preenchidos e consistentes.

Calcular tempo apropriado

(Antes de inserir, Antes de alterar)
Calcular o tempo da apropriação quando início e fim estiverem preenchidos.

Atualizar a atividade quando for o caso

(Depois de inserir, Depois de alterar, Depois de excluir)
Atualizar a atividade quando for necessário:

Adicionar pessoa na equipe

(Depois de inserir, Depois de alterar)
Quando uma pessoa apropria horas e não faz parte da equipe da atividade, ela será automaticamente adicionada.

Validar sobreposição de horários

(Depois de inserir, Depois de alterar)
Caso o tipo de atividade tenha o campo Permite sobrepor desmarcado esta rotina impede o registro de apropriações que se sobreponham na linha de tempo, verificando se os valores de início e fim registrados não estão apropriados dentro de algum registro para a mesma pessoa.
OBS: os testes de sobreposição serão realizados apenas entre apropriações que não permitem sobreposição.

Encerrar pendentes se necessário

(Antes de inserir)
Caso a atividade não permita sobrepor horários, encerra as apropriações anteriores.

Hora de início deve ser menor ou igual a hora de fim!

(Antes de inserir, Antes de alterar)
A hora de término não pode ser menor que a hora de início, quando ambos os horários forem preenchidos.

Tipo de atividade e descrição são obrigatórios quando atividade não informada!

(Antes de inserir, Antes de alterar)
Quando a atividade for informada, subentendesse que o tipo de atividade e a descrição são as mesmas da respectiva atividade.
Quando tipo de atividade for informado verificar se ela permite apropriação de horas.

Não pode alterar atividade ou tempo de apropriação já faturada!

(Antes de alterar, Antes de excluir)

Verificar o status da respectiva atividade

Valida a apropriação com relação a atividade, e bloqueia situações tais como:

Atualizar exclusão de apropriação(atividade)

Este método é usado para atualizar uma atividade após a exclusão de uma de suas apropriações. Pode ser utilizado em duas situações:

Encerrar pendentes(pessoa_id, termino)

Encerra as apropriações pendentes de um usuário.
Os critérios para serem utilizados para a hora de término, são os seguintes:

Retorna apenas o horário final da apropriação no formato HH:MM

Retorna apenas o horário final da apropriação no formato HH:MM.

Retorna apenas o horário de início no formato HH:MM

Retorna apenas o horário de início no formato HH:MM