文档性质:系统说明书(重写版)· 逐步增补 —— 本版覆盖「总体设计 + 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 模块全家桶)分离,客户端刻意做减法 + 引流钩子前置。
client.mdmed.com.cn底部 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 不受影响;首/末位菜单左/右对齐防溢出手机框。
定位:Step 1 · 旅程入口。承担「让客户先测起来」的引流职责——建议全部完成以获取最完整免疫画像。
① 四大健康测试卡区(test-grid,JS 由 TESTS 数组渲染):
| 卡 | 样式 | 点击去向 |
|---|---|---|
| 🏠 CFHI 家庭健康风险指数 | 全宽卡(右侧大得分与 c11 同源 · 当前 65) | → c11 家庭指数(评分中心) |
| 🌿 健康信息表 | 报纸卡 FORM·01(一排三列) | → c14 问卷页(真实问卷) |
| 🫁 长新冠调查问卷 | 报纸卡 FORM·02 | → c14 |
| 🧬 肿瘤风险评估 | 报纸卡 FORM·03 | → c14 |
| 🛡️ MICA+MISS 免疫评估 | 全宽卡(右侧 MISS 评分 −10 · 演示值) | → c20 验血预约屏 |
② 其他测试 · 非健康状态评估(分隔线下 4 个入口条):
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 单卡 · 三段分组 · 默认收起):
c5 会员权益)④ 家族健康资产 · 两大传承工具:
showPortrait(Hx) → c17 画像详情(特征 + 建议干预方案)c6 真实谱系⑤ MICA+MISS 免疫评估屏(c20 · 点免疫评估卡进入):顶部验血预约 Hero(明示「不通过问卷评估 · 需采血化验」· 健康顾问安排采血 · 1-2 周出报告含专家一对一解读 · 预约 CTA)→ 下方体系介绍:
buildImmuneRuler 渲染)⑥ 底部 CTA:「完成后查看综合评分 →」→ c2
测试中心 Tab 上拉菜单 7 项直达:CFHI 指数 / 健康信息表 / 长新冠问卷 / 肿瘤风险评估 / MICA+MISS 免疫评估 / CFPI / 保额测算。
定位:Step 2 · 我的结果。测试的「收成」页——四大检测独立评分 + 家庭层 CFHI 指数 + 积分激励闭环。三个屏共用顶部子 Tab(我的评分 / 家庭指数 / 健康银行),健康银行子 Tab 带积分余额角标(打卡入账时跳动动画)。
DET_META 驱动,点任一卡进 c2b;首位 = MICA+MISS 免疫评估——免疫力检测是健康家办核心):
-25 / 0 / +25 + 状态标签(如「中度抑制 · MISS」);卡面分值与 c2b 详情大数字同源(dets[] 免疫位 = m.miss)口径:「我的评分」只显示当前登录用户本人,家人得分归 c6 家族总览。
随所选检测切换内容(openDetail(detKey)):
-25/+25 与 0 同级加重显示);其余三项检测无 ±25 评分,此卡隐藏叙事:「用华尔街量化的方法管健康」· 体检+检测+穿戴+行为多源综合打分。
TEDx 叙事:每个健康行为 = 健康银行存款 · 可兑换真金白银。
c21)定位:Step 3 · 这是什么。品牌与服务体系的信任建设页——回答「健康家办是什么、凭什么信你、入会能得到什么」。
自上而下 8 个区块:
assets/orgs/ · 白底 contain · 背景统一纯白),位次:铭道众缘 / 助飞科技 / 国测会展 / 利世国际 | 贝净海洋 / 法盛长寿 / 健和九州 / 天九 GSO(国测在利世左侧、健和在国测原位),点击 showOrg() → c18 机构详情。优家健康(AlphaCare · 香港)为第 9 家备选——机构方尚未确认,墙格与 ORGS 条目均注释保留(恢复只取消注释,Logo 文件在库)c13(会员专属预告)c4c5(带演示用 会员/非会员 切换开关)assets/experts/)——肿瘤·血液 / 肝胆胰·消化(含李先亮主任)/ 微创介入 / 心血管·胸外·泌尿 / 神经·心理 / 检验医学 / 妇产·骨科 / 中医·儿科 / 健康管理·慢病按机构代码渲染(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 入会。
#aiFab 右下角常驻 · 全站唯一入口)c2 | 自测评估 → c1(跳现有模块,不新建题库)定位:Step 4 · 转化收割。检测是数据入口(人人可购),深度服务与免疫产品是会员价值(专属锁定),购物车完成落单闭环。
gate:'L1',非会员显示「会员专享」锁态)——未标 gate 默认 L0,刻意如此(忘标只是多卖一件,反之漏锁整类更难发现)#shopMask)保留未删、强制隐藏,恢复只需改一行memberState,管「买」);与顶栏「访客/会员」身份模式(IDENTITY,管「数据归属」)是两个独立维度c4cart| 周期 | 箱/瓶 | 折扣 | 标价 |
|---|---|---|---|
| 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/瓶估值(不受圆整影响)。
localStorage 持久化(md_cart_v1)· 加购(同名合并数量)/ 数量步进(减到 0 删行)/ 删除 / 合计 / 角标 / toast 反馈;价格解析支持「¥15,000」「¥10万」「起」等中文格式MD+时间戳 · 存 md_orders_v1(status「待支付」)· 订单结构预留 orderId/items/amount/status 字段,接后端不返工定位:Step 5 · 成为会员。转化终点 + 会员服务中心(家族总览、记录与福利)。
c9(16 题选卡工具)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 折 |
display:none,恢复只改一行)——储值+兑付实物命中《单用途商业预付卡管理办法》,待法律意见后定去留c6黑金卡权益清单屏(9 大类 26 项 · 单项价合计 ¥409,632 vs 套餐价 ¥299,999 ≈ 7.3 折 · 旗舰免疫调理价值另询不合计)。当前状态:c5 两处入口已关闭(权益明细待铭道确认后再放开),屏本体保留未删。
c11 家庭指数shared/family-tree.js 渲染(移动端纵向版 · 数据源 configs/families/*.json)c21(💌 邀请注册主路径 · 静态邀请卡+口令 / ✍️ 户主代录 6 字段+知情同意勾选 · 存 md_family_extra_v1);代录成员渲染灰色「待检测」卡,不进 CFHI 聚合/跨度/已检测计数;头卡成员数动态更新;C11 文字链 + C12「邀请家人 +200」入口卡为次入口。已知限制:代录成员暂不进谱系图(Phase 2 后端化后统一)c5(会员态隐藏);底部 → c7本文只写页面结构与行为;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 口径,勿引用)。
文档版本: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 标已被取代)· 原 §八 待续顺延为 §九