[PLAT-926] Add employment and institution information to user serializer

api/users/education-schema.json

@@ -0,0 +1,52 @@
+{
+	"type": "array",
+	"items": {
+		"type": "object",
+		"properties": {
+			"degree": {
+				"type": "string"
+			},
+			"startYear": {
+				"type": "integer",
+				"minimum": 1900
+			},
+			"startMonth": {
+				"type": "integer",
+				"minimum": 1,
+				"maximum": 12
+			},
+			"endMonth": {
+				"type": "integer",
+				"minimum": 1,
+				"maximum": 12
+			},
+			"endYear": {
+				"type": "integer",
+				"minimum": 1900
+			},
+			"ongoing": {
+				"type": "boolean"
+			},
+			"department": {
+				"type": "string"
+			},
+			"institution": {
+				"type": "string",
+				"minLength": 1
+			}
+		},
+		"required": [
+			"startYear",
+			"startMonth",
+			"ongoing",
+			"department",
+			"institution",
+			"degree"
+		],
+		"additionalProperties": false,
+		"dependencies": {
+			"endMonth": ["endYear"],
+			"endYear": ["endMonth"]
+		}
+	}
+}

api/users/employment-schema.json

@@ -0,0 +1,52 @@
+{
+	"type": "array",
+	"items": {
+		"type": "object",
+		"properties": {
+			"title": {
+				"type": "string"
+			},
+			"startYear": {
+				"type": "integer",
+				"minimum": 1900
+			},
+			"startMonth": {
+				"type": "integer",
+				"minimum": 1,
+				"maximum": 12
+			},
+			"endMonth": {
+				"type": "integer",
+				"minimum": 1,
+				"maximum": 12
+			},
+			"endYear": {
+				"type": "integer",
+				"minimum": 1900
+			},
+			"ongoing": {
+				"type": "boolean"
+			},
+			"department": {
+				"type": "string"
+			},
+			"institution": {
+				"type": "string",
+				"minLength": 1
+			}
+		},
+		"required": [
+			"startYear",
+			"startMonth",
+			"ongoing",
+			"department",
+			"institution",
+			"title"
+		],
+		"additionalProperties": false,
+		"dependencies": {
+			"endMonth": ["endYear"],
+			"endYear": ["endMonth"]
+		}
+	}
+}

api/users/schemas.py

@@ -0,0 +1,8 @@
+import os
+import json
+
+here = os.path.split(os.path.abspath(__file__))[0]
+
+def from_json(fname):
+    with open(os.path.join(here, fname)) as f:
+        return json.load(f)

api/users/serializers.py

@@ -1,3 +1,6 @@
+import datetime
+
+import jsonschema
 from guardian.models import GroupObjectPermission
 
 from django.utils import timezone
@@ -7,13 +10,14 @@
 from api.base.serializers import (
     BaseAPISerializer, JSONAPISerializer, JSONAPIRelationshipSerializer,
     VersionedDateTimeField, HideIfDisabled, IDField,
-    Link, LinksField, ListDictField, TypeField, RelationshipField,
-    WaterbutlerLink, ShowIfCurrentUser, DevOnly
+    Link, LinksField, ListDictField, TypeField, RelationshipField, JSONAPIListField,
+    WaterbutlerLink, ShowIfCurrentUser
 )
 from api.base.utils import absolute_reverse, get_user_auth, waterbutler_api_url_for
 from api.files.serializers import QuickFilesSerializer
 from osf.exceptions import ValidationValueError, ValidationError
 from osf.models import OSFUser, QuickFilesNode
+from api.users.schemas import from_json
 
 
 class QuickFilesRelationshipField(RelationshipField):
@@ -57,8 +61,10 @@ class UserSerializer(JSONAPISerializer):
     timezone = HideIfDisabled(ser.CharField(required=False, help_text="User's timezone, e.g. 'Etc/UTC"))
     locale = HideIfDisabled(ser.CharField(required=False, help_text="User's locale, e.g.  'en_US'"))
     social = ListDictField(required=False)
-    employment = DevOnly(ser.ListField(child=ser.DictField(), source='jobs', read_only=True))
-    education = DevOnly(ser.ListField(child=ser.DictField(), source='schools', read_only=True))
+    employment = JSONAPIListField(required=False, source='jobs')
+    employment_required_keys = {'department', 'institution', 'ongoing', 'startMonth', 'startYear', 'title'}
+    education = JSONAPIListField(required=False, source='schools')
+    education_required_keys = {'department', 'institution', 'ongoing', 'startMonth', 'startYear', 'degree'}
     can_view_reviews = ShowIfCurrentUser(ser.SerializerMethodField(help_text='Whether the current user has the `view_submissions` permission to ANY reviews provider.'))
     accepted_terms_of_service = ShowIfCurrentUser(ser.SerializerMethodField())
 
@@ -128,6 +134,44 @@ def profile_image_url(self, user):
         size = self.context['request'].query_params.get('profile_image_size')
         return user.profile_image_url(size=size)
 
+    def _update_social(self, social_dict, user):
+        for key, val in social_dict.items():
+            # currently only profileWebsites are a list, the rest of the social key only has one value
+            if key == 'profileWebsites':
+                user.social[key] = val
+            else:
+                if len(val) > 1:
+                    raise InvalidModelValueError(
+                        detail='{} only accept a list of one single value'.format(key)
+                    )
+                    user.social[key] = val[0]
+
+    def _validate_user_json(self, value, json_schema):
+        try:
+            jsonschema.validate(value, from_json(json_schema))
+        except jsonschema.ValidationError as e:
+            if len(e.path) > 1:
+                raise InvalidModelValueError("For '{}' the field value {}".format(e.path[-1], e.message))
+
+            raise InvalidModelValueError(e.message)
+        except jsonschema.SchemaError as e:
+            raise InvalidModelValueError(e.message)
+
+        self._validate_dates(value)
+
+    def _validate_dates(self, info):
+        for history in info:
+
+            startDate = datetime.date(history['startYear'], history['startMonth'], 1)
+
+            if not history['ongoing']:
+                endDate = datetime.date(history['endYear'], history['endMonth'], 1)
+
+                if (endDate - startDate).days <= 0:
+                    raise InvalidModelValueError(detail='End date must be greater than or equal to the start date.')
+            elif history.get('endYear') or history.get('endMonth'):
+                raise InvalidModelValueError(detail='Ongoing positions cannot have end dates.')
+
     def update(self, instance, validated_data):
         assert isinstance(instance, OSFUser), 'instance must be a User'
         for attr, value in validated_data.items():
@@ -142,6 +186,13 @@ def update(self, instance, validated_data):
                                 detail='{} only accept a list of one single value'. format(key)
                             )
                         instance.social[key] = val[0]
+            elif 'schools' == attr:
+                self._validate_user_json(value, 'education-schema.json')
+                instance.schools = value
+            elif 'jobs' == attr:
+                self._validate_user_json(value, 'employment-schema.json')
+                instance.jobs = value
+
             elif 'accepted_terms_of_service' == attr:
                 if value and not instance.accepted_terms_of_service:
                     instance.accepted_terms_of_service = timezone.now()