mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-08 20:42:43 +00:00
fix(i18n): give the Korean instruments their published source texts
The Korean questionnaire wording was translated freshly from English, so a score built from it was comparable to nothing in the literature. Each instrument now carries the text its own publisher put out, or no Korean at all. PHQ-9 and GAD-7 come verbatim from the instrument owner's distribution — Pfizer's `PHQ9_Korean for Korea.pdf` (2010-06-15) and `GAD7_Korean for Korea.pdf` (2010-05-18), the latter being the file Ahn/Kim/Choi 2019 names as what it validated. The sheets grant reproduction, translation, display and distribution without permission. Verbatim means verbatim: the spacing in "7 일 이상 방해 받았다" and the sheet's "안절부절 못하거나" against the GAD-7 sheet's "안절부절못해서" are reproduced as printed. WHO-5 has no official Korean arm. Neither the WHO's 2024 distribution (26 languages) nor the Psychiatric Research Unit folder it inherited from (31 languages) has ever carried one, and ePROVIDE lists the same 31. Korean therefore carries the published forward/back-translation from Kim HJ et al., J Korean Geriatr Psychiatry 2010;14(2):90-96, which is CC BY-NC and so redistributable; the attribution line names it. Its validation sample was community-dwelling elderly rather than general adults, which the definition says out loud. The Sleep Condition Indicator reverts to English. It is validated in English only, its cut-off was derived from those words, and no openly redistributable Korean exists — so `ko` now matches de/es/fr/it/pl: items, section stems and response anchors byte-identical to en.json, under the localized "validated in English" note. `ALL_APP_LOCALES` grows to seven, which is what stops the check-in wizard claiming English wording over Korean items on every Korean check-in. One gap is deliberate and not yet resolved. The official Korean PHQ-9 and GAD-7 sheets disagree on anchor 2 — "7 일 이상 방해 받았다" against "2 주 중 절반 이상 방해 받았다" — but both instruments read one shared `mentalHealth.options` set, which holds for the other six locales because their two sheets agree word for word. Korean takes the PHQ-9 wording for both here. GAD-7's anchors are therefore validated in substance but not verbatim; splitting them into a `gad7Options` namespace is the fix, and is left for the maintainer to weigh against the 24 duplicated keys it would add across the other locales. The functional-impairment item and its four anchors come from the same PHQ-9 sheet. They are not scored and not covered by the `validatedItemLocales` contract.
This commit is contained in:
3 files changed
+77
-70
No files matched your search
+65
-65
@@ -9039,17 +9039,17 @@
|
||||
"sci": "수면 점검, 8문항"
|
||||
},
|
||||
"options": {
|
||||
"0": "전혀 없음",
|
||||
"1": "며칠 동안",
|
||||
"2": "절반 이상",
|
||||
"3": "거의 매일"
|
||||
"0": "전혀 방해 받지 않았다",
|
||||
"1": "며칠 동안 방해 받았다",
|
||||
"2": "7 일 이상 방해 받았다",
|
||||
"3": "거의 매일 방해 받았다"
|
||||
},
|
||||
"functionalTitle": "위 문제 중 체크한 것이 있다면, 그 문제 때문에 일을 하거나 집안일을 돌보거나 다른 사람과 어울리는 것이 얼마나 어려웠나요?",
|
||||
"functionalTitle": "만일 당신이 위의 문제 중 하나 이상 \"예\" 라고 응답하셨으면, 이러한 문제들로 인해서 당신은 일을 하거나 가정일을 돌보거나 다른 사람과 어울리는 것이 얼마나 어려웠습니까?",
|
||||
"functional": {
|
||||
"0": "전혀 어렵지 않음",
|
||||
"1": "약간 어려움",
|
||||
"2": "매우 어려움",
|
||||
"3": "극도로 어려움"
|
||||
"0": "전혀 어렵지 않았다",
|
||||
"1": "약간 어려웠다",
|
||||
"2": "많이 어려웠다",
|
||||
"3": "매우 많이 어려웠다"
|
||||
},
|
||||
"functionalOptionalHint": "선택 사항이에요 — 이 문항에 답하지 않아도 제출할 수 있어요.",
|
||||
"result": {
|
||||
@@ -9099,41 +9099,41 @@
|
||||
},
|
||||
"items": {
|
||||
"phq9": {
|
||||
"1": "무슨 일을 하는 데 흥미나 즐거움이 거의 없음",
|
||||
"1": "일 또는 여가 활동을 하는 데 흥미나 즐거움을 느끼지 못함",
|
||||
"2": "기분이 가라앉거나, 우울하거나, 희망이 없음",
|
||||
"3": "잠들기 어렵거나 자주 깸, 또는 너무 많이 잠",
|
||||
"3": "잠이 들거나 계속 잠을 자는 것이 어려움, 또는 잠을 너무 많이 잠",
|
||||
"4": "피곤하다고 느끼거나 기운이 거의 없음",
|
||||
"5": "입맛이 없거나 과식을 함",
|
||||
"6": "자신을 나쁘게 여김 — 또는 자신이 실패자라고 느끼거나 자신이나 가족을 실망시켰다고 느낌",
|
||||
"7": "신문을 읽거나 텔레비전을 보는 것처럼 무언가에 집중하기 어려움",
|
||||
"8": "다른 사람이 알아차릴 정도로 느리게 움직이거나 말함. 또는 그 반대로, 너무 안절부절못하거나 들떠서 평소보다 훨씬 많이 돌아다님",
|
||||
"9": "차라리 죽는 것이 낫겠다는 생각, 또는 어떤 식으로든 자신을 해치려는 생각"
|
||||
"6": "자신을 부정적으로 봄 — 혹은 자신이 실패자라고 느끼거나 자신 또는 가족을 실망시킴",
|
||||
"7": "신문을 읽거나 텔레비전 보는 것과 같은 일에 집중하는 것이 어려움",
|
||||
"8": "다른 사람들이 주목할 정도로 너무 느리게 움직이거나 말을 함. 또는 반대로 평상시보다 많이 움직여서, 너무 안절부절 못하거나 들떠 있음",
|
||||
"9": "자신이 죽는 것이 더 낫다고 생각하거나 어떤 식으로든 자신을 해칠 것이라고 생각함"
|
||||
},
|
||||
"gad7": {
|
||||
"1": "초조하거나 불안하거나 조마조마하게 느낌",
|
||||
"2": "걱정을 멈추거나 조절할 수 없음",
|
||||
"3": "여러 가지 일에 대해 걱정을 너무 많이 함",
|
||||
"4": "편하게 쉬기 어려움",
|
||||
"5": "너무 안절부절못해서 가만히 앉아 있기 어려움",
|
||||
"6": "쉽게 짜증이 나거나 화가 남",
|
||||
"7": "무언가 끔찍한 일이 일어날 것 같아 두려움"
|
||||
"1": "초조하거나 불안하거나 조마조마하게 느낀다",
|
||||
"2": "걱정하는 것을 멈추거나 조절할 수가 없다",
|
||||
"3": "여러 가지 것들에 대해 걱정을 너무 많이 한다",
|
||||
"4": "편하게 있기가 어렵다",
|
||||
"5": "너무 안절부절못해서 가만히 있기가 힘들다",
|
||||
"6": "쉽게 짜증이 나거나 쉽게 성을 내게 된다",
|
||||
"7": "마치 끔찍한 일이 생길 것처럼 두렵게 느껴진다"
|
||||
},
|
||||
"who5": {
|
||||
"1": "밝고 기분이 좋았음",
|
||||
"2": "차분하고 편안했음",
|
||||
"3": "활동적이고 활기찼음",
|
||||
"4": "상쾌하고 푹 쉰 기분으로 잠에서 깼음",
|
||||
"5": "일상이 나에게 흥미로운 일들로 채워져 있었음"
|
||||
"1": "나는 즐겁고 기분이 좋다.",
|
||||
"2": "나는 평온하고 느긋하다.",
|
||||
"3": "나는 의욕적이고 활기차다.",
|
||||
"4": "나는 자고 일어나면 상쾌하고 푹 쉬었다는 느낌이 든다.",
|
||||
"5": "나의 일상생활은 흥미로운 일들로 가득하다."
|
||||
},
|
||||
"sci": {
|
||||
"1": "… 잠드는 데 얼마나 걸리나요?",
|
||||
"2": "… 그러다 밤중에 깬다면 … 모두 합쳐 얼마나 깨어 있나요? (깬 시간을 전부 더해서)",
|
||||
"3": "… 일주일에 며칠 밤이나 수면에 문제가 있나요?",
|
||||
"4": "… 수면의 질을 어떻게 평가하시겠어요?",
|
||||
"5": "… 기분, 활력, 인간관계에 영향을 주었나요?",
|
||||
"6": "… 집중력, 생산성, 깨어 있는 능력에 영향을 주었나요?",
|
||||
"7": "… 전반적으로 힘들게 했나요?",
|
||||
"8": "… 수면 문제가 얼마나 오래 이어졌나요?"
|
||||
"1": "… how long does it take you to fall asleep?",
|
||||
"2": "… if you then wake up during the night … how long are you awake for in total? (add all the wakenings up)",
|
||||
"3": "… how many nights a week do you have a problem with your sleep?",
|
||||
"4": "… how would you rate your sleep quality?",
|
||||
"5": "… affected your mood, energy, or relationships?",
|
||||
"6": "… affected your concentration, productivity, or ability to stay awake?",
|
||||
"7": "… troubled you in general?",
|
||||
"8": "… how long have you had a problem with your sleep?"
|
||||
}
|
||||
},
|
||||
"crisisResource": {
|
||||
@@ -9185,20 +9185,20 @@
|
||||
},
|
||||
"validatedInEnglishNote": "이 설문은 영어로 검증된 도구예요. 문항은 원문 영어 표현 그대로 보여줘요.",
|
||||
"who5Options": {
|
||||
"0": "전혀 없음",
|
||||
"1": "가끔",
|
||||
"2": "절반 이하",
|
||||
"3": "절반 이상",
|
||||
"4": "대부분",
|
||||
"5": "항상"
|
||||
"0": "전혀 그렇지 않다.",
|
||||
"1": "가끔 그렇다.",
|
||||
"2": "절반 미만이 그렇다.",
|
||||
"3": "절반 이상이 그렇다.",
|
||||
"4": "거의 그렇다.",
|
||||
"5": "항상 그렇다."
|
||||
},
|
||||
"sciOptions": {
|
||||
"duration": {
|
||||
"0": "61분 이상",
|
||||
"1": "46–60분",
|
||||
"2": "31–45분",
|
||||
"3": "16–30분",
|
||||
"4": "0–15분"
|
||||
"0": "≥ 61 min",
|
||||
"1": "46–60 min",
|
||||
"2": "31–45 min",
|
||||
"3": "16–30 min",
|
||||
"4": "0–15 min"
|
||||
},
|
||||
"nights": {
|
||||
"0": "5–7",
|
||||
@@ -9208,35 +9208,35 @@
|
||||
"4": "0–1"
|
||||
},
|
||||
"quality": {
|
||||
"0": "매우 나쁨",
|
||||
"1": "나쁨",
|
||||
"2": "보통",
|
||||
"3": "좋음",
|
||||
"4": "매우 좋음"
|
||||
"0": "Very poor",
|
||||
"1": "Poor",
|
||||
"2": "Average",
|
||||
"3": "Good",
|
||||
"4": "Very good"
|
||||
},
|
||||
"impact": {
|
||||
"0": "매우 많이",
|
||||
"1": "많이",
|
||||
"2": "어느 정도",
|
||||
"3": "조금",
|
||||
"4": "전혀 없음"
|
||||
"0": "Very much",
|
||||
"1": "Much",
|
||||
"2": "Somewhat",
|
||||
"3": "A little",
|
||||
"4": "Not at all"
|
||||
},
|
||||
"problemDuration": {
|
||||
"0": "1년 초과",
|
||||
"1": "7–12개월",
|
||||
"2": "3–6개월",
|
||||
"3": "1–2개월",
|
||||
"4": "문제 없음 / 1개월 미만"
|
||||
"0": "> 1 year",
|
||||
"1": "7–12 months",
|
||||
"2": "3–6 months",
|
||||
"3": "1–2 months",
|
||||
"4": "I don't have a problem / < 1 month"
|
||||
}
|
||||
},
|
||||
"stems": {
|
||||
"who5": {
|
||||
"period": "지난 2주 동안 …"
|
||||
"period": "지난 2주 동안"
|
||||
},
|
||||
"sci": {
|
||||
"night": "지난 한 달의 평범한 밤을 떠올려 보면 …",
|
||||
"impact": "지난 한 달을 떠올려 보면, 나쁜 수면이 어느 정도로 …",
|
||||
"finally": "마지막으로 …"
|
||||
"night": "Thinking about a typical night in the last month …",
|
||||
"impact": "Thinking about the past month, to what extent has poor sleep …",
|
||||
"finally": "Finally …"
|
||||
}
|
||||
},
|
||||
"openDetail": "자세히 보기",
|
||||
|
||||
@@ -196,7 +196,7 @@ describe("mental-health instruments", () => {
|
||||
});
|
||||
|
||||
it("declares validated item locales honestly (SCI = English only)", () => {
|
||||
for (const locale of ["de", "en", "es", "fr", "it", "pl"]) {
|
||||
for (const locale of ["de", "en", "es", "fr", "it", "pl", "ko"]) {
|
||||
expect(hasValidatedItems("WHO5", locale)).toBe(true);
|
||||
expect(hasValidatedItems("PHQ9", locale)).toBe(true);
|
||||
}
|
||||
|
||||
@@ -11,8 +11,9 @@
|
||||
* - PHQ-9: Kroenke 2001; GAD-7: Spitzer 2006 (public-domain Pfizer grant).
|
||||
* - WHO-5: WHO/UCN/MSD/MHE/2024.1 (© WHO 2024, CC BY-NC-SA 3.0 IGO) — raw
|
||||
* 0–25, × 4 → 0–100; "a percentage score below 50 … an indication for
|
||||
* further assessment". WHO publishes official translations for all six
|
||||
* app locales; they ship verbatim.
|
||||
* further assessment". Six app locales ship the WHO/PRU translations
|
||||
* verbatim; Korean, which neither distribution carries, ships the
|
||||
* published Kim 2010 translation instead.
|
||||
* - SCI: Espie et al., BMJ Open 2014;4:e004183 (© Sleepio Ltd, licensed
|
||||
* free for non-commercial use, CC BY-NC) — 8 items, 0–4 each, total 0–32,
|
||||
* HIGHER = better sleep; "a score of ≤16 … seems reasonable to detect
|
||||
@@ -98,7 +99,7 @@ export interface InstrumentDefinition {
|
||||
attribution: string;
|
||||
}
|
||||
|
||||
const ALL_APP_LOCALES = ["de", "en", "es", "fr", "it", "pl"] as const;
|
||||
const ALL_APP_LOCALES = ["de", "en", "es", "fr", "it", "pl", "ko"] as const;
|
||||
|
||||
/**
|
||||
* The PHQ family is public-domain (Pfizer 2010); this is the canonical footer
|
||||
@@ -188,11 +189,17 @@ const WHO5: InstrumentDefinition = {
|
||||
actionThreshold: 50,
|
||||
safetyItemIndex: null,
|
||||
// WHO publishes official de/en/es/fr/it/pl versions — all bundled verbatim.
|
||||
// There is no Korean one, so `ko` carries the published forward/back-
|
||||
// translation from Kim 2010 instead, which is CC BY-NC and so
|
||||
// redistributable. Its validation sample was community-dwelling elderly,
|
||||
// not general adults — narrower than the other six arms.
|
||||
validatedItemLocales: ALL_APP_LOCALES,
|
||||
attribution:
|
||||
"World Health Organization. The World Health Organization-Five Well-Being " +
|
||||
"Index (WHO-5). Geneva: World Health Organization; 2024. Licence: " +
|
||||
"CC BY-NC-SA 3.0 IGO. WHO does not endorse this application.",
|
||||
"CC BY-NC-SA 3.0 IGO. WHO does not endorse this application. Korean " +
|
||||
"translation: Kim HJ, Moon YS, Son BK, Lee SK, Rho HJ, Kim DH. J Korean " +
|
||||
"Geriatr Psychiatry 2010;14(2):90-96 (CC BY-NC 3.0).",
|
||||
};
|
||||
|
||||
/**
|
||||
|
||||
Reference in new issue
Block a user