davide.im

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Short name of the criterion, e.g. \"Price\", \"Commute to work\"."
    },
    "type": {
      "type": "string",
      "enum": [
        "boolean",
        "rating",
        "number",
        "ideal",
        "count",
        "percentage",
        "ordinal",
        "categorical",
        "tags",
        "date"
      ],
      "description": "boolean: present/absent. number: a quantity where higher or lower is better. count: how many things of a kind (e.g. pizzerias within 2 km). percentage: 0-100. ideal: a number with an optimal value (not too much, not too little). rating: subjective score on a 5 or 10 scale. ordinal: levels ordered from worst to best. categorical: one of several unordered options. tags: several features together. date: a date."
    },
    "description": {
      "type": "string",
      "description": "Useful context: how it is measured, from where, at what time… (optional)."
    },
    "unit": {
      "type": "string",
      "description": "Unit of measure for numeric types: \"€\", \"m²\", \"min\", \"km\"…"
    },
    "importance": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "description": "Declared initial importance 1-5 (3 if unclear). It will be refined by the \"would you rather\" game."
    },
    "missing": {
      "type": "string",
      "enum": [
        "penalize",
        "neutral",
        "ignore"
      ],
      "description": "What to do when an option has no value. Default neutral."
    },
    "direction": {
      "type": "string",
      "enum": [
        "higher",
        "lower",
        "earlier",
        "later"
      ],
      "description": "number/count/percentage: whether higher or lower is better. date: whether earlier or later is better."
    },
    "curve": {
      "type": "string",
      "enum": [
        "linear",
        "saturating",
        "threshold"
      ],
      "description": "number/count/percentage. linear: every unit counts the same. saturating: nothing more is gained beyond \"saturation\". threshold: only crossing \"threshold\" counts."
    },
    "range_min": {
      "type": "number",
      "description": "number/count/percentage: realistic minimum (for normalization)."
    },
    "range_max": {
      "type": "number",
      "description": "number/count/percentage: realistic maximum."
    },
    "saturation": {
      "type": "number",
      "description": "curve=saturating: value beyond which it no longer improves."
    },
    "threshold": {
      "type": "number",
      "description": "curve=threshold: threshold value."
    },
    "hard_min": {
      "type": "number",
      "description": "Hard constraint (number/count/percentage/ideal/rating): below this value the option is excluded. Only if the user says so explicitly."
    },
    "hard_max": {
      "type": "number",
      "description": "Hard constraint (number/count/percentage/ideal): above this value the option is excluded (e.g. maximum budget)."
    },
    "count_definition": {
      "type": "string",
      "description": "count: what is counted and by which rule."
    },
    "ideal": {
      "type": "number",
      "description": "ideal: the optimal value (required for type=ideal)."
    },
    "tolerance_below": {
      "type": "number",
      "description": "ideal: how far below the ideal it can go before it becomes terrible."
    },
    "tolerance_above": {
      "type": "number",
      "description": "ideal: how far above the ideal it can go before it becomes terrible."
    },
    "scale_max": {
      "type": "integer",
      "enum": [
        5,
        10
      ],
      "description": "rating: rating scale (default 10)."
    },
    "assessor": {
      "type": "string",
      "enum": [
        "me",
        "other",
        "external"
      ],
      "description": "rating: who gives the rating (me, another person, an external source)."
    },
    "preference": {
      "type": "string",
      "enum": [
        "positive",
        "negative",
        "neutral"
      ],
      "description": "boolean: whether having it is positive, negative or neutral."
    },
    "constraint": {
      "type": "string",
      "enum": [
        "none",
        "must_have",
        "must_not_have"
      ],
      "description": "boolean: must-have requirement (must_have) or exclusion (must_not_have)."
    },
    "choices": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ordinal: levels FROM WORST TO BEST (at least 2). categorical: the possible categories (at least 2). tags: the possible tags (at least 1)."
    },
    "equal_steps": {
      "type": "boolean",
      "description": "ordinal: are all steps between levels worth the same? (default true)"
    },
    "min_acceptable": {
      "type": "string",
      "description": "ordinal: lowest acceptable level (hard constraint), one of the choices."
    },
    "excluded": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "categorical: categories excluded up front (hard constraint)."
    },
    "required": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "tags: required tags (hard constraint)."
    },
    "tags_mode": {
      "type": "string",
      "enum": [
        "each",
        "count"
      ],
      "description": "tags: each tag counts on its own (each) or only how many there are counts (count)."
    },
    "deadline": {
      "type": "string",
      "description": "date: ISO yyyy-mm-dd deadline (hard constraint)."
    },
    "deadline_type": {
      "type": "string",
      "enum": [
        "not_after",
        "not_before"
      ],
      "description": "date: whether the deadline means \"not after\" or \"not before\"."
    }
  },
  "required": [
    "name",
    "type"
  ],
  "additionalProperties": false
}