{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://smellbook.com/data/heritage-record-schema.json","title":"SmellBook olfactory heritage record (draft)","description":"Describes a smell connected to a heritage object, place, practice or document, with its evidence class, sources and rights. Draft for discussion; not yet adopted by any institution.","type":"object","required":["recordId","title","smellDescription","evidenceClass","rights","recordedBy","recordedOn","status"],"additionalProperties":false,"properties":{"recordId":{"type":"string","minLength":1,"description":"Identifier assigned by the recording institution or researcher."},"title":{"type":"string","minLength":3},"smellDescription":{"type":"string","minLength":20,"description":"What the smell is like, in plain language."},"smellbookEntities":{"type":"array","items":{"type":"string","pattern":"^smellbook:[a-z][a-z-]*:[a-z0-9][a-z0-9-]*$"},"description":"Related SmellBook entities by permanent identifier (smells, descriptors, places, materials)."},"descriptors":{"type":"array","items":{"type":"string","pattern":"^smellbook:descriptor:[a-z0-9][a-z0-9-]*$"}},"place":{"type":"object","additionalProperties":false,"properties":{"entity":{"anyOf":[{"type":"string","pattern":"^smellbook:place:[a-z0-9][a-z0-9-]*$"},{"type":"string","pattern":"^smellbook:locality:[a-z0-9][a-z0-9-]*$"}],"description":"A kind of place (smellbook:place:…) or a named locality (smellbook:locality:…)."},"name":{"type":"string"},"locality":{"type":"string"},"country":{"type":"string","pattern":"^[A-Z]{2}$"}}},"period":{"type":"object","additionalProperties":false,"properties":{"label":{"type":"string"},"from":{"type":"string","pattern":"^-?[0-9]{1,4}(-[0-9]{2}){0,2}$"},"to":{"type":"string","pattern":"^-?[0-9]{1,4}(-[0-9]{2}){0,2}$"}}},"tradition":{"type":"string","pattern":"^smellbook:tradition:[a-z0-9][a-z0-9-]*$","description":"The tradition the smell belongs to, by permanent identifier."},"heritageObject":{"type":"object","additionalProperties":false,"properties":{"holdingInstitution":{"type":"string"},"objectReference":{"type":"string"},"url":{"type":"string","format":"uri"}}},"evidenceClass":{"enum":["scientific","historical","cultural","editorial","community","predicted"]},"sources":{"type":"array","items":{"type":"object","required":["citation"],"additionalProperties":false,"properties":{"citation":{"type":"string","minLength":10},"doi":{"type":"string"},"url":{"type":"string","format":"uri"}}}},"names":{"type":"array","items":{"type":"object","required":["lang","name"],"additionalProperties":false,"properties":{"lang":{"type":"string","pattern":"^[a-z]{2,3}(-[A-Z]{2})?$"},"name":{"type":"string"}}}},"rights":{"type":"object","required":["metadataRightsClass"],"additionalProperties":false,"properties":{"metadataRightsClass":{"enum":["smellbook-editorial","factual-structured","attribution-required","third-party-restricted","public-domain"]},"contentLicence":{"type":"string"}}},"recordedBy":{"type":"string","minLength":2},"recordedOn":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}$"},"status":{"enum":["draft","reviewed","published"]},"illustrative":{"type":"boolean","description":"True only for documentation examples that describe no real holding."}}}