netbos 0.0.1__tar.gz

netbos-0.0.1/LICENSE.txt

@@ -0,0 +1,17 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+Copyright 2026 Tobias Wild
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

netbos-0.0.1/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.4
+Name: netbos
+Version: 0.0.1
+Summary: A Netbox plugin to manage BOS assets
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://code.brknl.de/700180738/netbos
+Project-URL: Documentation, https://code.brknl.de/700180738/netbos#readme
+Project-URL: Source, https://code.brknl.de/700180738/netbos
+Project-URL: Issues, https://code.brknl.de/700180738/netbos/issues
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: Django
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Dynamic: license-file
+
+# netbos
+
+A Netbox plugin to manage BOS assets.
+
+## Installation
+
+```bash
+pip install netbos
+```
+
+## Netbox Configuration
+
+Add the plugin to your Netbox configuration:
+
+```python
+PLUGINS = ["netbos"]
+```
+
+## Source
+
+https://code.brknl.de/700180738/netbos

netbos-0.0.1/README.md

@@ -0,0 +1,21 @@
+# netbos
+
+A Netbox plugin to manage BOS assets.
+
+## Installation
+
+```bash
+pip install netbos
+```
+
+## Netbox Configuration
+
+Add the plugin to your Netbox configuration:
+
+```python
+PLUGINS = ["netbos"]
+```
+
+## Source
+
+https://code.brknl.de/700180738/netbos

netbos-0.0.1/__init__.py

@@ -0,0 +1 @@
+from .plugin import config

netbos-0.0.1/api/__init__.py

@@ -0,0 +1 @@
+

netbos-0.0.1/api/serializers.py

@@ -0,0 +1,95 @@
+from netbox.api.serializers import NetBoxModelSerializer
+from ..models import (
+    VehicleType,
+    Vehicle,
+    Group,
+    FirmwareVersion, Berechtigung, SIKA, Battery,
+    RadioDevice, Pager,
+    MaintenanceRecord,
+)
+
+class VehicleTypeSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = VehicleType
+        fields = ('id', 'url', 'display', 'type', 'type_short', 'tags', 'created', 'last_updated')
+
+
+class VehicleSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = Vehicle
+        fields = ('id', 'url', 'display', 'callsign', 'license_plate', 'vehicle_type', 'tags', 'created', 'last_updated')
+
+
+class GroupSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = Group
+        fields = ('id', 'url', 'display', 'group', 'name', 'mode', 'purpose', 'tags', 'created', 'last_updated')
+
+
+class FirmwareVersionSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = FirmwareVersion
+        fields = (
+            'id', 'url', 'display',
+            'version', 'mandatory_update', 'device_type',
+            'release_date', 'release_date_l_ttb', 'cutoff_date',
+            'changelog', 'tags', 'created', 'last_updated'
+        )
+
+
+class BerechtigungSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = Berechtigung
+        fields = ('id', 'url', 'display', 'name', 'description', 'tags', 'created', 'last_updated')
+
+
+class SIKASerializer(NetBoxModelSerializer):
+    class Meta:
+        model = SIKA
+        fields = (
+            'id', 'url', 'display',
+            'card_number', 'funkrufname', 'berechtigung', 'status', 'issi', 'org_block',
+            'tags', 'created', 'last_updated'
+        )
+
+
+class BatterySerializer(NetBoxModelSerializer):
+    class Meta:
+        model = Battery
+        fields = (
+            'id', 'url', 'display',
+            'capacity', 'serial_number', 'status', 'production_week', 'production_year', 'device_type',
+            'tags', 'created', 'last_updated'
+        )
+
+
+class RadioDeviceSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = RadioDevice
+        fields = (
+            'id', 'url', 'display',
+            'name', 'model', 'serial_number',
+            'owner', 'possessor_org', 'possessor_con', 'vehicle',
+            'sika', 'firmware', 'battery', 'licence',
+            'tei', 'status', 'notes', 'description', 'comments',
+            'tags', 'created', 'last_updated',
+        )
+
+
+class PagerSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = Pager
+        fields = (
+            'id', 'url', 'display',
+            'name', 'model', 'serial_number',
+            'tei', 'owner', 'possessor_org', 'possessor_con', 'sika', 'firmware', 'battery',
+            'status', 'notes',
+            'tags', 'created', 'last_updated',
+        )
+
+
+class MaintenanceRecordSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = MaintenanceRecord
+        fields = ('id', 'url', 'display', 'device', 'date', 'maintenance_type', 'description', 'tags', 'created', 'last_updated')
+

netbos-0.0.1/api/urls.py

@@ -0,0 +1,24 @@
+from netbox.api.routers import NetBoxRouter
+
+from .views import (
+    VehicleTypeViewSet,
+    VehicleViewSet,
+    GroupViewSet,
+    FirmwareVersionViewSet, BerechtigungViewSet, SIKAViewSet, BatteryViewSet,
+    RadioDeviceViewSet, PagerViewSet,
+    MaintenanceRecordViewSet,
+)
+
+router = NetBoxRouter()
+router.register('vehicle-types', VehicleTypeViewSet)
+router.register('vehicles', VehicleViewSet)
+router.register('groups', GroupViewSet)
+router.register('firmware', FirmwareVersionViewSet)
+router.register('berechtigungen', BerechtigungViewSet)
+router.register('sikas', SIKAViewSet)
+router.register('batteries', BatteryViewSet)
+router.register('radiodevices', RadioDeviceViewSet)
+router.register('pagers', PagerViewSet)
+router.register('maintenance', MaintenanceRecordViewSet)
+
+urlpatterns = router.urls

netbos-0.0.1/api/views.py

@@ -0,0 +1,71 @@
+from netbox.api.viewsets import NetBoxModelViewSet
+from .. import filtersets
+
+from ..models import (
+    VehicleType,
+    Vehicle,
+    Group,
+    FirmwareVersion, Berechtigung, SIKA, Battery,
+    RadioDevice, Pager,
+    MaintenanceRecord,
+)
+from .serializers import (
+    VehicleTypeSerializer,
+    VehicleSerializer,
+    GroupSerializer,
+    FirmwareVersionSerializer, BerechtigungSerializer, SIKASerializer, BatterySerializer,
+    RadioDeviceSerializer, PagerSerializer,
+    MaintenanceRecordSerializer,
+)
+
+
+class VehicleTypeViewSet(NetBoxModelViewSet):
+    queryset = VehicleType.objects.all()
+    serializer_class = VehicleTypeSerializer
+
+class VehicleViewSet(NetBoxModelViewSet):
+    queryset = Vehicle.objects.all()
+    serializer_class = VehicleSerializer
+
+
+class GroupViewSet(NetBoxModelViewSet):
+    queryset = Group.objects.all()
+    serializer_class = GroupSerializer
+
+
+class FirmwareVersionViewSet(NetBoxModelViewSet):
+    queryset = FirmwareVersion.objects.all()
+    serializer_class = FirmwareVersionSerializer
+    filterset_class = filtersets.FirmwareVersionFilterSet
+
+
+class BerechtigungViewSet(NetBoxModelViewSet):
+    queryset = Berechtigung.objects.all()
+    serializer_class = BerechtigungSerializer
+    filterset_class = filtersets.BerechtigungFilterSet
+
+
+class SIKAViewSet(NetBoxModelViewSet):
+    queryset = SIKA.objects.all()
+    serializer_class = SIKASerializer
+
+
+class BatteryViewSet(NetBoxModelViewSet):
+    queryset = Battery.objects.all()
+    serializer_class = BatterySerializer
+    filterset_class = filtersets.BatteryFilterSet
+
+
+class RadioDeviceViewSet(NetBoxModelViewSet):
+    queryset = RadioDevice.objects.all()
+    serializer_class = RadioDeviceSerializer
+
+
+class PagerViewSet(NetBoxModelViewSet):
+    queryset = Pager.objects.all()
+    serializer_class = PagerSerializer
+
+
+class MaintenanceRecordViewSet(NetBoxModelViewSet):
+    queryset = MaintenanceRecord.objects.all()
+    serializer_class = MaintenanceRecordSerializer

netbos-0.0.1/filtersets.py

@@ -0,0 +1,81 @@
+import django_filters
+
+from netbox.filtersets import NetBoxModelFilterSet
+from .models import (
+    VehicleType, Vehicle,
+    Group,
+    FirmwareVersion, Berechtigung, SIKA, Battery,
+    RadioDevice, Pager,
+    MaintenanceRecord,
+)
+
+
+class VehicleTypeFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = VehicleType
+        fields = ('type', 'type_short')
+
+
+class VehicleFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = Vehicle
+        fields = ('callsign', 'vehicle_type')
+
+
+class GroupFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = Group
+        fields = ('mode',)
+
+
+class FirmwareVersionFilterSet(NetBoxModelFilterSet):
+    model_id = django_filters.NumberFilter(method='filter_model_id')
+
+    def filter_model_id(self, queryset, name, value):
+        return queryset.filter(device_type=value)
+
+    class Meta:
+        model = FirmwareVersion
+        fields = ('device_type', 'model_id')
+
+
+class BerechtigungFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = Berechtigung
+        fields = ('name',)
+
+
+class SIKAFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = SIKA
+        fields = ('status', 'org_block', 'berechtigung')
+
+
+class BatteryFilterSet(NetBoxModelFilterSet):
+    model_id = django_filters.NumberFilter(method='filter_model_id')
+
+    def filter_model_id(self, queryset, name, value):
+        return queryset.filter(device_type=value)
+
+    class Meta:
+        model = Battery
+        fields = ('serial_number', 'status', 'device_type', 'model_id')
+
+
+class RadioDeviceFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = RadioDevice
+        fields = ('model', 'status')
+
+
+class PagerFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = Pager
+        fields = ('name', 'model', 'status')
+
+
+class MaintenanceRecordFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = MaintenanceRecord
+        fields = ('device', 'maintenance_type')
+

netbos-0.0.1/forms.py

@@ -0,0 +1,218 @@
+from django.db.models import Q
+from dcim.models import DeviceType
+from extras.models import Tag
+from netbox.forms import NetBoxModelForm
+from utilities.forms.fields import DynamicModelChoiceField, DynamicModelMultipleChoiceField
+from .models import (
+    VehicleType, Vehicle,
+    Group,
+    FirmwareVersion, Berechtigung, SIKA, Battery,
+    OrgBlockChoices,
+    RadioDevice, Pager,
+    MaintenanceRecord,
+)
+
+
+def _get_available_sika_queryset(org_block, instance=None):
+    """Return unassigned SIKAs for an org block, plus the instance's current SIKA while editing."""
+    queryset = SIKA.objects.filter(
+        org_block=org_block,
+        radio_device__isnull=True,
+        pager__isnull=True,
+    )
+
+    current_sika_id = getattr(instance, 'sika_id', None)
+    if current_sika_id:
+        queryset = queryset | SIKA.objects.filter(pk=current_sika_id, org_block=org_block)
+
+    return queryset.distinct().order_by('issi')
+
+
+class VehicleTypeForm(NetBoxModelForm):
+    class Meta:
+        model = VehicleType
+        fields = ('type', 'type_short', 'tags')
+
+
+class VehicleForm(NetBoxModelForm):
+    class Meta:
+        model = Vehicle
+        fields = ('name', 'callsign', 'license_plate', 'vehicle_type', 'description', 'comments', 'tags')
+
+
+class GroupForm(NetBoxModelForm):
+    class Meta:
+        model = Group
+        fields = ('group', 'name', 'mode', 'purpose', 'tags')
+
+
+class FirmwareVersionForm(NetBoxModelForm):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.fields['device_type'].queryset = DeviceType.objects.filter(
+            Q(tags__name='RadioDevice') | Q(tags__slug='radiodevice') | Q(tags__name='Pager') | Q(tags__slug='pager')
+        ).distinct()
+    
+    class Meta:
+        model = FirmwareVersion
+        fields = (
+            'version', 'mandatory_update', 'device_type',
+            'release_date', 'release_date_l_ttb', 'cutoff_date',
+            'changelog', 'tags'
+        )
+
+
+class BerechtigungForm(NetBoxModelForm):
+    class Meta:
+        model = Berechtigung
+        fields = ('name', 'description', 'comments', 'tags')
+
+
+class SIKAForm(NetBoxModelForm):
+    class Meta:
+        model = SIKA
+        fields = ('issi', 'card_number', 'funkrufname', 'funkrufname_tel', 'berechtigung', 'org_block', 'version', 'status', 'tags')
+
+
+class BatteryForm(NetBoxModelForm):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.fields['device_type'].queryset = DeviceType.objects.filter(
+            Q(tags__name='RadioDevice') | Q(tags__slug='radiodevice') | Q(tags__name='Pager') | Q(tags__slug='pager')
+        ).distinct()
+
+    class Meta:
+        model = Battery
+        fields = (
+            'capacity', 'serial_number', 'status', 'production_week', 'production_year',
+            'device_type', 'tags',
+        )
+
+
+class RadioDeviceForm(NetBoxModelForm):
+    firmware = DynamicModelChoiceField(
+        queryset=FirmwareVersion.objects.order_by('version'),
+        required=False,
+        label='Firmware',
+        query_params={'model_id': '$model'},
+    )
+
+    battery = DynamicModelMultipleChoiceField(
+        queryset=Battery.objects.order_by('serial_number'),
+        required=False,
+        label='Akkus',
+        query_params={'model_id': '$model'},
+    )
+
+    def _get_selected_model_id(self):
+        model_key = self.add_prefix('model')
+        model_id = self.data.get(model_key) if self.is_bound else self.initial.get('model')
+        if model_id in (None, '') and getattr(self.instance, 'model_id', None):
+            model_id = self.instance.model_id
+        return model_id
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.fields['model'].queryset = DeviceType.objects.filter(
+            Q(tags__name='RadioDevice') | Q(tags__slug='radiodevice')
+        ).distinct()
+        self.fields['sika'].queryset = _get_available_sika_queryset(
+            OrgBlockChoices.SPEECH,
+            instance=self.instance,
+        )
+        self.fields['licence'].queryset = Tag.objects.filter(
+            slug__in=('repeater', 'gateway', 'bluetooth')
+        ).order_by('name')
+        model_id = self._get_selected_model_id()
+        if model_id:
+            self.fields['firmware'].queryset = FirmwareVersion.objects.filter(device_type=model_id).distinct()
+            self.fields['battery'].queryset = Battery.objects.filter(device_type=model_id).distinct().order_by('serial_number')
+        else:
+            self.fields['firmware'].queryset = FirmwareVersion.objects.none()
+            self.fields['battery'].queryset = Battery.objects.none()
+
+    def clean(self):
+        super().clean()
+        model = self.cleaned_data.get('model')
+        firmware = self.cleaned_data.get('firmware')
+        batteries = self.cleaned_data.get('battery')
+        if model and firmware and not firmware.device_type.filter(pk=model.pk).exists():
+            self.add_error('firmware', 'Diese Firmware ist für den gewählten Gerätetyp nicht freigegeben.')
+        if model and batteries and batteries.exclude(device_type=model.pk).exists():
+            self.add_error('battery', 'Mindestens ein Akku ist für den gewählten Gerätetyp nicht freigegeben.')
+        return self.cleaned_data
+
+    class Meta:
+        model = RadioDevice
+        fields = (
+            'name', 'model', 'serial_number', 'tei',
+            'owner', 'possessor_org', 'possessor_con', 'vehicle',
+            'sika', 'firmware', 'battery', 'licence', 'status', 'notes', 'description', 'comments',
+            'tags',
+        )
+
+
+class PagerForm(NetBoxModelForm):
+    firmware = DynamicModelChoiceField(
+        queryset=FirmwareVersion.objects.order_by('version'),
+        required=False,
+        label='Firmware',
+        query_params={'model_id': '$model'},
+    )
+
+    battery = DynamicModelMultipleChoiceField(
+        queryset=Battery.objects.order_by('serial_number'),
+        required=False,
+        label='Akkus',
+        query_params={'model_id': '$model'},
+    )
+
+    def _get_selected_model_id(self):
+        model_key = self.add_prefix('model')
+        model_id = self.data.get(model_key) if self.is_bound else self.initial.get('model')
+        if model_id in (None, '') and getattr(self.instance, 'model_id', None):
+            model_id = self.instance.model_id
+        return model_id
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.fields['model'].queryset = DeviceType.objects.filter(
+            Q(tags__name='Pager') | Q(tags__slug='pager')
+        ).distinct()
+        self.fields['sika'].queryset = _get_available_sika_queryset(
+            OrgBlockChoices.ALARM,
+            instance=self.instance,
+        )
+        model_id = self._get_selected_model_id()
+        if model_id:
+            self.fields['firmware'].queryset = FirmwareVersion.objects.filter(device_type=model_id).distinct()
+            self.fields['battery'].queryset = Battery.objects.filter(device_type=model_id).distinct().order_by('serial_number')
+        else:
+            self.fields['firmware'].queryset = FirmwareVersion.objects.none()
+            self.fields['battery'].queryset = Battery.objects.none()
+
+    def clean(self):
+        super().clean()
+        model = self.cleaned_data.get('model')
+        firmware = self.cleaned_data.get('firmware')
+        batteries = self.cleaned_data.get('battery')
+        if model and firmware and not firmware.device_type.filter(pk=model.pk).exists():
+            self.add_error('firmware', 'Diese Firmware ist für den gewählten Gerätetyp nicht freigegeben.')
+        if model and batteries and batteries.exclude(device_type=model.pk).exists():
+            self.add_error('battery', 'Mindestens ein Akku ist für den gewählten Gerätetyp nicht freigegeben.')
+        return self.cleaned_data
+
+    class Meta:
+        model = Pager
+        fields = (
+            'name', 'model', 'serial_number',
+            'tei', 'owner', 'possessor_org', 'possessor_con', 'vehicle', 'sika', 'firmware', 'battery', 'status', 'notes',
+            'tags',
+        )
+
+
+class MaintenanceRecordForm(NetBoxModelForm):
+    class Meta:
+        model = MaintenanceRecord
+        fields = ('device', 'date', 'maintenance_type', 'description', 'tags')
+