SFT/docs/superpowers/specs/2026-08-10-enterprise-loan-application-form-redesign.md

企业贷款申请表单按原型截图改造 设计文档

背景

产品提供了"授信管理 > 企业贷款申请"页面的新原型截图（页面标题"提款申请 > 授信申请单"，来自旧版"电商服务工具平台"，用户已确认这是本次要对齐的目标设计），与当前 src/views/credit/loan-application/EnterpriseLoanForm.vue（阶段设计，参照《缺失的后端接口.md》1.12节 credit-apply/enterprise-loan-application 契约实现）相比，卡片分组、字段数量与顺序均大幅不同：

• 截图结构：授信基础信息 → 法定代表人信息（含"展开 更多信息"）→ 企业信息（含"展开 更多信息"）→ 影像信息（含"他行"征信报告、下载模板项）。
• 现状结构：基础信息 → 融资条件 → 企业信息 → 特殊融资用途标识 → 法定代表人信息 → 法人配偶信息 → 紧急联系人信息 → 影像资料。

对照后端契约 CreateEnterpriseLoanDraftBto/UpdateEnterpriseLoanApplicationBto（64字段，均无 required 约束）核对，截图新增的"更多信息"区域约 60+ 个字段后端完全没有承接位置。经与产品确认，本次采用以下原则（与今日同批完成的 PersonalLoanForm.vue 改造采用的"无字段仅本地展示不提交"策略不同，此处产品明确要求严格对齐截图）：

1. 完全按截图结构重写，现状"融资条件""特殊融资用途标识""法人配偶信息"三张卡片，以及"是否市场经营者""是否政府融资平台""贷款钱包账号"三个字段，截图均未出现，随本次改造一并移除（不在 UI 呈现，也不再提交，历史数据不受影响，仅本页面不可编辑）。
2. 截图有但后端无对应字段的约 60+ 项，前端仍新建 form.xxx 本地字段正常渲染输入控件，随表单一起提交（对象里直接带上，用推测的驼峰字段名），后端如做了未知属性容错则忽略，如严格校验则可能报错——此风险已与产品确认接受，逐项登记进《缺失的后端接口.md》Part 25，待后端评估是否正式建字段。
3. 底部"手机号+获取验证码"验证交互：项目内没有任何"贷款申请场景发码"接口（唯一的 send-sms-code 是登录场景专用），本次不实现验证码发送/校验交互；"手机号"字段保留，挪到"授信基础信息"卡片内作为普通输入框，绑定已有的 phoneNo 字段（无验证逻辑）。
4. "展开 更多信息"交互复用项目现状模式：一个"展开/收起"链接 + v-if 控制字段区域显隐（PersonalLoanForm.vue"经营实体信息"区已有同类"链接/开关 + v-if"先例，本次两处更多信息区各自维护一个 ref<boolean>）。

一、整体卡片结构

EnterpriseLoanForm.vue 重写为以下卡片顺序：

1. 授信基础信息
2. 法定代表人信息（含"展开 更多信息"次级区域）
3. 企业信息（含"展开 更多信息"次级区域）
4. 影像信息
5. 提交 / 取消按钮（沿用现状右上角 a-page-header #extra 布局，不引入个人贷款申请那套"二次确认弹窗+二维码"模式——截图本身没有该交互，维持企业贷款申请现状"提交后直接返回列表"的简单流程）

整体移除（现状已实现但截图未出现，随本次改造删除 UI 与提交逻辑）：

移除内容	原字段
"融资条件"卡片（8字段）	goodsCategory、paymentCycle、singleOrderLimit、financingRatio、estimatedReturnRate、loanTerm、orderFinancingTerm、loanPurpose(注：loanPurpose 字段被"授信品种"复用，见下，不是整个删除)
"特殊融资用途标识"卡片（5字段）	repayFundSource、acceptAgricultureType、industryAdjustType、industryUpgradeFlag、newIndustryType
"法人配偶信息"卡片（5字段）	spouseName、spousePhone、spouseGender、spouseCertType、spouseCertId
"紧急联系人信息"独立卡片	迁移进"法定代表人-更多信息"区"紧急联系人"一项，字段 emergencyContactName/emergencyContactPhone 不丢，仅位置变化
企业信息卡片内 2 个字段	isMarketOperator（是否市场经营者）、isGovernmentPlatform（是否政府融资平台）——截图企业信息区无对应展示位，随卡片重写一并去掉
基础信息卡片内 1 个字段	accountNo（贷款钱包账号选择下拉）——截图授信基础信息区无对应展示位，随卡片重写去掉；如后续发现贷款放款环节仍需指定钱包账号，需产品重新确认放置位置

以上"是否市场经营者/是否政府融资平台/贷款钱包账号"三项的移除是本设计文档新增的判断（用户此前只明确确认了融资条件/特殊融资用途标识/法人配偶信息三项），请在下方"spec 自查"通过后重点复核这一点，如需保留请在 review 阶段告知。

二、字段清单与映射

标记：✅ 复用现有后端字段（沿用 form.xxx）；🆕 前端新增本地字段，一起提交（用推测字段名）；⚠️ 语义映射到现有字段但命名不完全对应，已确认按此处理。

2.1 授信基础信息

截图字段	处理	说明
授信申请人	✅ customerId/customerName	沿用 WalletCustomerPicker
机构	✅ organizationId	沿用 OrgTreeSelect
产品	✅ loanProductCode	沿用现状文本输入框，不新增选择器
授信品种	⚠️ loanPurpose	语义最接近的现有字段承接
手机号码	✅ phoneNo	从底部验证区挪到此卡片，普通输入框
申请金额（万元）	✅ loanAmount	现状 label 是"申请金额(元)"，本次按截图改为"(万元)"，仅改文案，不做单位换算（后端字段本身是无单位约束的字符串），登记为缺口供后端确认单位口径
申请利率（%）	✅ applicationInterestRate	不变
授信种类	🆕 creditCategory	a-select，选项常量 CREDIT_CATEGORY_OPTIONS（新增于 creditEnums.js），目前只有截图可见的一项 {value:'OTHER_COMPREHENSIVE_LIMIT', label:'其他综合额度'}，默认选中；完整选项列表待业务确认，不臆造

2.2 法定代表人信息

截图字段	处理
姓名	✅ legalPersonName
身份证号码	✅ legalPersonCertId
手机号码	✅ legalPersonMobile
性别	✅ legalPersonGender
出生日期	✅ legalPersonBirthday
证件到期日期 + 长期	✅ legalPersonCertExpiry，新增 🆕 legalPersonCertExpiryLongTerm（勾选态，本地布尔，不提交，仅控制日期选择器禁用+回填哨兵日期）
婚姻状况	✅ legalPersonMarital
现居住地址	✅ legalPersonResidence
通讯地址	🆕 legalPersonMailAddress（截图"更多信息"区重复出现同名字段，合并为同一个，不重复渲染两次）
最高学历	✅ legalPersonEducation
是否本地置业	🆕 isLocalPropertyOwner（Y/N，a-radio-group）
子女是否本地就学	🆕 isChildLocalSchool（Y/N）

更多信息（链接 + v-if，本地 ref legalPersonMoreVisible）：

截图字段	处理
个人开户户名	🆕 legalPersonAccountType，枚举 LOCAL_CUSTOMER(本地客户)/NON_LOCAL_CUSTOMER(异地客户)
是否本地户籍	🆕 legalPersonLocalHousehold（Y/N）
个人是否有社保医保	🆕 legalPersonHasSocialInsurance（Y/N）
民族	✅ legalPersonNationality
经营公司名称	🆕 legalPersonBusinessCompanyName
经营公司营业性质用途	🆕 legalPersonBusinessNature
经营地址	🆕 legalPersonBusinessAddress
经营邮编	🆕 legalPersonBusinessZipCode
住处邮编	🆕 legalPersonResidenceZipCode（⚠️ 截图该行文字密集易读错，若实际是别的字段含义，review 时请指正）
资信业务	🆕 legalPersonCreditBusiness
电子邮箱	✅ legalPersonEmail
通讯地址邮编	🆕 legalPersonMailZipCode
紧急联系人	✅ emergencyContactName + emergencyContactPhone（从独立卡片迁移，两个输入框：姓名/电话）
个人基本户开户	🆕 legalPersonBasicAccountOpened（Y/N）
开户行别	🆕 legalPersonBankType
个人基本户户名	🆕 legalPersonBasicAccountName
个人基本户账号	🆕 legalPersonBasicAccountNo（不复用 accountNo，该字段随"贷款钱包账号"整体移除，语义也不同）
股票代码	🆕 legalPersonStockCode
备注	🆕 legalPersonRemark（a-textarea）

2.3 企业信息

截图字段	处理
营业执照编号	🆕 businessLicenseNo
经济类型	⚠️ enterpriseOrgType
隶属经济产权	🆕 enterpriseEconomicOwnership
经营场所	⚠️ businessScope（沿用现状"经营范围"字段，必填）
证件登记经营地址	🆕 businessLicenseRegisteredAddress
证件失效日期 + 长期	✅ businessLicenseExpiry，新增 🆕 businessLicenseExpiryLongTerm（同上长期哨兵处理）
企业经济区域	🆕 enterpriseEconomicZone
通讯地址	🆕 enterpriseMailAddress
上年末从业人数	✅ annualEmployeeCount
上年营业收入	✅ annualRevenue
上年末资产总额	✅ annualTotalAssets
企业类型	✅ enterpriseType
企业代码	🆕 enterpriseCode
提款种类标识	🆕 withdrawalTypeFlag
是否本地股票参与经营	🆕 isLocalStockParticipated（Y/N）
注册资本	✅ registeredCapital + registeredCapitalCurrency
实收资本	🆕 paidInCapital
企业所在地地址	🆕 enterpriseLocationAddress
企业所在地邮编	🆕 enterpriseLocationZipCode

更多信息（链接 + v-if，本地 ref enterpriseMoreVisible）：

截图字段	处理
企业基本户是否本行开立	🆕 enterpriseBasicAccountLocalBank（Y/N）
企业基本户开户行	🆕 enterpriseBasicAccountBank
企业基本户账号	🆕 enterpriseBasicAccountNo
首要股东（占公司比例）	🆕 enterprisePrimaryShareholder
企业办公地址	🆕 enterpriseOfficeAddress
办公地址邮编	🆕 enterpriseOfficeZipCode
是否有商铺	🆕 hasStorefront（Y/N）
业绩	🆕 enterprisePerformance
是否上市公司	✅ isListedCompany
是否私人控股	✅ isPrivateControlled
上市代码	🆕 listedStockCode
企业法定代表电话 / 企业法定代表人号码	不重复渲染：与"法定代表人信息"卡片的手机号码(legalPersonMobile)/身份证号码(legalPersonCertId) 语义重复，截图这两行按重复字段处理，不新建控件
企业银行汇账户名	🆕 enterpriseRemitAccountName
企业银行汇账账号	🆕 enterpriseRemitAccountNo
企业银行汇账开户行网点	🆕 enterpriseRemitBankBranch
企业货款账户名称	🆕 enterpriseLoanPaymentAccountName
企业与他行建立信贷关系情况	🆕 enterpriseOtherBankCreditRelation
财务报表编号	🆕 financialStatementNo
企业营销所在区域	🆕 enterpriseMarketingRegion
有无对外担保情况	🆕 hasExternalGuarantee（Y/N）
是否属于中小企业	🆕 isSmeEnterprise（Y/N）
是否属地生态化	🆕 isLocalEcological（Y/N）
是否属于股权制	🆕 isEquitySystem（Y/N）
高新技术产业标识	🆕 highTechIndustryFlag，枚举 OBTAINED(已获取)/APPLYING(正申请)
公司代号及关系企业	🆕 companyCodeAndAffiliates
公司e-Mail	🆕 enterpriseEmail
公司网址	🆕 enterpriseWebsite
企业经营网址	🆕 enterpriseBusinessWebsite
企业开户方式及运营开户	🆕 enterpriseAccountOpeningMethod
企业主要产品或服务	🆕 enterpriseMainProductsServices（a-textarea）
企业经营地址范围	🆕 enterpriseBusinessAddressScope（a-textarea；截图旁边有"+"按钮暗示多值，本次简化为单个多行文本框，不做数组结构，登记简化说明）
企业股权其他情况	🆕 enterpriseEquityOtherType，枚举 OWNED(自有)/LEASED(租用)/OTHER(其他)
企业上级公司名称	🆕 parentCompanyName
企业上级公司所在地址	🆕 parentCompanyAddress
企业上级公司持股比例	🆕 parentCompanyShareRatio
备注	🆕 enterpriseRemark（a-textarea）

2.4 影像信息

截图字段	处理
营业主照	✅ 沿用 LicenseUpload（businessLicenseFileNo）
法人代表身份证（人像面/国徽面）	✅ 沿用 IdCardUpload（legalPersonIdFrontFileNo/legalPersonIdBackFileNo）
他行 - 个人征信报告	🆕 复用 LicenseUpload 新实例（upload-text="上传个人征信报告"），本地 otherBankPersonalCreditReportFileNo，fileType 占位值 'OTHER_BANK_PERSONAL_CREDIT_REPORT'
他行 - 企业征信报告	🆕 复用 LicenseUpload 新实例，本地 otherBankEnterpriseCreditReportFileNo，fileType 占位值 'OTHER_BANK_ENTERPRISE_CREDIT_REPORT'
企业营业执照 - 下载模板	禁用占位按钮（disabled title="模板文件待业务方提供"，同 PersonalLoanForm.vue 现状写法）
法定代表人 - 下载模板	同上，禁用占位按钮

四个上传项统一走 buildImageList() 拼进 loanApplicationImageBtoList；两个新增的"他行"上传项因为没有真实 fileType 枚举，fileType 用上面列出的占位字符串，登记缺口。

三、长期哨兵日期处理

复用 src/constants/customerEnums.js 的 CERTIFICATE_LONG_TERM_DATE（'9999-12-31 00:00:00'），日期部分 .slice(0, 10) = '9999-12-31'。参照 EnterpriseForm.vue 的 handleLongTermChange 写法：

function handleLegalPersonCertExpiryLongTermChange(e) {
  if (e.target.checked) {
    legalPersonCertExpiryModel.value = undefined // 日期选择器禁用并清空展示
    form.legalPersonCertExpiry = CERTIFICATE_LONG_TERM_DATE_ONLY
  } else {
    form.legalPersonCertExpiry = ''
  }
}

businessLicenseExpiry 同理新增一份。a-date-picker :disabled="form.xxxLongTerm" + a-checkbox v-model:checked="form.xxxLongTerm" @change="handleXxxLongTermChange"。

四、《缺失的后端接口.md》新增登记（Part 25）

新增一节"Part 25：授信管理 —— 企业贷款申请表单按最新原型截图改造 —— 2026-08-10 补充"，编号从 146 开始，内容涵盖：

1. 本次移除的"融资条件/特殊融资用途标识/法人配偶信息"三张卡片 + "是否市场经营者/是否政府融资平台/贷款钱包账号"字段：现状 Bto 已支持但页面不再提供录入入口，历史数据不受影响。
2. 完整列出上方 2.2/2.3 节全部 🆕 字段（约 60+ 项）及其推测提交字段名，说明 CreateEnterpriseLoanDraftBto/UpdateEnterpriseLoanApplicationBto 均无对应属性，前端仍随表单一起提交，若后端未做未知属性容错可能导致整单提交失败，需要后端评估。
3. "授信种类"（creditCategory）完整枚举选项待业务确认，当前只有截图可见的"其他综合额度"一项。
4. "证件到期日长期"哨兵日期方案（沿用已有 CERTIFICATE_LONG_TERM_DATE 惯例，非新缺口，仅说明本次两个新增位置的沿用情况）。
5. 影像信息"他行个人/企业征信报告"两个新上传项的 fileType 占位值待后端确认；"下载模板"按钮维持禁用占位现状。
6. "申请金额"单位展示由"(元)"改为"(万元)"，字段本身无单位约束，是否需要前端做换算或后端补充单位字段，待确认。
7. "企业经营地址范围"截图暗示可"+"多值录入，本次简化为单个多行文本框，非数组结构。

五、组件变更清单

文件	变更类型
src/views/credit/loan-application/EnterpriseLoanForm.vue	重写
src/constants/creditEnums.js	修改（新增 CREDIT_CATEGORY_OPTIONS 等本次新枚举常量）
缺失的后端接口.md	修改（新增 Part 25）

复用不改动：ChannelSelect.vue、OrgTreeSelect.vue、WalletCustomerPicker.vue、IdCardUpload.vue、LicenseUpload.vue。

范围边界

• 不改动 LoanApplicationList.vue、路由映射、菜单层级。
• 不改动 PersonalLoanForm.vue（今日已完成的独立改造，风格与本次不同，互不影响）。
• 不实现底部短信验证码发送/校验交互（无接口支撑）。
• 不引入"二次确认弹窗+二维码"提交流程（截图无此交互，维持企业贷款申请现状"提交后直接返回列表"）。
• 不做"企业经营地址范围"多值数组结构、不新建"授信品种/产品"选择弹窗（沿用文本输入）。

待 review 重点确认项（已在正文标注 ⚠️，此处汇总）

1. 是否同意移除"是否市场经营者/是否政府融资平台/贷款钱包账号"三个截图未出现的现有字段（本文档新增判断，非用户此前明确确认项）。
2. "住处邮编"（legalPersonResidenceZipCode）对应截图原文是否读取准确。
3. "授信种类"完整枚举选项、"申请金额"单位换算规则，均需业务后续补充，当前先用最小可用值占位。