feat(shopro_huifu): 添加汇付进件管理功能

- 新增汇付进件管理模块,支持新建、编辑进件流程
- 实现用户角色绑定验证功能,确保进件角色的有效性
- 集成Vue.js前端界面,提供完整的表单操作体验
- 支持个人和企业两种账户类型的进件资料录入
- 添加银行支行搜索功能,方便结算账户信息填写
- 完善进件状态管理和审核流程控制
- 增加图片上传组件,支持身份证、营业执照等证件上传
```
这个提交包含在:
可乐加冰
2026-09-29 15:40:36 +08:00
父节点 f2bca20a22
当前提交 2e7cbefdcd
共有 11 个文件被更改,包括 1307 次插入 和 3 次删除

查看文件

@@ -0,0 +1,47 @@
<?php
namespace addons\shopro_huifu\library\onboard;
use addons\shopro_huifu\model\Onboard;
use think\Db;
class HuifuOnboardAdminService
{
public function saveDraft($userId, $roleType, $roleRefId, array $formData)
{
$userId = intval($userId);
$roleRefId = intval($roleRefId);
if ($userId <= 0) {
throw new \InvalidArgumentException('请选择用户');
}
if (!in_array($roleType, ['promoter', 'regional_agent'], true)) {
throw new \InvalidArgumentException('请选择进件角色');
}
$this->assertRoleBinding($userId, $roleType, $roleRefId);
$service = new HuifuOnboardService();
return $service->saveDraft($userId, $roleType, $roleRefId, $formData);
}
protected function assertRoleBinding($userId, $roleType, $roleRefId)
{
if ($roleType === 'promoter') {
if ($roleRefId !== $userId) {
throw new \InvalidArgumentException('分销商角色参数无效');
}
$agent = Db::name('shopro_commission_agent')->where('user_id', $userId)->find();
if (!$agent) {
throw new \InvalidArgumentException('该用户不是分销商,无法创建分销商进件');
}
return;
}
$agent = Db::name('shopro_regional_agent')
->where('id', $roleRefId)
->where('user_id', $userId)
->find();
if (!$agent) {
throw new \InvalidArgumentException('区域公司与用户不匹配');
}
}
}

查看文件

@@ -206,4 +206,140 @@ class HuifuOnboardAdminView
}
return substr($value, 0, 4) . '-' . substr($value, 4, 2) . '-' . substr($value, 6, 2);
}
/**
* 后台新建/编辑进件:列出用户可绑定的角色
*/
public static function listRolesForUser($userId)
{
$userId = intval($userId);
if ($userId <= 0) {
return [];
}
$roles = [];
$commissionAgent = Db::name('shopro_commission_agent')->where('user_id', $userId)->find();
if ($commissionAgent) {
$row = \addons\shopro_huifu\model\Onboard::findByRole($userId, 'promoter', $userId);
$roles[] = self::buildRoleOption(
'promoter',
$userId,
'分销商',
$commissionAgent['status'] ?? '',
$row
);
}
$regionalAgents = Db::name('shopro_regional_agent')->where('user_id', $userId)->order('id desc')->select();
foreach ($regionalAgents as $agent) {
$row = \addons\shopro_huifu\model\Onboard::findByRole($userId, 'regional_agent', $agent['id']);
$label = '区域公司';
if (!empty($agent['area_name'])) {
$label .= '(' . $agent['area_name'] . ')';
}
$roles[] = self::buildRoleOption(
'regional_agent',
$agent['id'],
$label,
$agent['status'] ?? '',
$row
);
}
return $roles;
}
protected static function buildRoleOption($roleType, $roleRefId, $label, $agentStatus, $onboardRow)
{
$onboardStatus = $onboardRow ? ($onboardRow['onboard_status'] ?? '') : '';
$blocked = $onboardRow && in_array($onboardStatus, [
\addons\shopro_huifu\model\Onboard::STATUS_SUBMITTING,
\addons\shopro_huifu\model\Onboard::STATUS_BASIC_OK,
\addons\shopro_huifu\model\Onboard::STATUS_BUSI_PENDING,
\addons\shopro_huifu\model\Onboard::STATUS_APPROVED,
], true);
return [
'role_type' => $roleType,
'role_ref_id' => $roleRefId,
'role_label' => $label,
'agent_status' => $agentStatus,
'onboard_id' => $onboardRow ? intval($onboardRow['id']) : 0,
'onboard_status' => $onboardStatus ?: null,
'can_save' => !$blocked,
'disabled_reason' => $blocked ? '该角色进件处理中或已通过,不可新建/覆盖' : '',
];
}
public static function defaultFormData()
{
return [
'account_type' => 'indv',
'bank_account_type' => '0',
'name' => '',
'cert_no' => '',
'cert_validity_type' => '1',
'cert_begin_date' => '',
'cert_end_date' => '',
'mobile_no' => '',
'reg_detail' => '',
'shopro_province_id' => '',
'shopro_city_id' => '',
'shopro_district_id' => '',
'prov_id' => '',
'area_id' => '',
'district_id' => '',
'card_no' => '',
'card_name' => '',
'branch_code' => '',
'branch_name' => '',
'mp' => '',
'id_card_front_url' => '',
'id_card_back_url' => '',
'bank_card_url' => '',
'reg_name' => '',
'license_code' => '',
'license_validity_type' => '1',
'license_begin_date' => '',
'license_end_date' => '',
'legal_name' => '',
'legal_mobile' => '',
'legal_cert_no' => '',
'legal_cert_validity_type' => '1',
'legal_cert_begin_date' => '',
'legal_cert_end_date' => '',
'license_url' => '',
'legal_id_front_url' => '',
'legal_id_back_url' => '',
'account_permit_url' => '',
];
}
public static function formDataFromRow($row)
{
$data = is_array($row) ? $row : $row->toArray();
$payload = self::parsePayload($data['payload'] ?? '');
$form = array_merge(self::defaultFormData(), $payload);
foreach (['id_card_front_url', 'id_card_back_url', 'bank_card_url', 'license_url', 'legal_id_front_url', 'legal_id_back_url', 'account_permit_url'] as $field) {
if (!empty($form[$field])) {
$form[$field] = self::fullUrl($form[$field]);
}
}
$user = self::fetchUser($data['user_id'] ?? 0);
$roles = self::listRolesForUser($data['user_id'] ?? 0);
$roleLabel = '';
foreach ($roles as $role) {
if ($role['role_type'] === ($data['role_type'] ?? '') && intval($role['role_ref_id']) === intval($data['role_ref_id'] ?? 0)) {
$roleLabel = $role['role_label'];
break;
}
}
return [
'onboard_id' => intval($data['id'] ?? 0),
'user_id' => intval($data['user_id'] ?? 0),
'user_label' => trim(($user['nickname'] ?? '') . ' (' . ($user['mobile'] ?? $data['user_id']) . ')'),
'role_type' => $data['role_type'] ?? '',
'role_ref_id' => intval($data['role_ref_id'] ?? 0),
'role_label' => $roleLabel,
'onboard_status' => $data['onboard_status'] ?? '',
'form' => $form,
];
}
}