wbhuman_resources 2.2.1__tar.gz

wbhuman_resources-2.2.1/.gitignore

@@ -0,0 +1,181 @@
+~
+
+# Docker volumes
+volumes/
+# Poetry auth file
+auth.toml
+
+media/*
+media/
+mediafiles/
+mediafiles/*
+test/*
+staticfiles/*
+staticfiles/
+#
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+info/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+.dccache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+report.xml
+*/report.xml
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+*.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+*.ipynb
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+.vscode/
+.idea/
+.idea.bkp/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+crm/
+# Cython debug symbols
+cython_debug/
+
+# Gitlab Runner
+builds
+builds/
+
+# Integrator Office 365 : reverse proxy tunnel for outlook365
+ngrok
+*/ngrok
+/modules/**/system/
+
+/modules/wbmailing/files/*
+/modules/wbmailing/mailing/*
+
+/projects/*/requirements.txt
+public
+
+# Ignore archive localization generated folder
+backend/modules/**/archive/*
+**/**/requirements.txt
+CHANGELOG-*

wbhuman_resources-2.2.1/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.3
+Name: wbhuman_resources
+Version: 2.2.1
+Summary: A workbench module for managing human resources.
+Author-email: Christopher Wittlinger <c.wittlinger@stainly.com>
+Requires-Dist: wbcore
+Requires-Dist: weasyprint==57.*
+Requires-Dist: workalendar==17.*
+Requires-Dist: xlsxwriter==3.*

wbhuman_resources-2.2.1/pyproject.toml

@@ -0,0 +1,32 @@
+[project]
+name = "wbhuman_resources"
+description = "A workbench module for managing human resources."
+authors = [{ name = "Christopher Wittlinger", email = "c.wittlinger@stainly.com"}]
+dynamic = ["version"]
+
+dependencies = [
+  "wbcore",
+  "weasyprint == 57.*",
+  "workalendar == 17.*",
+  "xlsxwriter==3.*",
+]
+
+[tool.uv.sources]
+wbcore = { workspace = true }
+
+[tool.uv]
+package = true
+
+[tool.hatch.version]
+path = "../../pyproject.toml"
+
+[tool.hatch.build.targets.sdist]
+include = ["wbhuman_resources/*"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["wbhuman_resources"]
+only-packages = true
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

wbhuman_resources-2.2.1/wbhuman_resources/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

wbhuman_resources-2.2.1/wbhuman_resources/admin/__init__.py

@@ -0,0 +1,5 @@
+from .absence import *
+from .calendars import *
+from .employee import *
+from .kpi import *
+from .review import *

wbhuman_resources-2.2.1/wbhuman_resources/admin/absence.py

@@ -0,0 +1,113 @@
+from io import StringIO
+
+import pandas as pd
+from django.contrib import admin
+from django.shortcuts import redirect, render
+from django.utils.translation import gettext_lazy as _
+from reversion.errors import RevertError
+from wbcore.admin import CsvImportForm, ImportCsvMixin
+
+from ..models.absence import AbsenceRequest, AbsenceRequestPeriods, AbsenceRequestType
+
+
+class CustomImportCsvMixin(ImportCsvMixin):
+    def _import_csv(self, request, _sep=";"):
+        if request.method == "POST":
+            csv_file = request.FILES["csv_file"]
+
+            str_text = ""
+            for line in csv_file:
+                str_text = str_text + line.decode()
+            # Import csv as df
+            df = pd.read_csv(StringIO(str_text), sep=_sep)
+            # Sanitize dataframe
+            df = df.where(pd.notnull(df), None)
+            df = df.drop(df.columns.difference(self.get_import_fields()), axis=1)
+
+            # Overide this function if there is foreign key ids in the dataframe
+            df = self.manipulate_df(df)
+            errors = 0
+            revert_errors = 0
+            nb_added = 0
+            for model in df.to_dict("records"):
+                # by default, process the modela as a create request. Can be override to change the behavior
+                try:
+                    nb_added += self.process_model(model)
+                # https://django-reversion.readthedocs.io/en/stable/common-problems.html
+                except RevertError:
+                    revert_errors += 1
+                except Exception as e:
+                    print(e)  # noqa: T201
+                    errors += 1
+            self.message_user(
+                request,
+                _(
+                    "Your CSV file has been imported : {} imported ({} added, {} updated), {} errors, {} revert errors found due to failure to restore old versions"
+                ).format(
+                    df.shape[0] - errors - revert_errors,
+                    nb_added,
+                    df.shape[0] - errors - revert_errors - nb_added,
+                    errors,
+                    revert_errors,
+                ),
+            )
+            return redirect("..")
+        form = CsvImportForm()
+        payload = {"form": form}
+        return render(request, "wbcore/admin/csv_form.html", payload)
+
+
+@admin.register(AbsenceRequestType)
+class AbsenceRequestTypeAdmin(admin.ModelAdmin):
+    list_display = [
+        "title",
+        "is_vacation",
+        "is_timeoff",
+        "is_extensible",
+        "auto_approve",
+        "days_in_advance",
+    ]
+
+    autocomplete_fields = ["crossborder_countries", "extra_notify_groups"]
+
+
+class AbsenceRequestPeriodsInline(admin.TabularInline):
+    model = AbsenceRequestPeriods
+    ordering = ("timespan__startswith",)
+    extra = 0
+    raw_id_fields = ["balance", "request"]
+
+
+@admin.register(AbsenceRequest)
+class AbsenceRequestAdmin(admin.ModelAdmin):
+    list_display = ["status", "employee", "period", "type", "_total_hours", "_total_vacation_hours"]
+
+    fieldsets = (
+        (
+            "",
+            {
+                "fields": (
+                    ("status", "type"),
+                    ("period", "employee"),
+                    "attachment",
+                )
+            },
+        ),
+        (
+            _("Notes"),
+            {"fields": ("notes", "reason")},
+        ),
+    )
+    inlines = (AbsenceRequestPeriodsInline,)
+    autocomplete_fields = ["employee"]
+    list_filter = ["type__is_vacation"]
+
+    def _total_hours(self, obj):
+        return obj._total_hours
+
+    def _total_vacation_hours(self, obj):
+        return obj._total_vacation_hours
+
+    #
+    # def get_queryset(self, request):
+    #     return super().get_queryset().

wbhuman_resources-2.2.1/wbhuman_resources/admin/calendars.py

@@ -0,0 +1,37 @@
+from django.contrib import admin
+
+from ..models import (
+    DayOff,
+    DayOffCalendar,
+    DefaultDailyPeriod,
+    EmployeeWeeklyOffPeriods,
+)
+
+
+@admin.register(DayOffCalendar)
+class DayOffCalendarModelAdmin(admin.ModelAdmin):
+    pass
+
+
+@admin.register(DayOff)
+class DayOffAdmin(admin.ModelAdmin):
+    list_display = ["date", "title", "count_as_holiday", "calendar"]
+    ordering = ["date"]
+
+
+@admin.register(DefaultDailyPeriod)
+class DefaultDailyPeriodAdmin(admin.ModelAdmin):
+    list_display = ["lower_time", "upper_time", "title", "total_hours"]
+    ordering = ["lower_time"]
+
+
+class EmployeeWeeklyOffPeriodsInLine(admin.TabularInline):
+    model = EmployeeWeeklyOffPeriods
+    fields = [
+        "period",
+        "weekday",
+    ]
+    fk_name = "employee"
+    extra = 0
+    raw_id_fields = ["employee"]
+    ordering = ("weekday", "period__lower_time")

wbhuman_resources-2.2.1/wbhuman_resources/admin/employee.py

@@ -0,0 +1,109 @@
+from django.contrib import admin
+
+from ..models.employee import (
+    BalanceHourlyAllowance,
+    EmployeeHumanResource,
+    EmployeeYearBalance,
+    Position,
+)
+from .calendars import EmployeeWeeklyOffPeriodsInLine
+
+
+class PositionInline(admin.TabularInline):
+    model = Position
+    extra = 0
+
+
+@admin.register(Position)
+class PositionAdmin(admin.ModelAdmin):
+    search_fields = ("name",)
+    list_display = ("name", "height", "manager")
+
+    raw_id_fields = ["groups", "manager"]
+    autocomplete_fields = ["groups", "manager"]
+
+
+class BalanceHourlyAllowanceTabularAdmin(admin.TabularInline):
+    model = BalanceHourlyAllowance
+    fk_name = "balance"
+
+
+@admin.register(EmployeeYearBalance)
+class EmployeeYearBalanceAdmin(admin.ModelAdmin):
+    inlines = [BalanceHourlyAllowanceTabularAdmin]
+
+
+class EmployeeYearBalanceInline(admin.TabularInline):
+    model = EmployeeYearBalance
+    fields = (
+        "year",
+        "balance",
+        "daily_hours",
+        "number_mandatory_days_off",
+        "total_vacation_hourly_usage",
+        "total_vacation_hourly_balance",
+        "balance_in_days",
+        "number_mandatory_days_off_in_days",
+        "total_vacation_hourly_usage_in_days",
+        "total_vacation_hourly_balance_in_days",
+    )
+    readonly_fields = [
+        "balance",
+        "daily_hours",
+        "number_mandatory_days_off",
+        "total_vacation_hourly_usage",
+        "total_vacation_hourly_balance",
+        "balance_in_days",
+        "number_mandatory_days_off_in_days",
+        "total_vacation_hourly_usage_in_days",
+        "total_vacation_hourly_balance_in_days",
+    ]
+    extra = 0
+    ordering = ("-year",)
+    show_change_link = True
+
+    def _number_mandatory_days_off(self, obj):
+        return obj._number_mandatory_days_off
+
+    def _total_vacation_hourly_usage(self, obj):
+        return obj._total_vacation_hourly_usage
+
+    def _total_vacation_hourly_balance(self, obj):
+        return obj._total_vacation_hourly_balance
+
+    def _balance_in_days(self, obj):
+        return obj._balance_in_days
+
+    def _number_mandatory_days_off_in_days(self, obj):
+        return obj._number_mandatory_days_off_in_days
+
+    def _total_vacation_hourly_usage_in_days(self, obj):
+        return obj._total_vacation_hourly_usage_in_days
+
+    def _total_vacation_hourly_balance_in_days(self, obj):
+        return obj._total_vacation_hourly_balance_in_days
+
+
+@admin.register(EmployeeHumanResource)
+class EmployeeHumanResourceAdmin(admin.ModelAdmin):
+    fieldsets = (
+        (
+            "",
+            {
+                "fields": (
+                    "profile",
+                    "is_active",
+                    "extra_days_frequency",
+                    "occupancy_rate",
+                    "contract_type",
+                    "position",
+                    "enrollment_at",
+                    "calendar",
+                )
+            },
+        ),
+    )
+    raw_id_fields = ("profile",)
+    search_fields = ("profile__computed_str",)
+    list_display = ("profile", "contract_type", "position", "calendar")
+    inlines = (EmployeeYearBalanceInline, EmployeeWeeklyOffPeriodsInLine)

wbhuman_resources-2.2.1/wbhuman_resources/admin/kpi.py

@@ -0,0 +1,21 @@
+from django.contrib import admin
+
+from ..models.kpi import KPI, Evaluation
+
+
+@admin.register(Evaluation)
+class KEvaluationAdmin(admin.ModelAdmin):
+    list_display = ["id", "person", "evaluated_score", "evaluation_date", "evaluated_period"]
+
+
+class EvaluationInline(admin.TabularInline):
+    model = Evaluation
+    extra = 0
+    raw_id_fields = ["kpi", "person"]
+
+
+@admin.register(KPI)
+class KPIAdmin(admin.ModelAdmin):
+    list_display = ["name", "period", "goal"]
+    inlines = (EvaluationInline,)
+    raw_id_fields = ["evaluated_persons"]

wbhuman_resources-2.2.1/wbhuman_resources/admin/review.py

@@ -0,0 +1,157 @@
+from io import StringIO
+
+import pandas as pd
+from django.contrib import admin
+from django.shortcuts import redirect, render
+from django.utils.translation import gettext_lazy as _
+from reversion.errors import RevertError
+from wbcore.admin import CsvImportForm, ExportCsvMixin, ImportCsvMixin
+
+from ..models.review import (
+    Review,
+    ReviewAnswer,
+    ReviewGroup,
+    ReviewQuestion,
+    ReviewQuestionCategory,
+)
+
+
+class CustomImportCsvMixin(ImportCsvMixin):
+    def _import_csv(self, request, _sep=";"):
+        if request.method == "POST":
+            csv_file = request.FILES["csv_file"]
+
+            str_text = ""
+            for line in csv_file:
+                str_text = str_text + line.decode()
+            # Import csv as df
+            df = pd.read_csv(StringIO(str_text), sep=_sep)
+            # Sanitize dataframe
+            df = df.where(pd.notnull(df), None)
+            df = df.drop(df.columns.difference(self.get_import_fields()), axis=1)
+
+            # Overide this function if there is foreign key ids in the dataframe
+            df = self.manipulate_df(df)
+            errors = 0
+            revert_errors = 0
+            nb_added = 0
+            for model in df.to_dict("records"):
+                # by default, process the modela as a create request. Can be override to change the behavior
+                try:
+                    nb_added += self.process_model(model)
+                # https://django-reversion.readthedocs.io/en/stable/common-problems.html
+                except RevertError:
+                    revert_errors += 1
+                except Exception as e:
+                    print(e)  # noqa: T201
+                    errors += 1
+            self.message_user(
+                request,
+                _(
+                    "Your CSV file has been imported : {} imported ({} added, {} updated), {} errors, {} revert errors found due to failure to restore old versions"
+                ).format(
+                    df.shape[0] - errors - revert_errors,
+                    nb_added,
+                    df.shape[0] - errors - revert_errors - nb_added,
+                    errors,
+                    revert_errors,
+                ),
+            )
+            return redirect("..")
+        form = CsvImportForm()
+        payload = {"form": form}
+        return render(request, "wbcore/admin/csv_form.html", payload)
+
+
+@admin.register(ReviewGroup)
+class ReviewGroupAdmin(admin.ModelAdmin):
+    list_display = ["name"]
+
+
+@admin.register(Review)
+class ReviewAdmin(admin.ModelAdmin):
+    list_display = [
+        "id",
+        "year",
+        "type",
+        "from_date",
+        "to_date",
+        "review_deadline",
+        "review",
+        "auto_apply_deadline",
+        "status",
+        "reviewee",
+        "reviewer",
+        "moderator",
+        "review_group",
+        "is_template",
+    ]
+
+
+@admin.register(ReviewQuestionCategory)
+class ReviewQuestionCategoryAdmin(ExportCsvMixin, CustomImportCsvMixin, admin.ModelAdmin):
+    list_display = ["name", "order", "weight"]
+
+    def manipulate_df(self, df):
+        return df
+
+    def get_import_fields(self):
+        return ["name", "order", "weight"]
+
+    def process_model(self, model):
+        if category_name := model.get("name"):
+            _, created = self.model.objects.update_or_create(
+                name=category_name,
+                defaults={
+                    "order": model.get("order"),
+                    "weight": model.get("weight"),
+                },
+            )
+            return 1 if created else 0
+        return 0
+
+
+@admin.register(ReviewQuestion)
+class ReviewQuestion(ExportCsvMixin, CustomImportCsvMixin, admin.ModelAdmin):
+    list_display = [
+        "id",
+        "question",
+        "review",
+        "category",
+        "mandatory",
+        "answer_type",
+        "for_reviewee",
+        "for_reviewer",
+        "for_department_peers",
+        "for_company_peers",
+        "order",
+        "weight",
+    ]
+
+    def manipulate_df(self, df):
+        df["review"] = df["review_id"].apply(lambda x: Review.objects.get(id=x))
+        df["category"] = df["category_name"].apply(lambda x: ReviewQuestionCategory.objects.filter(name=x).first())
+        return df
+
+    def get_import_fields(self):
+        return ["review_id", "category_name", "answer_type", "order", "weight", "question"]
+
+    def process_model(self, model):
+        if review := model.get("review"):
+            _, created = self.model.objects.update_or_create(
+                review=review,
+                question=model.get("question"),
+                defaults={
+                    "category": model.get("category"),
+                    "answer_type": model.get("answer_type"),
+                    "order": model.get("order"),
+                    "weight": model.get("weight"),
+                },
+            )
+            return 1 if created else 0
+        return 0
+
+
+@admin.register(ReviewAnswer)
+class ReviewAnswerAdmin(admin.ModelAdmin):
+    list_display = ["question", "answered_by", "answer_number", "answered_anonymized"]

wbhuman_resources-2.2.1/wbhuman_resources/apps.py

@@ -0,0 +1,22 @@
+from django.apps import AppConfig, apps
+from django.db.models.signals import post_migrate
+
+
+class WbhumanResourcesConfig(AppConfig):
+    name = "wbhuman_resources"
+
+    def ready(self) -> None:
+        from wbcore.signals.filters import add_filters
+        from wbhuman_resources.management import initialize_task
+
+        from .filters.signals import add_position_filter
+
+        if apps.is_installed("wbcrm"):
+            from wbcrm.filters import ActivityFilter
+
+            add_filters.connect(add_position_filter, sender=ActivityFilter)
+
+        post_migrate.connect(
+            initialize_task,
+            dispatch_uid="wbhuman_resources.initialize_task",
+        )