added functionality to create new facility on existing kolibri

kolibri/core/auth/api.py

@@ -16,6 +16,7 @@
 from django.contrib.auth.models import AnonymousUser
 from django.core.exceptions import ObjectDoesNotExist
 from django.core.exceptions import PermissionDenied
+from django.db import transaction
 from django.db.models import Func
 from django.db.models import OuterRef
 from django.db.models import Q
@@ -60,6 +61,7 @@
 from .models import Membership
 from .models import Role
 from .serializers import ClassroomSerializer
+from .serializers import CreateFacilitySerializer
 from .serializers import ExtraFieldsSerializer
 from .serializers import FacilityDatasetSerializer
 from .serializers import FacilitySerializer
@@ -621,6 +623,20 @@ def annotate_queryset(self, queryset):
             )
         )
 
+    @decorators.action(methods=["post"], detail=False)
+    def create_facility(self, request):
+        serializer = CreateFacilitySerializer(data=request.data)
+        if serializer.is_valid():
+            with transaction.atomic():
+                facility_dataset = FacilityDataset.objects.create(
+                    preset=serializer.validated_data.get("preset")
+                )
+                Facility.objects.create(
+                    name=serializer.validated_data.get("name"), dataset=facility_dataset
+                )
+            return Response()
+        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
+
 
 class PublicFacilityViewSet(viewsets.ReadOnlyModelViewSet):
     queryset = Facility.objects.all()

kolibri/core/auth/serializers.py

@@ -6,6 +6,7 @@
 from rest_framework import serializers
 from rest_framework.validators import UniqueTogetherValidator
 
+from .constants import facility_presets
 from .errors import IncompatibleDeviceSettingError
 from .errors import InvalidCollectionHierarchy
 from .errors import InvalidMembershipError
@@ -137,6 +138,14 @@ class Meta:
         fields = ("id", "name")
 
 
+class CreateFacilitySerializer(serializers.ModelSerializer):
+    preset = serializers.ChoiceField(choices=facility_presets.choices)
+
+    class Meta:
+        model = Facility
+        fields = ("id", "name", "preset")
+
+
 class PublicFacilitySerializer(serializers.ModelSerializer):
     learner_can_login_with_no_password = serializers.SerializerMethodField()
     learner_can_sign_up = serializers.SerializerMethodField()

kolibri/plugins/device/assets/src/constants.js

@@ -71,3 +71,8 @@ export const MeteredConnectionDownloadOptions = {
   DISALLOW_DOWNLOAD_ON_METERED_CONNECTION: 'DISALLOW_DOWNLOAD_ON_METERED_CONNECTION',
   ALLOW_DOWNLOAD_ON_METERED_CONNECTION: 'ALLOW_DOWNLOAD_ON_METERED_CONNECTION',
 };
+
+export const Presets = Object.freeze({
+  FORMAL: 'formal',
+  NONFORMAL: 'nonformal',
+});

kolibri/plugins/device/assets/src/views/FacilitiesPage/CreateNewFacilityModal.vue

@@ -0,0 +1,121 @@
+<template>
+
+  <KModal
+    :title="$tr('createFacilityLabel')"
+    :submitText="$tr('createFacilityButtonLabel')"
+    :cancelText="coreString('closeAction')"
+    size="medium"
+    @submit="handleSubmit"
+    @cancel="$emit('cancel')"
+  >
+    <p>{{ coreString('learningFacilityDescription') }}</p>
+    <KTextbox
+      ref="facilityNameTextBox"
+      v-model="facilityName"
+      :label="$tr('facilityNameFieldLabel')"
+      :invalid="facilityNameInvalid"
+      :invalidText="coreString('requiredFieldError')"
+      :maxlength="50"
+    />
+    <b>{{ $tr('learningEnvironmentHeader') }}</b>
+    <KRadioButton
+      v-model="preset"
+      class="permission-preset-radio-button"
+      :value="Presets.NONFORMAL"
+      :label="$tr('nonFormalLabel')"
+      :description="$tr('nonFormalDescription')"
+    />
+    <KRadioButton
+      v-model="preset"
+      class="permission-preset-radio-button"
+      :value="Presets.FORMAL"
+      :label="$tr('formalLabel')"
+      :description="$tr('formalDescription')"
+    />
+  </KModal>
+
+</template>
+
+
+<script>
+
+  import commonCoreStrings from 'kolibri.coreVue.mixins.commonCoreStrings';
+  import commonSyncElements from 'kolibri.coreVue.mixins.commonSyncElements';
+  import { Presets } from '../../constants';
+  import { createFacility } from './api';
+
+  export default {
+    name: 'CreateNewFacilityModal',
+    mixins: [commonCoreStrings, commonSyncElements],
+    data() {
+      return {
+        facilityName: '',
+        preset: 'nonformal',
+        Presets,
+      };
+    },
+    computed: {
+      facilityNameInvalid() {
+        return !this.facilityName || this.facilityName.trim() === '';
+      },
+    },
+    methods: {
+      handleSubmit() {
+        if (this.facilityNameInvalid) {
+          return this.$refs.facilityNameTextBox.focus();
+        }
+        const payload = {
+          name: this.facilityName,
+          preset: this.preset,
+        };
+        createFacility(payload)
+          .then(() => {
+            this.$emit('success');
+          })
+          .catch(error => {
+            this.$store.dispatch('handleApiError', error);
+          });
+      },
+    },
+    $trs: {
+      facilityNameFieldLabel: {
+        message: 'Learning facility name',
+        context: 'The field where the admin adds the name of their facility.',
+      },
+      learningEnvironmentHeader: {
+        message: 'What kind of environment is your facility?',
+        context: 'Title for facility environment.',
+      },
+      formalLabel: {
+        message: 'Formal',
+        context: 'Label for the radio button option in the facility setup.',
+      },
+      formalDescription: {
+        message: 'Schools and other formal learning contexts.',
+        context: "Option description text for 'Formal' facility types.",
+      },
+      nonFormalLabel: {
+        message: 'Non-formal',
+        context: 'Label for the radio button option in the facility setup',
+      },
+      nonFormalDescription: {
+        message:
+          'Libraries, orphanages, youth centers, computer labs, and other non-formal learning contexts.',
+
+        context: "Option description text for 'Non-formal' facility types.",
+      },
+      createFacilityLabel: {
+        message: 'Create a new learning facility',
+        context: 'Title for create facility modal',
+      },
+      createFacilityButtonLabel: {
+        message: 'create facility',
+        context: 'Label for create facility submit button.',
+      },
+    },
+  };
+
+</script>
+
+
+<style lang="scss" scoped></style>

kolibri/plugins/device/assets/src/views/FacilitiesPage/api.js

@@ -0,0 +1,12 @@
+import client from 'kolibri.client';
+import urls from 'kolibri.urls';
+
+const url = urls['kolibri:core:facility-create-facility']();
+
+export function createFacility(payload) {
+  return client({
+    url,
+    method: 'POST',
+    data: payload,
+  });
+}

kolibri/plugins/device/assets/src/views/FacilitiesPage/index.vue

@@ -14,11 +14,18 @@
               @click="showSyncAllModal = true"
             />
             <KButton
-              :text="getCommonSyncString('importFacilityAction')"
+              hasDropdown
+              :text="$tr('createFacilityLabel')"
               primary
               style="margin-top: 16px; margin-bottom: -16px;"
-              @click="showImportModal = true"
-            />
+            >
+              <template #menu>
+                <KDropdownMenu
+                  :options="options"
+                  @select="handleSelect"
+                />
+              </template>
+            </KButton>
           </KButtonGroup>
         </template>
       </HeaderWithOptions>
@@ -144,6 +151,11 @@
         @success="handleStartImportSuccess"
         @cancel="showImportModal = false"
       />
+      <CreateNewFacilityModal
+        v-if="showCreateFacilityModal"
+        @success="handleCreateFacilitySuccess"
+        @cancel="showCreateFacilityModal = false"
+      />
 
       <!-- NOTE similar code for KDP Registration in SyncInterface -->
       <template v-if="Boolean(facilityForRegister)">
@@ -202,6 +214,7 @@
   import RemoveFacilityModal from './RemoveFacilityModal';
   import SyncAllFacilitiesModal from './SyncAllFacilitiesModal';
   import ImportFacilityModalGroup from './ImportFacilityModalGroup';
+  import CreateNewFacilityModal from './CreateNewFacilityModal';
   import facilityTaskQueue from './facilityTasksQueue';
 
   const Options = Object.freeze({
@@ -221,6 +234,7 @@
       DeviceAppBarPage,
       ConfirmationRegisterModal,
       CoreTable,
+      CreateNewFacilityModal,
       HeaderWithOptions,
       FacilityNameAndSyncStatus,
       ImportFacilityModalGroup,
@@ -235,6 +249,7 @@
       return {
         showSyncAllModal: false,
         showImportModal: false,
+        showCreateFacilityModal: false,
         facilities: [],
         facilityForSync: null,
         facilityForRemoval: null,
@@ -245,6 +260,18 @@
       };
     },
     computed: {
+      options() {
+        return [
+          {
+            label: 'Import facility',
+            value: 'import_facility',
+          },
+          {
+            label: 'Create new facility',
+            value: 'create_new_facility',
+          },
+        ];
+      },
       pageTitle() {
         return deviceString('deviceManagementTitle');
       },
@@ -344,6 +371,10 @@
         });
         this.showImportModal = false;
       },
+      handleCreateFacilitySuccess() {
+        this.showCreateFacilityModal = false;
+        this.fetchFacilites();
+      },
       manageSync(facilityId) {
         return {
           name: PageNames.MANAGE_SYNC_SCHEDULE,
@@ -389,6 +420,13 @@
             this.$emit('failure');
           });
       },
+      handleSelect(option) {
+        if (option.value == 'import_facility') {
+          this.showImportModal = true;
+        } else {
+          this.showCreateFacilityModal = true;
+        }
+      },
     },
     $trs: {
       syncAllAction: {
@@ -401,6 +439,10 @@
         context:
           "Notification that appears after a facility has been deleted. For example, \"Removed 'Zuk Village' from this device'.",
       },
+      createFacilityLabel: {
+        message: 'ADD FACILITY',
+        context: 'Label for a button used to create new facility.',
+      },
     },
   };