refactor: make indicator ranges computable with min/max + status levels

docs/参考资料/知识库/报告指标知识库.json

@@ -1,13 +1,18 @@
 {
   "元数据": {
     "名称": "菌群报告指标知识库",
-    "版本": "1.0",
-    "说明": "标准化报告指标定义，包含标准范围、评估标准和说明",
-    "数据来源": "5份肠道菌群健康检测报告交叉验证"
+    "版本": "2.0",
+    "说明": "标准化报告指标定义，包含可计算的标准范围、状态分级和说明",
+    "数据来源": "5份肠道菌群健康检测报告交叉验证",
+    "用途": "用于报告指标值的自动化状态比对，取值规则：遍历状态分级，若值在[最小值, 最大值)区间内则匹配该状态"
   },
   "疾病风险评估": {
-    "说明": "疾病风险值0-1，<0.3低风险，0.3-0.5注意，>0.5高风险",
-    "标准范围": "0-1",
+    "标准范围": {"最小值": 0, "最大值": 1},
+    "状态分级": [
+      {"状态": "低风险", "最小值": 0, "最大值": 0.3},
+      {"状态": "注意", "最小值": 0.3, "最大值": 0.5},
+      {"状态": "高风险", "最小值": 0.5, "最大值": 1}
+    ],
     "指标": [
       {"名称": "炎症性肠炎", "说明": "肠道慢性炎症性疾病风险评估"},
       {"名称": "肠易激综合征", "说明": "功能性肠道疾病风险评估"},
@@ -32,10 +37,14 @@
     ]
   },
   "主要营养评估": {
-    "说明": "营养评估分值0-100，0-5缺乏，6-14偏低，15-99正常，70-80最佳，90-100过高",
-    "标准范围": "0-100",
+    "标准范围": {"最小值": 0, "最大值": 100},
+    "状态分级": [
+      {"状态": "缺乏", "最小值": 0, "最大值": 5},
+      {"状态": "偏低", "最小值": 5, "最大值": 15},
+      {"状态": "正常", "最小值": 15, "最大值": 100}
+    ],
     "指标": [
-      {"名称": "碳水化合物", "说明": "主要能量来源，建议维持在70-80分最佳"},
+      {"名称": "碳水化合物", "说明": "主要能量来源"},
       {"名称": "蛋白质", "说明": "机体构建和修复的重要营养素"},
       {"名称": "脂肪", "说明": "必需脂肪酸来源，脂溶性维生素载体"},
       {"名称": "纤维素", "说明": "促进肠道蠕动，维持菌群健康"},
@@ -43,8 +52,12 @@
     ]
   },
   "氨基酸评估": {
-    "说明": "氨基酸评估分值0-100，0-5缺乏，6-14偏低，15-99正常，70-80最佳，90-100过高",
-    "标准范围": "0-100",
+    "标准范围": {"最小值": 0, "最大值": 100},
+    "状态分级": [
+      {"状态": "缺乏", "最小值": 0, "最大值": 5},
+      {"状态": "偏低", "最小值": 5, "最大值": 15},
+      {"状态": "正常", "最小值": 15, "最大值": 100}
+    ],
     "指标": [
       {"名称": "苏氨酸", "说明": "必需氨基酸，参与蛋白质合成和免疫功能"},
       {"名称": "异亮氨酸", "说明": "支链氨基酸，促进肌肉合成和能量代谢"},
@@ -64,8 +77,12 @@
     ]
   },
   "维生素评估": {
-    "说明": "维生素评估分值0-100，0-5缺乏，6-14偏低，15-99正常，70-80最佳，90-100过高",
-    "标准范围": "0-100",
+    "标准范围": {"最小值": 0, "最大值": 100},
+    "状态分级": [
+      {"状态": "缺乏", "最小值": 0, "最大值": 5},
+      {"状态": "偏低", "最小值": 5, "最大值": 15},
+      {"状态": "正常", "最小值": 15, "最大值": 100}
+    ],
     "指标": [
       {"名称": "维生素A", "说明": "维持视力、免疫功能和皮肤健康"},
       {"名称": "维生素B1", "说明": "硫胺素，参与能量代谢和神经功能"},
@@ -80,16 +97,24 @@
     ]
   },
   "微量元素评估": {
-    "说明": "微量元素评估分值0-100，0-5缺乏，6-14偏低，15-99正常，70-80最佳，90-100过高",
-    "标准范围": "0-100",
+    "标准范围": {"最小值": 0, "最大值": 100},
+    "状态分级": [
+      {"状态": "缺乏", "最小值": 0, "最大值": 5},
+      {"状态": "偏低", "最小值": 5, "最大值": 15},
+      {"状态": "正常", "最小值": 15, "最大值": 100}
+    ],
     "指标": [
       {"名称": "铁", "说明": "血红蛋白的重要组成部分，缺铁会导致贫血"},
       {"名称": "锌", "说明": "参与免疫功能和伤口愈合，影响生长发育"}
     ]
   },
   "抗生素风险评估": {
-    "说明": "抗生素耐药基因水平0-100，0-30低风险，30-60注意，60-100高风险",
-    "标准范围": "0-100",
+    "标准范围": {"最小值": 0, "最大值": 100},
+    "状态分级": [
+      {"状态": "低风险", "最小值": 0, "最大值": 30},
+      {"状态": "注意", "最小值": 30, "最大值": 60},
+      {"状态": "高风险", "最小值": 60, "最大值": 100}
+    ],
     "指标": [
       {"名称": "β-内酰胺酶类", "说明": "青霉素类抗生素耐药基因水平"},
       {"名称": "氨基糖苷类", "说明": "氨基糖苷类抗生素耐药基因水平"},
@@ -103,48 +128,55 @@
     ]
   },
   "肠道屏障及代谢物": {
-    "标准范围": "各指标不同",
+    "标准范围": {"最小值": 0, "最大值": 100},
+    "状态分级": null,
     "指标": [
-      {"名称": "肠道炎症水平", "标准范围": "0-80", "状态": "正常0-80，过高>80", "说明": "肠道炎症程度评估"},
-      {"名称": "肠道产气", "标准范围": "0-50", "状态": "正常0-50，过高>50", "说明": "肠道产气水平评估"},
-      {"名称": "肠道屏障", "标准范围": "15-100", "状态": "缺乏<15，正常15-100", "说明": "肠道屏障功能评估"},
-      {"名称": "脂多糖LPS", "标准范围": "0-85", "状态": "正常0-85，过高>85", "说明": "内毒素水平评估"},
-      {"名称": "次级胆汁酸", "标准范围": "15-95", "状态": "缺乏<5，不足5-15，正常15-95，过高>95", "说明": "胆汁酸代谢产物"},
-      {"名称": "对甲酚（p-Cresol）", "标准范围": "0-85", "状态": "正常0-85，过高>85", "说明": "酪氨酸代谢产物，尿毒症毒素"},
-      {"名称": "吲哚", "标准范围": "15-90", "状态": "缺乏<5，不足5-15，正常15-90，过高>90", "说明": "色氨酸代谢产物"},
-      {"名称": "苯酚", "标准范围": "0-85", "状态": "正常0-85，过高>85", "说明": "酪氨酸代谢产物"},
-      {"名称": "腐胺", "标准范围": "5-85", "状态": "缺乏<5，正常5-85，过高>85", "说明": "多胺类物质，与细胞增殖和炎症相关"},
-      {"名称": "硫化氢", "标准范围": "5-85", "状态": "缺乏<5，正常5-85，过高>85", "说明": "含硫氨基酸代谢产物"},
-      {"名称": "尸胺", "标准范围": "5-85", "状态": "缺乏<5，正常5-85，过高>85", "说明": "组氨酸代谢产物，与肠道炎症相关"}
+      {"名称": "肠道炎症水平", "标准范围": {"最小值": 0, "最大值": 80}, "状态分级": [{"状态": "正常", "最小值": 0, "最大值": 80}, {"状态": "过高", "最小值": 80, "最大值": 100}], "说明": "肠道炎症程度评估"},
+      {"名称": "肠道产气", "标准范围": {"最小值": 0, "最大值": 50}, "状态分级": [{"状态": "正常", "最小值": 0, "最大值": 50}, {"状态": "轻度产气", "最小值": 50, "最大值": 80}, {"状态": "严重产气", "最小值": 80, "最大值": 100}], "说明": "肠道产气水平评估"},
+      {"名称": "肠道屏障", "标准范围": {"最小值": 15, "最大值": 100}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 100}], "说明": "肠道屏障功能评估"},
+      {"名称": "脂多糖LPS", "标准范围": {"最小值": 0, "最大值": 85}, "状态分级": [{"状态": "正常", "最小值": 0, "最大值": 85}, {"状态": "过高", "最小值": 85, "最大值": 100}], "说明": "内毒素水平评估"},
+      {"名称": "次级胆汁酸", "标准范围": {"最小值": 15, "最大值": 95}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "胆汁酸代谢产物"},
+      {"名称": "对甲酚（p-Cresol）", "标准范围": {"最小值": 0, "最大值": 85}, "状态分级": [{"状态": "正常", "最小值": 0, "最大值": 85}, {"状态": "过高", "最小值": 85, "最大值": 100}], "说明": "酪氨酸代谢产物，尿毒症毒素"},
+      {"名称": "吲哚", "标准范围": {"最小值": 15, "最大值": 90}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 90}, {"状态": "过高", "最小值": 90, "最大值": 100}], "说明": "色氨酸代谢产物"},
+      {"名称": "苯酚", "标准范围": {"最小值": 0, "最大值": 85}, "状态分级": [{"状态": "正常", "最小值": 0, "最大值": 85}, {"状态": "过高", "最小值": 85, "最大值": 100}], "说明": "酪氨酸代谢产物"},
+      {"名称": "腐胺", "标准范围": {"最小值": 5, "最大值": 85}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "正常", "最小值": 5, "最大值": 85}, {"状态": "过高", "最小值": 85, "最大值": 100}], "说明": "多胺类物质，与细胞增殖和炎症相关"},
+      {"名称": "硫化氢", "标准范围": {"最小值": 5, "最大值": 85}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "正常", "最小值": 5, "最大值": 85}, {"状态": "过高", "最小值": 85, "最大值": 100}], "说明": "含硫氨基酸代谢产物"},
+      {"名称": "尸胺", "标准范围": {"最小值": 5, "最大值": 85}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "正常", "最小值": 5, "最大值": 85}, {"状态": "过高", "最小值": 85, "最大值": 100}], "说明": "组氨酸代谢产物，与肠道炎症相关"}
     ]
   },
   "短链脂肪酸": {
-    "标准范围": "各指标不同",
+    "标准范围": {"最小值": 0, "最大值": 100},
+    "状态分级": null,
     "指标": [
-      {"名称": "丁酸盐（Butyrate）", "标准范围": "15-95", "状态": "缺乏<5，不足5-15，正常15-95，过高>95", "说明": "肠道上皮细胞主要能量来源，抗炎"},
-      {"名称": "丙酸盐（Propionate）", "标准范围": "15-90", "状态": "缺乏<5，不足5-15，正常15-90，过高>90", "说明": "参与肝脏糖异生，调节食欲"},
-      {"名称": "乙酸盐（Acetate）", "标准范围": "15-95", "状态": "缺乏<5，不足5-15，正常15-95，过高>95", "说明": "最丰富的短链脂肪酸，参与脂质代谢"},
-      {"名称": "异戊酸盐（Isovaleric）", "标准范围": "5-85", "状态": "缺乏<5，正常5-85，过高>85", "说明": "支链脂肪酸，过量提示蛋白质腐败"}
+      {"名称": "丁酸盐（Butyrate）", "标准范围": {"最小值": 15, "最大值": 95}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "肠道上皮细胞主要能量来源，抗炎"},
+      {"名称": "丙酸盐（Propionate）", "标准范围": {"最小值": 15, "最大值": 90}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 90}, {"状态": "过高", "最小值": 90, "最大值": 100}], "说明": "参与肝脏糖异生，调节食欲"},
+      {"名称": "乙酸盐（Acetate）", "标准范围": {"最小值": 15, "最大值": 95}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "最丰富的短链脂肪酸，参与脂质代谢"},
+      {"名称": "异戊酸盐（Isovaleric）", "标准范围": {"最小值": 5, "最大值": 85}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "正常", "最小值": 5, "最大值": 85}, {"状态": "过高", "最小值": 85, "最大值": 100}], "说明": "支链脂肪酸，过量提示蛋白质腐败"}
     ]
   },
   "神经递质及激素": {
-    "标准范围": "各指标不同",
+    "标准范围": {"最小值": 0, "最大值": 100},
+    "状态分级": null,
     "指标": [
-      {"名称": "血清素（5-HT）", "标准范围": "15-95", "状态": "缺乏<5，不足5-15，正常15-95，过高>95", "说明": "情绪调节、睡眠和食欲相关"},
-      {"名称": "γ-氨基丁酸（GABA）", "标准范围": "15-85", "状态": "缺乏<5，不足5-15，正常15-85，过高>85", "说明": "抑制性神经递质，抗焦虑"},
-      {"名称": "谷氨酸（Glutamate）", "标准范围": "15-95", "状态": "缺乏<5，不足5-15，正常15-95，过高>95", "说明": "兴奋性神经递质，学习记忆相关"},
-      {"名称": "色氨酸（Tryptophan）", "标准范围": "15-95", "状态": "缺乏<5，不足5-15，正常15-95，过高>95", "说明": "血清素和褪黑素前体"},
-      {"名称": "DOPAC", "标准范围": "15-95", "状态": "缺乏<5，不足5-15，正常15-95，过高>95", "说明": "多巴胺代谢产物"},
-      {"名称": "多巴胺", "标准范围": "15-95", "状态": "缺乏<5，不足5-15，正常15-95，过高>95", "说明": "奖赏、动机和运动控制相关"},
-      {"名称": "组胺（Histamine）", "标准范围": "15-95", "状态": "缺乏<5，不足5-15，正常15-95，过高>95", "说明": "免疫反应和胃酸分泌调节"},
-      {"名称": "一氧化氮", "标准范围": "15-95", "状态": "缺乏<5，不足5-15，正常15-95，过高>95", "说明": "血管舒张和神经信号传导"},
-      {"名称": "喹啉（Quinolinic）", "标准范围": "0-95", "状态": "正常0-95，过高>95", "说明": "色氨酸代谢产物，NMDA受体激动剂"},
-      {"名称": "维生素K2", "标准范围": "15-99", "状态": "缺乏<5，不足5-15，正常15-99，过高>99", "说明": "钙代谢和凝血功能调节"},
-      {"名称": "肌醇（Inositol）", "标准范围": "15-99", "状态": "缺乏<5，不足5-15，正常15-99，过高>99", "说明": "细胞信号传导和脂质代谢"}
+      {"名称": "血清素（5-HT）", "标准范围": {"最小值": 15, "最大值": 95}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "情绪调节、睡眠和食欲相关"},
+      {"名称": "γ-氨基丁酸（GABA）", "标准范围": {"最小值": 15, "最大值": 85}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 85}, {"状态": "过高", "最小值": 85, "最大值": 100}], "说明": "抑制性神经递质，抗焦虑"},
+      {"名称": "谷氨酸（Glutamate）", "标准范围": {"最小值": 15, "最大值": 95}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "兴奋性神经递质，学习记忆相关"},
+      {"名称": "色氨酸（Tryptophan）", "标准范围": {"最小值": 15, "最大值": 95}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "血清素和褪黑素前体"},
+      {"名称": "DOPAC", "标准范围": {"最小值": 15, "最大值": 95}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "多巴胺代谢产物"},
+      {"名称": "多巴胺", "标准范围": {"最小值": 15, "最大值": 95}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "奖赏、动机和运动控制相关"},
+      {"名称": "组胺（Histamine）", "标准范围": {"最小值": 15, "最大值": 95}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "免疫反应和胃酸分泌调节"},
+      {"名称": "一氧化氮", "标准范围": {"最小值": 15, "最大值": 95}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "血管舒张和神经信号传导"},
+      {"名称": "喹啉（Quinolinic）", "标准范围": {"最小值": 0, "最大值": 95}, "状态分级": [{"状态": "正常", "最小值": 0, "最大值": 95}, {"状态": "过高", "最小值": 95, "最大值": 100}], "说明": "色氨酸代谢产物，NMDA受体激动剂"},
+      {"名称": "维生素K2", "标准范围": {"最小值": 15, "最大值": 99}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 99}, {"状态": "过高", "最小值": 99, "最大值": 100}], "说明": "钙代谢和凝血功能调节"},
+      {"名称": "肌醇（Inositol）", "标准范围": {"最小值": 15, "最大值": 99}, "状态分级": [{"状态": "缺乏", "最小值": 0, "最大值": 5}, {"状态": "不足", "最小值": 5, "最大值": 15}, {"状态": "正常", "最小值": 15, "最大值": 99}, {"状态": "过高", "最小值": 99, "最大值": 100}], "说明": "细胞信号传导和脂质代谢"}
     ]
   },
   "主要消化道致病菌": {
-    "说明": "丰度值0%或ND为未检出，>0%为检出",
+    "标准范围": {"最小值": 0, "最大值": 100},
+    "状态分级": [
+      {"状态": "未检出", "最小值": 0, "最大值": 0},
+      {"状态": "检出", "最小值": 0, "最大值": 100}
+    ],
     "指标": [
       {"名称": "幽门螺杆菌", "说明": "与胃炎、胃溃疡和胃癌相关"},
       {"名称": "艰难梭菌", "说明": "抗生素相关性腹泻的主要病原菌"},
@@ -154,10 +186,10 @@
     ]
   },
   "健康总分评估": {
-    "健康总分": {"标准范围": "0-100", "分级": "≥80优秀，60-79良好，40-59一般，<40需关注"},
-    "菌群健康": {"标准范围": "0-100", "说明": "反映肠道菌群整体健康程度"},
-    "慢病控制": {"标准范围": "0-100", "说明": "反映慢性疾病风险控制水平"},
-    "营养均衡": {"标准范围": "0-100", "说明": "反映营养摄入均衡程度"},
+    "健康总分": {"标准范围": {"最小值": 0, "最大值": 100}, "状态分级": [{"状态": "需关注", "最小值": 0, "最大值": 40}, {"状态": "一般", "最小值": 40, "最大值": 60}, {"状态": "良好", "最小值": 60, "最大值": 80}, {"状态": "优秀", "最小值": 80, "最大值": 100}], "说明": "健康综合评分"},
+    "菌群健康": {"标准范围": {"最小值": 0, "最大值": 100}, "说明": "反映肠道菌群整体健康程度"},
+    "慢病控制": {"标准范围": {"最小值": 0, "最大值": 100}, "说明": "反映慢性疾病风险控制水平"},
+    "营养均衡": {"标准范围": {"最小值": 0, "最大值": 100}, "说明": "反映营养摄入均衡程度"},
     "肠道年龄": {"说明": "与实际年龄比较，反映肠道菌群的衰老/年轻程度"}
   }
 }