ChileanVacation Package
, (*1)
ChileanVacation permite calcular las vacaciones proporcionales como progresivas basado en la ley Chilena, (*2)
El package sigue los estandares PSR-1, PSR-2, and PSR-4., (*3)
Requerimientos
La rama Master posee los siguiente requerimientos, (*4)
Como instalar?
[Usando Composer], (*5)
Agrega el package en composer.json - de la siguiente manera:, (*6)
{
"require": {
"folivaresrios/chileanvacation": "^1.0"
}
}
o a traves de linea de comando, (*7)
composer require folivaresrios/chileanvacation
Como Usar?, (*8)
Existen 5 clases diferentes; Person, Vacation, Holidays, Certificate, Job y para dar flexibilidad al package 4 de estas poseen Interfaces por si ya tienes implementadas estas en tu proyecto con el fin de solo implementar los metodos., (*9)
Se debe crear un objeto Certificate con los años acreditados por el documento de la afp como la fecha de entrega de este., (*10)
new Certificate($quotedYears, $documentDeliveryDate);
Tambien debes crear un objeto Holiday pasando un arreglo con las fechas correspondientes a los feriados, (*11)
new Holiday($holidays);
El objeto Job contiene la fecha de inicio como la de termimno y adicionalmente debe tener los feriados, (*12)
new Job(string $startDate, string $endDate = null, ChileanHoliday $holiday, Document $certificate = null)
Por ultimo el objeto Person, que contiene a Job. Con este ultimo objeto trabajaremos y podremos calcular las vacaciones, (*13)
new Person(Employment $job)
Los metodos los encontramos "encapsulados" en la clase Vacation
new Vacation (string $requestedDate = null, int $requestedDays = 0, int $vacationDaysTaken = 0, int $progressiveDaysTaken = 0)
getReturnDate($holiday)
Obtenemos la fecha de retorno de las vacaciones solicitadas., (*14)
$this->getReturnDate(Holiday $holiday);
getProportionalDays($person)
Obtenemos la fecha de retorno de las vacaciones solicitadas., (*15)
$this->getProportionalDays(NaturalPerson $person);
getWorkedDays($person)
Obtenemos los dias trabajados en la empresa, (*16)
$this->getWorkedDays(NaturalPerson $person)
getProgressiveVacations($person)
Obtenemos los dias de vacaciones proporcionales obtenidos a la fecha, (*17)
$this->getProgressiveVacations(NaturalPErson $person)
getRemainingProgressiveVacations($person)
Obtenemos los dias restantes de vacaciones proporcionales obtenidos a la fecha, (*18)
$this->getRemainingProgressiveVacations(NaturalPErson $person)
getRemainingProgressiveVacations($person)
Obtenemos los dias restantes de vacaciones progresivas obtenidos a la fecha, (*19)
$this->getRemainingVacations(NaturalPErson $person)
Reportando errores
Si tienes problemas con ChileanVacation, abre un "issue" en GitHub., (*20)
Contribuir
Si quieres contribuir con ChileanVacation creado algo que quiereas agregar,envia un pull
requests o abre un
issues., (*21)