HumanResources-schema.json

{
  "$id": "https://raw.githubusercontent.com/smart-data-models/dataModel.HumanResources/master/HumanResources-schema.json",
  "title": "Human Resources Commons schema",
  "description": "Common definitions to describe HumanResources data models",
  "definitions": {
    "HumanResources-Commons": {
      "type": "object",
      "properties": {
        "competence": {
          "type": "object",
          "description": "Any competence used to complete professional tasks (tools proficiency as 'Excel', technologies mastered as 'JAVA', practices learned as 'TDD', hardware you know how to handle as vehicles or construction tools, and know-how domains as 'banking' or 'russia')",
          "properties": {
            "name": {
              "type": "string",
              "description": "Property. Name of the competence"
            },
            "type": {
              "type": "string",
              "description": "Property. type of the competence",
              "enum": [
                "domain",
                "hardware",
                "practice",
                "technology",
                "tool"
              ]
            },
            "description": {
              "type": "string",
              "description": "Property. Description of the competence"
            }
          }
        },
        "contactMean": {
          "type": "object",
          "description": "Property. A way to contact a specific person",
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "publicProfiles": {
                  "type": "array",
                  "description": "Property. Online services that provide a way to contact a person without exposing mail or phone number.",
                  "items": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string",
                        "description": "Property. Public profiles in social networks or equivalent resources",
                        "enum": [
                          "github",
                          "linkedin",
                          "manfred",
                          "other",
                          "stackoverflow",
                          "twitter",
                          "xing",
                          "website"
                        ]
                      },
                      "URL": {
                        "type": "string",
                        "format": "uri",
                        "description": "Property. Link to the candidate's profiles"
                      }
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "properties": {
                "phoneNumbers": {
                  "type": "array",
                  "description": "Property. Phone numbers to contact the candidate",
                  "items": {
                    "type": "object",
                    "properties": {
                      "countryCode": {
                        "type": "number",
                        "description": "Property. Country calling code as defined in International Telecommunication Union (ITU) standards E.123 and E.164."
                      },
                      "number": {
                        "type": "string",
                        "description": "Property. Phone number without the country prefix"
                      }
                    }
                  }
                }
              }
            },
            {
              "type": "object",
              "properties": {
                "contactMails": {
                  "description": "Property. Contact emails of the candidate",
                  "type": "array",
                  "items": {
                    "type": "string",
                    "format": "email",
                    "description": "Property. Every contact email of the candidate"
                  }
                }
              }
            }
          ]
        },
        "image": {
          "type": "object",
          "description": "Property. Link adn alternative description to the file wth the picture, thumbnail or avatar",
          "properties": {
            "alt": {
              "type": "string",
              "description": "Alternative description of the image"
            },
            "link": {
              "type": "string",
              "format": "uri",
              "description": "Property. Link to the stored image "
            },
            "data": {
              "type": "string",
              "description": "Property. The raw data of the image"
            },
            "mediaType": {
              "type": "string",
              "description": "Property. the media type of the image",
              "enum": [
                "image/png",
                "image/jpeg"
              ]
            },
            "encoding": {
              "type": "string",
              "description": "Property. The constant value base64 for encoding the images",
              "enum": [
                "base64"
              ]
            }
          }
        },
        "person": {
          "type": "object",
          "description": "A Person data",
          "properties": {
            "name": {
              "type": "string",
              "description": "Property. Name of the candidate"
            },
            "surnames": {
              "type": "string",
              "description": "Surname o Surnames of the person"
            },
            "title": {
              "type": "string",
              "description": "Role, relationship or activity related to the person."
            },
            "description": {
              "type": "string",
              "description": "Property. Brief bio of the candidate"
            },
            "birthday": {
              "type": "string",
              "description": "Person's birth date",
              "format": "date"
            },
            "avatar": {
              "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.HumanResources/master/HumanResources-schema.json#/definitions/HumanResources-Commons/properties/image"
            },
            "contact": {
              "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.HumanResources/master/HumanResources-schema.json#/definitions/HumanResources-Commons/properties/contactMean"
            },
            "location": {
              "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/Location-Commons/properties/location"
            }
          }
        },
        "role": {
          "type": "object",
          "description": "Property. Roles developed within an organization",
          "properties": {
            "name": {
              "type": "string",
              "description": "Property. Name of the role"
            },
            "startDate": {
              "type": "string",
              "format": "date",
              "description": "Property. Start date of the role"
            },
            "finishDate": {
              "type": "string",
              "format": "date",
              "description": "Property. End date of the role"
            },
            "challenges": {
              "type": "array",
              "description": "Property. List of challenges faced while assuming the role",
              "items": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string",
                    "description": "Property. Every challenge faced while assuming the role"
                  },
                  "actions": {
                    "type": "array",
                    "description": "Property. Actions taken to solve the challenges while playing this role",
                    "items": {
                      "type": "string",
                      "description": "Property. Every action taken to solve the challenges while playing this role"
                    }
                  }
                }
              }
            },
            "competences": {
              "type": "array",
              "items": {
                "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.HumanResources/master/HumanResources-schema.json#/definitions/HumanResources-Commons/properties/competence"
              }
            },
            "referrals": {
              "type": "array",
              "items": {
                "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.HumanResources/master/HumanResources-schema.json#/definitions/HumanResources-Commons/properties/person"
              }
            },
            "notes": {
              "type": "string",
              "description": "Notes and information about the role"
            }
          }
        },
        "publicEntityDetails": {
          "type": "object",
          "description": "Property. Organization, Company, Institution, Administration, Project or Initiative related to my career.",
          "properties": {
            "name": {
              "type": "string",
              "description": "Property. Name of the Organization, Company, Institution, Administration, Project or Initiative related to my career"
            },
            "description": {
              "type": "string",
              "description": "Property. Description of the Organization, Company, Institution, Administration, Project or Initiative related to my career"
            },
            "URL": {
              "type": "string",
              "format": "uri",
              "description": "Property. Link to the site of the Organization, Company, Institution, Administration, Project or Initiative related to my career"
            },
            "image": {
              "$ref": "https://raw.githubusercontent.com/smart-data-models/dataModel.HumanResources/master/HumanResources-schema.json#/definitions/HumanResources-Commons/properties/image"
            },
            "location": {
              "$ref": "https://smart-data-models.github.io/data-models/common-schema.json#/definitions/Location-Commons/properties/location"
            }
          }
        },
        "organizationType": {
          "type": "string",
          "description": "Property. Types of Organization",
          "enum": [
            "academicalInstitution",
            "bigCorp",
            "freelance",
            "NGO",
            "other",
            "publicAdministration",
            "SME",
            "startup"
          ]
        },
        "projectType": {
          "type": "string",
          "description": "Property. Types of Projects",
          "enum": [
            "openSource",
            "other",
            "personalAchievement",
            "proBono",
            "sideProject"
          ]
        },
        "publicArtifactType": {
          "type": "string",
          "description": "Property. Types of Public Artifacts",
          "enum": [
            "achievement",
            "launch",
            "post",
            "sideProject",
            "talk",
            "video"
          ]
        },
        "contractType": {
          "type": "string",
          "description": "Property. Types of Contracts",
          "enum": [
            "freelance",
            "internship",
            "permanent",
            "temporary"
          ]
        },
        "recommendationType": {
          "type": "string",
          "description": "Property. Types of Recommendations",
          "enum": [
            "other",
            "podcast",
            "reading",
            "video",
            "web"
          ]
        },
        "tags": {
          "type": "array",
          "description": "Property. A list of tags with values to provide the candidates a way to segment and categorize elements in their CV.",
          "items": {
            "type": "string",
            "description": "Property. Every tag description "
          }
        },
        "studyType": {
          "type": "string",
          "description": "Types of studies: 'officialDegree' is a degree accredited by the government (University Degree) or an external, recognized and independent agency (some MBAs). 'certification' is a degree accredited by a private institution (eg. Oracle Database Admin Certification or Project Management Institute PMP). 'unaccredited' is a course without any accreditation (eg. Coursera or Platzi courses), but this doesn't mean that is not valid, legit, or has poor quality. 'selfTraining' is the study designed, managed and evaluated just by the own learner.",
          "enum": [
            "certification",
            "officialDegree",
            "selfTraining",
            "unaccredited"
          ]
        }
      }
    }
  }
}