dingqiuyu
/
SFT
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: 订正阶段4设计文档字段(所属行业industry、恢复受益人beneAddress)

main
halo 2026-07-09 22:33:05 +08:00
parent be913bd9b0
commit 944239f446
1 changed files with 4 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
docs/superpowers/specs/2026-07-09-phase4-wallet-management-design.md
View File

@ -150,10 +150,10 @@ src/api/wallet.js # 本阶段全部接口封装
四个信息区,均按需求文档 2.6.3.4 字段表实现(不使用后端 Bto 的全量字段):
1. **基础信息**:所属渠道(`ChannelSelect`)、账户名称(点击"选择企业客户"→复用阶段3企业客户列表查询能力新建一个只读用途的企业客户选择弹窗,选中后回填 `enterpriseId/enterpriseName/businessLicense/certificateNumber/certificateEffectiveDate/certificateExpiryDate/certificateAddress`)、经营范围(文本,可编辑)、职业(文本,缺口5同上)、手机号码(文本,11位校验)、绑定银行账号/开户行号/开户行全称(文本输入)。`certificateType` 固定传 `BUSINESS_LICENSE`,不展示选择框
2. **法人代表信息**:客户名称(点击"选择"打开 `PersonalCustomerPicker`,选中后回填 `legalPersonName`,并需要额外一次个人客户 `detail` 查询补全 `certificateNumber`/`certificateExpiryDate` 映射为 `legalPersonIdType/legalPersonIdNo/legalPersonOpto`——因列表接口字段不含证件到期日,与阶段3股东高管信息同样的字段补全问题)
1. **基础信息**:所属渠道(`ChannelSelect`)、账户名称(点击"选择企业客户"→复用阶段3企业客户列表查询能力新建一个只读用途的企业客户选择弹窗,选中后额外调用一次 `enterprise-customer/detail` 补全字段,回填 `enterpriseId/enterpriseName/businessLicense/certificateNumber/certificateEffectiveDate/certificateExpiryDate/certificateAddress`)、经营范围(文本,可编辑)、所属行业(`industry`,文本输入——**订正**:此前版本误写为"职业",`CreateEnterpriseAccountOpenBto` 并无 `occupation` 字段,企业场景对应字段应为 `industry`)、手机号码(文本,11位校验)、绑定银行账号/开户行号/开户行全称(文本输入)。`certificateType` 固定传 `BUSINESS_LICENSE`,不展示选择框
2. **法人代表信息**:客户名称(点击"选择"打开 `PersonalCustomerPicker`,选中后回填 `legalPersonName`,并需要额外一次个人客户 `detail` 查询补全 `certificateType`/`certificateNumber`/`certificateExpiryDate` 映射为 `legalPersonIdType/legalPersonIdNo/legalPersonOpto`——因列表接口字段不含证件到期日,与阶段3股东高管信息同样的字段补全问题)
3. **实际控制人信息**:默认与"法人代表信息"相同(选中法人代表后自动回填,`controllerName/controllerIdType/controllerIdNo/controllerOpto` = 法人代表对应字段),同时提供"重新选择"按钮可打开 `PersonalCustomerPicker` 单独指定
4. **受益人信息**(单条,非列表,与需求文档"受益人信息"字段表结构一致,虽然后端是数组 `enterpriseAccountOpenApplicationBeneficiaryBtoList`,前端仅收集一条,提交时包裹为长度1的数组):客户名称(默认同法人代表,可重新选择)、证件号(`beneIdNo`)、证件地址(`beneAddress`)、证件到期日(`beneOpto`)、性别(`beneSex`,由选中客户 `GenderEnum` 映射为 `'0'`男/`'1'`女)、国籍(`beneNationality`,固定文本"中国",不可编辑)、是否股东(`actCtrl`,单选"是"/"否",默认"是")、持股比例(`actHdRat`,数字输入,单位%,0-100)
4. **受益人信息**(单条,非列表,虽然后端是数组 `enterpriseAccountOpenApplicationBeneficiaryBtoList`,前端仅收集一条,提交时包裹为长度1的数组):客户名称(默认同法人代表,可重新选择,选中后额外查一次个人客户 `detail`)、证件号(`beneIdNo`,取自 `certificateNumber`)、证件地址(`beneAddress`,取自 `certificateAddress`——**核实**:经重新核对 swagger `EnterpriseAccountOpenApplicationBeneficiaryBto` 原始定义,`beneAddress` 字段确实存在,此前一版"订正"误判为不存在并删除该字段,现予以恢复)、证件到期日(`beneOpto`,取自 `certificateExpiryDate`)、性别(`beneSex`,由选中客户 `GenderEnum` 映射为 `'0'`男/`'1'`女)、国籍(`beneNationality`,固定文本"中国",不可编辑)、是否股东(`actCtrl`,单选"是"/"否",默认"是")、持股比例(`actHdRat`,数字输入,单位%,0-100)。`beneIdType`(证件类型)不作为独立 UI 字段展示,提交时取自选中客户的 `certificateType`(与法人代表/实际控制人区块"不单独展示证件类型选择框"的处理方式一致)
5. **影像信息**:营业执照(`LicenseUpload`→`fileType='12'`)、法人身份证正/反面(`IdCardUpload`→`fileType='01'/'02'`),三者组装进 `enterpriseAccountOpenApplicationFileBtoList`
提交:`create` 时不传 `applicationNo`;`update` 时用路由 query 的 `applicationNo` 映射到 `id`。**编辑模式下四个信息区均可编辑**(与阶段3"股东高管信息仅新增可写"不同,已在2.3节注明,`UpdateEnterpriseAccountOpenApplicationBto` 支持全量回写)。查看模式(`detail`)全部字段 `disabled`,并展示 `applicationStatus`/`failReason`/`mainAccountNo`/`customerNo`(开立成功后回填)。
@ -206,7 +206,7 @@ src/api/wallet.js # 本阶段全部接口封装
## 7. 已识别的后端能力缺口(登记入 `缺失的后端接口.md`)
1. **企业开户 Bto/Vo 含"负责人信息""经办人信息"两组字段,但需求文档字段表未要求**——不采集,提交时不传;若后端将其中某字段标记为服务端必填,以实测报错为准调整(当前 swagger 未见 `required` 数组包含这两组字段)
2. **企业开户"受益人信息"后端支持35个反洗钱合规字段,需求文档仅要求8个**——按需求文档裁剪,只采集/回填 `beneName/beneIdType/beneIdNo/beneOpto/beneSex/beneNationality/actCtrl/actHdRat`,其余27个字段不提交(不传等同后端存空值,若后端有强制校验以实测调整)
2. **企业开户"受益人信息"后端支持35+反洗钱合规字段,需求文档仅要求8个**——按需求文档裁剪,只采集/回填 `beneName/beneIdNo/beneAddress/beneOpto/beneSex/beneNationality/actCtrl/actHdRat`(对应客户名称/证件号/证件地址/证件到期日/性别/国籍/是否股东/持股比例),另 `beneIdType` 不作为独立 UI 字段但提交时随选中客户 `certificateType` 一并回填(与法人代表/实际控制人一致的隐式字段处理方式),其余 26+ 个反洗钱扩展字段(受益所有权形成/终止日期、25%以上收益权/表决权、实际控制形式、高级管理人员职位、`beneBirthday`/`beneMobile` 等)不提交
3. **账户列表页字段/查询条件与需求文档不完全匹配**——`WalletAccountVo`/`WalletAccountDetailVo` 均无"渠道""机构""冻结账户余额"字段,`wallet-account/page` 查询体不支持按"所属机构""渠道""客户类型(个人/企业)"过滤(仅支持账户名称/账号/账户类型A1-A7);列表页按后端实际返回字段裁剪展示列与查询条件
4. **个人/企业开户"绑定银行账号"无卡号查询校验接口**——需求文档提及"卡信息查询接口223405"用于校验卡号正确性,swagger 中未检索到对应管理端接口(`wallet-account`/`wallet-management` 分组下均无 `query-bank-card`/`verify-card` 类路径),前端仅做格式校验,不做后端联动查卡校验
5. **"职业"字段无三级码值菜单查询接口**——需求文档要求"职业表菜单选择,选择至三级码值名称",swagger 未检索到职业字典接口,退化为文本输入