netbox-contract 2.2.3__tar.gz → 2.2.5__tar.gz

{netbox_contract-2.2.3/src/netbox_contract.egg-info → netbox_contract-2.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: netbox-contract
-Version: 2.2.3
+Version: 2.2.5
 Summary: Contract management plugin for Netbox
 Author-email: Marc Lebreuil <marc@famillelebreuil.net>
 Project-URL: Homepage, https://github.com/mlebreuil/netbox-contract
@@ -62,10 +62,11 @@ PLUGINS_CONFIG = {
             "project": "", 
             "cost center": ""
         },
-        'mandatory_contract_fields': ['accounting_dimensions'],
+        'mandatory_contract_fields': [],
         'hidden_contract_fields': [],
-        'mandatory_invoice_fields': ['accounting_dimensions'],
+        'mandatory_invoice_fields': [],
         'hidden_invoice_fields': [],
+        'mandatory_dimensions': [],
     }
 }
 

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/README.md

@@ -46,10 +46,11 @@ PLUGINS_CONFIG = {
             "project": "", 
             "cost center": ""
         },
-        'mandatory_contract_fields': ['accounting_dimensions'],
+        'mandatory_contract_fields': [],
         'hidden_contract_fields': [],
-        'mandatory_invoice_fields': ['accounting_dimensions'],
+        'mandatory_invoice_fields': [],
         'hidden_invoice_fields': [],
+        'mandatory_dimensions': [],
     }
 }
 

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "netbox-contract"
-version = "2.2.3"
+version = "2.2.5"
 authors = [
   { name="Marc Lebreuil", email="marc@famillelebreuil.net" },
 ]

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/src/netbox_contract/__init__.py

@@ -5,7 +5,7 @@ class ContractsConfig(PluginConfig):
     name = 'netbox_contract'
     verbose_name = 'Netbox contract'
     description = 'Contract management plugin for Netbox'
-    version = '2.2.3'
+    version = '2.2.5'
     author = 'Marc Lebreuil'
     author_email = 'marc@famillelebreuil.net'
     base_url = 'contracts'
@@ -22,6 +22,7 @@ class ContractsConfig(PluginConfig):
         'hidden_contract_fields': [],
         'mandatory_invoice_fields': [],
         'hidden_invoice_fields': [],
+        'mandatory_dimensions': [],
     }
 
 

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/src/netbox_contract/api/serializers.py

@@ -1,6 +1,7 @@
 from django.contrib.auth.models import ContentType
+from django.core.exceptions import ObjectDoesNotExist
 from drf_yasg.utils import swagger_serializer_method
-from netbox.api.fields import ContentTypeField
+from netbox.api.fields import ContentTypeField, SerializedPKRelatedField
 from netbox.api.serializers import NetBoxModelSerializer, WritableNestedSerializer
 from netbox.constants import NESTED_SERIALIZER_PREFIX
 from rest_framework import serializers
@@ -31,10 +32,46 @@ class NestedContractSerializer(WritableNestedSerializer):
     url = serializers.HyperlinkedIdentityField(
         view_name='plugins-api:netbox_contract-api:contract-detail'
     )
+    yrc = serializers.DecimalField(max_digits=10, decimal_places=2, read_only=True)
+    tenant = NestedTenantSerializer(many=False, required=False)
+    external_partie_object_type = ContentTypeField(queryset=ContentType.objects.all())
+    external_partie_object = serializers.SerializerMethodField(read_only=True)
 
     class Meta:
         model = Contract
-        fields = ('id', 'url', 'display', 'name')
+        fields = fields = (
+            'id',
+            'url',
+            'display',
+            'name',
+            'external_partie_object_type',
+            'external_partie_object_id',
+            'external_partie_object',
+            'external_reference',
+            'internal_partie',
+            'tenant',
+            'status',
+            'start_date',
+            'end_date',
+            'initial_term',
+            'renewal_term',
+            'currency',
+            'accounting_dimensions',
+            'mrc',
+            'yrc',
+            'nrc',
+            'invoice_frequency',
+            'comments',
+        )
+
+    @swagger_serializer_method(serializer_or_field=serializers.JSONField)
+    def get_external_partie_object(self, instance):
+        serializer = get_serializer_for_model(
+            instance.external_partie_object_type.model_class(),
+            prefix=NESTED_SERIALIZER_PREFIX,
+        )
+        context = {'request': self.context['request']}
+        return serializer(instance.external_partie_object, context=context).data
 
 
 class NestedInvoiceSerializer(WritableNestedSerializer):
@@ -134,8 +171,25 @@ class ContractSerializer(NetBoxModelSerializer):
             'url',
             'display',
             'name',
+            'external_partie_object_type',
+            'external_partie_object_id',
             'external_partie_object',
+            'external_reference',
+            'internal_partie',
+            'tenant',
             'status',
+            'start_date',
+            'end_date',
+            'initial_term',
+            'renewal_term',
+            'currency',
+            'accounting_dimensions',
+            'mrc',
+            'yrc',
+            'nrc',
+            'invoice_frequency',
+            'comments',
+            'parent',
         )
 
     @swagger_serializer_method(serializer_or_field=serializers.JSONField)
@@ -152,7 +206,12 @@ class InvoiceSerializer(NetBoxModelSerializer):
     url = serializers.HyperlinkedIdentityField(
         view_name='plugins-api:netbox_contract-api:invoice-detail'
     )
-    contracts = NestedContractSerializer(many=True, required=False)
+    contracts = SerializedPKRelatedField(
+        queryset=Contract.objects.all(),
+        serializer=ContractSerializer,
+        required=False,
+        many=True,
+    )
 
     class Meta:
         model = Invoice
@@ -162,6 +221,7 @@ class InvoiceSerializer(NetBoxModelSerializer):
             'display',
             'number',
             'date',
+            'template',
             'contracts',
             'period_start',
             'period_end',
@@ -174,7 +234,87 @@ class InvoiceSerializer(NetBoxModelSerializer):
             'created',
             'last_updated',
         )
-        brief_fields = ('id', 'url', 'display', 'number', 'contracts')
+        brief_fields = (
+            'id',
+            'url',
+            'display',
+            'number',
+            'date',
+            'template',
+            'contracts',
+            'period_start',
+            'period_end',
+            'currency',
+            'accounting_dimensions',
+            'amount',
+            'comments',
+        )
+
+    def validate(self, data):
+        data = super().validate(data)
+
+        # template checks
+        if data['template']:
+            # Check that there is only one invoice template per contract
+            contracts = data['contracts']
+            for contract in contracts:
+                for invoice in contract.invoices.all():
+                    if invoice.template and invoice != self.instance:
+                        raise serializers.ValidationError(
+                            'Only one invoice template allowed per contract'
+                        )
+
+            # Prefix the invoice name with _template
+            data['number'] = '_invoice_template_' + contract.name
+
+            # set the periode start and end date to null
+            data['period_start'] = None
+            data['period_end'] = None
+        return data
+
+    def create(self, validated_data):
+        instance = super().create(validated_data)
+
+        if not instance.template:
+            contracts = instance.contracts.all()
+
+            for contract in contracts:
+                try:
+                    template_exists = True
+                    invoice_template = Invoice.objects.get(
+                        template=True, contracts=contract
+                    )
+                except ObjectDoesNotExist:
+                    template_exists = False
+
+                if template_exists:
+                    first = True
+                    for line in invoice_template.invoicelines.all():
+                        dimensions = line.accounting_dimensions.all()
+                        line.pk = None
+                        line.id = None
+                        line._state.adding = True
+                        line.invoice = instance
+
+                        # adjust the first invoice line amount
+                        amount = validated_data['amount']
+                        if (
+                            first
+                            and amount != invoice_template.total_invoicelines_amount
+                        ):
+                            line.amount = (
+                                line.amount
+                                + amount
+                                - invoice_template.total_invoicelines_amount
+                            )
+
+                        line.save()
+
+                        for dimension in dimensions:
+                            line.accounting_dimensions.add(dimension)
+                        first = False
+
+        return instance
 
 
 class ServiceProviderSerializer(NetBoxModelSerializer):
@@ -235,8 +375,11 @@ class InvoiceLineSerializer(NetBoxModelSerializer):
         view_name='plugins-api:netbox_contract-api:invoiceline-detail'
     )
     invoice = NestedInvoiceSerializer(many=False, required=False)
-    accounting_dimensions = NestedAccountingDimensionSerializer(
-        many=True, required=False
+    accounting_dimensions = SerializedPKRelatedField(
+        queryset=AccountingDimension.objects.all(),
+        serializer=NestedAccountingDimensionSerializer,
+        required=False,
+        many=True,
     )
 
     class Meta:
@@ -264,6 +407,18 @@ class InvoiceLineSerializer(NetBoxModelSerializer):
             'name',
         )
 
+    def validate(self, data):
+        super().validate(data)
+        # check for duplicate dimensions
+        accounting_dimensions = data['accounting_dimensions']
+        dimensions_names = []
+        for dimension in accounting_dimensions:
+            if dimension.name in dimensions_names:
+                raise serializers.ValidationError('duplicate accounting dimension')
+            else:
+                dimensions_names.append(dimension.name)
+        return data
+
 
 class AccountingDimensionSerializer(NetBoxModelSerializer):
     url = serializers.HyperlinkedIdentityField(

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/src/netbox_contract/api/views.py

@@ -21,6 +21,7 @@ class ContractViewSet(NetBoxModelViewSet):
         )
     )
     serializer_class = ContractSerializer
+    filterset_class = filtersets.ContractFilterSet
 
 
 class InvoiceViewSet(NetBoxModelViewSet):
@@ -44,6 +45,7 @@ class InvoiceLineViewSet(NetBoxModelViewSet):
         'invoice', 'accounting_dimensions', 'tags'
     )
     serializer_class = InvoiceLineSerializer
+    filterset_class = filtersets.InvoiceLineFilterSet
 
 
 class AccountingDimensionViewSet(NetBoxModelViewSet):

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/src/netbox_contract/filtersets.py

@@ -1,20 +1,42 @@
+import django_filters
 from django.db.models import Q
 from netbox.filtersets import NetBoxModelFilterSet
+from tenancy.filtersets import TenancyFilterSet
 
 from .models import (
     AccountingDimension,
+    AccountingDimensionStatusChoices,
     Contract,
     ContractAssignment,
+    CurrencyChoices,
+    InternalEntityChoices,
     Invoice,
     InvoiceLine,
     ServiceProvider,
+    StatusChoices,
 )
 
 
-class ContractFilterSet(NetBoxModelFilterSet):
+class ContractFilterSet(NetBoxModelFilterSet, TenancyFilterSet):
+    status = django_filters.MultipleChoiceFilter(choices=StatusChoices, null_value=None)
+    internal_partie = django_filters.MultipleChoiceFilter(
+        choices=InternalEntityChoices, null_value=None
+    )
+    currency = django_filters.MultipleChoiceFilter(
+        choices=CurrencyChoices, null_value=None
+    )
+
     class Meta:
         model = Contract
-        fields = ('id', 'internal_partie', 'status', 'parent')
+        fields = (
+            'id',
+            'name',
+            'external_reference',
+            'start_date',
+            'end_date',
+            'initial_term',
+            'parent',
+        )
 
     def search(self, queryset, name, value):
         return queryset.filter(
@@ -26,9 +48,22 @@ class ContractFilterSet(NetBoxModelFilterSet):
 
 
 class InvoiceFilterSet(NetBoxModelFilterSet):
+    currency = django_filters.MultipleChoiceFilter(
+        choices=CurrencyChoices, null_value=None
+    )
+
     class Meta:
         model = Invoice
-        fields = ('id', 'contracts')
+        fields = (
+            'id',
+            'number',
+            'template',
+            'date',
+            'contracts',
+            'period_start',
+            'period_end',
+            'amount',
+        )
 
     def search(self, queryset, name, value):
         return queryset.filter(
@@ -55,9 +90,13 @@ class ContractAssignmentFilterSet(NetBoxModelFilterSet):
 
 
 class InvoiceLineFilterSet(NetBoxModelFilterSet):
+    currency = django_filters.MultipleChoiceFilter(
+        choices=CurrencyChoices, null_value=None
+    )
+
     class Meta:
         model = InvoiceLine
-        fields = ('id', 'invoice')
+        fields = ('id', 'invoice', 'accounting_dimensions')
 
     def search(self, queryset, name, value):
         return queryset.filter(
@@ -66,6 +105,10 @@ class InvoiceLineFilterSet(NetBoxModelFilterSet):
 
 
 class AccountingDimensionFilterSet(NetBoxModelFilterSet):
+    status = django_filters.MultipleChoiceFilter(
+        choices=AccountingDimensionStatusChoices, null_value=None
+    )
+
     class Meta:
         model = AccountingDimension
         fields = ('name', 'value')

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/src/netbox_contract/forms.py

@@ -2,7 +2,6 @@ from django import forms
 from django.conf import settings
 from django.contrib.contenttypes.models import ContentType
 from django.core.exceptions import ObjectDoesNotExist, ValidationError
-from extras.filters import TagFilter
 from netbox.forms import (
     NetBoxModelBulkEditForm,
     NetBoxModelFilterSetForm,
@@ -10,6 +9,7 @@ from netbox.forms import (
     NetBoxModelImportForm,
 )
 from tenancy.models import Tenant
+from utilities.forms import BOOLEAN_WITH_BLANK_CHOICES
 from utilities.forms.fields import (
     CommentField,
     ContentTypeChoiceField,
@@ -21,6 +21,7 @@ from utilities.forms.fields import (
     DynamicModelMultipleChoiceField,
     JSONField,
     SlugField,
+    TagFilterField,
 )
 from utilities.forms.widgets import DatePicker, HTMXSelect
 
@@ -30,6 +31,7 @@ from .models import (
     AccountingDimensionStatusChoices,
     Contract,
     ContractAssignment,
+    CurrencyChoices,
     InternalEntityChoices,
     Invoice,
     InvoiceLine,
@@ -160,9 +162,11 @@ class ContractFilterSetForm(NetBoxModelFilterSetForm):
 
     tenant = DynamicModelChoiceField(queryset=Tenant.objects.all(), required=False)
     external_reference = forms.CharField(required=False)
-    internal_partie = forms.CharField(required=False)
+    internal_partie = forms.ChoiceField(choices=InternalEntityChoices, required=False)
     status = forms.ChoiceField(choices=StatusChoices, required=False)
+    currency = forms.ChoiceField(choices=CurrencyChoices, required=False)
     parent = DynamicModelChoiceField(queryset=Contract.objects.all(), required=False)
+    tag = TagFilterField(model)
 
 
 class ContractCSVForm(NetBoxModelImportForm):
@@ -227,13 +231,17 @@ class ContractCSVForm(NetBoxModelImportForm):
 
 class ContractBulkEditForm(NetBoxModelBulkEditForm):
     name = forms.CharField(max_length=100, required=False)
-
     external_reference = forms.CharField(max_length=100, required=False)
     internal_partie = forms.ChoiceField(choices=InternalEntityChoices, required=False)
+    tenant = DynamicModelChoiceField(queryset=Tenant.objects.all(), required=False)
+    accounting_dimensions = Dimensions(required=False)
     comments = CommentField(required=False)
     parent = DynamicModelChoiceField(queryset=Contract.objects.all(), required=False)
 
-    nullable_fields = ('comments',)
+    nullable_fields = (
+        'accounting_dimensions',
+        'comments',
+    )
     model = Contract
 
 
@@ -354,9 +362,15 @@ class InvoiceForm(NetBoxModelForm):
 
 class InvoiceFilterSetForm(NetBoxModelFilterSetForm):
     model = Invoice
+    number = forms.CharField(required=False)
+    template = forms.NullBooleanField(
+        required=False, widget=forms.Select(choices=BOOLEAN_WITH_BLANK_CHOICES)
+    )
+    currency = forms.ChoiceField(choices=CurrencyChoices, required=False)
     contracts = DynamicModelMultipleChoiceField(
         queryset=Contract.objects.all(), required=False
     )
+    tag = TagFilterField(model)
 
 
 class InvoiceCSVForm(NetBoxModelImportForm):
@@ -386,9 +400,23 @@ class InvoiceCSVForm(NetBoxModelImportForm):
 
 class InvoiceBulkEditForm(NetBoxModelBulkEditForm):
     number = forms.CharField(max_length=100, required=True)
+    template = forms.BooleanField(required=False)
+    date = forms.DateField(required=False)
     contracts = DynamicModelMultipleChoiceField(
         queryset=Contract.objects.all(), required=False
     )
+    period_start = forms.DateField(required=False)
+    period_end = forms.DateField(required=False)
+    currency = forms.ChoiceField(choices=CurrencyChoices, required=False)
+    accounting_dimensions = Dimensions(required=False)
+    amount = forms.DecimalField(max_digits=10, decimal_places=2, required=False)
+    documents = forms.URLField(required=False)
+    comments = CommentField()
+    nullable_fields = (
+        'accounting_dimensions',
+        'comments',
+    )
+
     model = Invoice
 
 
@@ -406,7 +434,8 @@ class ServiceProviderForm(NetBoxModelForm):
 
 class ServiceProviderFilterSetForm(NetBoxModelFilterSetForm):
     model = ServiceProvider
-    tag = TagFilter()
+    name = forms.CharField(required=False)
+    tag = TagFilterField(model)
 
 
 class ServiceProviderCSVForm(NetBoxModelImportForm):
@@ -480,6 +509,12 @@ class InvoiceLineForm(NetBoxModelForm):
             else:
                 dimensions_names.append(dimension.name)
 
+        # Make sure mandatory dimensions are present
+        mandatory_dimensions = plugin_settings.get('mandatory_dimensions')
+        for dimension in mandatory_dimensions:
+            if dimension not in dimensions_names:
+                raise ValidationError(f'dimension {dimension} missing')
+
     class Meta:
         model = InvoiceLine
         fields = [
@@ -495,9 +530,11 @@ class InvoiceLineForm(NetBoxModelForm):
 class InvoiceLineFilterSetForm(NetBoxModelFilterSetForm):
     model = InvoiceLine
     invoice = DynamicModelChoiceField(queryset=Invoice.objects.all(), required=False)
-    accounting_dimensions = DynamicModelChoiceField(
+    accounting_dimensions = DynamicModelMultipleChoiceField(
         queryset=AccountingDimension.objects.all(), required=False
     )
+    currency = forms.ChoiceField(choices=CurrencyChoices, required=False)
+    tag = TagFilterField(model)
 
 
 class InvoiceLineImportForm(NetBoxModelImportForm):

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/src/netbox_contract/tables.py

@@ -200,7 +200,9 @@ class ServiceProviderListTable(NetBoxTable):
 
 class InvoiceLineListTable(NetBoxTable):
     invoice = tables.Column(linkify=True)
-    accounting_dimensions = tables.ManyToManyColumn(linkify=True)
+    accounting_dimensions = tables.ManyToManyColumn(
+        linkify=True, filter=lambda qs: qs.order_by('name')
+    )
 
     class Meta(NetBoxTable.Meta):
         model = InvoiceLine

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/src/netbox_contract/templates/netbox_contract/contract.html

@@ -120,6 +120,33 @@
     <div class="col col-md-6">
       {% include 'inc/panels/tags.html' %}
       {% include 'inc/panels/comments.html' %}
+      {% if invoice_template %}
+      <div class="card">
+        <h5 class="card-header">
+          Invoice template
+        </h5>
+        <table class="table table-hover attr-table">
+          <tr>
+            <th scope="row">Number</th>
+            <td>
+              <a href="{{ invoice_template.get_absolute_url }}">{{  invoice_template.number }}</a>
+            </td>
+          </tr>
+          <tr>
+            <th scope="row">Currency</th>
+            <td>{{ invoice_template.currency }}</td>
+          </tr>
+          <tr>
+            <th scope="row">Total amount</th>
+            <td>{{ invoice_template.total_invoicelines_amount }}</td>
+          </tr>
+        </table>
+        <h5 class="card-header">
+          Invoice template lines
+        </h5>
+          {% render_table invoicelines_table %}
+      </div>
+      {% endif %}
     </div>
   </div>
   <div class="row">
@@ -130,6 +157,7 @@
       </div>
     </div>
   </div>
+  {% if childs_table %}
   <div class="row">
     <div class="col col-md-12">
       <div class="card">
@@ -138,6 +166,7 @@
       </div>
     </div>
   </div>
+  {% endif %}
   {% if perms.netbox_contract.view_invoice %}
   <div class="row">
     <div class="col col-md-12">

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/src/netbox_contract/templates/netbox_contract/invoice.html

@@ -13,16 +13,16 @@
   <div class="row mb-3">
     <div class="col col-md-6">
       <div class="card">
-        <h5 class="card-header">Invoices</h5>
+        {% if object.template %}
+        <h5 class="card-header">Invoice template</h5>
+        {% else %}
+        <h5 class="card-header">Invoice</h5>
+        {% endif %}
           <table class="table table-hover attr-table">
             <tr>
               <th scope="row">Number</th>
               <td>{{ object.number }}</td>
             </tr>
-            <tr>
-              <th scope="row">Template</th>
-              <td>{{ object.template }}</td>
-            </tr>
             <tr>
               <th scope="row">Date</th>
               <td>{{ object.date }}</td>

{netbox_contract-2.2.3 → netbox_contract-2.2.5}/src/netbox_contract/views.py

@@ -138,20 +138,38 @@ class ContractView(generic.ObjectView):
     )
 
     def get_extra_context(self, request, instance):
-        invoices_table = tables.InvoiceListTable(instance.invoices.all())
+        invoices_table = tables.InvoiceListTable(
+            instance.invoices.exclude(template=True)
+        )
+        invoices_table.columns.hide('contracts')
         invoices_table.configure(request)
         assignments_table = tables.ContractAssignmentContractTable(
             instance.assignments.all()
         )
+        invoice_template = instance.invoices.filter(template=True).first()
+        if invoice_template:
+            invoicelines_table = tables.InvoiceLineListTable(
+                invoice_template.invoicelines.all()
+            )
+            invoicelines_table.columns.hide('invoice')
+            invoicelines_table.columns.hide('currency')
+            invoicelines_table.configure(request)
+        else:
+            invoicelines_table = None
         assignments_table.configure(request)
-        childs_table = tables.ContractListBottomTable(instance.childs.all())
-        childs_table.configure(request)
+        if instance.childs.all():
+            childs_table = tables.ContractListBottomTable(instance.childs.all())
+            childs_table.configure(request)
+        else:
+            childs_table = None
 
         hidden_fields = plugin_settings.get('hidden_contract_fields')
 
         return {
             'hidden_fields': hidden_fields,
             'invoices_table': invoices_table,
+            'invoice_template': invoice_template,
+            'invoicelines_table': invoicelines_table,
             'assignments_table': assignments_table,
             'childs_table': childs_table,
         }

{netbox_contract-2.2.3 → netbox_contract-2.2.5/src/netbox_contract.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: netbox-contract
-Version: 2.2.3
+Version: 2.2.5
 Summary: Contract management plugin for Netbox
 Author-email: Marc Lebreuil <marc@famillelebreuil.net>
 Project-URL: Homepage, https://github.com/mlebreuil/netbox-contract
@@ -62,10 +62,11 @@ PLUGINS_CONFIG = {
             "project": "", 
             "cost center": ""
         },
-        'mandatory_contract_fields': ['accounting_dimensions'],
+        'mandatory_contract_fields': [],
         'hidden_contract_fields': [],
-        'mandatory_invoice_fields': ['accounting_dimensions'],
+        'mandatory_invoice_fields': [],
         'hidden_invoice_fields': [],
+        'mandatory_dimensions': [],
     }
 }