Pārlūkot izejas kodu

sync: 2026-09-09 源码仓导出

Jack 2 mēneši atpakaļ
vecāks
revīzija
e05e5c4621

+ 4 - 0
README.md

@@ -10,5 +10,9 @@
 ## 依赖
 - `shared/` 共享 JS · `assets/` 图片资产(随仓快照)
 
+## 规格文档
+- `docs/★ 客户端APP 系统设计说明书 v2.0.md` — 系统设计说明书(5 Tab · 22 屏 · 当前态重写版)
+- `docs/算法说明书 · *.md(8 份)` — 8 项测评引擎的公式/阈值/题库 SSOT(CFHI · CFPI · IC Lite · HI · KQ · 健康信息表 · 长新冠 · 肿瘤)
+
 ## 本地预览
 直接双击 HTML,或 `python -m http.server 8000` 后访问对应页面。

BIN
assets/orgs/emnano.png


+ 13 - 0
client-app.html

@@ -1949,6 +1949,11 @@ body{
             <div style="aspect-ratio:1;border-radius:12px;background:#fff;border:1px solid rgba(15,60,55,.08);display:flex;align-items:center;justify-content:center;overflow:hidden"><img src="assets/orgs/everblanc.jpg" alt="屹立" style="width:86%;height:86%;object-fit:contain"></div>
             <div style="font-size:.52rem;color:var(--ink-soft);margin-top:4px;line-height:1.3">屹立集团</div>
           </div>
+          <!-- v1.128(2026-09-07 · Jack 指示)永活水上墙(第 10 家 · 联盟发起成员)· Logo 自《EMNano永活水使用说明.pdf》p2 裁剪 -->
+          <div onclick="showOrg('emnano')" style="cursor:pointer;text-align:center">
+            <div style="aspect-ratio:1;border-radius:12px;background:#fff;border:1px solid rgba(15,60,55,.08);display:flex;align-items:center;justify-content:center;overflow:hidden"><img src="assets/orgs/emnano.png" alt="永活水" style="width:86%;height:86%;object-fit:contain"></div>
+            <div style="font-size:.52rem;color:var(--ink-soft);margin-top:4px;line-height:1.3">永活水</div>
+          </div>
           <!-- v1.91(2026-09-03 · Jack 指示)优家健康待机构方确认,暂作备选注释下架
                —— 恢复只取消本注释 + ORGS youjia 条目注释,Logo 文件保留 assets/orgs/youjia.png
           <div onclick="showOrg('youjia')" style="cursor:pointer;text-align:center">
@@ -6611,6 +6616,14 @@ window.mingdaoPyramidSVG = function(key, p){
       intro:'屹立集团(Everblanc Corporation)通过十余年深耕,已构建多元化全球商业平台。集团业务涵盖资产管理、地产基金 REITs、汽车供应链金融、海外置业及跨境服务等领域,立志成为全球先锋资产与综合解决方案的行业引领者。',
       services:['海外房产建设:屹立置业(Everblanc Homes)深耕欧洲国家本土开发,打造「繁星璀璨」系列品质标杆精品房产','汽车进出口服务:屹立汽车(Everblanc Auto)依托资深汽车贸易底蕴,全面覆盖欧洲平行进口及国产优质汽车出口欧洲业务','全球先锋资产:通过屹立资本(Everblanc Capital)专业发行地产基金 REITs 与优质海外基金产品','跨境全域规划:屹立出国(Everblanc Overseas)覆盖全球多国留学教育、税务规划及跨境落地一站式无忧服务'],
       member:'会员尊享全球资产配置绿色通道;免费定制多维税务规划与子女教育评估报告;专享高净值私域圈层活动,并享受境外全流程管家式服务。' },
+    /* v1.128(2026-09-07 · Jack 提供《EMNano永活水使用说明.pdf》· 联盟发起成员上墙)
+       口径 sanitize:特供/内供(人民大会堂·中南海 · 广告法禁「特供」表述)与白酒功效应用
+       (酒量提升/告别宿醉 · 健康 APP 不挂酒类功效)按合规剔除,只留企业沿革 + 物理特质 + 钓鱼台合作 */
+    emnano: { short:'永活水', full:'现代永活水(杭州)技术有限公司 · 永活 EMNano', color:'#1E6FA8',
+      role:'非还原低赫兹饮用水 · 全球独创「永不还原技术」',
+      intro:'现代永活水(杭州)技术有限公司由现代联合集团与龙之泉集团共同成立(2025 · 杭州)。技术根基源于 2002 年创建的北京龙之泉水技术开发有限公司,前身为 1993 年成立的北京震旦矿泉水有限公司——北京最早的矿泉水企业之一,长期承担在京机关及大型国央企专用饮用水保障。旗下「永活 EMNano」非还原低赫兹饮用水采用全球独创「永不还原技术」,以纯物理方式实现超纳米级小分子团,并长期保持活性状态。',
+      services:['非还原低赫兹永活水:纯物理方式使水分子团簇超小化,不受时间、温度、环境影响,长期保持超级活性状态(官方口径活性可持续 20 年以上)','超活物理特质:−8℃ 不结冰(低温下仍保持液态活性)· 99.5℃ 即沸腾(加热速度比普通水快约 15 秒 · 官方口径)','三代技术传承:1993 第一代震旦系矿泉水 → 2002 第二代小分子富氧活水 → 2018 第三代永活纳米能量水技术(13 年科研攻关 · 世界级科研成果)','2023 年起成为外交部钓鱼台国宾馆所属单位的指定永活低赫兹饮用水合作单位'],
+      member:'会员可在商城直接下单永活水周期套餐(月/季/半年/年四档 · 越长越优惠 · 按月整箱配送);健康套餐会员含全年家庭饮用水权益。' },
     /* v1.91(2026-09-03 · Jack 指示)优家健康待机构方确认 · 暂作备选注释下架 · 恢复只取消注释
     youjia: { short:'优家健康', full:'优家健康 · AlphaCare International Limited(香港)', color:'#2E3A87',
       role:'血液年龄检测 · 精准营养',

+ 305 - 0
docs/★ 客户端APP 系统设计说明书 v2.0.md

@@ -0,0 +1,305 @@
+# 铭道健康家办 · 客户端 APP 系统设计说明书 v2.0
+
+> **文档性质**:系统说明书(重写版)· 逐步增补 —— 本版覆盖「总体设计 + Tab 1 测试中心 + Tab 2 评分中心 + Tab 3 健康家办 + Tab 4 商城 + Tab 5 会员」
+> **描述对象**:`mingdao-health-office/client-app.html`(当前版本 **v1.120** · 2026-09-05)
+> **写作原则**:只描述**当前态**,不写历史变更(历史归 BUILD_LOG 与 git log)
+> **上一代文档**:[[★ 客户端APP 系统设计说明书 v1.0]](8 分册 · 本文件为整体重写)
+
+---
+
+## 一、系统定位
+
+**铭道健康家办客户端**是面向 C 端家族客户的移动优先 H5 应用原型,承载「测试 → 评分 → 服务 → 商城 → 会员」五步转化旅程。与顾问端 `index.html`(14 模块全家桶)分离,客户端刻意**做减法 + 引流钩子前置**。
+
+- **品牌**:系统 UI 一律露「铭道」
+- **交付形态**:H5 网页版(不做 APK / 原生包);部署域 `client.mdmed.com.cn`
+- **目标读者**:家族客户(含未注册访客);同时是 9/12 大会演示与销售转化载体
+
+## 二、信息架构总览(5 Tab · 22 屏)
+
+底部 5 个主 Tab,屏(screen)通过导航栈互相跳转;无独立 Tab 的屏归属最近主 Tab 保持高亮:
+
+| Tab | 主屏 | 子屏(跳转进入) |
+|---|---|---|
+| ① **测试中心** | `c1` | `c20` MICA+MISS 免疫评估(验血预约)· `c14` 问卷页 · `c15` CFPI · `c16` 保额测算 · `c9` 投入测试 · `c10` 知识测试 · `c17` 画像详情 |
+| ② **评分中心** | `c2` 我的评分 | `c2b` 综合评分详情 · `c11` 家庭指数(CFHI)· `c12` 健康银行 |
+| ③ **健康家办** | `c3` | `c13` 专家名册 · `c18` 联盟机构详情 · `c19` AI 免疫顾问 |
+| ④ **商城** | `c4` | —(页内三类切换) |
+| ⑤ **会员** | `c5` | `c6` 家族健康总览 · `c7` 我的记录·福利 · `c21` 添加家庭成员 |
+
+**导航增强**:桌面端 Tab hover 弹上拉快捷菜单(JS 控制显隐 + 200ms 离开延迟),移动端无 hover 不受影响;首/末位菜单左/右对齐防溢出手机框。
+
+---
+
+## 三、Tab 1 · 测试中心(c1)
+
+> 定位:**Step 1 · 旅程入口**。承担「让客户先测起来」的引流职责——建议全部完成以获取最完整免疫画像。
+
+### 3.1 页面结构(自上而下 6 个区块)
+
+**① 四大健康测试卡区**(`test-grid`,JS 由 `TESTS` 数组渲染):
+
+| 卡 | 样式 | 点击去向 |
+|---|---|---|
+| 🏠 CFHI 家庭健康风险指数 | 全宽卡(右侧大得分与 c11 同源 · 当前 65) | → `c11` 家庭指数(评分中心) |
+| 🌿 健康信息表 | 报纸卡 FORM·01(一排三列) | → `c14` 问卷页(真实问卷) |
+| 🫁 长新冠调查问卷 | 报纸卡 FORM·02 | → `c14` |
+| 🧬 肿瘤风险评估 | 报纸卡 FORM·03 | → `c14` |
+| 🛡️ MICA+MISS 免疫评估 | 全宽卡(右侧 MISS 评分 −10 · 演示值) | → `c20` 验血预约屏 |
+
+**② 其他测试 · 非健康状态评估**(分隔线下 4 个入口条):
+- 🛡️ **CFPI 家庭保障测评** → `c15`(21 题 · 五维量化家庭保障缺口 · 与 CFHI 健康指数联动;v1.95 起结果页含保障金字塔卡,与 c16 共用共享渲染器 `mingdaoPyramidSVG`;v1.97 起 CTA「预约你的专属财富管家」→ 真预约框:险种多选(按缺口预选)→ 手机号 → 线索存 `md_leads_v1`)
+- 🧮 **保额快速测算** → `c16`(10 题 · 2 分钟出重疾/意外/医疗/寿险/年金缺口;v1.92 起结果页 = Top3 按金字塔层序排序(基础→长期→责任 · 寿险动态例外)+「建议补充的全部保障」简表 + 教育金联动 CFPI;v1.93 起金字塔改顾问端同款分险种水位图(意外/医疗/重疾底三格 + 定寿 + 教育年金灰层 + 养老年金)· Hero 带本人+家庭年收入测算口径行;v1.96 起推荐固定序 意外→医疗→重疾 · 意外卡文案点破大/小意外)
+- 💳 **家族健康投入测试** → `c9`(16 题 · 选卡工具,与健康状态无关)
+- 📖 **免疫健康知识测试** → `c10`(20 题 · 判对错+解析 · 源自《免疫力是第一生命力》)
+
+**③ 对号入座 · 十五类适用人群**(WHO IT SERVES 单卡 · 三段分组 · **默认收起**):
+- 默认显示:🟢 健康 3 类(品质追求者/企业领军人物/备孕产后)+ 🟡 亚健康前 3 类(长新冠/熬夜/压力)
+- 「展开全部 15 类 ▾」按钮展开其余 9 类:🟡 亚健康后 3 类(肥胖/抑郁倾向/家族遗传)+ 🔴 疾病 6 类专科精准管理(感染/过敏/器官移植/心脑血管/慢病/肿瘤 · 含「专科路径接管」导语 · CTA 指 `c5` 会员权益)
+
+**④ 家族健康资产 · 两大传承工具**:
+- **家族免疫画像卡**:H1 免疫优秀型(−3~+3)/ H2 亚健康普遍型 / H3 慢病管理型 / H4 免疫危机型 / H5 跨代失衡型(家族 MISS 跨度 ≥8),点击 `showPortrait(Hx)` → `c17` 画像详情(特征 + 建议干预方案)
+- **家族谱系图介绍卡**:内嵌 SVG 三代谱系示意 + 跳转 `c6` 真实谱系
+
+**⑤ MICA+MISS 免疫评估屏(c20 · 点免疫评估卡进入)**:顶部**验血预约 Hero**(明示「不通过问卷评估 · 需采血化验」· 健康顾问安排采血 · 1-2 周出报告含专家一对一解读 · 预约 CTA)→ 下方体系介绍:
+- Hero「免疫力是第一生命力」+ 双体系定义卡(MICA 数据层 60 项 / MISS 评分层 ±25)
+- 权威 badges(团体标准 / 112 位专家共识 / 10,000+ 临床样本)
+- MISS ±25 九段平衡尺(`buildImmuneRuler` 渲染)
+- 60 项五大体系面板(T 40 / B 5 / NK·NKT 5 / 树突 5 / 初级评估 5)
+- 战略锚点「免疫双体检」(疾病检出率约 30 倍 + 李先亮主任金句 + 「做对检查」话术)
+- 十五大适用人群完整版(健康 3 + 亚健康 6 + 疾病 6)
+
+**⑥ 底部 CTA**:「完成后查看综合评分 →」→ `c2`
+
+### 3.2 Tab 快捷菜单(桌面 hover)
+
+测试中心 Tab 上拉菜单 7 项直达:CFHI 指数 / 健康信息表 / 长新冠问卷 / 肿瘤风险评估 / MICA+MISS 免疫评估 / CFPI / 保额测算。
+
+---
+
+## 四、Tab 2 · 评分中心(c2 / c2b / c11 / c12)
+
+> 定位:**Step 2 · 我的结果**。测试的「收成」页——四大检测独立评分 + 家庭层 CFHI 指数 + 积分激励闭环。三个屏共用顶部子 Tab(我的评分 / 家庭指数 / 健康银行),健康银行子 Tab 带积分余额角标(打卡入账时跳动动画)。
+
+### 4.1 我的评分(c2 · 第一层)
+
+- **访客态示例条**:未注册访客看「示例案例 · 演示数据(李xx先生 · 已匿名)」明确标识 + 注册转化按钮;会员态隐藏
+- **四大检测得分卡**(`DET_META` 驱动,点任一卡进 c2b;**首位 = MICA+MISS 免疫评估**——免疫力检测是健康家办核心):
+  - 🛡️ MICA+MISS 免疫评估 —— **±25 MISS 专属**,迷你条用 MISS 尺色板(深绿抑制→浅绿平衡→金红激活,与大尺语义一致)+ 端点标签 `-25 / 0 / +25` + 状态标签(如「中度抑制 · MISS」);卡面分值与 c2b 详情大数字同源(`dets[]` 免疫位 = `m.miss`)
+  - 🌿 健康信息表 / 🫁 长新冠调查问卷 / 🧬 肿瘤风险评估 —— **0-100 指数制**,迷你条分 good(高分好·红→绿)/ risk(高分差·绿→红)两种方向配色
+- **其他测试结果**(非健康状态评估 4 卡):CFPI / 保额测算 / 家族健康投入测试 / 免疫知识测试——已完成显示百分制得分与结论摘要,未测试显示「点击前往测试 →」;访客态展示标注「示例」的演示结果
+- **我的 CFHI 走势**:mingdao-timeseries 组件(事件台阶 + 周日漂移形态)
+- **底部双 CTA**:查看综合评分与指标 → c2b | 了解健康家办 → c3
+
+> 口径:「我的评分」只显示当前登录用户本人,家人得分归 c6 家族总览。
+
+### 4.2 综合评分详情(c2b · 第二层)
+
+随所选检测切换内容(`openDetail(detKey)`):
+
+- **个人档案条**:头像 / 姓名 / 角色 / 性别年龄 / 身高体重 BMI(标注「部分基础信息为演示值」)
+- **MISS 评分卡**(仅免疫检测显示):大字得分 + 状态 pill + MISS ±25 评分尺(带本人分数标记;两端 `-25`/`+25` 与 `0` 同级加重显示);其余三项检测无 ±25 评分,此卡隐藏
+- **指标卡**:
+  - 免疫 → **MICA 7 项核心细胞指标**(CD3/CD4/CD8/NK/NKT/B/DC),每项带参考区间(浅色带)+ 本人相对水平(色条),低于参考区间标橙
+  - 其余三检测 → 各自问卷维度条(如健康信息表 6 维:免疫抵抗力/精力体力/睡眠质量/情绪压力/消化代谢/皮肤毛发)
+- **人群大数据分布**(SVG 散点):免疫 = 1 大 MISS ±25 分布图 + 4 小图(T/B/NK/NKT);其余检测 = 单张综合位置图。红星=你 · 绿点=既往检测人群(种子伪随机保证每次渲染一致)
+- **底部 CTA**:→ c3 健康家办
+
+### 4.3 家庭指数 · CFHI(c11)
+
+> 叙事:「用华尔街量化的方法管健康」· 体检+检测+穿戴+行为多源综合打分。
+
+- **家庭 CFHI 总分卡**:总分 65(2026-08-13 首次实测基线)+ 定性「🟠 系统失衡型」+ 最大短板提示(D6 心理与恢复 1/6)+ λ 治理系数标注
+- **健康 K 线**:mingdao-timeseries 组件,**家庭 / 我的**双序列切换;事件台阶 + 周日漂移形态,事件注释(如「全家完成 MICA+MISS 检测 · CFHI +5」)
+- **家庭成员指数**:S 女士 82(H1)/ L 先生 70(H2)/ Jack 60(H3 · 标低分)——与顾问端、谱系图同源
+- **7 维健康结构**:SVG 雷达图(短板维红点高亮)+ 明细条(D1 免疫基础 ~ D7 医疗可及);**D6 下挂双子分**(心理状态 · 问卷 / 恢复质量 · 数据 + 70/30 合成注 · 数据子分未接穿戴显示「待接入穿戴」,兼作穿戴引流钩子)
+- **今日可加分**:行为清单(步数/健身/早睡/饮食/永活水打卡,各带积分值)
+- **CFHI 双层测评**(题库双层制):
+  - **入口版快测 Layer 1**:14 题 + 家庭治理 λ 2 题 · 约 3 分钟 · 建立基线
+  - **深度测评 Layer 2**:31 题 · 约 15 分钟 · 覆盖入口版基线 · 生成短板清单 · 完成 +200 积分
+  - 基线优先级:**真实数据 > 深度版 > 入口版**;⚠️ D6 含 PHQ-2/GAD-2 国际公版筛查题,结果仅作风险提示,不构成医学诊断(合规声明)
+- **底部双 CTA**:去健康银行 → c12 | 看看检测与服务 → c4
+
+### 4.4 健康银行(c12)
+
+> TEDx 叙事:每个健康行为 = 健康银行存款 · 可兑换真金白银。
+
+- **积分余额卡**:可用积分 + 现金等值(10 积分 = ¥1)——当前演示余额 1,168 ≈ ¥117(与可见流水逐行求和一致)
+- **今日打卡**:5 项(步数达标 +5 / 健身 +10 / 早睡 +5 / 健康饮食 +5 / 永活水 +3),打卡入账触发角标跳动动画;打卡区下挂「邀请家人加入家族」入口卡(+200 积分 · → `c21`)
+- **积分流水**:收支明细(v1.102 起按积分大小降序:检测 +500 / 消费返 1%:月套餐 ¥3,500 → ¥35 = +350 / 邀请家人 +200 / 录入病史 +100 / 日常打卡;余额与可见流水逐行求和一致 · 终值待李主任确认;v1.101 起无兑换行——1% 返利下演示收入撑不起兑换)
+- **积分兑换商城**(汇率 10 积分 = ¥1,兑换价 = 门市价 × 10;v1.101 起按所需积分降序):MICA+MISS 检测全额兑换(150,000 分 · 门市 ¥15,000)/ 永活水 · 1 箱(4,680 分 · 门市 ¥468)/ 智能穿戴手环(3,000 分)/ **老人专属**:特效药·原研药、养老产品(面议)
+
+---
+
+## 五、Tab 3 · 健康家办(c3 / c13 / c18 / c19)
+
+> 定位:**Step 3 · 这是什么**。品牌与服务体系的信任建设页——回答「健康家办是什么、凭什么信你、入会能得到什么」。
+
+### 5.1 健康家办主页(c3)
+
+自上而下 8 个区块:
+
+1. **联盟机构墙**:「联盟机构 · 紧密协同做一件事」(家数不写死,随联盟扩展)——当前 8 家共建机构,**全部真实 Logo**(`assets/orgs/` · 白底 contain · 背景统一纯白),位次:铭道众缘 / 助飞科技 / **国测会展 / 利世国际** | 贝净海洋 / 法盛长寿 / **健和九州** / 天九 GSO(国测在利世左侧、健和在国测原位),点击 `showOrg()` → `c18` 机构详情。**优家健康(AlphaCare · 香港)为第 9 家备选**——机构方尚未确认,墙格与 ORGS 条目均注释保留(恢复只取消注释,Logo 文件在库)
+2. **Hero 主张**:全球首创 · 稀缺性叙事
+3. **全流程守护四段**:🛡️ 预防(免疫画像·早筛早防)→ 📊 管理(分层随访·慢病管控)→ 🏥 治疗(精准干预·绿色治疗)→ 🌿 康复(长期随访·免疫重建);收口文案「以家庭为单位管理」+「做对检查」话术
+4. **三级免疫健康管理体系(金字塔)**:A/B 两版预览切换(完整 6 层:双体检 100% → 健康维持 10% → 亚健康一/二/三级 35/25/15% → 疾病综合治疗 15% | 精简 4 层)
+5. **铭道基因(品牌背书)**:12 年沉淀 / 2 项国家团体标准(T/CAWAORG 054.1·054.2 铭道牵头)/ 112 位专家共识 / 46+ 知识产权 +「美国有梅奥 · 中国有铭道」+ 德勤中国科技高成长 50 强
+6. **联盟四大支撑**:🗄️ 家族免疫健康数据资产库 / 📐 科学方法保障 / 🎁 产品与资源 / 👨‍⚕️ 专家网络
+7. **专家名册入口**:→ `c13`(会员专属预告)
+8. **真实家庭案例区**:折叠卡「📖 真实家庭如何受益(3 个案例)」(已获授权 + 全匿名 · 疗效表述合规软化:删自闭症/复发/抗肿瘤断言,保留 MISS 数值与指标事实层 · badge 深绿实心区分演示数据描边样式);C1 底部有瘦条入口,点击直跳本区并自动展开
+9. **底部 CTA**:「看看服务与商城 →」→ `c4`
+
+### 5.2 专家名册(c13 · 会员专属)
+
+- **非会员遮罩**:名册区盖「🔒 专家名册为会员专属」遮罩 +「先入会解锁 →」`c5`(带演示用 会员/非会员 切换开关)
+- **科室 chip 筛选**:按科室过滤
+- **专家列表**:9 个科室分组 · **38 位真实专家**(姓名/职称/医院/专长/照片 `assets/experts/`)——肿瘤·血液 / 肝胆胰·消化(含李先亮主任)/ 微创介入 / 心血管·胸外·泌尿 / 神经·心理 / 检验医学 / 妇产·骨科 / 中医·儿科 / 健康管理·慢病
+
+### 5.3 联盟机构详情(c18)
+
+按机构代码渲染(`ORGS` 数据 + `showOrg()`),页面为**三段式结构:📋 公司简介 → 🏛 核心服务 → 💎 会员权益**;健和九州另带卒中急救地图示意截图卡(核心服务后 · 标注示意图)。**8 家全部为机构方官方口径**:
+
+| 机构 | 定位 | 口径来源 |
+|---|---|---|
+| 铭道众缘 | 免疫医学服务主体(标准制定者/管理开创者/产业赋能者 · MICA+MISS+PISA) | 《铭道医疗企业宣传册》2026 版 |
+| 助飞科技 | 平台与系统研发主体(APP/顾问端/指数体系) | — |
+| 国测会展 | 一站式会议会展综合体(52 万㎡ · 8000 人同会 · 距首都机场 1.5km) | 国测官方介绍 |
+| 利世国际 | 利世G9国际庄园 · 高端康养与国际会客厅(怀来 5000 亩 · 法国庄) | 《利世G9国际庄园|完整介绍》 |
+| 贝净海洋 | 壳寡糖研究与应用 · 第六生命要素(日本专利 · 惠州工厂 · NHB) | 《北京贝净介绍.docx》 |
+| 法盛长寿 | 长寿产业基金 · 全球投资平台(**基金口径 · 不提家族办公室**) | 官方概览 + Jack 定稿文案 |
+| 健和九州 | 脑卒中防治 · 国家级急救网络协同(神州云 3000+ 医院 · 数据库覆盖 3000 万人 · 卒中地图 280 城) | 健和官方四图 |
+| 天九 GSO | 全球共享商务处 · 企业国际化服务平台(GERI 五步闭环 · 前元首顾问网络) | 《GSO全球共享商务处-简介.pdf》 |
+
+优家健康条目在 ORGS 中注释保留(备选 · 恢复只取消注释)。底部 CTA → `c5` 入会。
+
+### 5.4 AI 免疫顾问(c19 · Phase 1 UI 壳 + 预设 FAQ)
+
+- **入口**:全局悬浮球(`#aiFab` 右下角常驻 · 全站唯一入口)
+- **欢迎卡**:时段问候 + 日期;**快捷入口两卡**:报告解读 → `c2` | 自测评估 → `c1`(跳现有模块,不新建题库)
+- **大家都在问**:4 条预设 FAQ(铭道介绍 / 淋巴细胞亚群解读 / 检测流程 / 免疫球蛋白偏低)精确匹配作答
+- **对话区**:命中 FAQ 出答案;未命中走 fallback(引导预约专家 1on1);每条 bot 回答带免责小字
+- **会话记录**:右上角 🕘 面板 · 内存态(关闭页面清空)
+- **合规口径**:副标明示「**非诊疗建议**,干预方案请转专家 1on1」
+
+---
+
+## 六、Tab 4 · 商城(c4 / c4cart)
+
+> 定位:**Step 4 · 转化收割**。检测是数据入口(人人可购),深度服务与免疫产品是会员价值(专属锁定),购物车完成落单闭环。
+
+### 6.1 商城主页(c4)
+
+- **三大类 Tab**:医疗服务(检测·评估·管理)/ 生活服务(永活水·周期套餐)/ 免疫产品(二级子 Tab:铭道鉴品·数据验证 / 铭道优品·广泛认可 / 铭道选品·SKU 待补暂空);「🛍️ 铭道甄选商城」标题**仅免疫产品 Tab 下显示**(与二级子 Tab 同显隐 · 甄选 = 鉴品/优品/选品体系,医疗/生活服务不属甄选)
+- **SKU 三级门禁**(副标明示「MICA+MISS 与 PISA 检测人人可购 · 免疫产品与深度服务会员专属」):
+  - **L0 全开放**:PISA ¥980 · MICA+MISS ¥15,000 · 永活水全系 → 非会员可买(检测是数据入口,锁会员墙后等于自废引流)
+  - **L1 会员专属**:免疫产品全部 + 深度检测/健康管理/AI 数据/私医/尊享/报告解读类(SKU 标 `gate:'L1'`,非会员显示「会员专享」锁态)——**未标 gate 默认 L0,刻意如此**(忘标只是多卖一件,反之漏锁整类更难发现)
+  - **L2 权益核销**:会员权益内含次数,核销不走支付
+  - 整城遮罩 DOM(`#shopMask`)保留未删、强制隐藏,恢复只需改一行
+- **价格口径**:全品类统一价 · **无会员折扣**;唯一折扣形态 = 永活水周期套餐的「承诺时长折扣」(对非会员同样生效)。v1.108 起五档套餐卡含「鉴品/优品/选品 9/8/7/6 折」权益(官方套餐方案口径,属合同权益非商城现售价)——v1.117 起商城副标加过渡口径「**会员档位折扣结算时顾问核销**」,会员价引擎(身份 × 免疫产品 × 结算/积分兑换联动)Phase 2 实现
+- **SKU 概览**(v1.105 · 2026-09-05 起 **SSOT =《铭道免疫核心全产业链产品&服务一览表(带价)》官方价格表**,前后端同一份清单,对照 [[商城SKU清单 · 觅哥对接版 v1.0]]):
+  - 医疗服务(22 SKU):免疫精准评估(PISA ¥980 · PISA Plus ¥1,680 · MICA+MISS ¥15,000 · 双解读)/ 免疫健康管理(三级方案 ¥5,000/年 · 健康管理方案 ¥6,000/次 · 中医调理 · 档案·沙龙免费 · 白皮书·管家)/ 免疫细胞调理(¥98,000/次)/ 名医诊疗绿通(门诊 ¥1,000 · 住院 ¥15,000 · 上门 ¥120 · 会诊/私人医生/海外系列至 ¥60,000)
+  - 生活服务(7 SKU):永活水周期套餐 4 档(¥3,500 起)+ 品质生活 6 项(红酒/养生茶/饮食/运动/睡眠/情绪)
+  - 免疫产品(26 SKU):鉴品 4 / 优品 13 / 选品 9(选品 v1.105 填实)
+  - 冲突口径:与旧 SKU 同名服务一律以官方表为准(绿通/上门/咨询/鉴品三品已刷新)
+- **演示用「会员/非会员」切换开关**(`memberState`,管「买」);与顶栏「访客/会员」身份模式(`IDENTITY`,管「数据归属」)是两个独立维度
+- **底部**:「成为会员 →」c5 +「🛒 我的购物车」入口(带数量角标)→ `c4cart`
+
+### 6.2 永活水周期套餐(c4 内嵌展开面板)
+
+| 周期 | 箱/瓶 | 折扣 | 标价 |
+|---|---|---|---|
+| 1 个月 | 8 箱 / 96 瓶 | 9.3 折 | ¥3,500 |
+| 3 个月 | 24 箱 / 288 瓶 | 8.9 折 | ¥10,000 |
+| 6 个月 | 48 箱 / 576 瓶 | 8.5 折 | ¥19,000 |
+| 1 年 | 96 箱 / 1,152 瓶 | 7.8 折(单瓶约 ¥30.4) | ¥35,000 |
+
+口径:门市 ¥39/瓶 · 养生 3 瓶/天 · 按月整箱配送(8 箱/月,不发分数箱)。**v1.98(2026-09-05 Jack 拍板)四档圆整便于销售报价,实际折扣仍严格递减;v1.53「月装门市价不打折 = 价格锚」铁律自此退役**。会员套餐内含水权益一律按门市 ¥39/瓶估值(不受圆整影响)。
+
+### 6.3 购物车与落单(c4cart · 前端真购物车)
+
+- **CART 模块**:`localStorage` 持久化(`md_cart_v1`)· 加购(同名合并数量)/ 数量步进(减到 0 删行)/ 删除 / 合计 / 角标 / toast 反馈;价格解析支持「¥15,000」「¥10万」「起」等中文格式
+- **商品分行**:服务类(tag ∈ 评估/检测/体检/管理/私医/尊享/数据)标「预约制服务」,其余标「实物配送」
+- **结算表单**:姓名 * + 手机号 *(11 位校验)+ 收货地址(只买服务可留空)+ 备注(预约偏好/顾问姓名)
+- **落单**:订单号 `MD`+时间戳 · 存 `md_orders_v1`(status「待支付」)· 订单结构预留 orderId/items/amount/status 字段,接后端不返工
+- **订单确认页**:支付二选一 —— ① 扫码支付(向顾问出示订单号)② 现场顾问协助;「继续逛逛」回 c4
+- **合规边界**:健康套餐**不进购物车**(走《服务合同》签约路径)· 购物车只卖实物/即时交付 · 不接储值支付(储值卡已下线)· 微信支付 JSAPI 真收款 = Phase 2 觅哥后端
+- **9/12 支付链路(三条 · 2026-09-02 Jack 拍板 PISA 开放收款)**:下单买水 / 下单买 MICA ¥15,000 / 下单买 PISA ¥980;健康套餐仅展示不收款
+
+---
+
+## 七、Tab 5 · 会员(c5 / c5hj / c6 / c7)
+
+> 定位:**Step 5 · 成为会员**。转化终点 + 会员服务中心(家族总览、记录与福利)。
+
+### 7.1 会员套餐主页(c5)
+
+- **会员价值横幅**:🔑 检测与永活水人人可购 · 免疫产品与深度服务会员专属(与商城 L0/L1 门禁同口径)
+- **选套餐前先测测**:家族健康投入测试入口 → `c9`(16 题选卡工具)
+- **五档健康套餐**(v1.108 起 · 2026-09-05 Jack 指示 · 替代旧三档 个人/家庭/企业家 10/30/100 万)——**SSOT =《五档套餐/Word文档》五份官方方案(全国统一价)**,数据驱动 `TIERS` + `renderTiers()`,套餐合同形态沿用(入会即签《年度健康管理服务合同》,服务逐项列明、按约交付):
+  | 档位 | 价格 | 定位 | 人数 | 核心递增 |
+  |---|---|---|---|---|
+  | 一档 · 免疫平衡维稳 | ¥1.68 万/年 | 换季易病 · 防未病入门 | 单人 | 检测 1 · 商城 9 折(v1.112 起不含绿通/鉴品疗程 · 入门瘦身) |
+  | 二档 · 免疫精准修复 | ¥10 万/年 | 高压职场 · 免疫失衡纠正 | 单人 | 检测 2 · 细胞调理 1 · 8 折 |
+  | 三档 · 免疫抗衰激活 | ¥30 万/年 | 免疫早衰 · 抗衰 | 单人/夫妻 | 检测 3 · 调理 2 · 7 折 |
+  | 四档 · 家庭免疫防火墙 | ¥100 万/年 | 分龄免疫 · 家庭屏障 | 家庭 3-5 人 | 检测 8 · 调理 6 · 门诊绿通不限次 · 6 折 |
+  | 五档 · 家族免疫力传承 | ¥300 万/年 | 家族传承 · 全生命周期 | 家族 5-8 人 | 检测 12 · 调理 12 · 海外直达 · 6 折 |
+  - 全档共性:生活服务 7 项全年 + 鉴品四品一疗程 + 优品/选品按需 + 终身档案 + 沙龙 + 线上课程免费;四/五档含保险与财富家办管理服务(双管家接口)
+- **「关于套餐费用」话术卡**:费用对应合同逐项列明的服务与权益,按约交付、逐项核销(退款条款按合同公式 · 最终表述待合同文本确认)
+- **储值卡模块**:整卡隐藏下线(DOM 保留 `display:none`,恢复只改一行)——储值+兑付实物命中《单用途商业预付卡管理办法》,待法律意见后定去留
+- **底部**:「联系顾问 · 立即入会」(支付通道待接入)+「已是会员?查看我的家族总览」→ `c6`
+
+### 7.2 家庭套餐权益明细(c5hj · 入口暂关)
+
+黑金卡权益清单屏(9 大类 26 项 · 单项价合计 ¥409,632 vs 套餐价 ¥299,999 ≈ 7.3 折 · 旗舰免疫调理价值另询不合计)。**当前状态**:c5 两处入口已关闭(权益明细待铭道确认后再放开),屏本体保留未删。
+
+### 7.3 家族健康总览(c6 · 会员专属)
+
+- **CFHI 总分卡**:与 c11 同源渲染(当前 65 · 系统失衡型),点击 → `c11` 家庭指数
+- **家族头卡**:李xx先生家族(访客态标「示例案例」badge)· H5 跨代失衡型 · MISS 跨度/分布区间/已检测人数三指标
+- **风险提示条**:反差叙事(免疫最弱的不是长辈而是户主)
+- **家族谱系图**:`shared/family-tree.js` 渲染(移动端纵向版 · 数据源 `configs/families/*.json`)
+- **成员卡 ×3**:S 女士(母 · H1 · +2)/ L 先生(父 · H2 · −5)/ Jack(户主 · H3 · −10),各带 MISS 迷你尺 + 画像判定 + 管理建议
+- **添加家庭成员(v1.86)**:成员卡末尾「+ 添加家庭成员」虚线卡 → `c21`(💌 邀请注册主路径 · 静态邀请卡+口令 / ✍️ 户主代录 6 字段+知情同意勾选 · 存 `md_family_extra_v1`);代录成员渲染灰色「待检测」卡,**不进 CFHI 聚合/跨度/已检测计数**;头卡成员数动态更新;C11 文字链 + C12「邀请家人 +200」入口卡为次入口。已知限制:代录成员暂不进谱系图(Phase 2 后端化后统一)
+- **访客态转化 CTA**:注册/成为会员 → `c5`(会员态隐藏);底部 → `c7`
+
+### 7.4 我的记录 · 福利(c7 · 会员专属)
+
+- **检测记录时间线**:已完成(MICA 报告已出)/ 已预约(专家面诊)/ 待执行(MD Health 首次配药)三态标签
+- **水权益进度条**:「一年水 · 按月配送中」——总权益/已配送/剩余/剩余月数四格 + 可转赠亲友(赠送码)或兑商城券(演示态按企业家卡 456 箱)
+- **权益使用进度**:5 项进度条(检测 1/1 · 私人医生 2/6 · 报告解读 0/2 · 上门 0/2 · 密集调理 0/1)+ 累计已使用价值 ¥10,300
+- **专家建议留痕**:顾问建议文本留痕(含补充/调整记录)
+- 口径:本页只显示本人记录
+
+---
+
+## 八、算法说明书索引(算法 SSOT 指针)
+
+本文只写页面结构与行为;**8 项测评引擎的公式、阈值、题库、折扣项以 docs/ 根目录的独立《算法说明书》系列为单一真相源**(每份头注声明实现位置与基线版本,查算法请读对应份):
+
+| # | 说明书 | 引擎 / 屏 | 性质 |
+|---|---|---|---|
+| 1 | [[算法说明书 · CFHI 家庭健康风险指数 v1.0.md]] | `CFHI_ENTRY` / `CFHI_DEEP` · `c11` | 家庭健康风险指数 · 双层题库 + λ 治理系数 |
+| 2 | [[算法说明书 · CFPI 家庭保障测评 v1.0.md]] | `CFPI_QS` / `cfpiCalc()` · `c15` | 五维保障缺口指数 + 保障金字塔 |
+| 3 | [[算法说明书 · 保额快速测算(IC Lite)v1.0.md]] | `ICQ_QS` / `icqCalc()` · `c16` | 五险种缺口金额(IC v5.1 粗算映射) |
+| 4 | [[算法说明书 · 家族健康投入测试(HI)v1.0.md]] | `hiSubmit()` · `c9` | 选卡工具 · 推荐套餐档位(题库顾问端共享) |
+| 5 | [[算法说明书 · 免疫健康知识测试(KQ)v1.0.md]] | `KQ` · `c10` | 科普判对错 · 不产生健康分数 |
+| 6 | [[算法说明书 · 铭道健康信息表 v1.0.md]] | `FORMS.health` · `c14` | 仅完成统计 · 算分待铭道确认 |
+| 7 | [[算法说明书 · 长新冠调查问卷 v1.0.md]] | `FORMS.covid` · `c14` | 仅完成统计 · 算分待铭道确认 |
+| 8 | [[算法说明书 · 铭道肿瘤风险评估表 v1.0.md]] | `FORMS.tumor` · `c14` | 仅完成统计 · 权重须铭道/李主任定 |
+
+> ⚠️ 旧 v1.0 分册《4 · 算法说明书(8 大测评引擎)》已被本索引 + 独立系列取代(停留在 ~v1.58 口径,勿引用)。
+
+---
+
+## 九、待续
+
+- [x] Tab 1 · 测试中心(c1 / c14 / c15 / c16 / c9 / c10 / c17)
+- [x] Tab 2 · 评分中心(c2 / c2b / c11 / c12)
+- [x] Tab 3 · 健康家办(c3 / c13 / c18 / c19)
+- [x] Tab 4 · 商城(c4 / c4cart)
+- [x] Tab 5 · 会员(c5 / c5hj / c6 / c7)
+
+---
+
+*文档版本:v2.1 · 2026-09-05 · 基线 client-app.html v1.120(同步 v1.81–v1.120 全部变更:机构墙全真 Logo+位次+优家备选 · C18 三段式+8 家官方口径 · 评分中心免疫首位+MISS 迷你条色板 · 健康银行余额口径 · C3 真实案例区 · 商城甄选标题归位免疫产品 Tab · 22 屏)*
+*文档版本:v2.2 · 2026-09-09 · 新增 §八 算法说明书索引(8 份独立算法 SSOT 指针 · 旧 v1.0 分册 4 标已被取代)· 原 §八 待续顺延为 §九*

+ 115 - 0
docs/算法说明书 · CFHI 家庭健康风险指数 v1.0.md

@@ -0,0 +1,115 @@
+# 算法说明书 · CFHI 家庭健康风险指数 v1.0
+
+> **系列**:客户端 APP 测评算法说明书(Tab 1 测试中心 · 8 项测评之一)
+> **实现位置**:`client-app.html`(屏 `c11` 家庭指数 · 引擎 `CFHI_ENTRY` / `CFHI_DEEP` / `CFHI_LAMBDA_Q` / `submitEntry()` / `submitDeep()`)
+> **参数单一真相源**:`shared/cfhi-params.js`(⚠️ 由 `scripts/build-cfhi-params.py` 从 `configs/cfhi-params.json` 生成,**禁止手改**)
+> **方法论 SSOT(IP 层)**:[[【助飞科技】/知识产权/文字著作/家庭健康风险指数(CFHI)/CFHI 评分标准与计分方法 v0.3.md]] —— 本文只写 APP 实现口径,方法论权属与表述以 IP 文档为准
+> **基线版本**:client-app.html v1.120 · cfhi-params v0.3.1(2026-09-05 核对:内容与实现一致 · v1.88 D6 更名 / v1.96 双子分均已收录)
+
+---
+
+## 一、概述
+
+CFHI(Chinese Family Health Risk Index)用问卷 + 检测 + 穿戴 + 行为多源数据量化家庭健康风险。客户端采用**双层题库制**:
+
+| 层 | 题量 | 时长 | 作用 |
+|---|---|---|---|
+| **Layer 1 · 入口版快测** | 14 题(7 维 × 2)+ λ 治理 2 题 | 约 3 分钟 | 建立基线,低门槛引流 |
+| **Layer 2 · 深度测评** | 31 题(7 维) | 约 15 分钟 | 覆盖入口版基线,生成短板清单,完成 +200 积分 |
+
+**覆盖优先级(按维度独立覆盖,不是整分替换)**:真实检测数据 > 深度版 > 入口版。
+
+## 二、维度与权重
+
+| 维度 | 名称 | 权重 w | 入口版题数 | 深度版题数 |
+|---|---|---|---|---|
+| D1 | 免疫基础 | **1.5** | 2 | 4 |
+| D2 | 代谢健康 | 1.0 | 2 | 5 |
+| D3 | 慢病管理 | 1.0 | 2 | 4 |
+| D4 | 家族遗传风险 | 1.0 | 2 | 4 |
+| D5 | 生活方式 | 1.0 | 2 | 5 |
+| D6 | 心理与恢复 | 1.0 | 2 | 5 |
+| D7 | 医疗可及 | 1.0 | 2 | 4 |
+
+- 每维度满分 **6 分**;加权满分 **R_max = 45**(= 1.5×6 + 6×6)
+- 短板判定:`score ≤ 2` 标红(雷达图红点 + 明细条橙色)
+
+## 三、计分公式
+
+### 3.1 选项计分
+
+每题 4 个选项,按选项序位计 **0 / 1 / 2 / 3 分**(选项按状态从差到好排列)。
+
+### 3.2 维度分
+
+```
+s_d = min(6, round( 该维合计 ÷ (该维题数 × 3) × 6 ))
+```
+
+入口版与深度版**同一公式**,只换题库。
+
+### 3.3 基线指数 P(百分制)
+
+```
+P = round( Σ( w_d × s_d ) ÷ 45 × 100 )
+```
+
+### 3.4 分级阈值(`gradeOf()`)
+
+| 分级 | 分数区间 |
+|---|---|
+| 🟢 健康完备型 | ≥ 85 |
+| 🟡 局部缺口型 | 70 – 84 |
+| 🟠 系统失衡型 | 55 – 69 |
+| 🔴 高风险型 | < 55 |
+
+## 四、λ 家庭治理系数(入口版 2 题)
+
+```
+λ = λ_机制 + λ_账户,钳制在 [0.75, 1.05]
+```
+
+**λ_机制**(健康决策机制):无 = 0.80 | 口头共识无书面 = 0.85 | 设决策人未系统化 = 0.90 | 完整治理体系 = 1.00
+**λ_账户**(建档完整度):仅 1 人建档 = −0.05 | 核心成员已建档 = 0.00 | 全员建档定期更新 = +0.05
+
+治理完备可加分(λ > 1.00),上限 1.05 而非 1.00。
+
+## 五、家庭聚合(方案 C · 短板敏感)
+
+```
+F = round( ( 0.75 × mean(P_members) + 0.25 × min(P_members) ) × λ )
+```
+
+- 均值占 75% + **最弱成员占 25%** —— 家庭分被最差成员拉低,体现「短板敏感」(2026-08-01 Jack 拍板)
+- 实现:`MINGDAO_CFHI_PARAMS.familyScore(scores, lambda)`
+- **当前客户端口径**:入口版产出 P 与 λ 展示(演示口径);深度版提交后直接覆盖 `CFHI.total = P` 并触发三屏同步刷新(c1 卡 / c6 / c11)
+
+## 六、结果输出
+
+**入口版结果页**:基线分 P + 分级 + λ 值 + 7 维明细条 + 短板提示 + 「补深度测评(+200 积分)」引导。
+
+**深度版结果页**:新基线 P + 分级 + 7 维明细(逐项显示 vs 旧基线分差)+ **短板清单**(最低 2 维,作顾问面谈提纲)+ 积分入账。
+
+**合规声明(不可删)**:D6 含 PHQ-2 / GAD-2 国际公版筛查题,结果仅为风险提示,**不构成医学诊断**。
+
+**D6 双子分(v1.96 · 呈现层)**:7 维明细 D6 行下挂「心理状态 · 问卷」(基线子分)+「恢复质量 · 数据」(动态子分,未接穿戴显示「待接入穿戴」)+ 70/30 合成注。数据驱动:`CFHI.dims[D6].subs`(`val:null` 渲染待接入态)。合成规则与总分不变,方法论见 IP v0.3.1 §5.1 呈现层补充。
+
+## 七、题库与数据文件
+
+| 资产 | 位置 | 说明 |
+|---|---|---|
+| 入口版题库 | `client-app.html` · `CFHI_ENTRY`(7 维 × 2 题)+ `CFHI_LAMBDA_Q`(2 题) | 与顾问端 `shared/cfhi-questions.js` 同源 |
+| 深度版题库 | `client-app.html` · `CFHI_DEEP`(31 题) | D3 注明「无慢病家庭按满分计」· D6 注明「筛查非诊断」 |
+| 参数 | `shared/cfhi-params.js` | 权重 / R_max / 分级阈值 / λ 选项值 / 聚合公式 |
+| 当前演示基线 | `CFHI.total = 65`(2026-08-13 入口版实测) | K 线 / 积分 / 个人 7 维为模拟演示 |
+
+## 八、已知边界
+
+1. 深度版覆盖回写目前**仅本次会话生效**,落库持久化归 Phase 2 后端
+2. 穿戴数据接入(×1.2 倍率)方向已定、未实现
+3. 复测激励(如 30 天后复测 +20)待 P1 与 CFHI 复测叙事一并设计
+
+---
+
+*文档版本:v1.0 · 2026-09-01 · Jack + Claudian*
+*文档版本:v1.0.1 · 2026-09-05 · 基线戳刷新(v1.73→v1.120 · cfhi-params v0.3.1)· 内容核对无漂移未改*

+ 94 - 0
docs/算法说明书 · CFPI 家庭保障测评 v1.0.md

@@ -0,0 +1,94 @@
+# 算法说明书 · CFPI 家庭保障测评 v1.0
+
+> **系列**:客户端 APP 测评算法说明书(Tab 1 测试中心 · 8 项测评之二)
+> **实现位置**:`client-app.html`(屏 `c15` · 引擎 `CFPI_QS` / `cfpiCalc()` / `cfpiSubmit()`)
+> **方法论 SSOT**:《CFPI 方法论 v1.0》(五维权重与阈值定稿口径)· 题库骨架 ProtectionScan v2.4 · 需求侧公式严格对齐 **IC(保险计算器)v5.1**
+> **边界**:测评引流、不做销售 —— 结果页带免责声明 + 预约顾问 CTA;产品层健康化(只推健康保障四件套,传承向产品归顾问端 1v1)
+> **基线版本**:client-app.html v1.124(2026-09-07)
+
+---
+
+## 一、题库结构(22 题 · 5 部分)
+
+每题选项直接携带数值(`vals`)——输入题为「万元」区间中值或比例/档位;**现有保障题为倍数**(v1.122 起 · ≈年收入/年支出 ×N · 教育储备为每名子女万元):
+
+| 部分 | 题数 | 采集内容 |
+|---|---|---|
+| 一 · 关于你 | 3 | 年龄段(→岁数值)· 年收入(→万元中值)· 配偶收入分担比(1.0/0.7/0.5) |
+| 二 · 资产与负债 | 4 | 房贷债务 · 年均支出 · 经营贷/担保 · 流动资产(6 档) |
+| 三 · 子女与教育 | 3 | 子女人数 · 教育规划方向(→单子女教育金 50-350 万)· 已备教育储备(**v1.122 起按每名子女万元计**) |
+| 四 · 现有保障 | 8 | **定期寿险(≈年收入 ×N → D2)+ 终身寿险(≈年支出 ×N → D3)· v1.123 拆两题** · 重疾 / 意外保额(≈本人年收入 ×N 倍自评)· 高端医疗档(0/0.5/1)· 境外保单(≈家庭年支出 ×N 倍)· 养老储备(≈年收入 ×N 倍)· **保费占比(钟形值)** |
+| 五 · 移民专项 | 4 | 移民身份状态 · 境外资产占比 · 信托架构 · 跨境传承认知 |
+
+## 二、需求侧公式(对齐 IC v5.1)
+
+设:收入 `salary`(万)、年龄 `age`、分担比 `share`、债务 `debt`、年支出 `annualExp`、流动资产 `liquid`(万):
+
+| 需求项 | 公式 |
+|---|---|
+| 重疾 | `salary × 3` |
+| 意外 | `salary × 5`;**HNW**(流动资产 ≥ 5,000 万)→ `× 3` |
+| 高端医疗 | 固定 800 万档(二值需求) |
+| 寿险(DIM) | `max(0, debt + salary × max(0.3, share) × (60 − age) − liquid)` |
+| 教育金 | `子女人数 × 单子女教育金` |
+| 养老年金 | `max(0, salary×0.70/12 − 1.2万社保) × 12 × 年金因子`;年金因子 = `(1−1.03⁻³⁰)/0.03`(60→90 岁 30 年 · 通胀=折现率 3%) |
+
+## 三、覆盖侧与五维合成
+
+**覆盖率**:各项 `min(1, 已有 ÷ 需求)`;医疗按档直取(无=0 / 百万医疗=0.5 / 800 万高端档=1);**定寿层覆盖 = 境内定期寿 + 境外保单合并计**(境外储蓄险兼具身故杠杆);**终身寿不计入定寿层,归 D3 高端层**(v1.123 拆题后分层归位)。
+
+**已有保额的量化口径(v1.122 起 · Jack 拍板 B 方案)**:不再用固定万元档,改**倍数自评**——寿险/重疾/意外/养老 = `倍数 × 本人年收入`,境外保单 = `倍数 × max(家庭年支出, 40万)`(下限与 D3 需求 200 万地板对齐),教育储备 = `每名子女万元 × 子女数`。**v1.123 起**:原「境内寿险(定期寿+终身寿)」合并题拆为两题——定期寿(≈年收入 ×3/×5/×10)归 D2 定寿层、终身寿(≈家庭年支出 ×1/×3/×5)归 D3 高端层;拆题前终身寿被错计进定寿层,且 D3/终身层只剩境外保单单一数据源(无境外保单 = 终身层永 0 · Jack 报障)。根因:旧固定档上限(寿险 700 万 / 重疾 150 万)与 IC v5.1 需求公式(收入×3 / DIM → 典型需求数千万)量纲失配,高收入家庭选最高档覆盖率仍≈0、全最优答卷仅 65 分永远到不了 🟢(用户感知「寿险选了等于没选」);改后与需求同量纲、天然随收入缩放(全最优 → 96 🟢)。
+
+| 维度 | 权重 | 合成 |
+|---|---|---|
+| D1 基础保障(意外/医疗/重疾) | **35%** | (重疾% + 意外% + 医疗档)÷ 3 |
+| D2 中端保障(定寿/教育/养老) | **25%** | (定期寿% + 教育% + 养老%)÷ 3 |
+| D3 高端保障(终身寿/境外保单) | **15%** | `min(1, (境内终身寿 + 境外保单) ÷ max(200万, 5×年支出))` · v1.123 起终身寿有独立数据源 |
+| D4 结构均衡 | **10%** | `(1 − 三层标准差/0.5)×min(1,三层均值/0.05)×0.7 + min(1,(持有险种数−2)/5)×0.3`,截断 [0,1](v1.123 险种数上限 6→7 · +终身寿;**v1.124 均衡项软缩放**——三层全空时「无单点缺失」真空成立拿满 0.7 属逻辑漏洞(实测 D4=58 白拿 5.8 分),三层均值 <5% 视为无结构、均衡项按比例归零,全空→0 · ≥5% 全额 · 连续无跳变 · Jack 拍板) |
+| D5 保费可负担 | **15%** | 钟形直取:5%–15% = **1.0** | <5% = 0.6 | 15%–25% = 0.7 | >25% = 0.4 |
+
+```
+CFPI = round( 35·D1 + 25·D2 + 15·D3 + 10·D4 + 15·D5 )   (百分制)
+```
+
+## 四、分级与优先级
+
+| 分级 | 分数 |
+|---|---|
+| 🟢 充足 · Well-Protected | ≥ 80 |
+| 🟡 基本 · Adequate | 60 – 79 |
+| 🟠 不足 · Under-Protected | 40 – 59 |
+| 🔴 严重缺口 · Critical Gap | < 40 |
+
+**保额缺口与优先级**:一次性赔付层 = 意外 + 医疗 + 重疾 + 寿险(对齐 IC `totalOnetimeCoverage`);`covRate = 已有合计 ÷ 需求合计` → <0.4 = 🔴 P0(7 天内必须推进)| <0.6 = 🟡 P1(30 天窗口)| 其余 🔵 P2 常规。
+
+## 五、结果页输出
+
+1. **总分卡**:CFPI 得分 + 分级 + 保额缺口(需求/现有对比)
+2. **五维诊断条**:D1-D5 各得分 + 权重标注
+3. **保障金字塔卡**(v1.95 起):共享渲染器 `mingdaoPyramidSVG`(C15/C16 复用 · 错题#11 共享优先)——层级严格对齐顾问端 IC 风险金字塔(尖→底:终身寿/境外 → 养老年金 → 教育金 → 定寿 → 意外/医疗/重疾底三格);CFPI 七层全有真实数据(终身寿/境外层 = D3 高端覆盖率 · 教育年金有真实覆盖率,**无灰槽**);卡右上「动态」开关(`PYR_ANIM` per key · ON = 水位涨起 SMIL 动画 / OFF = 静态)
+4. **跨境配比诊断**:移民身份 4 档 → 建议境外配比(无身份 20% / 规划中 35% / 已有身份 50%)
+5. **健康保障四件套**(触发式):重疾(覆盖率 <0.8)· 高端医疗(档 <1)· 意外(<0.65)· 养老年金(始终展示)——文案与 CFHI/MISS 健康管理联动
+6. **双指数联动话术**:CFHI(动态取 `CFHI.total` · `CFHI.qual`,v1.74 起不再硬编码)× CFPI 双预警
+7. **预约顾问 CTA**(v1.97 起 · 真预约框,替代原 alert 微信号):step1 险种多选(6 项 · **按测评缺口自动预选**)→ step2 手机号(11 位校验 + 隐私口径)→ 线索存 `md_leads_v1`(字段对齐后端 · Phase 2 觅哥接入)
+8. **免责声明**:结果仅供参考,不构成保险销售建议;以你的专属顾问一对一服务及持牌代理人核保结果为准(2026-09-05 全库统一口径 · Jack 拍板)
+
+## 六、结果登记与示例态
+
+- 真实作答 → 写 `TEST_RESULTS.cfpi`(c2「其他测试结果」卡显示得分与分级)
+- 访客态示例:`CFPI_DEMO_ANS`(22 题版 · 高缺口中年家庭画像 · CFPI 27 🔴 · 终身寿=未配置)自动预填并出结果,写 `DEMO_RESULTS`(c2 标「示例」);用户点任一选项自动清示例转真实作答
+- **重新测评健壮性**(v1.91 修复):曾因 KQ 示例作答的锁定选择器未限定作用域,把 `.locked` 误打到 CFPI/ICQ/HI 同 `data-q` 选项上(真实点击被吞 · 静态验证查不出,真实鼠标 hit-test 才暴露)——修复 = kqPick 选择器限定 `#kqBody` + cfpi/icq/hi 三套 reset 防御性清 `locked/correct/wrong`
+
+## 七、已知边界
+
+1. 选项数值为区间中值粗算(如年收入 100–300 万取 200);已有保额为倍数自评粗估(v1.122 起)——精度归「测评」不归「精算」;精算走顾问 1v1
+2. 保费占比题(D5)直取用户自报档位,无交叉校验
+3. 社保养老金按 1.2 万/月固定值扣减,未分地区
+
+---
+
+*文档版本:v1.0 · 2026-09-01 · Jack + Claudian*
+*文档版本:v1.1 · 2026-09-05 · 同步 v1.91 重测修复 / v1.95 保障金字塔卡 / v1.97 真预约框 · 基线 v1.120*
+*文档版本:v1.2 · 2026-09-07 · 覆盖侧改倍数自评口径(v1.122 · Jack 拍板 B 方案)· 基线 v1.122*
+*文档版本:v1.3 · 2026-09-07 · 寿险拆定期/终身两题(21→22 · v1.123 · Jack 拍板)修 D3 终身层永 0 · 基线 v1.123*
+*文档版本:v1.4 · 2026-09-07 · D4 均衡项软缩放修「全空也算均衡」(v1.124 · Jack 拍板)· 基线 v1.124*

+ 70 - 0
docs/算法说明书 · 保额快速测算(IC Lite)v1.0.md

@@ -0,0 +1,70 @@
+# 算法说明书 · 保额快速测算(IC Lite)v1.0
+
+> **系列**:客户端 APP 测评算法说明书(Tab 1 测试中心 · 8 项测评之三)
+> **实现位置**:`client-app.html`(屏 `c16` · 引擎 `ICQ_QS` / `icqCalc()` / `icqSubmit()`)
+> **算法血缘**:IC(保险计算器)v5.1 内核的**粗算映射**(Whoop 轻量档)——选项区间中值近似,精算归顾问端 IC 完整版(27 字段)
+> **与 CFPI 的分工**:CFPI 给**指数**(五维结构分),本测算给**数字**(各险种缺口金额);两结果互链
+> **基线版本**:client-app.html v1.122(2026-09-07)
+
+---
+
+## 一、题库结构(10 题 · 3 步)
+
+| 步 | 题数 | 采集内容(→数值) |
+|---|---|---|
+| 一 · 关于你 | 3 | 年龄(→岁)· 年收入(→万)· 配偶分担比(1.0/0.7/0.5) |
+| 二 · 家庭责任 | 2 | 负债总额 · 流动资产(6 档) |
+| 三 · 现有保障 | 5 | 重疾 / 意外 / 寿险已有保额(**v1.122 起 = ≈本人年收入 ×N 倍自评**)· 高端医疗档(0/0/1 二值)· 养老储备(≈年收入 ×N 倍) |
+
+> v1.24 逻辑修正后补齐意外/医疗/养老储备三问——此前漏问导致**医疗缺口永远满额误报**。
+
+## 二、五险种需求公式(IC v5.1 口径)
+
+| 险种 | 需求公式 | 缺口 |
+|---|---|---|
+| 重疾 | `salary × 3` | need − 已有重疾(= 倍数 × salary · v1.122) |
+| 高端医疗 | 固定 800 万档 | 已有 800 档 → 0;否则 800 |
+| 意外 | `salary × 5`;HNW(流动资产 ≥5,000 万)→ `× 3` | need − 已有意外 |
+| 寿险(DIM) | `max(0, 负债 + salary × max(0.3, 分担比) × (60−年龄) − 流动资产)`(收入不折现,IC 默认 `incomeDiscountRate=0`) | need − 已有寿险 |
+| 养老年金 | `max(0, salary×0.70/12 − 1.2万社保) × 12 × PV年金因子(3%, 30年≈19.6)` | need − 已有养老储备 |
+
+## 三、保障完整度评分
+
+```
+完整度 = round( min(1, 一次性赔付层已有合计 ÷ 需求合计) × 100 )
+一次性赔付层 = 意外 + 医疗 + 重疾 + 寿险(对齐 IC totalOnetimeCoverage · 养老属长周期层不计入)
+各险种已有超出需求的部分截断不计(min 逐项封顶)
+```
+
+**已有保额的量化口径(v1.122 起 · Jack 拍板 B 方案)**:已有保额题从固定万元档改 **≈本人年收入 ×N 倍**自评(重疾 ×1-4 / 意外 ×2-10 / 寿险 ×3-15 / 养老 ×1-8)。根因:旧固定档上限(寿险 1,200 万 / 重疾 400 万)与 IC v5.1 需求公式(收入×3 / DIM → 数千万)量纲失配,全最优答卷完整度仅 27 还显示「保障脆弱」(Jack 报障「寿险选了等于没选」);改后与需求同量纲、天然随收入缩放(全最优 → 100,寿险档灵敏度 22→69)。
+
+**评分话术**:≥80 保障底盘扎实 | 60–79 基础覆盖已有 | 40–59 缺口明显 | <40 保障脆弱。
+
+## 四、结果页输出
+
+1. **完整度环形图**(SVG 圆环 · 四档配色 绿/金/橙/红)+ 重疾/意外/寿险缺口速览 + Hero 测算口径行(本人 + 家庭年收入口径 · v1.93)
+2. **保障金字塔**(v1.93-v1.95 · 顾问端同款分险种水位图):层级严格对齐顾问端 IC 风险金字塔——尖 终身寿(**灰层** · 传承归顾问 1v1)→ 养老年金 → 教育年金(灰层 · 联动 CFPI)→ 定寿 → 底三格 意外/医疗/重疾;共享渲染器 `mingdaoPyramidSVG`(C15/C16 复用 · 错题#11 共享优先);卡右上「动态」开关(`ICQ_ANIM` · ON = 水位涨起 SMIL 动画 / OFF = 静态)
+3. **最该先补 Top 3**:排序键 = **金字塔层序**(基础层 意外/医疗/重疾 → 长期层 → 责任层 · 层内金额降序 · v1.92)——旧逻辑长期层年金(30 年现金流天然大额)永远顶掉基础层缺口;**基础层内推荐固定序 意外→医疗→重疾**(保费阶梯 = 行动门槛从低到高 · 基础层三者皆必须有、金额排序是噪声 · v1.96);**寿险动态例外**:缺口>0 且(负债>0 或配偶无收入)→ 提至长期层前;⚠️ 医疗 800 万为年报销额度档位非现金缺口,卡片文案单列不与其他险种比价;意外卡文案点破大/小意外(v1.96)
+4. **建议补充的全部保障**清单(全部 gap>0 险种 · 同层序 · v1.92)
+5. **紧迫性提示**:年龄 ≥45 触发「为什么是现在」(费率上行 · 核保趋严 · 今年配省 20–40% 总保费)
+6. **CFPI 互链**:已完成 CFPI 则显示其指数卡(「指数看结构,本报告给数字」);子女教育金文案联动 CFPI(不加题 · v1.92)
+7. **免责声明**:粗算口径(10 题简版)仅供参考,不构成保险销售建议;以你的专属顾问一对一服务及持牌代理人核保结果为准(2026-09-05 全库统一口径 · Jack 拍板)
+8. **CTA**:「预约你的专属财富管家」真预约框(v1.97 起 · 替代原 alert 微信号)——step1 险种多选(6 项 · **按测算缺口自动预选**)→ step2 手机号(11 位校验 + 隐私口径)→ 线索存 `md_leads_v1`(字段对齐后端 · Phase 2 觅哥接入)
+
+## 五、结果登记与示例态
+
+- 真实作答 → `TEST_RESULTS.icLite`(c2「其他测试结果」卡:保障完整度 + 话术)
+- 访客态示例:`ICQ_DEMO_ANS`(50 岁 · 年收入 50-100 万档 · 部分覆盖 · 完整度 21 · v1.122 倍数目径重调:示例意外档 ×5→×2)自动预填出结果,写 `DEMO_RESULTS`;点任一选项转真实作答
+- **重新测评健壮性**(v1.91 修复):曾因 KQ 示例作答的锁定选择器未限定作用域,把 `.locked` 误打到 CFPI/ICQ/HI 同 `data-q` 选项上(真实点击被吞)——修复 = kqPick 选择器限定 `#kqBody` + cfpi/icq/hi 三套 reset 防御性清 `locked/correct/wrong`
+
+## 六、已知边界
+
+1. 区间中值近似(如负债 100–500 万取 300)+ 已有保额倍数自评粗估(v1.122 起)——刻意粗算,引导转 IC 完整版
+2. 完整度只算一次性赔付层,养老缺口不进分母(长周期层),避免「没存养老金就把完整度打到 0」
+3. 不采集子女数/父母赡养(IC 完整版的子女 100万/人、父母 50万/位口径在简版中并入负债与收入替代)
+
+---
+
+*文档版本:v1.0 · 2026-09-01 · Jack + Claudian*
+*文档版本:v1.1 · 2026-09-05 · 同步 v1.91 重测修复 / v1.92 层序排序+全量补充清单 / v1.93-95 保障金字塔水位图 / v1.96 基础层固定序 / v1.97 真预约框 / 免责语统一 · 基线 v1.120*
+*文档版本:v1.2 · 2026-09-07 · 覆盖侧改倍数自评口径(v1.122 · Jack 拍板 B 方案)· 基线 v1.122*

+ 49 - 0
docs/算法说明书 · 免疫健康知识测试(KQ)v1.0.md

@@ -0,0 +1,49 @@
+# 算法说明书 · 免疫健康知识测试(KQ)v1.0
+
+> **系列**:客户端 APP 测评算法说明书(Tab 1 测试中心 · 8 项测评之五)
+> **实现位置**:屏 `c10`(引擎在 `client-app.html` · `KQ` / `kqPick()` / `kqSubmit()`)
+> **题库来源**:《免疫力是第一生命力》李先亮(核心概念科普向)
+> **性质**:科普教育 + 判对错即时反馈 —— 不是健康评估,不产生健康分数,结果不进 CFHI
+> **基线版本**:client-app.html v1.76
+
+---
+
+## 一、题库结构(20 题)
+
+- 单选 · 每题 4 选项 · 含正确答案索引 `a` 与解析 `exp`
+- 内容域:免疫系统基础(三道防线 / NK 细胞 / 胸腺 / 免疫监视)· 免疫平衡理念(MISS ±25 · 平衡区 −3~+3)· 亚健康认知(WHO 第三状态 ~70-75% · 四大恶因)· 免疫体检 vs 常规体检(双体检叙事)
+- 题目顺带完成品牌教育:MISS 评分尺、免疫双体检、「做对检查」等核心叙事全部植入题干与解析
+
+## 二、判分机制(逐题即时反馈)
+
+- 点选即判:选对 → 绿色 `correct` 样式 + 展开解析;选错 → 红色 `wrong` 样式 + 展开解析(含正确答案说明)
+- 判后该题锁定(`locked`,不可改答)
+- 计分:`c = 答对题数`,`r = c ÷ 20`,`score100 = round(r × 100)`
+
+## 三、段位分级
+
+| 段位 | 正确率 |
+|---|---|
+| 🏆 免疫达人 | ≥ 85%(≥17/20) |
+| 🌿 健康新知者 | 60% – 84% |
+| 📖 入门学习者 | 40% – 59% |
+| 🌱 起步阶段 | < 40% |
+
+## 四、结果页输出
+
+段位图标 + 名称 · 「X / 20 答对」 · 知识得分 X / 100。逐题解析在答题过程中已展示(结果页不重复)。
+
+## 五、结果登记与示例态
+
+- 真实作答 → `TEST_RESULTS.kq`(c2「其他测试结果」卡:段位 + 答对 X/20)
+- 访客态示例:前 13 题答对 + 后 7 题答错(13/20 · 🌿 健康新知者),逐题解析全展示,写 `DEMO_RESULTS`;点任一选项转真实作答
+
+## 六、已知边界
+
+1. 无防刷/无计时,纯科普定位,不追求测量学严谨性
+2. 解析文本含品牌叙事植入,改题库需同步审解析话术
+3. 结果不与任何健康指数联动(与 CFHI/MISS 隔离,避免「知识分」被误读为「健康分」)
+
+---
+
+*文档版本:v1.0 · 2026-09-01 · Jack + Claudian*

+ 63 - 0
docs/算法说明书 · 家族健康投入测试(HI)v1.0.md

@@ -0,0 +1,63 @@
+# 算法说明书 · 家族健康投入测试(HI)v1.0
+
+> **系列**:客户端 APP 测评算法说明书(Tab 1 测试中心 · 8 项测评之四)
+> **实现位置**:屏 `c9`(客户端引擎在 `client-app.html` · `hiSubmit()`)
+> **题库单一真相源**:`shared/health-investment-questions.js`(**顾问端共用** · 客户端取 `client:true` 子集 · 英文版 `health-investment-questions-en.js`)
+> **性质**:选卡工具(与健康状态无关)——测的是「家庭对健康投入的意愿与结构」,输出推荐健康套餐档位
+> **基线版本**:client-app.html v1.75 · HI 题库共享版
+
+---
+
+## 一、题库结构(客户端精简版 16 题 · 7 维度)
+
+| 维度 | 英文名 | 客户端题数 | 客户端满分 | 说明 |
+|---|---|---|---|---|
+| 1 健康认知 | Awareness | 2 | 6 | 家族对健康管理的重视与认知深度 |
+| 2 年度预算 🔑 | Budget | 2 | 16 | 当前/计划的年度健康支出规模 |
+| 3 现有投入 | Baseline | 2 | 6 | 已购检测/体检/健康险/生活方式 |
+| 4 时间投入 | Time | 2 | 6 | 愿投入的运动/随访/管理时间 |
+| 5 家庭覆盖 | Coverage | 2 | 6 | 覆盖几代几口人(家庭 vs 个人) |
+| 6 支付意愿 🔑 | Willingness | 3 | 18 | 对高端健康服务/套餐的支付意愿 |
+| 7 高端医疗资源 🔑 | Resources | 3 | 10 | 私人医生/绿通/海外医疗触达层级 |
+
+- 🔑 = 关键维度(`key:true`)
+- **客户端满分 `HI_CLIENT_MAX = 68`**(由题库 `client:true` 子集动态汇总,非写死);顾问端全量满分 112
+- 每题选项各带 `score` 分值,单选直加
+
+## 二、计分与归一化
+
+```
+原始分 score = Σ 所选选项 score
+百分比 pct = score ÷ HI_CLIENT_MAX        (分层判定用)
+展示分 score100 = round(pct × 100)        (纯展示口径)
+```
+
+## 三、分型与套餐推荐(`HI_TIERS` · 按 pct 降序匹配)
+
+| 分型 | 区间 | 推荐 | 销售动作 |
+|---|---|---|---|
+| 🌐 深度投入型 Deep Investor | ≥ 80% | **企业家健康套餐 ¥100 万** | 讲联盟服务网络 + 双向权益互通 |
+| 👨‍👩‍👧 家庭主导型 Family-Led | 60% – 79% | **家庭健康套餐 ¥30 万** | 讲全家覆盖 + 代际风险 |
+| 🌱 初步意识型 Emerging | 40% – 59% | **个人健康套餐 ¥10 万** | 先自试引流 |
+| 💤 待唤醒型 Dormant | < 40% | 免费小测验(无直接成交品) | 认知教育;承接钩子 = 入会后解锁永活水周期套餐(¥3,744 起 · 年装 8 折) |
+
+> 待唤醒型**不做断头漏斗**:不给付费卡面,给低成本入会理由(钩子随 SKU 调整,勿指向已下架 SKU)。
+
+## 四、结果页输出
+
+分型图标 + 名称 → 「为你推荐」套餐卡(档位 + 价格;待唤醒型换水套餐钩子)→ 健康投入得分 X / 100 → CTA 选套餐(→ `c5`)。
+
+## 五、结果登记与示例态
+
+- 真实作答 → `TEST_RESULTS.hi`(c2「其他测试结果」卡:分型 + 推荐档位 + 百分制分)
+- 访客态示例:每题自动选第 2 档,分型由引擎实时算出(写 `DEMO_RESULTS` 标「示例」);点任一选项转真实作答
+
+## 六、已知边界
+
+1. 分层按**百分比**而非绝对分——客户端/顾问端题量不同但分型口径一致(68 与 112 各自归一)
+2. 题库改动会改变 `HI_CLIENT_MAX`,分型阈值不受影响(百分比制),但历史百分制得分不可比
+3. 共享文件顾问端也在用——改题库/分型**两端同步生效**,改动需先知会顾问端
+
+---
+
+*文档版本:v1.0 · 2026-09-01 · Jack + Claudian*

+ 50 - 0
docs/算法说明书 · 铭道健康信息表 v1.0.md

@@ -0,0 +1,50 @@
+# 算法说明书 · 铭道健康信息表 v1.0
+
+> **系列**:客户端 APP 测评算法说明书(Tab 1 测试中心 · 8 项测评之六)
+> **实现位置**:c1 报纸卡 FORM·01 → 屏 `c14`(通用问卷引擎 `FORMS.health` / `renderForm()` / `submitForm()`)
+> **数据来源**:铭道《健康信息表 1.0》原始文档忠实录入
+> **⚠️ 当前口径**:原始文档未定义算分规则 → **提交仅做完成统计**;本文 §四 为 Claudian 推断方案,**未经铭道/李主任书面确认前不得进对客 UI**
+> **基线版本**:client-app.html v1.78
+
+---
+
+## 一、题库结构(36 题 · 2 部分)
+
+| 部分 | 题数 | 题型 | 内容 |
+|---|---|---|---|
+| 一 · 基本信息 | 15 | 填空 8 / 单选 3 / 多选 4 | 身份与体征(姓名/性别/年龄/身高体重等)· 行动与精神状态 · 慢病史 · 过敏史 · 手术史 · 家族史 · 长期用药 |
+| 二 · 免疫平衡自评 | 20 + 1 开放 | **5 级李克特单选** + 开放填空 | 近期身体状况 20 题(从来没有/偶尔发生/经常发生/总是如此/非常明显) |
+
+## 二、当前机制
+
+- 通用问卷引擎:题型 `sec/text/radio/check` · 进度计数 · 全部作答后开放提交
+- **草稿机制**:会话 + `localStorage` 双写(`md_form_health`),中途返回不丢答案,提交后清草稿
+- 提交 = 完成统计;不写 `TEST_RESULTS`,不进任何指数
+
+## 三、数据用途定位
+
+第一部分 = **家族健康档案**的原始录入(供顾问端建档与画像用);第二部分 = 免疫平衡主观负荷采集。
+
+## 四、推断算分方案(⚠️ 待铭道书面确认)
+
+**结构推断依据**:第二部分是标准 5 级李克特量表,且 c2b 展示层已预留 6 个维度条(免疫抵抗力/精力体力/睡眠质量/情绪压力/消化代谢/皮肤毛发 · `dir:'good'` 高分好)。
+
+```
+题目负荷 ℓ ∈ {0,1,2,3,4}(从来没有=0 … 非常明显=4)
+维度得分_d = 维内题目负荷均值 ÷ 4 × 100(20 题按题意归入 6 维)
+健康综合分 = 100 − (Σℓ ÷ (20×4)) × 100     (good 向 · 高分 = 状态好)
+```
+
+维度归映射(提案):睡眠 ← 失眠/熬夜/盗汗/畏寒 4 题 | 情绪压力 ← 注意力/易怒/焦虑/情绪低落 4 题 | 消化代谢 ← 食欲/便秘/酒量/体重 4 题 | 皮肤毛发 ← 肤色色斑/头发 2 题 | 精力体力 ← 精力疲惫/手脚发凉/心悸胸闷 3 题 | 免疫抵抗力 ← 易感冒/不适疼痛/内分泌紊乱 3 题。
+
+**第一部分不进分**,全部归档案。
+
+## 五、已知边界
+
+1. 推断方案的维度归并与方向(good/risk)需铭道确认;确认前 c2 得分卡保持演示数据
+2. 填空题(身份证号等)有合规采集敏感性,存储与脱敏归后端 Phase 2 一并设计
+3. 自评量表与 MICA 客观检测的关系:自评负荷高 ≠ 免疫失衡,两端数据口径需在报告层对齐
+
+---
+
+*文档版本:v1.0 · 2026-09-01 · Jack + Claudian*

+ 48 - 0
docs/算法说明书 · 铭道肿瘤风险评估表 v1.0.md

@@ -0,0 +1,48 @@
+# 算法说明书 · 铭道肿瘤风险评估表 v1.0
+
+> **系列**:客户端 APP 测评算法说明书(Tab 1 测试中心 · 8 项测评之八)
+> **实现位置**:c1 报纸卡 FORM·03 → 屏 `c14`(通用问卷引擎 `FORMS.tumor`)
+> **数据来源**:铭道《肿瘤筛查表 1.0》原始文档忠实录入
+> **⚠️ 当前口径**:原始文档未定义算分规则 → **提交仅做完成统计**;本文 §四 推断方案的**权重分配属医学判断,必须铭道/李主任定**,本文只给结构不给权重值
+> **基线版本**:client-app.html v1.79
+
+---
+
+## 一、题库结构(29 题 · 3 部分)
+
+| 部分 | 题数 | 题型 | 内容 |
+|---|---|---|---|
+| 基本信息 | 5 | 填空/单选 | 姓名 · 性别 · BMI 档 · 年龄档 · 血型 |
+| 生活方式与饮食 | 11 | 单选/多选 | 锻炼 · 盐/热烫/烟熏/腌制/粗纤维/红肉饮食 · 吸烟 · 饮酒 · 睡眠 · 情绪 |
+| 风险暴露与病史 | 12 + 1 开放 | 单选 + 多选清单 | 重大负性事件 · 类固醇/免疫抑制剂 · 接触暴露 · **消化系统 22 项 / 呼吸系统 12 项 / 妇科 12 项 / 男性泌尿 11 项 / 乳腺 12 项专科清单** · 皮肤/碘 · 确诊恶性肿瘤史 · 家族肿瘤史(一级/二级亲属) |
+
+特点:**不是李克特量表,是风险因子清单**——多选清单题占比大,专科按性别分流(妇科/乳腺 vs 男性泌尿)。
+
+## 二、当前机制
+
+同健康信息表(c14 通用引擎 + 草稿双写 `md_form_tumor`)。提交 = 完成统计,不进任何指数。
+
+## 三、推断算分方案(⚠️ 结构可推断 · 权重必须铭道定)
+
+**结构推断**:风险因子计数/加权法(c2b 展示层 `dir:'risk'` 高分差已预留):
+
+```
+风险指数 = Σ 命中因子权重 w_i → 归一化 0-100(risk 向)
+分层(提案):低 / 中 / 高风险三档(阈值待定)
+```
+
+**必须铭道回答的问题**:
+1. 各因子权重(如:确诊恶性肿瘤史 / 一级亲属家族史应为重权;生活方式因子轻权)
+2. 保护性因子是否减分(粗纤维/不烟酒/从不熬夜)
+3. 性别专科清单是否只计对应性别(v1.79 起 UI 层已按性别路由,只存在对应性别的作答;算分侧自然继承)
+4. 年龄/BMI 是进分还是作校正系数
+
+## 四、已知边界
+
+1. ~~专科清单无性别路由~~ ✅ 已修(v1.79:妇科/乳腺仅女性 · 男性泌尿仅男性 · 未答性别先隐藏)
+2. 「两年内重大负性事件」等心理社会因子的权重争议大,属于典型的专家拍板项
+3. 肿瘤风险分敏感度高,对客呈现话术(避免恐吓)需与分数一起过审
+
+---
+
+*文档版本:v1.0 · 2026-09-01 · Jack + Claudian*

+ 48 - 0
docs/算法说明书 · 长新冠调查问卷 v1.0.md

@@ -0,0 +1,48 @@
+# 算法说明书 · 长新冠调查问卷 v1.0
+
+> **系列**:客户端 APP 测评算法说明书(Tab 1 测试中心 · 8 项测评之七)
+> **实现位置**:c1 报纸卡 FORM·02 → 屏 `c14`(通用问卷引擎 `FORMS.covid`)
+> **数据来源**:《长新冠调查问卷_2025》原始文档忠实录入
+> **⚠️ 当前口径**:原始文档未定义算分规则 → **提交仅做完成统计**;本文 §四 为 Claudian 推断方案,**未经铭道/李主任书面确认前不得进对客 UI**
+> **基线版本**:client-app.html v1.78
+
+---
+
+## 一、题库结构(25 题 · 4 部分)
+
+| 部分 | 题数 | 题型 | 内容 |
+|---|---|---|---|
+| 一 · 基本信息 | 5 | 填空/单选/多选 | 姓名 · 性别 · 年龄段 · 职业 · 基础疾病 |
+| 二 · 新冠感染情况 | 8 | 单选为主 + 多选症状 | 感染史(**未感染 → 跳至第 12 题**)· 次数 · 疫苗 · 首染时间 · 发热/合并感染/免疫治疗史 |
+| 三 · 首阳后 2 个月内 | 2 | 单选 + 多选(17 项症状清单) | 恢复时长 · 残留不适 |
+| 四 · 感染后 6 个月至 2 年以上(按系统) | **10** | **5 级李克特单选**(从来没有/偶尔/时常/总是/非常明显) | 消化 / 呼吸 / 循环 / 中枢神经 / 自主神经 / 内分泌 / 免疫 / 血液 / 运动 / 泌尿生殖 十大系统 |
+
+## 二、当前机制
+
+同健康信息表(c14 通用引擎 + 草稿双写 `md_form_covid`)。提交 = 完成统计,不进任何指数。
+
+## 三、数据用途定位
+
+二、三部分 = 感染史与急性期背景(定性);**第四部分 = 长新冠症状负荷的量化主体**(10 系统 × 5 级,是天然的计分结构)。
+
+## 四、推断算分方案(⚠️ 待铭道书面确认)
+
+**结构推断依据**:第四部分 10 系统 × 5 级李克特,且 c2b 展示层已按「多系统症状负荷」预留(`DETAIL.covid dir:'risk'` 高分差)。
+
+```
+系统负荷_d = 级位(0-4) ÷ 4 × 100          (10 个系统各一条)
+长新冠症状负荷指数 = 10 系统负荷均值(0-100 · risk 向 · 高分 = 负荷重)
+跳题规则:第二部分「未感染」→ 第四部分按 0 负荷计(或无暴露不评分,二选一待确认)
+```
+
+**一/二/三部分不进分**,作感染史背景档案;未感染者的「长新冠指数」语义需铭道定义(建议:不产出分数,标注「无感染史」)。
+
+## 五、已知边界
+
+1. 5 级档距是否等距(从来没有→非常明显)属量表假设,需确认
+2. 「是否接受免疫治疗」等题与负荷分的交互(治疗可能压症状)未建模
+3. 与 MICA 免疫检测的关系:长新冠人群是 MICA 的适配人群之一,问卷负荷高 → 建议检测,转化话术归顾问端
+
+---
+
+*文档版本:v1.0 · 2026-09-01 · Jack + Claudian*