I would like to propose the addition of vocabulary related to addiction and the treatment of addiction. The accompanying diagram shows the proposed additions in red along with their relations to existing vocabulary in the core and the health-lifesci extension.

AddictionTreatmentCenter
The first class to be added is AddictionTreatmentCenter, which is a subclass of MedicalOrganization and MedicalBusiness. It is at the same level as other MedicalOrganization subtypes such as Physician, MedicalClinic, and Hospital. The properties are:
- onsiteDetox, which takes a Boolean value. This indicates whether the center has its own detox facilities on site or makes use of those at another entity such as a hospital.
- typesOfPrograms, which takes a Text value. Standard values would include inpatient, outpatient, and residential. I suggest Text as a type instead of enumerations for flexibility.
- availableService, which takes a MedicalTherapy as its type. This property is currently used on Hospital, MedicalClinic, and Physician. It may make sense to make availableService a property of the parent class MedicalBusiness because it is used on so many of the subtypes. On the other hand, makesOffer is already a property that AddictionTreatmentCenter would inherit. The Offer could indicate the service that is available, so availableService may not be necessary.
AddictionDisorder
The second proposed class is AddictionDisorder, which is a subclass of MedicalCondition. AddictionDisorder could be used as a value for healthCondition on the Patient class. The term AddictionDisorder corresponds to the language of DSM-V, and covers both substance and behavioral/process addictions. The properties are:
- addictedTo, which would take a Drug or Text as its type. This indicates the drug(s) or process(es) to which the patient is addicted and would be parallel to the language “drug of choice” that is used in addiction treatment.
- addictionType, which would take Text as its type. This would be used to indicate whether an addiction was a substance addiction or a behavioral addiction (e.g., sex, gambling, eating disorders).
MedicalSpecialty Enumerations
I also propose two enumerations be added to MedicalSpecialty. These are AddictionMedicine and AddictionPsychiatry, which are the two specialties recognized by the American Board of Medical Specialties. This has been discussed in issue #1334, and Leeza Rodriguez suggested using these two enumerations. AddictionTreatmentCenter would use these enumerations for the property medicalSpecialty it inherits from MedicalOrganization. This would allow them to indicate whether they provided medical or psychological treatment for addiction (or both).
Issues of Accreditation
Leeza also raised valid concerns about addiction treatment centers marketing themselves without having any parent boards that regulated them (akin to problems in the past with pain management providers). I considered proposing a property of accreditedBy for AddictionTreatmentCenter to allow organizations to list credentials. CARF International and The Joint Commission are the two main accrediting bodies for addiction treatment. MedicalEntity has a property of recognizingAuthority that is described as “the organization that officially recognizes this entity as part of its endorsed system of medicine.” I’m not sure whether this would correspond to an accrediting agency and therefore could be used as a property on AddictionTreatmentCenter or whether accreditedBy would be a better property. Either way, I would propose that it take MedicalOrganization as its type.
Coding
I have written the RDFa definitions for the proposed items, along with JSON-LD and RDFa markup examples. Unfortunately, I am having trouble getting the schema.org app to work (see issue #1384), so I am currently unable to put these up for comment. I will make these available as soon as I can.
I would like to propose the addition of vocabulary related to addiction and the treatment of addiction. The accompanying diagram shows the proposed additions in red along with their relations to existing vocabulary in the core and the health-lifesci extension.
AddictionTreatmentCenter
The first class to be added is AddictionTreatmentCenter, which is a subclass of MedicalOrganization and MedicalBusiness. It is at the same level as other MedicalOrganization subtypes such as Physician, MedicalClinic, and Hospital. The properties are:
AddictionDisorder
The second proposed class is AddictionDisorder, which is a subclass of MedicalCondition. AddictionDisorder could be used as a value for healthCondition on the Patient class. The term AddictionDisorder corresponds to the language of DSM-V, and covers both substance and behavioral/process addictions. The properties are:
MedicalSpecialty Enumerations
I also propose two enumerations be added to MedicalSpecialty. These are AddictionMedicine and AddictionPsychiatry, which are the two specialties recognized by the American Board of Medical Specialties. This has been discussed in issue #1334, and Leeza Rodriguez suggested using these two enumerations. AddictionTreatmentCenter would use these enumerations for the property medicalSpecialty it inherits from MedicalOrganization. This would allow them to indicate whether they provided medical or psychological treatment for addiction (or both).
Issues of Accreditation
Leeza also raised valid concerns about addiction treatment centers marketing themselves without having any parent boards that regulated them (akin to problems in the past with pain management providers). I considered proposing a property of accreditedBy for AddictionTreatmentCenter to allow organizations to list credentials. CARF International and The Joint Commission are the two main accrediting bodies for addiction treatment. MedicalEntity has a property of recognizingAuthority that is described as “the organization that officially recognizes this entity as part of its endorsed system of medicine.” I’m not sure whether this would correspond to an accrediting agency and therefore could be used as a property on AddictionTreatmentCenter or whether accreditedBy would be a better property. Either way, I would propose that it take MedicalOrganization as its type.
Coding
I have written the RDFa definitions for the proposed items, along with JSON-LD and RDFa markup examples. Unfortunately, I am having trouble getting the schema.org app to work (see issue #1384), so I am currently unable to put these up for comment. I will make these available as soon as I can.