feat: company certification

packages/global/common/error/code/team.ts

@@ -1,3 +1,4 @@
+import { EnterpriseAuthErrEnum } from '../../../support/user/team/enterpriseAuth/constant';
 import { i18nT } from '../../i18n/utils';
 import type { ErrType } from '../errorCode';
 /* team: 500000 */
@@ -154,17 +155,76 @@ const teamErr = [
   {
     statusText: TeamErrEnum.sandboxNotSupport,
     message: i18nT('common:code_error.team_error.sandbox_not_support')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.disabled,
+    message: i18nT('common:enterprise_auth.error.disabled')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.serviceNotConfigured,
+    message: i18nT('common:enterprise_auth.error.service_not_configured')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.noRemainingTimes,
+    message: i18nT('common:enterprise_auth.error.no_remaining_times')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.alreadyVerified,
+    message: i18nT('common:enterprise_auth.error.already_verified')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.enterpriseOccupied,
+    message: i18nT('common:enterprise_auth.error.enterprise_occupied')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.tooFrequent,
+    message: i18nT('common:enterprise_auth.error.too_frequent')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.serviceError,
+    message: i18nT('common:enterprise_auth.error.service_error')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.serviceTimeout,
+    message: i18nT('common:enterprise_auth.error.service_timeout')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.infoFailed,
+    message: i18nT('common:enterprise_auth.error.info_failed')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.taskNotFound,
+    message: i18nT('common:enterprise_auth.error.task_not_found')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.taskExpired,
+    message: i18nT('common:enterprise_auth.error.task_expired')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.amountError,
+    message: i18nT('common:enterprise_auth.error.amount_error')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.amountFailed,
+    message: i18nT('common:enterprise_auth.error.amount_failed')
+  },
+  {
+    statusText: EnterpriseAuthErrEnum.processing,
+    message: i18nT('common:enterprise_auth.error.processing')
   }
 ];
 
-export default teamErr.reduce((acc, cur, index) => {
-  return {
-    ...acc,
-    [cur.statusText]: {
-      code: 500000 + index,
-      statusText: cur.statusText,
-      message: cur.message,
-      data: null
-    }
-  };
-}, {} as ErrType<`${TeamErrEnum}`>);
+export default teamErr.reduce(
+  (acc, cur, index) => {
+    return {
+      ...acc,
+      [cur.statusText]: {
+        code: 500000 + index,
+        statusText: cur.statusText,
+        message: cur.message,
+        data: null
+      }
+    };
+  },
+  {} as ErrType<`${TeamErrEnum}` | `${EnterpriseAuthErrEnum}`>
+);

packages/global/common/system/types/index.ts

@@ -61,6 +61,7 @@ export type FastGPTFeConfigsType = {
   show_aiproxy?: boolean;
   show_coupon?: boolean;
   show_discount_coupon?: boolean;
+  show_enterprise_auth?: boolean;
   showWecomConfig?: boolean;
 
   show_dataset_feishu?: boolean;

packages/global/openapi/support/user/team/enterpriseAuth/api.ts

@@ -0,0 +1,205 @@
+import z from 'zod';
+import { IntSchema } from '../../../../../common/zod';
+import {
+  EnterpriseAuthAmountMaxErrorTimes,
+  EnterpriseAuthMaxTimes,
+  TeamEnterpriseAuthStatusEnum,
+  TeamEnterpriseAuthTaskStatusEnum
+} from '../../../../../support/user/team/enterpriseAuth/constant';
+
+/* ============================================================================
+ * API: 获取企业认证状态
+ * Route: GET /api/support/user/team/enterpriseAuth/status
+ * Method: GET
+ * Description: 获取当前团队企业认证入口开关、认证状态和可恢复任务信息
+ * Tags: ['团队管理']
+ * ============================================================================ */
+
+export const EnterpriseAuthLightTaskSchema = z.object({
+  taskId: z.string().meta({ description: '认证任务 ID' }),
+  status: z.enum(TeamEnterpriseAuthTaskStatusEnum).meta({ description: '当前任务状态' }),
+  amountErrorTimes: z.number().int().meta({
+    description: '当前任务金额填写错误次数',
+    example: 0
+  }),
+  expireAt: z.date().optional().meta({ description: '金额验证过期时间' })
+});
+
+export const GetEnterpriseAuthStatusResponseSchema = z.object({
+  enabled: z.boolean().meta({ description: '企业认证入口是否开启' }),
+  status: z.enum(TeamEnterpriseAuthStatusEnum).optional().meta({ description: '团队认证状态' }),
+  usedTimes: z
+    .number()
+    .int()
+    .optional()
+    .meta({ description: `已使用认证次数，最多 ${EnterpriseAuthMaxTimes} 次`, example: 0 }),
+  canManage: z.boolean().optional().meta({ description: '当前成员是否可管理企业认证' }),
+  verifiedEnterpriseName: z.string().optional().meta({ description: '认证通过企业名称' }),
+  currentTask: EnterpriseAuthLightTaskSchema.optional().meta({
+    description: '未完成认证任务；expireAt 仅金额验证阶段存在'
+  }),
+  lastErrorCode: z.string().optional().meta({ description: '最近一次失败错误码' }),
+  lastErrorMessage: z.string().optional().meta({ description: '最近一次失败提示' })
+});
+export type GetEnterpriseAuthStatusResponseType = z.infer<
+  typeof GetEnterpriseAuthStatusResponseSchema
+>;
+
+/* ============================================================================
+ * API: 获取当前企业认证任务详情
+ * Route: GET /api/support/user/team/enterpriseAuth/currentTaskDetail
+ * Method: GET
+ * Description: 获取待金额验证任务的完整展示信息，不返回验证金额
+ * Tags: ['团队管理']
+ * ============================================================================ */
+
+export const GetEnterpriseAuthCurrentTaskDetailResponseSchema = z.object({
+  taskId: z.string().meta({ description: '认证任务 ID' }),
+  status: z.enum(TeamEnterpriseAuthTaskStatusEnum).meta({ description: '当前任务状态' }),
+  enterpriseName: z.string().meta({ description: '企业名称' }),
+  unifiedCreditCode: z.string().meta({ description: '统一社会信用代码' }),
+  legalPersonName: z.string().meta({ description: '法人姓名' }),
+  bankName: z.string().meta({ description: '开户银行总行名称' }),
+  bankAccount: z.string().meta({ description: '企业银行账号，仅此接口返回完整值' }),
+  contactName: z.string().meta({ description: '联系人姓名' }),
+  contactTitle: z.string().meta({ description: '联系人职位' }),
+  contactPhone: z.string().meta({ description: '联系人手机号' }),
+  demand: z.string().meta({ description: '需求描述' }),
+  amountErrorTimes: z.number().int().meta({ description: '金额错误次数' }),
+  expireAt: z.date().meta({ description: '金额验证过期时间' })
+});
+export type GetEnterpriseAuthCurrentTaskDetailResponseType = z.infer<
+  typeof GetEnterpriseAuthCurrentTaskDetailResponseSchema
+>;
+
+/* ============================================================================
+ * API: 获取企业认证银行列表
+ * Route: GET /api/support/user/team/enterpriseAuth/banks
+ * Method: GET
+ * Description: 从小额汇款服务获取银行编码到总行名称映射
+ * Tags: ['团队管理']
+ * ============================================================================ */
+
+export const GetEnterpriseAuthBanksResponseSchema = z.record(z.string(), z.string()).meta({
+  description: '银行编码到银行名称的映射'
+});
+export type GetEnterpriseAuthBanksResponseType = z.infer<
+  typeof GetEnterpriseAuthBanksResponseSchema
+>;
+
+const EnterpriseAuthRequiredStringSchema = z.string().trim().min(1);
+const BankAccountSchema = EnterpriseAuthRequiredStringSchema.transform((account) =>
+  account.replace(/\s+/g, '')
+)
+  .pipe(z.string().regex(/^\d{1,64}$/))
+  .meta({
+    description: '企业银行账号，仅支持 1-64 位数字，可输入空格分隔',
+    example: '6222000000000000000'
+  });
+const UnifiedCreditCodeSchema = EnterpriseAuthRequiredStringSchema.transform((code) =>
+  code.toUpperCase()
+)
+  .pipe(z.string().regex(/^[0-9A-HJ-NPQRTUWXY]{18}$/))
+  .meta({
+    description: '统一社会信用代码，18 位大写数字或字母（不包含 I/O/Z/S/V）',
+    example: '91310000MA1K000000'
+  });
+
+export const StartEnterpriseAuthBodySchema = z.object({
+  enterpriseName: EnterpriseAuthRequiredStringSchema.max(100).meta({
+    description: '企业全称，需与银行开户名一致',
+    example: '示例科技有限公司'
+  }),
+  unifiedCreditCode: UnifiedCreditCodeSchema,
+  legalPersonName: EnterpriseAuthRequiredStringSchema.max(50).meta({
+    description: '法人姓名',
+    example: '张三'
+  }),
+  bankAccount: BankAccountSchema,
+  bankName: EnterpriseAuthRequiredStringSchema.max(80).meta({
+    description: '开户银行总行名称',
+    example: '中国工商银行'
+  }),
+  contactName: EnterpriseAuthRequiredStringSchema.max(50).meta({
+    description: '联系人姓名',
+    example: '李四'
+  }),
+  contactTitle: EnterpriseAuthRequiredStringSchema.max(50).meta({
+    description: '联系人职位',
+    example: '产品负责人'
+  }),
+  contactPhone: EnterpriseAuthRequiredStringSchema.max(30).meta({
+    description: '联系人手机号',
+    example: '13800000000'
+  }),
+  demand: EnterpriseAuthRequiredStringSchema.max(500).meta({
+    description: '使用需求描述',
+    example: '希望了解企业知识库和工作流能力'
+  })
+});
+export type StartEnterpriseAuthBodyType = z.infer<typeof StartEnterpriseAuthBodySchema>;
+
+/* ============================================================================
+ * API: 发起企业认证
+ * Route: POST /api/support/user/team/enterpriseAuth/start
+ * Method: POST
+ * Description: 创建小额汇款认证任务，打款成功后返回待金额验证任务
+ * Tags: ['团队管理']
+ * ============================================================================ */
+
+export const StartEnterpriseAuthResponseSchema = z.object({
+  status: z.enum(TeamEnterpriseAuthStatusEnum).meta({ description: '团队认证状态' }),
+  currentTask: EnterpriseAuthLightTaskSchema.optional().meta({
+    description: '未完成认证任务；仅 pending_amount/amount_failed 可进入金额验证页'
+  }),
+  usedTimes: z
+    .number()
+    .int()
+    .meta({ description: `已使用认证次数，最多 ${EnterpriseAuthMaxTimes} 次` }),
+  message: z.string().optional().meta({ description: '流程提示' })
+});
+export type StartEnterpriseAuthResponseType = z.infer<typeof StartEnterpriseAuthResponseSchema>;
+
+export const VerifyEnterpriseAuthAmountBodySchema = z.object({
+  taskId: z.string().min(1).meta({ description: '认证任务 ID' }),
+  amountFen: IntSchema.meta({
+    description: '用户填写的到账金额，单位为分',
+    example: 123
+  })
+});
+export type VerifyEnterpriseAuthAmountBodyType = z.infer<
+  typeof VerifyEnterpriseAuthAmountBodySchema
+>;
+
+/* ============================================================================
+ * API: 验证企业认证打款金额
+ * Route: POST /api/support/user/team/enterpriseAuth/verifyAmount
+ * Method: POST
+ * Description: 校验到账金额并在成功后发放企业认证赠送权益
+ * Tags: ['团队管理']
+ * ============================================================================ */
+
+export const VerifyEnterpriseAuthAmountResponseSchema = z.object({
+  status: z.enum(TeamEnterpriseAuthStatusEnum).meta({ description: '团队认证状态' }),
+  verifiedEnterpriseName: z.string().optional().meta({ description: '认证通过企业名称' }),
+  grantExpiredAt: z.date().optional().meta({
+    description: '认证赠送高级版权益到期时间；真实权益以套餐记录 advancedSub.expiredTime 为准'
+  }),
+  amountMaxErrorTimes: z.literal(EnterpriseAuthAmountMaxErrorTimes).meta({
+    description: '金额最大错误次数'
+  })
+});
+export type VerifyEnterpriseAuthAmountResponseType = z.infer<
+  typeof VerifyEnterpriseAuthAmountResponseSchema
+>;
+
+/* ============================================================================
+ * API: 重置企业认证待金额验证任务
+ * Route: POST /api/support/user/team/enterpriseAuth/reset
+ * Method: POST
+ * Description: 用户确认信息有误后取消当前待金额验证任务
+ * Tags: ['团队管理']
+ * ============================================================================ */
+
+export const ResetEnterpriseAuthResponseSchema = z.undefined().meta({ description: '操作成功' });
+export type ResetEnterpriseAuthResponseType = z.infer<typeof ResetEnterpriseAuthResponseSchema>;