bxs-tools-ui 3.2.0-1 → 3.2.0-2

package/packages/bxs-utils/readme.md

@@ -1,463 +1,445 @@
-<!--仅用于绕过 eslint-loader 校验的错误信息：Parsing error: Invalid character-->
-<!--??以目前现象看，文档首字符不为 "<" 会报错??-->
-## 一些辅助函数（BxsUtils）
-### COMMON 函数
-
-<dl>
-<dt><a href="#convertEleOrderListToObj">convertEleOrderListToObj(obj)</a> ⇒ <code>any</code></dt>
-<dd><p><strong>将对象下的 eleOrderList 数组中的子元素下的 value，转换为 key-value 键值对</strong></p></dd>
-<dt><a href="#calcTotalBaof">calcTotalBaof(productGroupList)</a> ⇒ <code>number</code></dt>
-<dd><p><strong>对所有产品组中的已选产品的保费求和</strong></p></dd>
-<dt><a href="#getHuomianPeriodValue">getHuomianPeriodValue(val, pMinus, age)</a> ⇒ <code>string</code></dt>
-<dd><p><strong>转换交费期间的值。实际是表示豁免险与所关联的险种的交费期间值的关系</strong></p></dd>
-<dt><a href="#getNumberFromYear">getNumberFromYear(value, age)</a> ⇒ <code>number</code></dt>
-<dd><p><strong>将交费期间或者保险期间的值，转换成数值</strong></p></dd>
-<dt><a href="#converUnit10000">converUnit10000(value)</a> ⇒ <code>string</code></dt>
-<dd><p><strong>将大于10000且是10000的倍数的值，转换成单位为万的字符串</strong></p></dd>
-<dt><a href="#getAgeFromBirth">getAgeFromBirth(birth, cDate)</a> ⇒ <code>number</code></dt>
-<dd><p><strong>根据生日算年龄</strong></p></dd>
-</dl>
-
-<a name="convertEleOrderListToObj"></a>
-
-## convertEleOrderListToObj(obj) ⇒ <code>any</code>
-<p><strong>将对象下的 eleOrderList 数组中的子元素下的 value，转换为 key-value 键值对</strong></p>
-
-**Kind**: global function  
-**Date**: 2022-04-25  
-**Author**: Lizhao <lz@winbaoxian.com>  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| obj | <code>any</code> | <p>必传。带eleOrderList数组的对象。如人员数据、产品数据</p> |
-
-**Example**  
+## 辅助函数（BxsUtils）
+
+计划书、险种计算相关的工具函数集合。
+
+---
+
+### 目录
+
+- planbook/common — 通用工具函数
+  - convertEleOrderListToObj
+  - calcTotalBaof
+  - getHuomianPeriodValue
+  - getNumberFromYear
+  - converUnit10000
+  - getAgeFromBirth
+  - formatNumberToThousand
+  - textOverflowEllipsis
+- planbook/person — 人员数据处理
+  - initPersonData
+  - personDataHandler
+  - convertPersonData
+- planbook/product — 产品数据处理
+  - initProductData
+  - productDataHandler
+  - convertProductData
+  - clearAddAndTakeAndAdjustBaoeData
+- planbook/insurance — 险种数据处理
+  - initInsuranceData
+  - insuranceDataHandler
+- trade — 保费试算
+  - insureCalculate
+  - checkInsureCalculate
+
+---
+
+## planbook/common 通用工具函数
+
+### convertEleOrderListToObj
+
+将对象下的 `eleOrderList` 数组中子元素的 `value`，提取并转换为 key-value 键值对，与对象其余字段合并后返回。
+
+**参数**
+
+| 参数  | 类型  | 说明                            |
+| ----- | ----- | ------------------------------- |
+| `obj` | `any` | 必传。带 `eleOrderList` 数组的对象，如人员数据、产品数据 |
+
+**返回值**：`any` — 转换后的对象
+
+**示例**
+
 ```javascript
 convertEleOrderListToObj({
-    "key": "insuredInfo"
-    "eleOrderList": [
-      { "value": true, "key": "title" },
-      { "value": 1, "key": "sex" },
-      { "value": 30, "key": "age" },
-      { "value": "2020/10/23", "key": "insuranceDay" }
-    ]
-  })
-  // returns
-  // {
-  //  "key": "insuredInfo",
-  //  "title": true,
-  //  "sex": 1,
-  //  "age": 30,
-  //  "insuranceDay": "2020/10/23",
-  // }
+  key: 'insuredInfo',
+  eleOrderList: [
+    { value: true, key: 'title' },
+    { value: 1, key: 'sex' },
+    { value: 30, key: 'age' },
+    { value: '2020/10/23', key: 'insuranceDay' }
+  ]
+})
+// returns
+// {
+//   key: 'insuredInfo',
+//   title: true,
+//   sex: 1,
+//   age: 30,
+//   insuranceDay: '2020/10/23',
+// }
 ```
-<a name="calcTotalBaof"></a>
 
-## calcTotalBaof(productGroupList) ⇒ <code>number</code>
-<p><strong>对所有产品组中的已选产品的保费求和</strong></p>
+---
 
-**Kind**: global function  
-**Returns**: <code>number</code> - <p>总保费</p>  
-**Date**: 2022-04-25  
-**Author**: Lizhao <lz@winbaoxian.com>  
+### calcTotalBaof
 
-| Param | Type | Description |
-| --- | --- | --- |
-| productGroupList | <code>IPbProductGroup</code> | <p>所有产品组数据</p> |
+对所有产品组中已选产品的保费求和。隐藏的产品组（`isHide: true`）和隐藏的产品（`hide: true`）不计入。
 
-<a name="getHuomianPeriodValue"></a>
+**参数**
 
-## getHuomianPeriodValue(val, pMinus, age) ⇒ <code>string</code>
-<p><strong>转换交费期间的值。实际是表示豁免险与所关联的险种的交费期间值的关系</strong></p>
+| 参数               | 类型                | 说明             |
+| ------------------ | ------------------- | ---------------- |
+| `productGroupList` | `IPbProductGroup[]` | 必传。所有产品组数据 |
 
-**Kind**: global function  
-**Returns**: <code>string</code> - <p>交费期间</p>  
-**Date**: 2022-04-25  
-**Author**: Lizhao <lz@winbaoxian.com>  
+**返回值**：`number` — 总保费，保留两位小数
 
-| Param | Type | Default | Description |
-| --- | --- | --- | --- |
-| val | <code>string</code> |  | <p>必传。交费期间的值</p> |
-| pMinus | <code>number</code> | <code>0</code> | <p>0 可不传。指定要减去的值</p> |
-| age | <code>number</code> | <code>0</code> | <p>0 可不传。所附加的人员的年龄</p> |
+---
 
-**Example**  
-```javascript
-getHuomianPeriodValue('a999')
-// returns a999
+### getHuomianPeriodValue
 
-getHuomianPeriodValue('b10', 1)
-// returns b9
+转换豁免险的交费期间值，表示豁免险与其关联险种之间的交费期间关系。
 
-getHuomianPeriodValue('a60', 1, 30)
-// returns b29
-```
-<a name="getNumberFromYear"></a>
+转换规则：
+- `a999`（终身）/ `a1000`（趸交）直接返回原值
+- `b` 开头（年数）：年数 - `pMinus`
+- `a` 开头（至X岁）：保额年龄 - 人员年龄 - `pMinus`，转为 `b` 开头
+
+**参数**
 
-## getNumberFromYear(value, age) ⇒ <code>number</code>
-<p><strong>将交费期间或者保险期间的值，转换成数值</strong></p>
+| 参数     | 类型     | 默认值 | 说明                       |
+| -------- | -------- | ------ | -------------------------- |
+| `val`    | `string` | `''`   | 必传。交费期间的值          |
+| `pMinus` | `number` | `0`    | 可不传。指定要减去的值      |
+| `age`    | `number` | `0`    | 可不传。所附加人员的年龄    |
 
-**Kind**: global function  
-**Returns**: <code>number</code> - <p>数值</p>  
-**Date**: 2022-04-25  
-**Author**: Lizhao <lz@winbaoxian.com>  
+**返回值**：`string` — 转换后的交费期间值
 
-| Param | Type | Default | Description |
-| --- | --- | --- | --- |
-| value | <code>string</code> |  | <p>必传。需要转换的值</p> |
-| age | <code>number</code> | <code>0</code> | <p>0 可不传。被保人年龄</p> |
+**示例**
 
-**Example**  
 ```javascript
-getNumberFromYear('a1000')
-// returns 1
+getHuomianPeriodValue('a999')      // returns 'a999'
+getHuomianPeriodValue('b10', 1)    // returns 'b9'
+getHuomianPeriodValue('a60', 1, 30) // returns 'b29'
+```
+
+---
+
+### getNumberFromYear
+
+将交费期间或保险期间的值转换成数值。
+
+转换规则：
+- `a1000`（趸交）返回 `1`
+- `a` 开头（至X岁）：X - `age`
+- `b` 开头（年数）：提取数字部分
+- 数字类型直接返回
+
+**参数**
+
+| 参数    | 类型            | 默认值 | 说明                   |
+| ------- | --------------- | ------ | ---------------------- |
+| `value` | `string\|number` |       | 必传。需要转换的值      |
+| `age`   | `number`        | `0`    | 可不传。被保人年龄      |
+
+**返回值**：`number`
 
-getNumberFromYear('a10', 1)
-// returns 9
+**示例**
 
-getNumberFromYear('b10')
-// returns 10
+```javascript
+getNumberFromYear('a1000')     // returns 1
+getNumberFromYear('a10', 1)    // returns 9
+getNumberFromYear('b10')       // returns 10
 ```
-<a name="converUnit10000"></a>
 
-## converUnit10000(value) ⇒ <code>string</code>
-<p><strong>将大于10000且是10000的倍数的值，转换成单位为万的字符串</strong></p>
+---
+
+### converUnit10000
+
+将大于 10000 且是 10000 的倍数的值，转换成单位为"万"的字符串；否则返回原数值。
+
+**参数**
 
-**Kind**: global function  
-**Returns**: <code>string</code> - <p>单位为万的字符串</p>  
-**Date**: 2022-04-25  
-**Author**: Lizhao <lz@winbaoxian.com>  
+| 参数    | 类型     | 说明   |
+| ------- | -------- | ------ |
+| `value` | `number` | 必传   |
 
-| Param | Type | Description |
-| --- | --- | --- |
-| value | <code>number</code> | <p>必传</p> |
+**返回值**：`number | string` — 满足条件时返回带"万"的字符串，否则返回原数值
+
+**示例**
 
-**Example**  
 ```javascript
-converUnit10000(1000)
-// returns 1000
+converUnit10000(1000)     // returns 1000
+converUnit10000(2000000)  // returns '200万'
+converUnit10000(2000001)  // returns 2000001
+```
+
+---
+
+### getAgeFromBirth
 
-converUnit10000(2000000)
-// returns 200万
+根据生日计算年龄。
 
-converUnit10000(2000001)
-// returns 2000001
+**参数**
+
+| 参数    | 类型                       | 说明                               |
+| ------- | -------------------------- | ---------------------------------- |
+| `birth` | `Date \| number \| string` | 必传。时间字符串或时间戳            |
+| `cDate` | `Date \| number \| string` | 可不传。指定时间，不传默认为当前时间 |
+
+**返回值**：`number` — 年龄
+
+**示例**
+
+```javascript
+getAgeFromBirth('2000-01-01')                   // returns 22（取决于当前日期）
+getAgeFromBirth('2000-01-10', '2022-01-10')     // returns 22
+getAgeFromBirth('2000-01-10', '2022-01-09')     // returns 21
 ```
-<a name="getAgeFromBirth"></a>
 
-## getAgeFromBirth(birth, cDate) ⇒ <code>number</code>
-<p><strong>根据生日算年龄</strong></p>
+---
+
+### formatNumberToThousand
+
+将数值转换为千分位格式的字符串。
+
+**参数**
 
-**Kind**: global function  
-**Returns**: <code>number</code> - <p>年龄</p>  
-**Date**: 2022-04-25  
-**Author**: Lizhao <lz@winbaoxian.com>  
+| 参数 | 类型            | 说明                   |
+| ---- | --------------- | ---------------------- |
+| `n`  | `number\|string` | 必传。需要转换的数值    |
 
-| Param | Type | Description |
-| --- | --- | --- |
-| birth | <code>Date</code> \| <code>timestamp</code> \| <code>dateStr</code> | <p>必传。时间字符串或时间翟</p> |
-| cDate | <code>Date</code> \| <code>timestamp</code> \| <code>dateStr</code> | <p>可不传。指定时间，不传默认为当前时间</p> |
+**返回值**：`string` — 千分位字符串；空值返回空字符串；非数值返回原值
+
+**示例**
 
-**Example**  
 ```javascript
-getAgeFromBirth('2000-01-01')
-// returns 22
+formatNumberToThousand(1234567)   // returns '1,234,567'
+formatNumberToThousand(0)         // returns '0'
+formatNumberToThousand(null)      // returns ''
+```
+
+---
+
+### textOverflowEllipsis
+
+按视觉字符宽度截取字符串到指定长度，超出时末尾追加 `...`。
+
+计数规则：
+- 中文字符（及非 `[0-9a-z.()]` 的字符）计为 1 个字符
+- 数字、小写字母及 `.()` 计为 0.5 个字符
+
+**参数**
+
+| 参数  | 类型     | 说明                           |
+| ----- | -------- | ------------------------------ |
+| `str` | `string` | 必传。需要截取的字符串          |
+| `n`   | `number` | 必传。最大字符数（需大于 2）    |
 
-getAgeFromBirth('2000-01-10', '2022-01-10')
-// returns 22
+**返回值**：`string` — 截取后的字符串
 
-getAgeFromBirth('2000-01-10', '2022-01-09')
-// returns 21
+**示例**
+
+```javascript
+textOverflowEllipsis('你好world', 4)    // returns '你好...'
+textOverflowEllipsis('hello world', 4)  // returns 'hello world'
 ```
 
-###  
-###  
-### INSURANCE 函数
-
-<dl>
-<dt><a href="#initInsuranceData">initInsuranceData(insData)</a> ⇒ <code>void</code></dt>
-<dd><p><strong>初始化险种数据</strong></p>
-<ul>
-<li>补充一些显示文案</li>
-<li>转换元素的选项字段</li>
-<li>预设一些后面可能用到的字段，如追加领取、减保领取</li>
-</ul></dd>
-<dt><a href="#insuranceDataHandler">insuranceDataHandler(insData, productData)</a> ⇒ <code>IProdInsurance</code></dt>
-<dd><p><strong>处理险种数据</strong></p>
-<ul>
-<li>初始化元素的校验规则</li>
-<li>处理保额保费互算、保额和计划的逻辑关系</li>
-</ul></dd>
-</dl>
-
-<a name="initInsuranceData"></a>
-
-## initInsuranceData(insData) ⇒ <code>void</code>
-<p><strong>初始化险种数据</strong></p>
-<ul>
-<li>补充一些显示文案</li>
-<li>转换元素的选项字段</li>
-<li>预设一些后面可能用到的字段，如追加领取、减保领取</li>
-</ul>
-
-**Kind**: global function  
-**Date**: 2022-04-26  
-**Author**: Lizhao <lz@winbaoxian.com>  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| insData | <code>IProdInsurance</code> | <p>必传。险种数据（单个）</p> |
-
-<a name="insuranceDataHandler"></a>
-
-## insuranceDataHandler(insData, productData) ⇒ <code>IProdInsurance</code>
-<p><strong>处理险种数据</strong></p>
-<ul>
-<li>初始化元素的校验规则</li>
-<li>处理保额保费互算、保额和计划的逻辑关系</li>
-</ul>
-
-**Kind**: global function  
-**Returns**: <code>IProdInsurance</code> - <p>险种数据（单个）</p>  
-**Date**: 2022-04-26  
-**Author**: Lizhao <lz@winbaoxian.com>  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| insData | <code>IProdInsurance</code> | <p>必传。险种数据（单个）</p> |
-| productData | <code>IPbProduct</code> | <p>必传。产品数据（单个）</p> |
-
-
-###  
-###  
-### PERSON 函数
-
-<dl>
-<dt><a href="#initPersonData">initPersonData(inputData, verifyData)</a> ⇒ <code>void</code></dt>
-<dd><p><strong>初始化人员数据</strong></p>
-<ul>
-<li>增加一些元素。如：投被保人是否为同一人、生日</li>
-<li>补充一些文案。如：占位符</li>
-<li>补充、转换一些必要数据。如：所用的模块名称、年龄的选项、可能用到的字段</li>
-<li>计算被保人年龄范围，即计划书年龄范围</li>
-</ul></dd>
-<dt><a href="#personDataHandler">personDataHandler(allPersonsData)</a> ⇒ <code>IPbPersons</code></dt>
-<dd><p><strong>处理人员数据</strong></p>
-<ul>
-<li>年龄、生日的联动</li>
-<li>关于被保人、投保人是否是同一人的处理</li>
-<li>被保人、投保人、投保人配偶之间的逻辑</li>
-</ul></dd>
-<dt><a href="#convertPersonData">convertPersonData(allPersonsData, type)</a> ⇒ <code>any</code></dt>
-<dd><p><strong>转换人员数据</strong></p></dd>
-</dl>
-
-<a name="initPersonData"></a>
-
-## initPersonData(inputData, verifyData) ⇒ <code>void</code>
-<p><strong>初始化人员数据</strong></p>
-<ul>
-<li>增加一些元素。如：投被保人是否为同一人、生日</li>
-<li>补充一些文案。如：占位符</li>
-<li>补充、转换一些必要数据。如：所用的模块名称、年龄的选项、可能用到的字段</li>
-<li>计算被保人年龄范围，即计划书年龄范围</li>
-</ul>
-
-**Kind**: global function  
-**Date**: 2022-04-26  
-**Author**: Lizhao <lz@winbaoxian.com>  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| inputData | <code>IPbInput</code> | <p>必传。计划书数据</p> |
-| verifyData | <code>object</code> | <p>必传。计划书校验条件</p> |
-
-<a name="personDataHandler"></a>
-
-## personDataHandler(allPersonsData) ⇒ <code>IPbPersons</code>
-<p><strong>处理人员数据</strong></p>
-<ul>
-<li>年龄、生日的联动</li>
-<li>关于被保人、投保人是否是同一人的处理</li>
-<li>被保人、投保人、投保人配偶之间的逻辑</li>
-</ul>
-
-**Kind**: global function  
-**Returns**: <code>IPbPersons</code> - <p>所有人员的数据</p>  
-**Date**: 2022-04-26  
-**Author**: Lizhao <lz@winbaoxian.com>  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| allPersonsData | <code>IPbPersons</code> | <p>必传。所有人员的数据</p> |
-
-<a name="convertPersonData"></a>
-
-## convertPersonData(allPersonsData, type) ⇒ <code>any</code>
-<p><strong>转换人员数据</strong></p>
-
-**Kind**: global function  
-**Returns**: <code>any</code> - <p>人员数据(单个或多个)</p>  
-**Date**: 2022-04-26  
-**Author**: Lizhao <lz@winbaoxian.com>  
-
-| Param | Type | Default | Description |
-| --- | --- | --- | --- |
-| allPersonsData | <code>IPbPersons</code> |  | <p>必传。所有人员数据</p> |
-| type | <code>null</code> \| <code>string</code> | <code></code> | <p>可不传。 不传，人员数据按原结构返回； 字符串，返回指定的人员数据； 数组，以数组形式，返回多个人员数据。</p> |
-
-
-###  
-###  
-### PRODUCT 函数
-
-<dl>
-<dt><a href="#initProductData">initProductData(prodData)</a> ⇒ <code>IPbProduct</code></dt>
-<dd><p><strong>初始化产品数据（单个）</strong></p>
-<ul>
-<li>初始化调整保额数据</li>
-<li>初始化险种数据</li>
-</ul></dd>
-<dt><a href="#productDataHandler">productDataHandler(prodData, productVerifyData, personData)</a> ⇒ <code>IPbProduct</code></dt>
-<dd><p><strong>处理产品数据（单个）</strong></p>
-<ul>
-<li>提取通用信息</li>
-<li>处理险种数据</li>
-<li>根据被、投保人信息，处理险种状态。如：险种是否可选</li>
-<li>根据校验条件解析产品状态。如：险种是否可选、重新获取元素（下拉框、单选框）的可选项</li>
-<li>创建或更新组合险（多个险种组合成一个险种）</li>
-<li>根据被、投保人信息，判断该产品是否可以显示</li>
-</ul></dd>
-<dt><a href="#convertProductData">convertProductData(prodData)</a> ⇒ <code>IPbProduct</code></dt>
-<dd><p><strong>转换产品数据</strong></p>
-<ul>
-<li>转换通用信息的数据</li>
-<li>转换组合险的数据</li>
-<li>转换常规险种的数据。包括将 eleOrderList 数组下的 value 值，转换成 key-value 键值对</li>
-</ul></dd>
-<dt><a href="#clearAddAndTakeAndAdjustBaoeData">clearAddAndTakeAndAdjustBaoeData(productData)</a> ⇒ <code>IPbProduct</code></dt>
-<dd><p><strong>清空追加领取、减保领取、调整保额数据</strong></p></dd>
-</dl>
-
-<a name="initProductData"></a>
-
-## initProductData(prodData) ⇒ <code>IPbProduct</code>
-<p><strong>初始化产品数据（单个）</strong></p>
-<ul>
-<li>初始化调整保额数据</li>
-<li>初始化险种数据</li>
-</ul>
-
-**Kind**: global function  
-**Returns**: <code>IPbProduct</code> - <p>产品数据</p>  
-**Date**: 2022-04-26  
-**Author**: Lizhao <lz@winbaoxian.com>  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| prodData | <code>IPbProduct</code> | <p>必传。产品数据（单个）</p> |
-
-<a name="productDataHandler"></a>
-
-## productDataHandler(prodData, productVerifyData, personData) ⇒ <code>IPbProduct</code>
-<p><strong>处理产品数据（单个）</strong></p>
-<ul>
-<li>提取通用信息</li>
-<li>处理险种数据</li>
-<li>根据被、投保人信息，处理险种状态。如：险种是否可选</li>
-<li>根据校验条件解析产品状态。如：险种是否可选、重新获取元素（下拉框、单选框）的可选项</li>
-<li>创建或更新组合险（多个险种组合成一个险种）</li>
-<li>根据被、投保人信息，判断该产品是否可以显示</li>
-</ul>
-
-**Kind**: global function  
-**Returns**: <code>IPbProduct</code> - <p>产品数据（单个）</p>  
-**Date**: 2022-04-26  
-**Author**: Lizhao <lz@winbaoxian.com>  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| prodData | <code>IPbProduct</code> | <p>必传。产品数据（单个）</p> |
-| productVerifyData | <code>object</code> | <p>必传。产品校验条件（单个）</p> |
-| personData | <code>IPbPersons</code> | <p>必传。人员信息，包括被保人、投保人、投保人配偶</p> |
-
-<a name="convertProductData"></a>
-
-## convertProductData(prodData) ⇒ <code>IPbProduct</code>
-<p><strong>转换产品数据</strong></p>
-<ul>
-<li>转换通用信息的数据</li>
-<li>转换组合险的数据</li>
-<li>转换常规险种的数据。包括将 eleOrderList 数组下的 value 值，转换成 key-value 键值对</li>
-</ul>
-
-**Kind**: global function  
-**Returns**: <code>IPbProduct</code> - <p>产品数据（单个）</p>  
-**Date**: 2022-04-26  
-**Author**: Lizhao <lz@winbaoxian.com>  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| prodData | <code>IPbProduct</code> | <p>必传。产品数据（单个）</p> |
-
-<a name="clearAddAndTakeAndAdjustBaoeData"></a>
-
-## clearAddAndTakeAndAdjustBaoeData(productData) ⇒ <code>IPbProduct</code>
-<p><strong>清空追加领取、减保领取、调整保额数据</strong></p>
-
-**Kind**: global function  
-**Returns**: <code>IPbProduct</code> - <p>产品数据</p>  
-**Date**: 2022-04-26  
-**Author**: Lizhao <lz@winbaoxian.com>  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| productData | <code>IPbProduct</code> | <p>产品数据</p> |
-
-
-###  
-###  
-### INSURECALCULATE 函数
-
-<dl>
-<dt><a href="#insureCalculate">insureCalculate(urlParams, postParams, planParams)</a> ⇒ <code>promise</code></dt>
-<dd><p>险种计算</p></dd>
-<dt><a href="#checkInsureCalculate">checkInsureCalculate(urlParams, postParams, planParams)</a> ⇒ <code>promise</code></dt>
-<dd><p><strong>检查险种计算</strong></p></dd>
-</dl>
-
-<a name="insureCalculate"></a>
-
-## insureCalculate(urlParams, postParams, planParams) ⇒ <code>promise</code>
-<p>险种计算</p>
-
-**Kind**: global function  
-**Returns**: <code>promise</code> - <p>试算结果</p>  
-**Date**: 2022-04-26  
-**Author**: watson  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| urlParams | <code>object</code> | <p>接口URL上面的参数，c端必传uuid</p> |
-| postParams | <code>object</code> | <p>试算用的参数，product_id, current_data 和 scenario: 'h5Widget'</p> |
-| planParams | <code>object</code> | <p>计划书初始化参数</p> |
-
-<a name="checkInsureCalculate"></a>
-
-## checkInsureCalculate(urlParams, postParams, planParams) ⇒ <code>promise</code>
-<p><strong>检查险种计算</strong></p>
-
-**Kind**: global function  
-**Returns**: <code>promise</code> - <p>试算结果</p>  
-**Date**: 2022-04-26  
-**Author**: watson  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| urlParams | <code>object</code> | <p>接口URL上面的参数，c端必传uuid</p> |
-| postParams | <code>object</code> | <p>试算用的参数，product_id, current_data 和 scenario: 'h5Widget'</p> |
-| planParams | <code>object</code> | <p>计划书初始化参数</p> |
-
-
-###  
-###  
+---
+
+## planbook/person 人员数据处理
+
+### initPersonData
+
+初始化人员数据（直接修改传入对象，无返回值）。
+
+主要处理内容：
+- 增加元素：投被保人是否为同一人、生日
+- 补充文案：占位符等
+- 补充、转换必要数据：模块名称、年龄选项、可能用到的字段
+- 计算被保人年龄范围（即计划书年龄范围）
+
+**参数**
+
+| 参数          | 类型       | 说明                     |
+| ------------- | ---------- | ------------------------ |
+| `inputData`   | `IPbInput` | 必传。计划书数据          |
+| `verifyData`  | `object`   | 必传。计划书校验条件      |
+
+**返回值**：`void`
+
+---
+
+### personDataHandler
+
+处理人员数据，处理后直接修改并返回传入对象。
+
+主要处理内容：
+- 年龄、生日的联动
+- 被保人与投保人是否为同一人的处理
+- 被保人、投保人、投保人配偶之间的逻辑
+
+**参数**
+
+| 参数              | 类型          | 说明               |
+| ----------------- | ------------- | ------------------ |
+| `allPersonsData`  | `IPbPersons`  | 必传。所有人员数据  |
+
+**返回值**：`IPbPersons` — 所有人员的数据
+
+---
+
+### convertPersonData
+
+转换人员数据，将各人员的 `eleOrderList` 下的值提取为 key-value 结构，便于直接读取字段。
+
+**参数**
+
+| 参数              | 类型                    | 说明                                                                                         |
+| ----------------- | ----------------------- | -------------------------------------------------------------------------------------------- |
+| `allPersonsData`  | `IPbPersons`            | 必传。所有人员数据                                                                            |
+| `type`            | `null\|string\|string[]` | 可不传。不传返回完整结构；字符串返回指定人员数据；数组以数组形式返回多个人员数据 |
+
+**返回值**：`any` — 人员数据（单个或多个）
+
+---
+
+## planbook/product 产品数据处理
+
+### initProductData
+
+初始化产品数据（单个），直接修改并返回传入对象。
+
+主要处理内容：
+- 初始化调整保额数据
+- 初始化险种数据
+
+**参数**
+
+| 参数       | 类型         | 说明               |
+| ---------- | ------------ | ------------------ |
+| `prodData` | `IPbProduct` | 必传。产品数据（单个） |
+
+**返回值**：`IPbProduct` — 产品数据
+
+---
+
+### productDataHandler
+
+处理产品数据（单个），异步函数。
+
+主要处理内容：
+- 提取通用信息
+- 处理险种数据
+- 根据被、投保人信息处理险种状态（如：险种是否可选）
+- 根据校验条件解析产品状态（如：重新获取元素的可选项）
+- 创建或更新组合险
+- 判断产品是否隐藏
+
+**参数**
+
+| 参数              | 类型          | 说明                                   |
+| ----------------- | ------------- | -------------------------------------- |
+| `prodData`        | `IPbProduct`  | 必传。产品数据（单个）                  |
+| `prodVerifyData`  | `object`      | 必传。产品校验条件（单个）              |
+| `personData`      | `IPbPersons`  | 必传。人员信息，包括被保人、投保人、投保人配偶 |
+| `parmas`          | `object`      | 可不传。补充参数，目前只有 `planbookId` |
+
+**返回值**：`Promise<IPbProduct>` — 产品数据（单个）
+
+---
+
+### convertProductData
+
+转换产品数据，将产品下所有险种的 `eleOrderList` 提取为 key-value 结构。
+
+主要处理内容：
+- 转换通用信息（`common`）
+- 转换组合险数据
+- 转换常规险种数据
+
+**参数**
+
+| 参数       | 类型         | 说明               |
+| ---------- | ------------ | ------------------ |
+| `prodData` | `IPbProduct` | 必传。产品数据（单个） |
+
+**返回值**：`IPbProduct` — 转换后的产品数据（单个）
+
+---
+
+### clearAddAndTakeAndAdjustBaoeData
+
+清空产品下的追加领取、减保领取、调整保额数据。
+
+**参数**
+
+| 参数          | 类型         | 说明   |
+| ------------- | ------------ | ------ |
+| `productData` | `IPbProduct` | 产品数据 |
+
+**返回值**：`IPbProduct` — 产品数据
+
+---
+
+## planbook/insurance 险种数据处理
+
+### initInsuranceData
+
+初始化险种数据（单个），直接修改传入对象，无返回值。
+
+主要处理内容：
+- 补充显示文案（保额、保费等字段的占位符）
+- 转换元素的选项字段（`optConf` → `opts`，补全 `isHide`、`isDisabled`、`isInvalid`）
+- 预设后续可能用到的字段，如追加领取、减保领取数据结构
+
+**参数**
+
+| 参数      | 类型              | 说明               |
+| --------- | ----------------- | ------------------ |
+| `insData` | `IProdInsurance`  | 必传。险种数据（单个） |
+
+**返回值**：`void`
+
+---
+
+### insuranceDataHandler
+
+处理险种数据（单个），直接修改并返回传入对象。
+
+主要处理内容：
+- 初始化元素的校验规则（必填、取值范围、倍数、比较）
+- 处理保额保费互算逻辑（`calMethod` 元素控制 `baoe`/`baof` 的显隐）
+- 处理保额与计划的显隐关系
+
+**参数**
+
+| 参数          | 类型             | 说明               |
+| ------------- | ---------------- | ------------------ |
+| `insData`     | `IProdInsurance` | 必传。险种数据（单个） |
+| `productData` | `IPbProduct`     | 必传。产品数据（单个） |
+
+**返回值**：`IProdInsurance` — 险种数据（单个）
+
+---
+
+## trade 保费试算
+
+### insureCalculate
+
+险种试算。
+
+**参数**
+
+| 参数          | 类型     | 说明                                                      |
+| ------------- | -------- | --------------------------------------------------------- |
+| `urlParams`   | `object` | 接口 URL 参数，c 端必传 `uuid`                            |
+| `postParams`  | `object` | 试算参数，包含 `product_id`、`current_data`、`scenario`   |
+| `planParams`  | `object` | 计划书初始化参数（含 `detail_age`、`detail_sex` 等字段）  |
+
+**返回值**：`Promise` — 试算结果
+
+---
+
+### checkInsureCalculate
+
+检查险种试算。当 `postParams` 中缺少 `current_data` 时，会先请求获取后再进行二次试算。
+
+**参数**
+
+| 参数          | 类型     | 说明                                                      |
+| ------------- | -------- | --------------------------------------------------------- |
+| `urlParams`   | `object` | 接口 URL 参数，c 端必传 `uuid`                            |
+| `postParams`  | `object` | 试算参数，包含 `product_id`、`current_data`、`scenario`   |
+| `planParams`  | `object` | 计划书初始化参数（含 `detail_age`、`detail_sex` 等字段）  |
+
+**返回值**：`Promise` — 试算结果；失败时 `Promise.reject`