Author: |
Pierre Verkest, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
14.0 |
Repository: |
OCA/hr-attendance |
Dependencies: |
hr_attendance,
hr_attendance_modification_tracking,
hr_attendance_overtime,
hr_attendance_reason,
hr_holidays,
and
web |
Languages: |
HTML (390, 17.1%),
JavaScript (26, 1.1%),
PO File (244, 10.7%),
Python (1000, 43.8%),
XML (526, 23.0%),
and
reStructuredText (99, 4.3%) |
Other repositories: |
pegonzalezspesol/hr-attendance,
and
tegin/hr-attendance |
<h1 class="title">Hr Attendance Validation</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/hr-attendance/tree/14.0/hr_attendance_validation"><img alt="OCA/hr-attendance" src="https://img.shields.io/badge/github-OCA%2Fhr--attendance-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/hr-attendance-14-0/hr-attendance-14-0-hr_attendance_validation"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/288/14.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>This add a validation mechanism to review employee attendance
and generate compensatory hours (allocated leaves) that can
be used later as day off or to regulate credits leaves as
this module is compatible with <cite>hr_holidays_credit</cite> module.</p>
<p>This is based on the <cite>hr_attendance_overtime</cite> module which
mark rows as "overtime" those rows are not due by default
as it could came from possible mist check-out. So manager can
decide to add or not those overtime attendance lines or not and
compute or adjust compensatory/leaves hours to generate.</p>
<p>..note:</p>
<pre>
<code>If you are allowing flexible hours - check-in/check-out range
are bigger than average hours per day - So you can generate
compensatory hours from lines that are not marked as overtime.</code>
</pre>
<p>Once review is validated attendance lines are locked on that period.</p>
<p>At the end managers can check holidays allocation per year and
by employee to make sure allowed employee compensatory hours are
not over.</p>
<p>Employees can:
- access to validated sheets to review hours taken account
- see current week hours on check-in view</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#configuration" id="id1">Configuration</a></li>
<li><a class="reference internal" href="#usage" id="id2">Usage</a></li>
<li><a class="reference internal" href="#known-issues-roadmap" id="id3">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id4">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id5">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id6">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id7">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id8">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id1">Configuration</a></h2>
<ul>
<li><p class="first">Ensure employee weeks are properly set</p>
</li>
<li><p class="first">Set the leave type to use by generating compensatory
hours from attendance review (to be done in hr attendance configuration)</p>
</li>
<li><p class="first">once all leaves and attendances has been recorded you can generate leave reviews
by setting up a cron job running every monday morning to generate the previous week
with the following code on <cite>hr.attendance.validation.sheet</cite> model:</p>
<pre>
<code>model.generate_reviews()</code>
</pre>
</li>
</ul>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id2">Usage</a></h2>
<ul class="simple">
<li>Once review has been generate by ir cron manager are able to
open each one on Attenances > Manager > Attendance validation</li>
<li>On each form decide if recorded overtime are due or not</li>
<li>change the amount of allocated compensatory hours to generate</li>
<li>validate the review to generate the allocation</li>
</ul>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h2>
<ul class="simple">
<li>Improve validation sheet to choose any frame validation/reviews
date to date/daily/2 weeks/monthly... it has been developed with
the weekly reviews in mind.</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id4">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/hr-attendance/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/hr-attendance/issues/new?body=module:%20hr_attendance_validation%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id5">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id6">Authors</a></h3>
<ul class="simple">
<li>Pierre Verkest</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id7">Contributors</a></h3>
<ul class="simple">
<li>Pierre Verkest <<a class="reference external" href="mailto:pierreverkest84@gmail.com">pierreverkest84@gmail.com</a>></li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id8">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.</p>
<p>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p>
<p><a class="reference external" href="https://github.com/petrus-v"><img alt="petrus-v" src="https://github.com/petrus-v.png?size=40px" /></a></p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/hr-attendance/tree/14.0/hr_attendance_validation">OCA/hr-attendance</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>
Dependency Graph