@baravak/risloo-profile-cli 4.83.0 → 4.85.0

package/src/publish/json/profiles/PSQI93.json

@@ -0,0 +1,365 @@
+{
+  "id": "$X1HXXXXX",
+  "scale": {
+    "id": "$PSQI-93",
+    "title": "شاخص کیفیت خواب پیتزبورگ"
+  },
+  "chain": null,
+  "version": "1",
+  "edition": "فرهی مقدم",
+  "edition_version": null,
+  "client": {
+    "id": "GH966XXXX",
+    "name": "مراجع"
+  },
+  "room": {
+    "id": "RS96XXXX",
+    "manager": {
+      "id": "GH9XXXXX",
+      "name": "درمانگر",
+      "user_id": "IR9XXXX"
+    },
+    "center": {
+      "id": "RS966XXXX",
+      "acceptation": null,
+      "status": "active",
+      "type": "personal_clinic",
+      "detail": {
+        "title": "درمانگر"
+      }
+    },
+    "acceptation": null,
+    "status": "active",
+    "type": "personal_clinic"
+  },
+  "case": null,
+  "code": null,
+  "created_at": 1694157079,
+  "started_at": 1694157198,
+  "scored_at": 1694242467,
+  "closed_at": 1694160574,
+  "total_amount": 100000,
+  "prepayment": true,
+  "purchased": true,
+  "amount": 100000,
+  "description": "سؤالات زیر مربوط به عادات معمول خواب شما **فقط** در ماه گذشته می‌باشد. جواب‌های شما باید مشخص‌کننده صحیح‌ترین پاسخ در **اکثر** ایام ماه گذشته باشد، لطفاً به تمام سؤالات پاسخ دهید.",
+  "items": [
+    {
+      "type": "text",
+      "text": "در طی ماه گذشته معمولاً شب‌ها ساعت چند به رختخواب می‌رفتید؟ (ساعت را به صورت عددی بین ۰ تا ۲۳ بنویسید)",
+      "description": "ساعت رفتن به رختخواب",
+      "answer": {
+        "type": "number"
+      },
+      "user_answered": "23"
+    },
+    {
+      "type": "text",
+      "text": "در طی ماه گذشته معمولاً هر شب چقدر طول می‌کشید تا به خواب بروید (به دقیقه)؟",
+      "description": "تعداد دقایق",
+      "answer": {
+        "type": "number"
+      },
+      "user_answered": "40"
+    },
+    {
+      "type": "text",
+      "text": "در طی ماه گذشته معمولاً صبح‌ها چه ساعتی از رختخواب بلند شده‌اید؟ (ساعت را به صورت عددی بین ۰ تا ۲۳ بنویسید)",
+      "description": "ساعت بلند شدن",
+      "answer": {
+        "type": "number"
+      },
+      "user_answered": "7"
+    },
+    {
+      "type": "text",
+      "text": "در طی ماه گذشته هر شب عملاً چند ساعت خوابیده‌اید؟ (ممکن است با تعداد ساعت‌هایی که در رختخواب گذرانده‌اید متفاوت باشد)",
+      "description": "تعداد ساعات خواب در هر شب — به ساعت؛ کسر ساعت را اعشاری وارد کنید، مثلاً 6.5 برای شش ساعت و نیم",
+      "answer": {
+        "type": "number"
+      },
+      "user_answered": "5.5"
+    },
+    {
+      "type": "text",
+      "text": "به خواب نرفتن در عرض 30 دقیقه",
+      "category": "برای سؤالات باقی‌مانده بهترین پاسخ را علامت بزنید. لطفاً به تمام سؤالات پاسخ دهید.\n\nدر طی ماه گذشته چند بار به دلایل زیر در خوابیدن مشکل داشته‌اید (تعداد دفعات را مشخص بفرمایید):",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "3"
+    },
+    {
+      "type": "text",
+      "text": "بیدار شدن در نیمه‌شب یا صبح زود",
+      "category": "برای سؤالات باقی‌مانده بهترین پاسخ را علامت بزنید. لطفاً به تمام سؤالات پاسخ دهید.\n\nدر طی ماه گذشته چند بار به دلایل زیر در خوابیدن مشکل داشته‌اید (تعداد دفعات را مشخص بفرمایید):",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "4"
+    },
+    {
+      "type": "text",
+      "text": "بلند شدن از رختخواب برای رفتن به دستشویی",
+      "category": "برای سؤالات باقی‌مانده بهترین پاسخ را علامت بزنید. لطفاً به تمام سؤالات پاسخ دهید.\n\nدر طی ماه گذشته چند بار به دلایل زیر در خوابیدن مشکل داشته‌اید (تعداد دفعات را مشخص بفرمایید):",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "2"
+    },
+    {
+      "type": "text",
+      "text": "مشکل در نفس کشیدن",
+      "category": "برای سؤالات باقی‌مانده بهترین پاسخ را علامت بزنید. لطفاً به تمام سؤالات پاسخ دهید.\n\nدر طی ماه گذشته چند بار به دلایل زیر در خوابیدن مشکل داشته‌اید (تعداد دفعات را مشخص بفرمایید):",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "1"
+    },
+    {
+      "type": "text",
+      "text": "سرفه و خروپف با صدای بلند",
+      "category": "برای سؤالات باقی‌مانده بهترین پاسخ را علامت بزنید. لطفاً به تمام سؤالات پاسخ دهید.\n\nدر طی ماه گذشته چند بار به دلایل زیر در خوابیدن مشکل داشته‌اید (تعداد دفعات را مشخص بفرمایید):",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "1"
+    },
+    {
+      "type": "text",
+      "text": "احساس سرمای شدید",
+      "category": "برای سؤالات باقی‌مانده بهترین پاسخ را علامت بزنید. لطفاً به تمام سؤالات پاسخ دهید.\n\nدر طی ماه گذشته چند بار به دلایل زیر در خوابیدن مشکل داشته‌اید (تعداد دفعات را مشخص بفرمایید):",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "1"
+    },
+    {
+      "type": "text",
+      "text": "احساس گرمای شدید",
+      "category": "برای سؤالات باقی‌مانده بهترین پاسخ را علامت بزنید. لطفاً به تمام سؤالات پاسخ دهید.\n\nدر طی ماه گذشته چند بار به دلایل زیر در خوابیدن مشکل داشته‌اید (تعداد دفعات را مشخص بفرمایید):",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "1"
+    },
+    {
+      "type": "text",
+      "text": "خواب بد دیدن",
+      "category": "برای سؤالات باقی‌مانده بهترین پاسخ را علامت بزنید. لطفاً به تمام سؤالات پاسخ دهید.\n\nدر طی ماه گذشته چند بار به دلایل زیر در خوابیدن مشکل داشته‌اید (تعداد دفعات را مشخص بفرمایید):",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "2"
+    },
+    {
+      "type": "text",
+      "text": "درد داشتن",
+      "category": "برای سؤالات باقی‌مانده بهترین پاسخ را علامت بزنید. لطفاً به تمام سؤالات پاسخ دهید.\n\nدر طی ماه گذشته چند بار به دلایل زیر در خوابیدن مشکل داشته‌اید (تعداد دفعات را مشخص بفرمایید):",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "3"
+    },
+    {
+      "type": "text",
+      "text": "اگر موارد دیگری وجود داشته است، لطفاً توضیح دهید (تعداد دفعات آن را نیز مشخص بفرمایید):",
+      "category": "برای سؤالات باقی‌مانده بهترین پاسخ را علامت بزنید. لطفاً به تمام سؤالات پاسخ دهید.\n\nدر طی ماه گذشته چند بار به دلایل زیر در خوابیدن مشکل داشته‌اید (تعداد دفعات را مشخص بفرمایید):",
+      "answer": {
+        "type": "optional",
+        "description": {
+          "text": "موارد دیگر را اینجا توضیح دهید"
+        },
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "2",
+      "user_description": "پای بی‌قرار"
+    },
+    {
+      "type": "text",
+      "text": "به‌طور کلی کیفیت خواب خود را در طی ماه گذشته چگونه ارزیابی می‌کنید؟",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "خیلی خوب",
+          "نسبتاً خوب",
+          "نسبتاً بد",
+          "خیلی بد"
+        ]
+      },
+      "user_answered": "3"
+    },
+    {
+      "type": "text",
+      "text": "در طی ماه گذشته چند بار جهت خواب رفتن از دارو استفاده کرده‌اید؟ (چه با تجویز پزشک و چه بدون نسخه)",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "1"
+    },
+    {
+      "type": "text",
+      "text": "در طی ماه گذشته چند بار جهت بیدار ماندن حین رانندگی، غذا خوردن یا شرکت در فعالیت اجتماعی دچار مشکل شده‌اید؟",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مورد در طی ماه گذشته",
+          "کمتر از یک مورد در هفته",
+          "یک یا دو بار در هفته",
+          "سه بار یا بیشتر در هفته"
+        ]
+      },
+      "user_answered": "2"
+    },
+    {
+      "type": "text",
+      "text": "در طی ماه گذشته برای اینکه اشتیاق کافی جهت انجام دادن کار را در خود حفظ کنید، چقدر مشکل داشته‌اید؟",
+      "answer": {
+        "type": "optional",
+        "options": [
+          "هیچ مشکلی نداشتم",
+          "خیلی کم مشکل داشتم",
+          "تا حدی مشکل داشتم",
+          "مشکل زیادی داشتم"
+        ]
+      },
+      "user_answered": "3"
+    }
+  ],
+  "prerequisites": [
+    {
+      "type": "text",
+      "label": "gender",
+      "text": "جنسیت",
+      "answer": {
+        "type": "select",
+        "options": [
+          "زن",
+          "مرد"
+        ]
+      },
+      "alias": "gender",
+      "force": true,
+      "user_answered": "1"
+    },
+    {
+      "type": "text",
+      "label": "age",
+      "text": "سن",
+      "answer": {
+        "type": "number"
+      },
+      "alias": "age",
+      "force": true,
+      "user_answered": "35"
+    },
+    {
+      "type": "text",
+      "label": "education",
+      "text": "تحصیلات",
+      "answer": {
+        "type": "select",
+        "options": [
+          "ابتدایی اول",
+          "ابتدایی دوم",
+          "متوسطه اول",
+          "متوسطه دوم",
+          "دیپلم",
+          "کارشناسی",
+          "کارشناسی ارشد",
+          "پزشکی عمومی",
+          "متخصص",
+          "دکتری تخصصی",
+          "حوزوی مقدمات",
+          "حوزوی سطح۱",
+          "حوزوی سطح۲",
+          "حوزوی سطح۳",
+          "حوزوی سطح۴"
+        ]
+      },
+      "alias": "education",
+      "force": true,
+      "user_answered": "6"
+    }
+  ],
+  "cornometer": 743,
+  "score": {
+    "status": "valid",
+    "subjective_quality": 2,
+    "latency": 2,
+    "duration": 2,
+    "efficiency": 2,
+    "disturbances": 1,
+    "medication": 0,
+    "daytime_dysfunction": 2,
+    "total": 11,
+    "screening": "positive"
+  },
+  "score_current_version": "1.0.0",
+  "score_last_version": "1.0.0"
+}

package/src/samples/JSS93.js

@@ -0,0 +1,132 @@
+const { Profile } = require("../Profile");
+
+// ---------------------------------------------------------------------------
+// Chart geometry, measured from the Figma "Chart" layer (789 × 414). Only the
+// values the controller has to compute with live here; the static geometry is
+// transcribed in the template.
+// ---------------------------------------------------------------------------
+const ROW = { top: 54, pitch: 40 }; // first bar row, row-to-row pitch
+const BAR = { x: 174, coefficient: 4, gap: 4 }; // 100 % = 400 px (designer note); label 4 px inside the tip
+const BASELINE = 12.06; // 13 px text baseline, measured from the row top
+
+// Total column: vertical bar filling bottom → up, 100 % = 350 px (designer note).
+const TOTAL = { bottom: 396, coefficient: 3.5 };
+
+class JSS93 extends Profile {
+  static pages = 1;
+
+  // JSS93 — پرسشنامه رضایت شغلی اسپکتور. Nine 4-item factors (raw 4–20) plus the
+  // total (raw 36–180). `percentage` is the share of the possible maximum, the
+  // definition the design uses (scoring/JSS93.py → round(raw / max, 3)); it drives
+  // both the bar length and the "٪ NN" readout so the two can never disagree.
+  labels = {
+    L1_1: { eng: "pay_raw", title: "رضایت از پرداخت‌ها", max: 20 },
+    L1_2: { eng: "pay_percentage" },
+
+    L2_1: { eng: "operating_procedures_raw", title: "فرآیندهای اجرایی کار (شرایط کار)", max: 20 },
+    L2_2: { eng: "operating_procedures_percentage" },
+
+    L3_1: { eng: "coworkers_raw", title: "همکاران", max: 20 },
+    L3_2: { eng: "coworkers_percentage" },
+
+    L4_1: { eng: "promotion_raw", title: "ارتقای شغلی", max: 20 },
+    L4_2: { eng: "promotion_percentage" },
+
+    L5_1: { eng: "supervision_raw", title: "نظارت", max: 20 },
+    L5_2: { eng: "supervision_percentage" },
+
+    L6_1: { eng: "fringe_benefits_raw", title: "مزایای جانبی شغل", max: 20 },
+    L6_2: { eng: "fringe_benefits_percentage" },
+
+    L7_1: { eng: "contingent_rewards_raw", title: "پاداش‌های احتمالی", max: 20 },
+    L7_2: { eng: "contingent_rewards_percentage" },
+
+    L8_1: { eng: "nature_of_work_raw", title: "ماهیت شغل", max: 20 },
+    L8_2: { eng: "nature_of_work_percentage" },
+
+    L9_1: { eng: "communication_raw", title: "ارتباطات و اطلاع‌رسانی", max: 20 },
+    L9_2: { eng: "communication_percentage" },
+
+    L10_1: { eng: "total_raw", title: "نمره کل رضایت شغلی", max: 180 },
+    L10_2: { eng: "total_percentage" },
+  };
+
+  profileSpec = {
+    sample: {
+      name: "پرسشنامه رضایت شغلی اسپکتور",
+      multiProfile: false,
+      questions: false,
+      defaultFields: true,
+      fields: [],
+    },
+    profile: {
+      get dimensions() {
+        return {
+          width: 789 + 2 * this.padding.x, // Chart layer 789 wide → 903
+          height: 414 + 2 * this.padding.y, // Chart layer 414 tall → 714
+        };
+      },
+      // Padding is the Chart's inset inside the 943 × 754 design page *minus* the
+      // 20 px the layout already owns on every side, so the page resolves to
+      // 903 × 714 — the exact with-sidebar drawing area — and renders at scale 1
+      // instead of being shrunk to fit.
+      padding: {
+        x: 57, // (943 − 789) / 2 − 20
+        y: 150, // (754 − 414) / 2 − 20
+      },
+    },
+    labels: Object.values(this.labels),
+  };
+
+  constructor(dataset, options, config = {}) {
+    super();
+    this._init(dataset, options, config);
+  }
+
+  _calcContext() {
+    const { dataset } = this;
+    const s = dataset.score; // [raw, percentage] × 9 factors, then the total
+
+    const items = [];
+    for (let i = 0; i < 9; i++) {
+      const raw = s[2 * i];
+      const top = ROW.top + i * ROW.pitch;
+      // The design rounds the percentage before drawing, so the tip of the bar
+      // always lands exactly on the number printed inside it.
+      const pct = Math.round((s[2 * i + 1].mark ?? 0) * 100);
+      const width = BAR.coefficient * pct;
+
+      items.push({
+        title: raw.label.title,
+        mark: raw.mark ?? 0,
+        pct,
+        width,
+        top,
+        // Designer note: the percentage never leaves the bar — this test cannot
+        // score below 20 %, so there is always room for the label inside it.
+        labelX: BAR.x + width - BAR.gap,
+        baseline: top + BASELINE,
+      });
+    }
+
+    const totalRaw = s[18];
+    const totalPct = Math.round((s[19].mark ?? 0) * 100);
+    const height = TOTAL.coefficient * totalPct;
+    const tip = TOTAL.bottom - height;
+
+    const total = {
+      mark: totalRaw.mark ?? 0,
+      max: totalRaw.label.max,
+      pct: totalPct,
+      height,
+      tip,
+      // Designer note: the readout travels with the bar, centred on its tip.
+      pctBaseline: tip - 0.98,
+      fractionBaseline: tip + 13.06,
+    };
+
+    return [{ items, total }];
+  }
+}
+
+module.exports = JSS93;

package/src/samples/PSQI93.js

@@ -0,0 +1,135 @@
+const { Profile } = require("../Profile");
+
+// ---------------------------------------------------------------------------
+// PSQI93 — شاخص کیفیت خواب پیتزبورگ. No Figma source: the chart was designed
+// directly from the approved result specification of the science record
+// (catalog/assessments/psqi, «مشخصات نتیجه فردی»), whose rules this layout
+// enforces rather than decorates:
+//   - seven components on one shared 0–3 axis, raw only — no per-component
+//     class, colour or label (no evidence for any);
+//   - the total 0–21, drawn neutral: the screening result lives ONLY in the
+//     approved interpretation text — no badge, no colour, no cut line;
+//   - all-or-nothing: when scoring/PSQI93.py returns status "invalid" nothing
+//     but the no-result message is drawn — never a partial or zero score.
+// Chart 863 × 674, centred on the 943 × 754 design page.
+// ---------------------------------------------------------------------------
+const CHART = { width: 863, height: 674 };
+
+// Component rows: bars grow left → right from the 0 guide; the total card sits
+// to the right of the chart.
+const ROW = { top: 84, pitch: 44, height: 18 };
+const AXIS = { zero: 162, unit: 150, max: 3 }; // 0 at x=162, 3 at x=612
+const BASELINE = 13.2; // 14 px text on an 18 px row
+
+// Total card bar, also left → right: 0 at the card's left inset, 21 at its right.
+const TOTAL = { left: 713, length: 130, max: 21, cutoff: 6 };
+
+// Interpretation panel: one fixed line pitch; the conditional false-positive
+// line collapses its space when the screen is negative.
+const TEXT = { top: 494, pitch: 27 };
+
+class PSQI93 extends Profile {
+  static pages = 1;
+
+  labels = {
+    L1: { eng: "subjective_quality", title: "کیفیت ذهنی خواب" },
+    L2: { eng: "latency", title: "تأخیر خواب" },
+    L3: { eng: "duration", title: "مدت خواب" },
+    L4: { eng: "efficiency", title: "کارایی معمول خواب" },
+    L5: { eng: "disturbances", title: "اختلال‌های خواب" },
+    L6: { eng: "medication", title: "مصرف داروی خواب" },
+    L7: { eng: "daytime_dysfunction", title: "اختلال عملکرد روزانه" },
+    L8: { eng: "total", title: "نمره کل", max: 21 },
+    L9: { eng: "status" }, // valid | invalid
+    L10: { eng: "screening" }, // positive | negative — read, never drawn as a label
+  };
+
+  profileSpec = {
+    sample: {
+      name: "شاخص کیفیت خواب پیتزبورگ",
+      multiProfile: false,
+      questions: false,
+      defaultFields: true,
+      fields: [],
+    },
+    profile: {
+      get dimensions() {
+        return {
+          width: CHART.width + 2 * this.padding.x, // 863 → 903
+          height: CHART.height + 2 * this.padding.y, // 674 → 714
+        };
+      },
+      // Chart inset inside the 943 × 754 design page minus the 20 px the layout
+      // owns on every side, so the with-sidebar page renders at scale 1.
+      padding: {
+        x: (943 - CHART.width) / 2 - 20, // 20
+        y: (754 - CHART.height) / 2 - 20, // 20
+      },
+    },
+    labels: Object.values(this.labels),
+  };
+
+  constructor(dataset, options, config = {}) {
+    super();
+    this._init(dataset, options, config);
+  }
+
+  _calcContext() {
+    const s = this.dataset.score;
+    const status = s[8].mark;
+
+    // Anything but an explicit "valid" is treated as no result: a missing
+    // status must not let seven `?? 0` zeros read as "no sleep problem".
+    if (status !== "valid") return [{ valid: false }];
+
+    const items = s.slice(0, 7).map((data, i) => {
+      const mark = data.mark ?? 0;
+      const top = ROW.top + i * ROW.pitch;
+      const width = mark * AXIS.unit;
+      return {
+        title: data.label.title,
+        mark,
+        top,
+        width,
+        x: AXIS.zero,
+        baseline: top + BASELINE,
+      };
+    });
+
+    const totalMark = s[7].mark ?? 0;
+    const positive = totalMark >= TOTAL.cutoff;
+    const totalWidth = (TOTAL.length * totalMark) / TOTAL.max;
+
+    const line = (n) => TEXT.top + n * TEXT.pitch;
+    const falsePositive = positive ? line(3) : null;
+    const next = positive ? 4 : 3;
+
+    return [
+      {
+        valid: true,
+        items,
+        ticks: [0, 1, 2, 3].map((v) => ({ v, x: AXIS.zero + v * AXIS.unit })),
+        total: {
+          mark: totalMark,
+          max: TOTAL.max,
+          width: totalWidth,
+          x: TOTAL.left,
+        },
+        screen: {
+          positive,
+          text: positive ? "نیازمند بررسی بیشتر" : "نشانه‌ای از مشکل قابل‌توجه دیده نشد",
+        },
+        lines: {
+          direction: line(0),
+          screen: line(1),
+          cutoff: line(2),
+          falsePositive,
+          limits1: line(next),
+          limits2: line(next + 1),
+        },
+      },
+    ];
+  }
+}
+
+module.exports = PSQI93;