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:

Medir tempo de execução real das atividades (para posteriormente comparar com o tempo estimado)
Medir a produtividade dos recursos
Tarifar serviços executados para clientes
etc.

Atributos

Atributo	Domínio	Regras	Descrição
ID	ID(18)	Rqd PK	Id: Chave de identificação interna
PESSOA_ID	ID(18)	Rqd FK	Pessoa: Indica a pessoa que exerceu a atividade. Referência para PESSOAS
DATA	DATE		Data: Data da apropriação. Se não informado e inicio for informado, a data será a mesma do início.
HORA_INICIO	DAY_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_TERMINO	DAY_TIME(5)		Hora de término: Hora em que encerrou a apropriação. Caso não informado e fim informado, infere dele.
INICIO	DATE_TIME_HM	Rqd 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
FIM	DATE_TIME_HM	AK	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.
INDICE	VALUE(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
TEMPO	DOUBLE(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_ID	ID(18)	FK	Atividade: Indica a atividade exercida durante a apropriação. Referência para ATIVIDADES
DESCRICAO	WIKI		Descriçã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.
ACOES	SELECTION_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_ATIVIDADE	FLAG(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_ATIVIDADE	FLAG(1)	Rqd	Encerra atividade: Indica se esta apropriação encerra a atividade relacionada. Valor padrão = N
TIPO_APROPRIACAO_ID	ID(18)	FK	Tipo de apropriação: Indica o tipo de atividade exercida na apropriação. Referência para TIPOS_APROPRIACOES
TIPO_ATIVIDADE_ID	ID(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
INTERVALO	TIME(5)		Intervalo: Define um tempo de intervalo ocorrido durante a apropriação.
REGRA_CUSTEIO_ID	ID(18)	FK	Forma de calculo: Forma para realizar o calculo do custeio da apropriação Referência para REGRAS_CUSTEIO_APROPRIACOES
CUSTO_HORA	VALUE(18)		Custo hora: Custo da hora do profissional.
CONTA_FATURAMENTO_ID	ID(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_ID	ID(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:

Aplica as ações informadas.
Caso a apropriação esteja marcada para executar a atividade e a data de início efetivo não esteja informada ou informada com um valor maior que a data da apropriação, então atualizar a data de início efetivo com a data da apropriação.
Caso a atividade não tenha responsável, atualiza-a com o usuário que está apropriando horas.
Caso o registro seja de encerramento da atividade, automaticamente atualiza a data de encerramento da mesma.
Atualiza o checklist através da descrição da apropriação: Verifica linha por linha da descrição da apropriação e caso exista uma linha igual a um item do checklist, começando com OK, inclui o OK no respectivo item do checklist.

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.

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:

Tentar apropriar a execução de uma atividade não aprovada quando o tipo de atividade exige aprovação.
Tentar apropriar a conclusão de uma atividade não aprovada quando o tipo de atividade exige aprovação para concluir.
Tentar apropriar a execução de uma atividade não aprovada quando o tipo de atividade exige aprovação se faturada e o faturamento for diferente de "não".

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.

Entidade APROPRIACAO_HORAS

Descrição

Atributos

Regras

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

Calcular tempo apropriado

Atualizar a atividade quando for o caso

Adicionar pessoa na equipe

Validar sobreposição de horários

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

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

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

Verificar o status da respectiva atividade

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