-
Notifications
You must be signed in to change notification settings - Fork 110
Glossary: Ubiquitous language
This document strives to be the "master vocabulary" for unambiguously describing terminology used by both the Red Cross and the CBS Development team to describe the concepts and terms relevant to the implementation of CBS. Modeled on Eric Evans Domain Driven Design - see also Ubiquitous Language in Martin Fowlers bliki
Red Cross and Red Crescent (RCRC). Refers to a non-country specific National Society (NS, e.g. Norwegian Red Cross) or multiple National Societies.
- Rule: There is one National Society per country (Red Cross fundamental priniciple of "Unity", implying hard boundaries between NSs) and these National Societies are independent and equal to one another (Red Cross fundamental principle of "Universaility", implies we also ask permission before accessing information, starting programs, etc. within another country/NS).
- Reference: Mandawi Red Cross is a fictional Red Cross / Red Crescent National Society used for demo, teaching, testing purposes.
- Alternative terms: "National Society", "NS", "Red Cross", "Red Crescent", "RC"
The Red Cross references "project" whenever a new CBS operation is started. Projects are defined by the configuration of "Health Risk", geographic location, time duration, and people (care a lot about "Supervisors" and "Data Collectors").
- Current state (19 January 2019): There is no reference to "project" in other bounded context as there is only one project per country/NS.
- Alternative terms: CBS program, CBS deployment, emergency operation
Types of persons involved with the CBS tool...
| Role name | Alternative names | Name used in UI mock-up | Medium for engagement | Major needs |
|---|---|---|---|---|
| Data Collector | Volunteer | Basic feature phone via SMS |
|
|
| Supervisor | Data Validator | Email ("Alert" notifications), Smartphone (Smartphone-based forms for validation), and Laptops |
|
|
| Data Owner | Hassan | Laptop | ||
| Technical Advisor | Guddu | Laptop | ||
| Global Admin | Roxanne | Laptop |
|
|
| Data Consumer | Partners | Chris | Laptop |
|
Previous work regarding Roles: [Roles in CBS (June 2018)] (https://docs.google.com/presentation/d/12rm0TuggBGGgzkFeEib4Ib88LfYv6YEewhCiunWh2SY/edit?usp=sharing)
Describes the one or more diseases being reported by a Red Cross volunteer (also called "Data Collector"). There is also a catch-all Health Risk called "Unusual event", which allows Data Collectors to report things in addition to the pre-set list (e.g. the Mandawi Red Crescent is reporting "Acute Watery Diarrhea (AWD)", "Measles", and "Unusual Events" (odd/concerning events that are not AWD or Measles).
- Rule: Currently the Red Cross has 29 different Health Risks (CBS Health Risk - https://docs.google.com/spreadsheets/d/1bfbfaTr6jx3ia7tOEZxDMDk-qrWAfS9vCoH2N-TG9zM/edit#gid=1036114658).
- This list is determined (including additions and deletions) at the Global level (by "Global admin"). At the local level (e.g. Mandawi Red Cross Data Owner) s/he can select what Health Risk their volunteers ("Data Collectors") will report against. They can localized specific information related to a Health Risk (e.g. "Case definition", "Threshold (Number of Cases, Amount of Time, and/or geographic distance)", "Symptoms", and "Feedback messages"), but can not create new Health Risk.
A volunteer sends in a case report which contains a health event identifier, along with supplementary data. There are two different variants of a case report. Single Case Report reports on one individual case, while an Aggregate Case Report reports on a number of people with the same symptoms/situation.
Single Case Report will include: Health Risk (List), Sex (Male or Female), and Age (Under 5 or Over 5)
[Number] # [Number] # [Number] (two hash - single event #44 )
| Health Risk | Sex | age |
|---|---|---|
| 3 | 1 | 1 |
| 4 | 1 | 2 |
| 5 | 2 | 1 |
| 6 | 2 | 2 |
Health Risk is defined by Health Risk UID in Health Risk database #33 Sex is defined as Male =1, Female =2 Age is defined as <5 =1, >5=2
Aggregated Case Report is an expanded Single Case Report that includes Health Risk and intersection of Sex (Male and Female) and Age (Under 5 and Over 5).
An Aggregate Case Report will include the number of individuals along with gender and age bracket(?). Age can be an approximation. Currently the most important age distinction is <5 years vs >5 years. The list of attributes may expand in the future (case in point - Zika might make it relevant to provide information on pregnancy).
[Number] # [Number] # [Number] # [Number] # [Number] (four hash - aggregate event #46)
| Event | Male<5 | Male>5 | Female<5 | Female>5 |
|---|---|---|---|---|
| 3 | 1 | 0 | 0 | 0 |
| 4 | 0 | 1 | 0 | 0 |
| 5 | 0 | 0 | 1 | 0 |
| 6 | 0 | 0 | 0 | 1 |