Initial commit: OCA Technical packages (595 packages)

This commit is contained in:
Ernad Husremovic 2025-08-29 15:43:03 +02:00
commit 2cc02aac6e
24950 changed files with 2318079 additions and 0 deletions

View file

@ -0,0 +1,45 @@
# Hr Contract Employee Calendar Planning
Odoo addon: hr_contract_employee_calendar_planning
## Installation
```bash
pip install odoo-bringout-oca-hr-hr_contract_employee_calendar_planning
```
## Dependencies
This addon depends on:
- hr_contract
- hr_employee_calendar_planning
## Manifest Information
- **Name**: Hr Contract Employee Calendar Planning
- **Version**: 16.0.1.0.2
- **Category**: Human Resources
- **License**: AGPL-3
- **Installable**: False
## Source
Based on [OCA/hr](https://github.com/OCA/hr) branch 16.0, addon `hr_contract_employee_calendar_planning`.
## License
This package maintains the original AGPL-3 license from the upstream Odoo project.
## Documentation
- Overview: doc/OVERVIEW.md
- Architecture: doc/ARCHITECTURE.md
- Models: doc/MODELS.md
- Controllers: doc/CONTROLLERS.md
- Wizards: doc/WIZARDS.md
- Install: doc/INSTALL.md
- Usage: doc/USAGE.md
- Configuration: doc/CONFIGURATION.md
- Dependencies: doc/DEPENDENCIES.md
- Troubleshooting: doc/TROUBLESHOOTING.md
- FAQ: doc/FAQ.md

View file

@ -0,0 +1,32 @@
# Architecture
```mermaid
flowchart TD
U[Users] -->|HTTP| V[Views and QWeb Templates]
V --> C[Controllers]
V --> W[Wizards Transient Models]
C --> M[Models and ORM]
W --> M
M --> R[Reports]
DX[Data XML] --> M
S[Security ACLs and Groups] -. enforces .-> M
subgraph Hr_contract_employee_calendar_planning Module - hr_contract_employee_calendar_planning
direction LR
M:::layer
W:::layer
C:::layer
V:::layer
R:::layer
S:::layer
DX:::layer
end
classDef layer fill:#eef8ff,stroke:#6ea8fe,stroke-width:1px
```
Notes
- Views include tree/form/kanban templates and report templates.
- Controllers provide website/portal routes when present.
- Wizards are UI flows implemented with `models.TransientModel`.
- Data XML loads data/demo records; Security defines groups and access.

View file

@ -0,0 +1,3 @@
# Configuration
Refer to Odoo settings for hr_contract_employee_calendar_planning. Configure related models, access rights, and options as needed.

View file

@ -0,0 +1,3 @@
# Controllers
This module does not define custom HTTP controllers.

View file

@ -0,0 +1,6 @@
# Dependencies
This addon depends on:
- [hr_contract](../../odoo-bringout-oca-ocb-hr_contract)
- [hr_employee_calendar_planning](../../odoo-bringout-oca-hr-hr_employee_calendar_planning)

View file

@ -0,0 +1,4 @@
# FAQ
- Q: Which Odoo version? A: 16.0 (OCA/OCB packaged).
- Q: How to enable? A: Start server with --addon hr_contract_employee_calendar_planning or install in UI.

View file

@ -0,0 +1,7 @@
# Install
```bash
pip install odoo-bringout-oca-hr-hr_contract_employee_calendar_planning"
# or
uv pip install odoo-bringout-oca-hr-hr_contract_employee_calendar_planning"
```

View file

@ -0,0 +1,12 @@
# Models
Detected core models and extensions in hr_contract_employee_calendar_planning.
```mermaid
classDiagram
class hr_contract
```
Notes
- Classes show model technical names; fields omitted for brevity.
- Items listed under _inherit are extensions of existing models.

View file

@ -0,0 +1,6 @@
# Overview
Packaged Odoo addon: hr_contract_employee_calendar_planning. Provides features documented in upstream Odoo 16 under this addon.
- Source: OCA/OCB 16.0, addon hr_contract_employee_calendar_planning
- License: LGPL-3

View file

@ -0,0 +1,3 @@
# Reports
This module does not define custom reports.

View file

@ -0,0 +1,8 @@
# Security
This module does not define custom security rules or access controls beyond Odoo defaults.
Default Odoo security applies:
- Base user access through standard groups
- Model access inherited from dependencies
- No custom row-level security rules

View file

@ -0,0 +1,5 @@
# Troubleshooting
- Ensure Python and Odoo environment matches repo guidance.
- Check database connectivity and logs if startup fails.
- Validate that dependent addons listed in DEPENDENCIES.md are installed.

View file

@ -0,0 +1,7 @@
# Usage
Start Odoo including this addon (from repo root):
```bash
python3 scripts/nix_odoo_web_server.py --db-name mydb --addon hr_contract_employee_calendar_planning
```

View file

@ -0,0 +1,3 @@
# Wizards
This module does not include UI wizards.

View file

@ -0,0 +1,107 @@
.. image:: https://odoo-community.org/readme-banner-image
:target: https://odoo-community.org/get-involved?utm_source=readme
:alt: Odoo Community Association
======================================
Hr Contract Employee Calendar Planning
======================================
..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:27f33e79c82f669fe034c9f6bb5f951d47d87126a1c2afba3d9385de92ca91e4
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fhr-lightgray.png?logo=github
:target: https://github.com/OCA/hr/tree/16.0/hr_contract_employee_calendar_planning
:alt: OCA/hr
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/hr-16-0/hr-16-0-hr_contract_employee_calendar_planning
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/hr&target_branch=16.0
:alt: Try me on Runboat
|badge1| |badge2| |badge3| |badge4| |badge5|
This module ensures a consistent working times history when using the
**hr_contract** and **hr_employee_calendar_planning** modules together.
There are 3 different data models which can relate to working time
(resource.calendar) records:
* Employees (hr.employee)
* Contracts (hr.contract)
* Resources (resource.resource) -> related to hr.employee through resource.mixin
The **hr_employee_calendar_planning** module adds the calendar_ids field
to employees, which allows a more flexible working times configuration:
Instead of selecting a single resource.calendar, multiple calendars can be
combined into one auto-generated calendar.
However, contracts are not considered when creating auto-generated calendars.
This can lead to unexpected behaviour, because the active contract calendar
and the employee calendar can diverge (calendar mismatch). Additionally, when
configuring a new contract, or changing the existing contract calendar,
the employee calendar will be overwritten by the contract calendar.
To resolve this issue, this module migrates current and previous contract
calendars into the calendar_ids and thus the auto-generated calendar.
Additionally, changes to the employee calendar by contracts are prevented.
The resource_calendar_id field is hidden in contract views, since all
working times should be managed in the calendar_ids field for each employee.
However, it is still possible to keep a meaningful contract history,
e.g. for salary information.
**Table of contents**
.. contents::
:local:
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/hr/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/hr/issues/new?body=module:%20hr_contract_employee_calendar_planning%0Aversion:%2016.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.
Do not contact contributors directly about support or help with technical issues.
Credits
=======
Authors
~~~~~~~
* cibex
Contributors
~~~~~~~~~~~~
* Jonas Buchholz <J.Buchholz@cibex.net>
Maintainers
~~~~~~~~~~~
This module is maintained by the OCA.
.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org
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.
This module is part of the `OCA/hr <https://github.com/OCA/hr/tree/16.0/hr_contract_employee_calendar_planning>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

View file

@ -0,0 +1,3 @@
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
from . import models
from .hooks import post_init_hook

View file

@ -0,0 +1,14 @@
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
{
"name": "Hr Contract Employee Calendar Planning",
"version": "16.0.1.0.2",
"category": "Human Resources",
"website": "https://github.com/OCA/hr",
"author": "cibex,Odoo Community Association (OCA)",
"license": "AGPL-3",
"application": False,
"auto_install": True,
"depends": ["hr_contract", "hr_employee_calendar_planning"],
"data": ["views/contract.xml"],
"post_init_hook": "post_init_hook",
}

View file

@ -0,0 +1,63 @@
import logging
from odoo import SUPERUSER_ID, api
_logger = logging.getLogger(__name__)
def post_init_hook(cr, registry, employees=None):
"""Migrate calendars from contracts to calendar_ids
to have consistent work schedule history"""
env = api.Environment(cr, SUPERUSER_ID, {})
if not employees:
employees = env["hr.employee"].with_context(active_test=False).search([])
for employee in employees.filtered("contract_ids"):
contract_calendar_lines = []
for contract in employee.contract_ids.sorted("date_start"):
date_start = contract.date_start
date_end = contract.date_end
# filter calendar_ids to check for overlaps with contracts
# with the same work schedule
cal_ids = employee.calendar_ids.filtered(
lambda x: x.calendar_id == contract.resource_calendar_id
and (not x.date_start or not date_end or x.date_start < date_end)
and (not x.date_end or not date_start or x.date_end > date_start)
)
if cal_ids:
_logger.info(f"{contract} is overlapping with {cal_ids}")
for calendar in cal_ids.sorted("date_start"):
if date_start and calendar.date_start != date_start:
_logger.info(
f"changing date_start of {calendar} "
f"from {calendar.date_start} to {date_start}"
)
calendar.date_start = date_start
if date_end and calendar.date_end != date_end:
_logger.info(
f"changing date_end of {calendar} "
f"from {calendar.date_end} to {date_end}"
)
calendar.date_end = date_end
break
else:
_logger.info(
f"adding new calendar_id for {contract.employee_id.name}: "
f"{contract.resource_calendar_id.name} from {date_start} to {date_end}"
)
contract_calendar_lines.append(
(
0,
0,
{
"date_start": date_start,
"date_end": date_end,
"calendar_id": contract.resource_calendar_id.id,
},
)
)
employee.calendar_ids = contract_calendar_lines
# set correct calendar in contract
employee.contract_id.resource_calendar_id = employee.resource_calendar_id

View file

@ -0,0 +1,19 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * hr_contract_employee_calendar_planning
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"
#. module: hr_contract_employee_calendar_planning
#: model:ir.model,name:hr_contract_employee_calendar_planning.model_hr_contract
msgid "Contract"
msgstr "Ugovor"

View file

@ -0,0 +1,19 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * hr_contract_employee_calendar_planning
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 16.0\n"
"Report-Msgid-Bugs-To: \n"
"Last-Translator: \n"
"Language-Team: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: \n"
#. module: hr_contract_employee_calendar_planning
#: model:ir.model,name:hr_contract_employee_calendar_planning.model_hr_contract
msgid "Contract"
msgstr ""

View file

@ -0,0 +1,25 @@
# Translation of Odoo Server.
# This file contains the translation of the following modules:
# * hr_contract_employee_calendar_planning
#
msgid ""
msgstr ""
"Project-Id-Version: Odoo Server 15.0\n"
"Report-Msgid-Bugs-To: \n"
"PO-Revision-Date: 2024-12-04 12:06+0000\n"
"Last-Translator: mymage <stefano.consolaro@mymage.it>\n"
"Language-Team: none\n"
"Language: it\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: \n"
"Plural-Forms: nplurals=2; plural=n != 1;\n"
"X-Generator: Weblate 5.6.2\n"
#. module: hr_contract_employee_calendar_planning
#: model:ir.model,name:hr_contract_employee_calendar_planning.model_hr_contract
msgid "Contract"
msgstr "Contratto"
#~ msgid "Employee Contract"
#~ msgstr "Contratto dipendente"

View file

@ -0,0 +1,39 @@
from odoo import api, models
class HrContract(models.Model):
_inherit = "hr.contract"
def write(self, vals):
if (
vals.get("resource_calendar_id")
and self.employee_id
and vals.get("resource_calendar_id")
!= self.employee_id.resource_calendar_id.id
):
# in the write method of contracts, when writing the resource_calendar_id
# the employee resource_calendar_id is set to the same id
# this interferes with the logic of hr_employee_calendar_planning
# which assumes that calendar times are managed by resource.calendar.attendances
# in auto-generated calendars based on the employee's calendar_ids
# since the default calendar for new contracts is the employee calendar
# and we set the correct calendar for the existing contract in the post_init_hook
# we resolve this conflict by not allowing calendar changes in contracts
vals.pop("resource_calendar_id")
return super().write(vals)
@api.model_create_multi
def create(self, vals_list):
# the create method of contracts syncs contract calendars with employee calendars
# in order to not overwrite the employee calendar
# we set the contract calendar to match the employee calendar
for vals in vals_list:
employee_id = vals.get("employee_id")
if employee_id:
employee_contract = (
self.env["hr.employee"].browse(employee_id).resource_calendar_id
)
if employee_contract:
vals.update({"resource_calendar_id": employee_contract.id})
contracts = super().create(vals_list)
return contracts

View file

@ -0,0 +1,28 @@
This module ensures a consistent working times history when using the
**hr_contract** and **hr_employee_calendar_planning** modules together.
There are 3 different data models which can relate to working time
(resource.calendar) records:
* Employees (hr.employee)
* Contracts (hr.contract)
* Resources (resource.resource) -> related to hr.employee through resource.mixin
The **hr_employee_calendar_planning** module adds the calendar_ids field
to employees, which allows a more flexible working times configuration:
Instead of selecting a single resource.calendar, multiple calendars can be
combined into one auto-generated calendar.
However, contracts are not considered when creating auto-generated calendars.
This can lead to unexpected behaviour, because the active contract calendar
and the employee calendar can diverge (calendar mismatch). Additionally, when
configuring a new contract, or changing the existing contract calendar,
the employee calendar will be overwritten by the contract calendar.
To resolve this issue, this module migrates current and previous contract
calendars into the calendar_ids and thus the auto-generated calendar.
Additionally, changes to the employee calendar by contracts are prevented.
The resource_calendar_id field is hidden in contract views, since all
working times should be managed in the calendar_ids field for each employee.
However, it is still possible to keep a meaningful contract history,
e.g. for salary information.

View file

@ -0,0 +1,453 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils: https://docutils.sourceforge.io/" />
<title>README.rst</title>
<style type="text/css">
/*
:Author: David Goodger (goodger@python.org)
:Id: $Id: html4css1.css 9511 2024-01-13 09:50:07Z milde $
:Copyright: This stylesheet has been placed in the public domain.
Default cascading style sheet for the HTML output of Docutils.
Despite the name, some widely supported CSS2 features are used.
See https://docutils.sourceforge.io/docs/howto/html-stylesheets.html for how to
customize this style sheet.
*/
/* used to remove borders from tables and images */
.borderless, table.borderless td, table.borderless th {
border: 0 }
table.borderless td, table.borderless th {
/* Override padding for "table.docutils td" with "! important".
The right padding separates the table cells. */
padding: 0 0.5em 0 0 ! important }
.first {
/* Override more specific margin styles with "! important". */
margin-top: 0 ! important }
.last, .with-subtitle {
margin-bottom: 0 ! important }
.hidden {
display: none }
.subscript {
vertical-align: sub;
font-size: smaller }
.superscript {
vertical-align: super;
font-size: smaller }
a.toc-backref {
text-decoration: none ;
color: black }
blockquote.epigraph {
margin: 2em 5em ; }
dl.docutils dd {
margin-bottom: 0.5em }
object[type="image/svg+xml"], object[type="application/x-shockwave-flash"] {
overflow: hidden;
}
/* Uncomment (and remove this text!) to get bold-faced definition list terms
dl.docutils dt {
font-weight: bold }
*/
div.abstract {
margin: 2em 5em }
div.abstract p.topic-title {
font-weight: bold ;
text-align: center }
div.admonition, div.attention, div.caution, div.danger, div.error,
div.hint, div.important, div.note, div.tip, div.warning {
margin: 2em ;
border: medium outset ;
padding: 1em }
div.admonition p.admonition-title, div.hint p.admonition-title,
div.important p.admonition-title, div.note p.admonition-title,
div.tip p.admonition-title {
font-weight: bold ;
font-family: sans-serif }
div.attention p.admonition-title, div.caution p.admonition-title,
div.danger p.admonition-title, div.error p.admonition-title,
div.warning p.admonition-title, .code .error {
color: red ;
font-weight: bold ;
font-family: sans-serif }
/* Uncomment (and remove this text!) to get reduced vertical space in
compound paragraphs.
div.compound .compound-first, div.compound .compound-middle {
margin-bottom: 0.5em }
div.compound .compound-last, div.compound .compound-middle {
margin-top: 0.5em }
*/
div.dedication {
margin: 2em 5em ;
text-align: center ;
font-style: italic }
div.dedication p.topic-title {
font-weight: bold ;
font-style: normal }
div.figure {
margin-left: 2em ;
margin-right: 2em }
div.footer, div.header {
clear: both;
font-size: smaller }
div.line-block {
display: block ;
margin-top: 1em ;
margin-bottom: 1em }
div.line-block div.line-block {
margin-top: 0 ;
margin-bottom: 0 ;
margin-left: 1.5em }
div.sidebar {
margin: 0 0 0.5em 1em ;
border: medium outset ;
padding: 1em ;
background-color: #ffffee ;
width: 40% ;
float: right ;
clear: right }
div.sidebar p.rubric {
font-family: sans-serif ;
font-size: medium }
div.system-messages {
margin: 5em }
div.system-messages h1 {
color: red }
div.system-message {
border: medium outset ;
padding: 1em }
div.system-message p.system-message-title {
color: red ;
font-weight: bold }
div.topic {
margin: 2em }
h1.section-subtitle, h2.section-subtitle, h3.section-subtitle,
h4.section-subtitle, h5.section-subtitle, h6.section-subtitle {
margin-top: 0.4em }
h1.title {
text-align: center }
h2.subtitle {
text-align: center }
hr.docutils {
width: 75% }
img.align-left, .figure.align-left, object.align-left, table.align-left {
clear: left ;
float: left ;
margin-right: 1em }
img.align-right, .figure.align-right, object.align-right, table.align-right {
clear: right ;
float: right ;
margin-left: 1em }
img.align-center, .figure.align-center, object.align-center {
display: block;
margin-left: auto;
margin-right: auto;
}
table.align-center {
margin-left: auto;
margin-right: auto;
}
.align-left {
text-align: left }
.align-center {
clear: both ;
text-align: center }
.align-right {
text-align: right }
/* reset inner alignment in figures */
div.align-right {
text-align: inherit }
/* div.align-center * { */
/* text-align: left } */
.align-top {
vertical-align: top }
.align-middle {
vertical-align: middle }
.align-bottom {
vertical-align: bottom }
ol.simple, ul.simple {
margin-bottom: 1em }
ol.arabic {
list-style: decimal }
ol.loweralpha {
list-style: lower-alpha }
ol.upperalpha {
list-style: upper-alpha }
ol.lowerroman {
list-style: lower-roman }
ol.upperroman {
list-style: upper-roman }
p.attribution {
text-align: right ;
margin-left: 50% }
p.caption {
font-style: italic }
p.credits {
font-style: italic ;
font-size: smaller }
p.label {
white-space: nowrap }
p.rubric {
font-weight: bold ;
font-size: larger ;
color: maroon ;
text-align: center }
p.sidebar-title {
font-family: sans-serif ;
font-weight: bold ;
font-size: larger }
p.sidebar-subtitle {
font-family: sans-serif ;
font-weight: bold }
p.topic-title {
font-weight: bold }
pre.address {
margin-bottom: 0 ;
margin-top: 0 ;
font: inherit }
pre.literal-block, pre.doctest-block, pre.math, pre.code {
margin-left: 2em ;
margin-right: 2em }
pre.code .ln { color: gray; } /* line numbers */
pre.code, code { background-color: #eeeeee }
pre.code .comment, code .comment { color: #5C6576 }
pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
pre.code .literal.string, code .literal.string { color: #0C5404 }
pre.code .name.builtin, code .name.builtin { color: #352B84 }
pre.code .deleted, code .deleted { background-color: #DEB0A1}
pre.code .inserted, code .inserted { background-color: #A3D289}
span.classifier {
font-family: sans-serif ;
font-style: oblique }
span.classifier-delimiter {
font-family: sans-serif ;
font-weight: bold }
span.interpreted {
font-family: sans-serif }
span.option {
white-space: nowrap }
span.pre {
white-space: pre }
span.problematic, pre.problematic {
color: red }
span.section-subtitle {
/* font-size relative to parent (h1..h6 element) */
font-size: 80% }
table.citation {
border-left: solid 1px gray;
margin-left: 1px }
table.docinfo {
margin: 2em 4em }
table.docutils {
margin-top: 0.5em ;
margin-bottom: 0.5em }
table.footnote {
border-left: solid 1px black;
margin-left: 1px }
table.docutils td, table.docutils th,
table.docinfo td, table.docinfo th {
padding-left: 0.5em ;
padding-right: 0.5em ;
vertical-align: top }
table.docutils th.field-name, table.docinfo th.docinfo-name {
font-weight: bold ;
text-align: left ;
white-space: nowrap ;
padding-left: 0 }
/* "booktabs" style (no vertical lines) */
table.docutils.booktabs {
border: 0px;
border-top: 2px solid;
border-bottom: 2px solid;
border-collapse: collapse;
}
table.docutils.booktabs * {
border: 0px;
}
table.docutils.booktabs th {
border-bottom: thin solid;
text-align: left;
}
h1 tt.docutils, h2 tt.docutils, h3 tt.docutils,
h4 tt.docutils, h5 tt.docutils, h6 tt.docutils {
font-size: 100% }
ul.auto-toc {
list-style-type: none }
</style>
</head>
<body>
<div class="document">
<a class="reference external image-reference" href="https://odoo-community.org/get-involved?utm_source=readme">
<img alt="Odoo Community Association" src="https://odoo-community.org/readme-banner-image" />
</a>
<div class="section" id="hr-contract-employee-calendar-planning">
<h1>Hr Contract Employee Calendar Planning</h1>
<!-- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:27f33e79c82f669fe034c9f6bb5f951d47d87126a1c2afba3d9385de92ca91e4
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->
<p><a class="reference external image-reference" 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 image-reference" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/license-AGPL--3-blue.png" /></a> <a class="reference external image-reference" href="https://github.com/OCA/hr/tree/16.0/hr_contract_employee_calendar_planning"><img alt="OCA/hr" src="https://img.shields.io/badge/github-OCA%2Fhr-lightgray.png?logo=github" /></a> <a class="reference external image-reference" href="https://translation.odoo-community.org/projects/hr-16-0/hr-16-0-hr_contract_employee_calendar_planning"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external image-reference" href="https://runboat.odoo-community.org/builds?repo=OCA/hr&amp;target_branch=16.0"><img alt="Try me on Runboat" src="https://img.shields.io/badge/runboat-Try%20me-875A7B.png" /></a></p>
<p>This module ensures a consistent working times history when using the
<strong>hr_contract</strong> and <strong>hr_employee_calendar_planning</strong> modules together.</p>
<p>There are 3 different data models which can relate to working time
(resource.calendar) records:</p>
<ul class="simple">
<li>Employees (hr.employee)</li>
<li>Contracts (hr.contract)</li>
<li>Resources (resource.resource) -&gt; related to hr.employee through resource.mixin</li>
</ul>
<p>The <strong>hr_employee_calendar_planning</strong> module adds the calendar_ids field
to employees, which allows a more flexible working times configuration:
Instead of selecting a single resource.calendar, multiple calendars can be
combined into one auto-generated calendar.</p>
<p>However, contracts are not considered when creating auto-generated calendars.
This can lead to unexpected behaviour, because the active contract calendar
and the employee calendar can diverge (calendar mismatch). Additionally, when
configuring a new contract, or changing the existing contract calendar,
the employee calendar will be overwritten by the contract calendar.</p>
<p>To resolve this issue, this module migrates current and previous contract
calendars into the calendar_ids and thus the auto-generated calendar.
Additionally, changes to the employee calendar by contracts are prevented.
The resource_calendar_id field is hidden in contract views, since all
working times should be managed in the calendar_ids field for each employee.
However, it is still possible to keep a meaningful contract history,
e.g. for salary information.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#bug-tracker" id="toc-entry-1">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="toc-entry-2">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="toc-entry-3">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="toc-entry-4">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="toc-entry-5">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<div class="section" id="bug-tracker">
<h2><a class="toc-backref" href="#toc-entry-1">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/hr/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 to smash it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/hr/issues/new?body=module:%20hr_contract_employee_calendar_planning%0Aversion:%2016.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>
</div>
<div class="section" id="credits">
<h2><a class="toc-backref" href="#toc-entry-2">Credits</a></h2>
<div class="section" id="authors">
<h3><a class="toc-backref" href="#toc-entry-3">Authors</a></h3>
<ul class="simple">
<li>cibex</li>
</ul>
</div>
<div class="section" id="contributors">
<h3><a class="toc-backref" href="#toc-entry-4">Contributors</a></h3>
<ul class="simple">
<li>Jonas Buchholz &lt;<a class="reference external" href="mailto:J.Buchholz&#64;cibex.net">J.Buchholz&#64;cibex.net</a>&gt;</li>
</ul>
</div>
<div class="section" id="maintainers">
<h3><a class="toc-backref" href="#toc-entry-5">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>This module is part of the <a class="reference external" href="https://github.com/OCA/hr/tree/16.0/hr_contract_employee_calendar_planning">OCA/hr</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>
</div>
</div>
</div>
</div>
</body>
</html>

View file

@ -0,0 +1 @@
from . import test_hr_contract_employee_calendar_planning

View file

@ -0,0 +1,103 @@
from datetime import datetime
from odoo.addons.hr_contract.tests.common import TestContractCommon
from ..hooks import post_init_hook
class TestHrContractEmployeeCalendarPlanning(TestContractCommon):
def test_calendar_migration_from_contracts(self):
self.env = self.env(
context=dict(
self.env.context,
mail_create_nolog=True,
mail_create_nosubscribe=True,
mail_notrack=True,
no_reset_password=True,
tracking_disable=True,
)
)
# newly created contracts get the same calendar as the employee
self.employee.resource_calendar_id = self.env["resource.calendar"].browse([1])
self.env["hr.contract"].create(
{
"name": "contract1",
"wage": 1,
"state": "close",
"employee_id": self.employee.id,
"date_start": datetime.strptime("2018-11-30", "%Y-%m-%d").date(),
"date_end": datetime.strptime("2019-11-30", "%Y-%m-%d").date(),
}
)
self.employee.resource_calendar_id = self.env["resource.calendar"].browse([2])
self.env["hr.contract"].create(
{
"name": "contract2",
"wage": 1,
"state": "open",
"employee_id": self.employee.id,
"date_start": datetime.strptime("2019-12-01", "%Y-%m-%d").date(),
"date_end": datetime.strptime("2020-11-30", "%Y-%m-%d").date(),
}
)
self.employee.calendar_ids.unlink()
calendar_ids = self.env["hr.employee.calendar"].create(
[
{
"date_start": False,
"date_end": datetime.strptime("2020-11-30", "%Y-%m-%d").date(),
"calendar_id": 2,
"employee_id": self.employee.id,
},
{
"date_start": datetime.strptime("2020-12-01", "%Y-%m-%d").date(),
"date_end": False,
"calendar_id": 1,
"employee_id": self.employee.id,
},
]
)
start_dt = datetime(2019, 1, 1, 0, 0, 0)
end_dt = datetime(2019, 1, 2, 0, 0, 0)
self.assertEqual(
7.0,
self.employee.resource_calendar_id.get_work_hours_count(
start_dt=start_dt,
end_dt=end_dt,
),
)
# calendar migration from contracts
post_init_hook(self.env.cr, self.env.registry, self.employee)
self.assertEqual(
8.0,
self.employee.resource_calendar_id.get_work_hours_count(
start_dt=start_dt,
end_dt=end_dt,
),
)
self.assertTrue(calendar_ids.ids < self.employee.calendar_ids.ids)
def test_contract_create(self):
self.employee.resource_calendar_id = self.env["resource.calendar"].browse([1])
self.env["hr.contract"].create(
{
"name": "contract1",
"wage": 1,
"state": "close",
"employee_id": self.employee.id,
"date_start": datetime.strptime("2018-11-30", "%Y-%m-%d").date(),
"date_end": datetime.strptime("2019-11-30", "%Y-%m-%d").date(),
"resource_calendar_id": self.env["resource.calendar"].browse([2]).id,
}
)
self.assertEqual(self.employee.resource_calendar_id.id, 1)
def test_contract_write(self):
self.employee.resource_calendar_id = self.env["resource.calendar"].browse([1])
self.env["hr.contract"].write(
{
"resource_calendar_id": 2,
}
)
self.assertEqual(self.employee.resource_calendar_id.id, 1)

View file

@ -0,0 +1,29 @@
<odoo>
<record id="hr_contract_employee_calendar_planning_form" model="ir.ui.view">
<field name="name">hr.contract.employee.calendar.planning.form</field>
<field name="model">hr.contract</field>
<field name="inherit_id" ref="hr_contract.hr_contract_view_form" />
<field name="priority">999</field>
<field name="arch" type="xml">
<xpath expr="//label[@for='resource_calendar_id']" position="replace" />
<xpath expr="//div[@id='resource_calendar_warning']" position="replace">
<field name="resource_calendar_id" invisible="1" />
</xpath>
</field>
</record>
<record model="ir.ui.view" id="hr_contract_employee_calendar_history_form">
<field name="name">hr.contract.employee.calendar.planning.history.form</field>
<field name="model">hr.contract.history</field>
<field name="inherit_id" ref="hr_contract.hr_contract_history_view_form" />
<field name="priority">999</field>
<field name="arch" type="xml">
<xpath expr="//field[@name='resource_calendar_id']" position="replace">
<field name="resource_calendar_id" invisible="1" />
</xpath>
<xpath expr="//tree/field[@name='resource_calendar_id']" position="replace">
<field name="resource_calendar_id" invisible="1" />
</xpath>
</field>
</record>
</odoo>

View file

@ -0,0 +1,43 @@
[project]
name = "odoo-bringout-oca-hr-hr_contract_employee_calendar_planning"
version = "16.0.0"
description = "Hr Contract Employee Calendar Planning - Odoo addon"
authors = [
{ name = "Ernad Husremovic", email = "hernad@bring.out.ba" }
]
dependencies = [
"odoo-bringout-oca-hr-hr_contract>=16.0.0",
"odoo-bringout-oca-hr-hr_employee_calendar_planning>=16.0.0",
"requests>=2.25.1"
]
readme = "README.md"
requires-python = ">= 3.11"
classifiers = [
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Topic :: Office/Business",
]
[project.urls]
homepage = "https://github.com/bringout/0"
repository = "https://github.com/bringout/0"
[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"
[tool.hatch.metadata]
allow-direct-references = true
[tool.hatch.build.targets.wheel]
packages = ["hr_contract_employee_calendar_planning"]
[tool.rye]
managed = true
dev-dependencies = [
"pytest>=8.4.1",
]