Forráskód Böngészése

docs: 新增《算法说明书 · 养老计算器 v1.0》· 设计说明书 v2.0 算法索引 + Tab1 入口清单补 C22(文档与 v1.136-137 实现对齐)

Jack 1 hónapja
szülő
commit
448055a174

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

@@ -50,6 +50,7 @@
 **② 其他测试 · 非健康状态评估**(分隔线下 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 起推荐固定序 意外→医疗→重疾 · 意外卡文案点破大/小意外)
+- 🏖️ **养老计算器** → `c22`(2026-09-23 新增 · 转化钩子:顶级养老院 ¥2万/月 通胀冲击 → 养老总池 → 每月应存 → 延迟5年代价;5 组点选(年龄/退休年龄/月成本/分红险收益率/入住年限)· CTA 预约框预选养老年金 · 线索 source:'pension';详见 [[算法说明书 · 养老计算器 v1.0.md]])
 - 💳 **家族健康投入测试** → `c9`(16 题 · 选卡工具,与健康状态无关)
 - 📖 **免疫健康知识测试** → `c10`(20 题 · 判对错+解析 · 源自《免疫力是第一生命力》)
 
@@ -274,7 +275,7 @@
 
 ## 八、算法说明书索引(算法 SSOT 指针)
 
-本文只写页面结构与行为;**8 项测评引擎的公式、阈值、题库、折扣项以 docs/ 根目录的独立《算法说明书》系列为单一真相源**(每份头注声明实现位置与基线版本,查算法请读对应份):
+本文只写页面结构与行为;**测评引擎的公式、阈值、题库、折扣项以 docs/ 根目录的独立《算法说明书》系列为单一真相源**(每份头注声明实现位置与基线版本,查算法请读对应份):
 
 | # | 说明书 | 引擎 / 屏 | 性质 |
 |---|---|---|---|
@@ -286,6 +287,7 @@
 | 6 | [[算法说明书 · 铭道健康信息表 v1.0.md]] | `FORMS.health` · `c14` | 仅完成统计 · 算分待铭道确认 |
 | 7 | [[算法说明书 · 长新冠调查问卷 v1.0.md]] | `FORMS.covid` · `c14` | 仅完成统计 · 算分待铭道确认 |
 | 8 | [[算法说明书 · 铭道肿瘤风险评估表 v1.0.md]] | `FORMS.tumor` · `c14` | 仅完成统计 · 权重须铭道/李主任定 |
+| 9 | [[算法说明书 · 养老计算器 v1.0.md]] | `PEN` / `renderPension()` · `c22` | 转化钩子 · 养老总池与每月应存(分红险演示口径 · 2026-09-25 补入) |
 
 > ⚠️ 旧 v1.0 分册《4 · 算法说明书(8 大测评引擎)》已被本索引 + 独立系列取代(停留在 ~v1.58 口径,勿引用)。
 

+ 64 - 0
docs/算法说明书 · 养老计算器 v1.0.md

@@ -0,0 +1,64 @@
+# 算法说明书 · 养老计算器 v1.0
+
+> **系列**:客户端 APP 测评算法说明书(Tab 1 测试中心 · 10 项测评之十)
+> **实现位置**:`app.html`(屏 `c22` · 状态 `PEN` · 引擎 `renderPension()` / `penSet()` / `penGroup()` · CTA `openBooking('pension')`)
+> **定位**:**转化钩子**,非精算工具——顶级养老院 ¥2 万/月多数人无概念,本器把「未来住不起」算成「现在每月存多少」,促成养老年金规划咨询
+> **入口**:C1 首页「保额快速测算」正下方入口卡(🧮 → 🏖️ 顺序:先保障缺口,再养老储蓄)
+> **基线版本**:app.html v1.137(2026-09-24 · 入住年限 30 年档 + 分红险演示口径)
+
+---
+
+## 一、输入结构(5 组点选 · 零键盘输入)
+
+| 组 | 选项 | 默认 | 说明 |
+|---|---|---|---|
+| ① 现在年龄 | 25 / 30 / 35 / 40 / 45 / 50 | 35 | 决定复利年限 n |
+| ② 退休年龄 | 55 / 60 / 65 / 70 | 65 | n = 退休 − 现在 |
+| ③ 养老院月成本(今天价) | ¥8,000 基础 / ¥12,000 品质 / ¥20,000 顶级 / ¥30,000+ 尊享 | ¥20,000 | 锚点档=「顶级」——本器核心叙事 |
+| ④ 年金收益率(分红险演示) | 2.5% 保守 / 3.5% 稳健 / 4.5% 乐观 | 3.5% | v1.137 起去「友邦」品牌,改分红险通用口径(顾问可自由配产品) |
+| ⑤ 预计入住年限 | 10 / 15 / 20 / 30 年 | 15 | v1.137 新增 30 年档(长寿情景) |
+
+> 设计原则:全部点选、无文本输入——转化钩子的摩擦要趋近于零;改任一选项结果区即时重算(`penSet()` 单项更新)。
+
+## 二、算法公式(四步)
+
+固定口径:**护理成本通胀 3%/年**(不考虑通胀选项——通胀不是用户变量,是叙事的一部分)。
+
+```
+n        = 退休年龄 − 现在年龄                      …… 储蓄年限
+退休时点月成本 = 当前月成本 × 1.03ⁿ                  …… ① 冲击卡
+rr       = (1 + r) / 1.03 − 1                      …… 实际收益率(收益率 r 对通胀调整后)
+养老总池  = 退休时点年成本 × 期初年金现值系数(rr, g 年)
+           系数 = g                    (rr ≈ 0 时)
+           系数 = (1 − (1+rr)^(−g)) / rr × (1+rr)  (期初口径 · 每年初支取)
+趸交等价  = 养老总池 ÷ (1 + r)ⁿ
+每月应存  = 养老总池 ÷ 普通年金终值系数(月利率 r/12 · n×12 期)
+           系数 = ((1 + r/12)^(12n) − 1) / (r/12)
+延迟5年   = 同总池 ÷ ((n−5)×12 期终值系数)          …… 紧迫感卡
+每天成本  = 每月应存 ÷ 30
+```
+
+**默认档演算**(35 岁 · 65 退 · ¥2 万/月 · 3.5% · 15 年):
+退休月成本 ¥48,545 → 总池 **¥845 万**(趸交 ¥301 万)→ **每月存 ¥13,296**(≈每天 ¥443)→ 延迟 5 年 ¥17,654/月(**+33%**)。
+
+> 实现校验:浏览器渲染结果与 Python 独立复算逐分一致(默认档 + 45 岁·3万·2.5%·20年档 + 30 年档三案例 · v1.136/v1.137 验收记录)。
+
+## 三、结果页输出(4 卡 + CTA)
+
+1. **冲击卡**:「到你退休那年,¥2 万/月的养老院已涨到 ¥4.9 万/月」——先建立通胀概念,再谈储蓄
+2. **养老总池卡**:退休时需备好的总额 + 趸交等价(「现在一次性准备」)
+3. **每月只需存 ¥X,XXX**(金色主卡 · 转化锚点)+ ≈每天 ¥XXX + 存 n 年到退休年龄
+4. **⏰ 延迟 5 年的代价**:每月多存 ¥X(+33%~43%)——制造紧迫感
+5. **CTA**「开始存年金 · 预约专属财富管家」→ 共用预约框 `openBooking('pension')`:自动**预选「养老年金」**(v1.136 修复:不再误套用 ICQ 缺口预选)· 线索独立标记 `source:'pension'`(与 cfpi / icLite 并列第三来源,便于统计各钩子转化)
+6. **合规声明**(固定页脚):收益率为分红险演示假设(非保证利益)· 本测算为粗算口径 · 实际以保险公司正式计划书为准
+
+## 四、已知边界
+
+1. **粗算口径刻意为之**:通胀固定 3%、收益率三档、不考虑税收/费用/保证期间差异——目的是「让人开始存」,精算归顾问端与正式计划书
+2. 总池按期初年金(每年初支取),月存按普通年金(每月末存入)——两口径混用是行业惯例简化,已在注释标明
+3. 不建模「入住前已积累资产的继续增值」与「长寿超出入住年限」——30 年档即长寿情景的显式回答
+4. 分红演示利率非保证利益,合规页脚常驻;收益率口径 v1.137 起与具体保司脱钩
+
+---
+
+*文档版本:v1.0 · 2026-09-25 · Jack + Hermes · 基线 v1.137(含 v1.136 初版与 v1.137 两项修订)*