feat: 电子签全场景集成+场景筛选+设置开关

- ESignRecord 模型新增 scene 字段（CONTRACT/RESIGNATION/POLICY/PAYSLIP/ONBOARDING）
- Organization 模型新增3个电子签开关：esignPolicyEnabled/esignPayslipEnabled/esignOnboardingEnabled
- 设置页面企业信息新增电子签署设置区域，3个开关各自独立，缺省关闭
- 规章制度签收：开启电子签后，员工阅读确认时自动创建POLICY场景签署记录
- 工资条确认：开启电子签后，员工确认工资条时自动创建PAYSLIP场景签署记录
- 入职文件签署：开启电子签后，HR审批通过入职流程时自动创建ONBOARDING场景签署记录
- 电子签署列表增加场景筛选下拉（全部场景/劳动合同/离职协议/规章制度/工资条/入职文件）
- 管理端和员工端列表均展示场景标签（基于scene字段，替代硬编码判断）
- 合同和离职流程的esign调用已加scene参数

backend/prisma/schema.prisma

@@ -132,6 +132,9 @@ model Organization {
   contactPhone String?
   payrollFrequency Int    @default(1)  // 每月发薪次数（1=一次一批）
   retirementReminderEnabled Boolean @default(false) // 退休提醒开关
+  esignPolicyEnabled  Boolean @default(false) // 规章制度电子签
+  esignPayslipEnabled Boolean @default(false) // 工资条电子签
+  esignOnboardingEnabled Boolean @default(false) // 入职文件电子签
   createdAt    DateTime @default(now())
   updatedAt    DateTime @updatedAt
 
@@ -1465,6 +1468,7 @@ model ESignRecord {
   contractId      String?  // 关联 LaborContract
   employeeId      String
   employee        Employee @relation(fields: [employeeId], references: [id], onDelete: Cascade)
+  scene           String   @default("CONTRACT") // CONTRACT | RESIGNATION | POLICY | PAYSLIP | ONBOARDING
   flowId          String?  // 易签宝流程ID
   documentTitle   String   // 文件标题
   documentContent String?  // 文件内容（HTML/PDF base64）

backend/src/routes/esign.routes.ts

@@ -12,16 +12,19 @@ const createSignSchema = z.object({
   documentTitle: z.string().min(1),
   documentContent: z.string().optional(),
   remark: z.string().optional(),
+  scene: z.string().optional(),
 })
 
 // 签署记录列表
 router.get('/', async (req: AuthRequest, res: Response, next: NextFunction) => {
   try {
     const status = req.query.status as string | undefined
+    const scene = req.query.scene as string | undefined
     const records = await prisma.eSignRecord.findMany({
       where: {
         orgId: req.user!.orgId,
         ...(status && { status }),
+        ...(scene && { scene }),
       },
       include: {
         employee: { select: { id: true, name: true, department: true, phone: true } },
@@ -56,6 +59,7 @@ router.post('/create', async (req: AuthRequest, res: Response, next: NextFunctio
         orgId: req.user!.orgId,
         contractId: data.contractId || null,
         employeeId: data.employeeId,
+        scene: data.scene || 'CONTRACT',
         documentTitle: data.documentTitle,
         documentContent: data.documentContent || null,
         // flowId: esignResult.flowId,  // TODO: 易签宝对接后启用

backend/src/routes/portal.routes.ts

@@ -171,6 +171,25 @@ router.post('/payslip/:id/confirm', portalAuth, async (req: any, res, next) => {
       events: [{ action: '工资条确认', timestamp: new Date().toISOString(), ip: req.ip, userAgent: req.headers['user-agent'] }],
       createdBy: req.employee.id,
     }).catch(() => {})
+
+    // 如果开启了工资条电子签，创建电子签记录
+    const org = await prisma.organization.findUnique({ where: { id: req.employee.orgId }, select: { esignPayslipEnabled: true } })
+    if (org?.esignPayslipEnabled) {
+      await prisma.eSignRecord.create({
+        data: {
+          orgId: req.employee.orgId,
+          employeeId: req.employee.id,
+          scene: 'PAYSLIP',
+          documentTitle: `工资条确认：${payslip.month}`,
+          status: 'PENDING',
+          initiatedBy: req.employee.id,
+          createdBy: req.employee.id,
+          remark: '工资条确认时自动发起',
+          expiredAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
+        },
+      })
+    }
+
     res.json({ success: true })
   } catch (err) {
     next(err)
@@ -544,6 +563,27 @@ router.post('/policies/:id/read', portalAuth, async (req: Request, res: Response
         userAgent: req.headers['user-agent'] || null,
       },
     })
+
+    // 如果开启了制度电子签，创建电子签记录
+    const org = await prisma.organization.findUnique({ where: { id: orgId }, select: { esignPolicyEnabled: true } })
+    if (org?.esignPolicyEnabled) {
+      const policyDoc = await prisma.policyDocument.findUnique({ where: { id: req.params.id }, select: { title: true, content: true } })
+      await prisma.eSignRecord.create({
+        data: {
+          orgId,
+          employeeId,
+          scene: 'POLICY',
+          documentTitle: `制度签收：${policyDoc?.title || '未知'}`,
+          documentContent: policyDoc?.content || null,
+          status: 'PENDING',
+          initiatedBy: employeeId,
+          createdBy: employeeId,
+          remark: '制度阅读确认后自动发起',
+          expiredAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
+        },
+      })
+    }
+
     res.json({ success: true, data: { readAt: record.readAt.toISOString() } })
   } catch (err) {
     next(err)

backend/src/routes/settings.routes.ts

@@ -28,7 +28,7 @@ router.get('/org', async (req: AuthRequest, res, next) => {
   try {
     const org = await prisma.organization.findUnique({
       where: { id: req.user!.orgId },
-      select: { id: true, name: true, plan: true, maxEmployees: true, city: true, contactName: true, contactPhone: true, payrollFrequency: true, retirementReminderEnabled: true, createdAt: true },
+      select: { id: true, name: true, plan: true, maxEmployees: true, city: true, contactName: true, contactPhone: true, payrollFrequency: true, retirementReminderEnabled: true, esignPolicyEnabled: true, esignPayslipEnabled: true, esignOnboardingEnabled: true, createdAt: true },
     })
     res.json({ success: true, data: org })
   } catch (err) {
@@ -39,7 +39,7 @@ router.get('/org', async (req: AuthRequest, res, next) => {
 // 更新企业信息
 router.put('/org', requireAdmin, async (req: AuthRequest, res, next) => {
   try {
-    const { name, payrollFrequency, city, contactName, contactPhone, retirementReminderEnabled } = req.body as { name?: string; payrollFrequency?: number; city?: string; contactName?: string; contactPhone?: string; retirementReminderEnabled?: boolean }
+    const { name, payrollFrequency, city, contactName, contactPhone, retirementReminderEnabled, esignPolicyEnabled, esignPayslipEnabled, esignOnboardingEnabled } = req.body as { name?: string; payrollFrequency?: number; city?: string; contactName?: string; contactPhone?: string; retirementReminderEnabled?: boolean; esignPolicyEnabled?: boolean; esignPayslipEnabled?: boolean; esignOnboardingEnabled?: boolean }
     const updateData: any = {}
     if (name) updateData.name = name
     if (payrollFrequency !== undefined) updateData.payrollFrequency = payrollFrequency
@@ -47,10 +47,13 @@ router.put('/org', requireAdmin, async (req: AuthRequest, res, next) => {
     if (contactName !== undefined) updateData.contactName = contactName
     if (contactPhone !== undefined) updateData.contactPhone = contactPhone
     if (retirementReminderEnabled !== undefined) updateData.retirementReminderEnabled = retirementReminderEnabled
+    if (esignPolicyEnabled !== undefined) updateData.esignPolicyEnabled = esignPolicyEnabled
+    if (esignPayslipEnabled !== undefined) updateData.esignPayslipEnabled = esignPayslipEnabled
+    if (esignOnboardingEnabled !== undefined) updateData.esignOnboardingEnabled = esignOnboardingEnabled
     const org = await prisma.organization.update({
       where: { id: req.user!.orgId },
       data: updateData,
-      select: { id: true, name: true, plan: true, maxEmployees: true, city: true, contactName: true, contactPhone: true, payrollFrequency: true, retirementReminderEnabled: true },
+      select: { id: true, name: true, plan: true, maxEmployees: true, city: true, contactName: true, contactPhone: true, payrollFrequency: true, retirementReminderEnabled: true, esignPolicyEnabled: true, esignPayslipEnabled: true, esignOnboardingEnabled: true },
     })
     res.json({ success: true, data: org })
   } catch (err) {

backend/src/routes/work-process.routes.ts

@@ -164,6 +164,27 @@ router.post('/:id/approve', authMiddleware, async (req: AuthRequest, res: Respon
         ...(execResult.employeeId && !process.employeeId && { employeeId: execResult.employeeId }),
       },
     })
+
+    // 入职审批通过且开启了入职文件电子签，创建电子签记录
+    if (execResult.employeeId && process.type === 'ONBOARDING') {
+      const orgSettings = await prisma.organization.findUnique({ where: { id: req.user!.orgId }, select: { esignOnboardingEnabled: true } })
+      if (orgSettings?.esignOnboardingEnabled) {
+        await prisma.eSignRecord.create({
+          data: {
+            orgId: req.user!.orgId,
+            employeeId: execResult.employeeId,
+            scene: 'ONBOARDING',
+            documentTitle: '入职文件签署',
+            status: 'PENDING',
+            initiatedBy: req.user!.id,
+            createdBy: req.user!.id,
+            remark: '入职审批通过后自动发起',
+            expiredAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
+          },
+        })
+      }
+    }
+
     res.json({ success: true, data: updated })
   } catch (err) {
     next(err)

frontend/src/lib/api-services.ts

@@ -603,9 +603,9 @@ export const benefitApi = {
 
 // ========== 电子签署（易签宝） ==========
 export const esignApi = {
-  list: (status?: string) =>
+  list: (params?: { status?: string; scene?: string }) =>
-    get('/esign', { params: status ? { status } : {} }).then(unwrap<any[]>()),
+    get('/esign', { params: params || {} }).then(unwrap<any[]>()),
-  create: (data: { contractId?: string; employeeId: string; documentTitle: string; documentContent?: string; remark?: string }) =>
+  create: (data: { contractId?: string; employeeId: string; documentTitle: string; documentContent?: string; remark?: string; scene?: string }) =>
     post('/esign/create', data),
   status: (id: string) =>
     get(`/esign/${id}/status`).then(unwrap<any>()),

frontend/src/pages/ESign.tsx

@@ -19,9 +19,18 @@ const STATUS_CONFIG: Record<string, { label: string; color: string }> = {
   CANCELLED: { label: '已取消', color: 'bg-gray-100 text-gray-500' },
 }
 
+const SCENE_CONFIG: Record<string, { label: string; color: string }> = {
+  CONTRACT: { label: '劳动合同', color: 'bg-blue-50 text-blue-600 border border-blue-200' },
+  RESIGNATION: { label: '离职协议', color: 'bg-orange-50 text-orange-600 border border-orange-200' },
+  POLICY: { label: '规章制度', color: 'bg-amber-50 text-amber-600 border border-amber-200' },
+  PAYSLIP: { label: '工资条', color: 'bg-emerald-50 text-emerald-600 border border-emerald-200' },
+  ONBOARDING: { label: '入职文件', color: 'bg-purple-50 text-purple-600 border border-purple-200' },
+}
+
 export default function ESign() {
   const queryClient = useQueryClient()
   const [filterStatus, setFilterStatus] = useState('')
+  const [filterScene, setFilterScene] = useState('')
   const [showCreate, setShowCreate] = useState(false)
   const [formData, setFormData] = useState({
     employeeId: '',
@@ -30,9 +39,9 @@ export default function ESign() {
   })
 
   const { data: records = [], isLoading } = useQuery<any[]>({
-    queryKey: ['esign-records', filterStatus],
+    queryKey: ['esign-records', filterStatus, filterScene],
     queryFn: async () => {
-      return await esignApi.list(filterStatus || undefined)
+      return await esignApi.list({ status: filterStatus || undefined, scene: filterScene || undefined })
     },
   })
 
@@ -114,6 +123,14 @@ export default function ESign() {
             <option value="">全部状态</option>
             {Object.entries(STATUS_CONFIG).map(([k, v]) => <option key={k} value={k}>{v.label}</option>)}
           </select>
+          <select
+            value={filterScene}
+            onChange={(e) => setFilterScene(e.target.value)}
+            className="h-9 rounded-md border border-gray-200 bg-white px-3 text-sm text-gray-700 shadow-sm outline-none transition focus:border-primary focus:ring-2 focus:ring-primary/10"
+          >
+            <option value="">全部场景</option>
+            {Object.entries(SCENE_CONFIG).map(([k, v]) => <option key={k} value={k}>{v.label}</option>)}
+          </select>
         </div>
         <Button size="sm" onClick={() => setShowCreate(true)}>
           <Plus className="w-4 h-4 mr-1" />发起签署
@@ -149,11 +166,8 @@ export default function ESign() {
                         <div className="flex items-center gap-1.5">
                           <FileText className="w-3.5 h-3.5 text-gray-400 shrink-0" />
                           <span className="font-medium truncate max-w-[200px]">{r.documentTitle}</span>
-                          {r.contractId && (
+                          {r.scene && SCENE_CONFIG[r.scene] && (
-                            <span className="px-1.5 py-0.5 rounded text-xs bg-blue-50 text-blue-600 border border-blue-200 shrink-0">劳动合同</span>
+                            <span className={`px-1.5 py-0.5 rounded text-xs shrink-0 ${SCENE_CONFIG[r.scene].color}`}>{SCENE_CONFIG[r.scene].label}</span>
-                          )}
-                          {!r.contractId && r.documentTitle?.includes('离职') && (
-                            <span className="px-1.5 py-0.5 rounded text-xs bg-orange-50 text-orange-600 border border-orange-200 shrink-0">离职协议</span>
                           )}
                         </div>
                         {r.remark && <div className="text-xs text-gray-400 mt-0.5">{r.remark}</div>}

frontend/src/pages/Settings.tsx

@@ -1,7 +1,7 @@
 import { useState, useEffect } from 'react'
 import { toast } from 'sonner'
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
-import { Building2, Users, CreditCard, Plus, Bell, Download, Upload, FileSpreadsheet, Clock, CheckCircle, AlertCircle, ClipboardList, LayoutGrid } from 'lucide-react'
+import { Building2, Users, CreditCard, Plus, Bell, Download, Upload, FileSpreadsheet, Clock, CheckCircle, AlertCircle, ClipboardList, LayoutGrid, PenTool } from 'lucide-react'
 import { settingsApi, notificationsApi } from '../lib/api-services'
 import { useAuthStore } from '../store/authStore'
 import { getPageSize, setPageSize as setGlobalPageSize } from '../lib/pageSize'
@@ -93,6 +93,9 @@ function OrgSettings({ orgData, onSave, saving }: { orgData: any; onSave: (data:
     contactPhone: '',
     payrollFrequency: 1,
     retirementReminderEnabled: false,
+    esignPolicyEnabled: false,
+    esignPayslipEnabled: false,
+    esignOnboardingEnabled: false,
   })
 
   useEffect(() => {
@@ -103,6 +106,9 @@ function OrgSettings({ orgData, onSave, saving }: { orgData: any; onSave: (data:
         contactPhone: orgData.contactPhone || '',
         payrollFrequency: orgData.payrollFrequency || 1,
         retirementReminderEnabled: orgData.retirementReminderEnabled || false,
+        esignPolicyEnabled: orgData.esignPolicyEnabled || false,
+        esignPayslipEnabled: orgData.esignPayslipEnabled || false,
+        esignOnboardingEnabled: orgData.esignOnboardingEnabled || false,
       })
     }
   }, [orgData])
@@ -139,6 +145,36 @@ function OrgSettings({ orgData, onSave, saving }: { orgData: any; onSave: (data:
       </div>
 
       <RetirementSection enabled={form.retirementReminderEnabled} onToggle={(v) => { setForm({ ...form, retirementReminderEnabled: v }); onSave({ ...form, retirementReminderEnabled: v }) }} />
+
+      {/* 电子签设置 */}
+      <div className="mt-6 pt-6 border-t">
+        <div className="flex items-center gap-2 mb-4">
+          <PenTool className="w-5 h-5 text-primary" />
+          <h3 className="font-medium">电子签署设置</h3>
+        </div>
+        <p className="text-xs text-gray-500 mb-3">开启后，对应场景将使用电子签署替代默认确认方式。关闭则保持原有确认方式（阅读确认/点击确认）。</p>
+        <div className="space-y-3">
+          {[
+            { key: 'esignPolicyEnabled', label: '规章制度电子签', desc: '开启后制度签收升级为电子签署，缺省为阅读确认' },
+            { key: 'esignPayslipEnabled', label: '工资条电子签', desc: '开启后工资条确认升级为电子签署，缺省为点击确认' },
+            { key: 'esignOnboardingEnabled', label: '入职文件电子签', desc: '开启后入职填报时签署入职相关文件，缺省不签' },
+          ].map(item => (
+            <div key={item.key} className="flex items-center justify-between p-3 rounded-lg bg-gray-50">
+              <div>
+                <div className="text-sm font-medium">{item.label}</div>
+                <div className="text-xs text-gray-500 mt-0.5">{item.desc}</div>
+              </div>
+              <button
+                type="button"
+                onClick={() => { const v = !form[item.key as keyof typeof form]; setForm({ ...form, [item.key]: v }); onSave({ ...form, [item.key]: v }) }}
+                className={`relative inline-flex h-6 w-11 items-center rounded-full transition-colors shrink-0 ml-4 ${form[item.key as keyof typeof form] ? 'bg-primary' : 'bg-gray-300'}`}
+              >
+                <span className={`inline-block h-4 w-4 transform rounded-full bg-white transition-transform ${form[item.key as keyof typeof form] ? 'translate-x-6' : 'translate-x-1'}`} />
+              </button>
+            </div>
+          ))}
+        </div>
+      </div>
     </Card>
   )
 }

frontend/src/pages/Termination.tsx

@@ -1559,6 +1559,7 @@ export default function Termination() {
                           employeeId,
                           documentTitle: '离职协议',
                           remark: '离职流程中发起',
+                          scene: 'RESIGNATION',
                         })
                         queryClient.invalidateQueries({ queryKey: ['esign-records'] })
                         toast.success('离职协议电子签署已发起')

frontend/src/pages/portal/MyEsign.tsx

@@ -18,6 +18,14 @@ const STATUS_MAP: Record<string, { label: string; color: string; icon: React.Rea
   EXPIRED: { label: '已过期', color: 'bg-red-50 text-red-600', icon: <XCircle className="w-3 h-3" /> },
 }
 
+const SCENE_LABELS: Record<string, { label: string; color: string }> = {
+  CONTRACT: { label: '劳动合同', color: 'bg-blue-50 text-blue-600 border border-blue-200' },
+  RESIGNATION: { label: '离职协议', color: 'bg-orange-50 text-orange-600 border border-orange-200' },
+  POLICY: { label: '规章制度', color: 'bg-amber-50 text-amber-600 border border-amber-200' },
+  PAYSLIP: { label: '工资条', color: 'bg-emerald-50 text-emerald-600 border border-emerald-200' },
+  ONBOARDING: { label: '入职文件', color: 'bg-purple-50 text-purple-600 border border-purple-200' },
+}
+
 export default function MyEsign() {
   const queryClient = useQueryClient()
   const [selectedId, setSelectedId] = useState<string | null>(null)
@@ -101,6 +109,11 @@ export default function MyEsign() {
                 <FileText className="w-3.5 h-3.5" />关联合同
               </div>
             )}
+            {detail.scene && SCENE_LABELS[detail.scene] && (
+              <div className="mb-4">
+                <span className={`px-2 py-0.5 rounded text-xs ${SCENE_LABELS[detail.scene].color}`}>{SCENE_LABELS[detail.scene].label}</span>
+              </div>
+            )}
 
             {/* 签署操作 */}
             <div className="border-t pt-4">
@@ -169,8 +182,8 @@ export default function MyEsign() {
                   <div className="flex-1 min-w-0">
                     <div className="flex items-center gap-1.5">
                       <span className="text-sm font-medium truncate min-w-0">{r.documentTitle}</span>
-                      {r.contractId && (
+                      {r.scene && SCENE_LABELS[r.scene] && (
-                        <span className="px-1.5 py-0.5 rounded text-xs bg-blue-50 text-blue-600 border border-blue-200 flex-shrink-0">劳动合同</span>
+                        <span className={`px-1.5 py-0.5 rounded text-xs flex-shrink-0 ${SCENE_LABELS[r.scene].color}`}>{SCENE_LABELS[r.scene].label}</span>
                       )}
                     </div>
                     <div className="text-xs text-gray-500 mt-1">

frontend/src/pages/roster/ContractInfo.tsx

@@ -27,6 +27,7 @@ export default function ContractInfo({ employeeId, contracts, hireDate }: { empl
             employeeId,
             documentTitle: `${data.contractType === 'UNFIXED' ? '无固定期限' : '固定期限'}劳动合同`,
             remark: '合同创建时自动发起',
+            scene: 'CONTRACT',
           })
           toast.success('合同已保存，电子签署记录已创建')
         } catch {