diff --git a/.gitignore b/.gitignore index c428c384..e01f99b7 100644 --- a/.gitignore +++ b/.gitignore @@ -95,6 +95,7 @@ missing-video-files*.json /.claude/settings.local.json /.claude/worktrees/ /.playwright-mcp/ +/.performance-survey-audits/ # Temporary investigation/probe artifacts /tmp/ diff --git a/app/api/performance-survey/[...path]/route.ts b/app/api/performance-survey/[...path]/route.ts index 7b5f778b..6932454d 100644 --- a/app/api/performance-survey/[...path]/route.ts +++ b/app/api/performance-survey/[...path]/route.ts @@ -14,11 +14,13 @@ import { exportPerformanceSurveyCsv, getPerformanceSurveyDashboard, getPerformanceSurveyDashboardDetail, + getPerformanceSurveyAdminConfiguration, getPerformanceSurveyDetail, getPerformanceSurveyMe, getPerformanceSurveyNotificationStatus, getPerformanceSurveyResults, getPerformanceSurveyTemplates, + getPerformanceSurveyPositionGroups, listPerformanceSurveyDepartments, listPerformanceSurveyNotifications, listPerformanceSurveys, @@ -30,6 +32,11 @@ import { submitPerformanceSurveyResponse, syncPerformanceSurveyEmployeeProfiles, updatePerformanceSurvey, + savePerformanceSurveyAdminPositionGroup, + publishPerformanceSurveyAdminPositionGroup, + savePerformanceSurveyAdminTemplate, + clonePerformanceSurveyAdminTemplateVersion, + publishPerformanceSurveyAdminTemplateVersion, } from '@/lib/performance-survey-service' export const runtime = 'nodejs' @@ -51,6 +58,13 @@ function errorResponse(error: unknown) { return NextResponse.json({ success: false, error: error.message }, { status: error.status }) } + if (error && typeof error === 'object' && typeof (error as { status?: unknown }).status === 'number') { + return NextResponse.json( + { success: false, error: error instanceof Error ? error.message : '请求失败' }, + { status: (error as { status: number }).status }, + ) + } + const message = error instanceof Error ? error.message : '服务器错误' console.error('[performance-survey] API error:', error) return NextResponse.json({ success: false, error: message }, { status: 500 }) @@ -108,7 +122,11 @@ export async function GET(request: Request, context: RouteContext) { } if (path[0] === 'templates') { - return ok(await getPerformanceSurveyTemplates(session)) + return ok(await getPerformanceSurveyTemplates(session, url.searchParams)) + } + + if (path[0] === 'position-groups') { + return ok(await getPerformanceSurveyPositionGroups(session, url.searchParams)) } if (path[0] === 'employees') { @@ -147,6 +165,10 @@ export async function GET(request: Request, context: RouteContext) { return ok(await getPerformanceSurveyNotificationStatus(session)) } + if (path[0] === 'admin' && path[1] === 'config') { + return ok(await getPerformanceSurveyAdminConfiguration(session, url.searchParams)) + } + if (path[0] === 'admin' && path[1] === 'notifications') { return ok(await listPerformanceSurveyNotifications(session, url.searchParams)) } @@ -202,6 +224,22 @@ export async function POST(request: Request, context: RouteContext) { return ok(await syncPerformanceSurveyEmployeeProfiles(session, body)) } + if (path[0] === 'admin' && path[1] === 'position-groups' && path[2] && path[3] === 'publish') { + return ok(await publishPerformanceSurveyAdminPositionGroup(session, path[2], body)) + } + + if (path[0] === 'admin' && path[1] === 'templates' && path.length === 2) { + return ok(await savePerformanceSurveyAdminTemplate(session, body), { status: 201 }) + } + + if (path[0] === 'admin' && path[1] === 'templates' && path[2] && path[3] === 'clone') { + return ok(await clonePerformanceSurveyAdminTemplateVersion(session, path[2]), { status: 201 }) + } + + if (path[0] === 'admin' && path[1] === 'templates' && path[2] && path[3] === 'publish') { + return ok(await publishPerformanceSurveyAdminTemplateVersion(session, path[2], body)) + } + if (path[0] === 'admin' && path[1] === 'notifications' && path[2] === 'maintenance') { return ok(await runPerformanceSurveyNotificationMaintenance(session)) } @@ -226,6 +264,14 @@ export async function PATCH(request: Request, context: RouteContext) { return ok(await updatePerformanceSurvey(session, path[1], body)) } + if (path[0] === 'admin' && path[1] === 'position-groups' && path[2] && path.length === 3) { + return ok(await savePerformanceSurveyAdminPositionGroup(session, path[2], body)) + } + + if (path[0] === 'admin' && path[1] === 'templates' && path[2] && path.length === 3) { + return ok(await savePerformanceSurveyAdminTemplate(session, { ...body, versionId: path[2] })) + } + return NextResponse.json({ success: false, error: '接口不存在' }, { status: 404 }) } catch (error) { return errorResponse(error) diff --git a/app/performance-survey/PerformanceSurveyAdminConfig.test.tsx b/app/performance-survey/PerformanceSurveyAdminConfig.test.tsx new file mode 100644 index 00000000..80ff5bbf --- /dev/null +++ b/app/performance-survey/PerformanceSurveyAdminConfig.test.tsx @@ -0,0 +1,110 @@ +/** @jest-environment jsdom */ + +import { fireEvent, render, screen, waitFor } from '@testing-library/react' +import { PerformanceSurveyAdminConfig } from './PerformanceSurveyAdminConfig' + +const config = { + month: '2026-07', + groups: [{ + id: 'group-1', + code: 'brand_designer', + name: '品牌设计师', + sortOrder: 10, + isActive: true, + status: 'ready', + memberCount: 6, + rules: [{ + id: 'rule-1', + departmentPathPrefix: '集团/品牌中心', + positionTitle: '品牌设计师', + isActive: true, + sortOrder: 0, + }], + effectivePlan: { + id: 'plan-1', + version: 1, + effectiveMonth: '2026-07', + templateVersionIds: ['version-1'], + }, + draftPlan: null, + }], + templates: [{ + id: 'template-1', + code: 'visual_review', + name: '视觉案例评分', + description: '视觉案例评分', + surveyType: 'visual_case', + isActive: true, + versions: [{ + id: 'version-1', + version: 1, + status: 'published', + effectiveMonth: '2026-07', + definition: { + code: 'visual_review', + name: '视觉案例评分', + shortName: '视觉评分', + description: '视觉案例评分', + surveyType: 'visual_case', + weight: 1, + maxTotal: 120, + questionMaxScore: 20, + requiredWorkItemCount: 3, + workItemImageRequired: true, + questions: [{ id: 'quality', title: '作品质量', maxScore: 20 }], + scoreBands: [], + workflow: { + stages: [{ + key: 'review', + label: '终评', + order: 0, + reviewers: [{ source: 'direct_manager', label: '直属主管' }], + }], + scoring: { mode: 'final_reviewer', stageKey: 'review', reviewerSource: 'direct_manager' }, + }, + }, + }], + }], + issues: { + unmatched: [{ id: 'employee-1', displayName: '待配置人员', departmentPath: '集团/品牌中心', positionTitle: '设计师' }], + conflicts: [], + }, +} as const + +describe('PerformanceSurveyAdminConfig', () => { + test('岗位配置使用岗位列表和右侧编辑区,并展示配置问题', async () => { + const request = jest.fn().mockResolvedValue(config) + render() + + expect(screen.getByText('配置加载中...')).toBeInTheDocument() + await waitFor(() => expect(screen.getByText('品牌设计师')).toBeInTheDocument()) + expect(screen.getByText('人员匹配规则')).toBeInTheDocument() + expect(screen.getByText('考核项与顺序')).toBeInTheDocument() + expect(screen.getByText(/未匹配 1 人/)).toBeInTheDocument() + expect(screen.getByText('待配置人员')).toBeInTheDocument() + expect(request).toHaveBeenCalledWith(expect.stringContaining('/admin/config?month=')) + }) + + test('模板管理展示版本状态、评分项和评审流程', async () => { + const request = jest.fn().mockResolvedValue(config) + render() + + await waitFor(() => expect(screen.getAllByText('视觉案例评分').length).toBeGreaterThan(0)) + expect(screen.getByText('评分项')).toBeInTheDocument() + expect(screen.getByText('评审流程')).toBeInTheDocument() + expect(screen.getByText(/v1 · 已发布/)).toBeInTheDocument() + }) + + test('岗位发布失败时直接展示服务端业务错误', async () => { + const request = jest.fn().mockImplementation((path: string) => ( + path.startsWith('/admin/config') + ? Promise.resolve(config) + : Promise.reject(new Error('岗位规则存在重复匹配人员')) + )) + render() + + await waitFor(() => expect(screen.getByText('品牌设计师')).toBeInTheDocument()) + fireEvent.click(screen.getByRole('button', { name: /发布至/ })) + await waitFor(() => expect(screen.getByText('岗位规则存在重复匹配人员')).toBeInTheDocument()) + }) +}) diff --git a/app/performance-survey/PerformanceSurveyAdminConfig.tsx b/app/performance-survey/PerformanceSurveyAdminConfig.tsx new file mode 100644 index 00000000..c5ed9146 --- /dev/null +++ b/app/performance-survey/PerformanceSurveyAdminConfig.tsx @@ -0,0 +1,892 @@ +'use client' + +import { useCallback, useEffect, useMemo, useRef, useState } from 'react' + +type RequestFn = (path: string, options?: RequestInit) => Promise + +type RuleDraft = { + departmentPathPrefix: string + positionTitle: string +} + +type ReviewerSource = 'self' | 'direct_manager' | 'fixed_employee' | 'manual_selection' + +type ReviewerDraft = { + source: ReviewerSource + label: string + employeeId?: string + employeeName?: string +} + +type StageDraft = { + key: string + label: string + order: number + reviewers: ReviewerDraft[] +} + +type TemplateDefinition = { + code: string + name: string + shortName?: string + description: string + surveyType: 'person_period' | 'visual_case' | 'item_course' + weight: number + maxTotal?: number + questionMaxScore?: number + requiredWorkItemCount?: number + workItemImageRequired?: boolean + questions: Array<{ id: string; title: string; description?: string; maxScore?: number }> + scoreBands: unknown[] + workflow: { + stages: StageDraft[] + scoring: { + mode: 'final_reviewer' | 'average_reviewers' + stageKey?: string + reviewerSource?: ReviewerSource + stageKeys?: string[] + } + } +} + +type TemplateVersion = { + id: string + version: number + status: 'draft' | 'published' | 'archived' + effectiveMonth?: string | null + definition: TemplateDefinition +} + +type TemplateRecord = { + id: string + code: string + name: string + description: string + surveyType: string + isActive: boolean + versions: TemplateVersion[] +} + +type PositionGroupRecord = { + id: string + code: string + name: string + sortOrder: number + isActive: boolean + status: 'ready' | 'pending' | 'disabled' + memberCount: number + rules: Array + effectivePlan: null | { + id: string + version: number + effectiveMonth: string + templateVersionIds: string[] + } + draftPlan: null | { + id: string + version: number + templateVersionIds: string[] + } +} + +type AdminConfig = { + month: string + groups: PositionGroupRecord[] + templates: TemplateRecord[] + issues: { + unmatched: Array<{ id: string; displayName: string; departmentName?: string; departmentPath?: string; positionTitle?: string }> + conflicts: Array<{ id: string; displayName: string; groupNames: string[]; departmentName?: string; departmentPath?: string; positionTitle?: string }> + } +} + +function currentMonth() { + const now = new Date() + return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}` +} + +function clone(value: T): T { + return JSON.parse(JSON.stringify(value)) as T +} + +function newTemplateDefinition(): TemplateDefinition { + return { + code: '', + name: '', + shortName: '', + description: '', + surveyType: 'person_period', + weight: 1, + maxTotal: 120, + questions: [{ id: 'score_1', title: '评分项 1', description: '', maxScore: 20 }], + scoreBands: [], + workflow: { + stages: [{ + key: 'review', + label: '评价', + order: 0, + reviewers: [{ source: 'manual_selection', label: '评价人' }], + }], + scoring: { mode: 'average_reviewers', stageKeys: ['review'] }, + }, + } +} + +function reviewerSourceLabel(source: ReviewerSource) { + return { + self: '本人', + direct_manager: '直属主管', + fixed_employee: '固定员工', + manual_selection: '发起时选择', + }[source] +} + +export function PerformanceSurveyAdminConfig({ + mode, + request, +}: { + mode: 'positions' | 'templates' + request: RequestFn +}) { + const [month, setMonth] = useState(currentMonth()) + const [data, setData] = useState(null) + const [loading, setLoading] = useState(true) + const [error, setError] = useState(null) + const [notice, setNotice] = useState(null) + + const load = useCallback(async () => { + setLoading(true) + setError(null) + try { + setData(await request(`/admin/config?month=${encodeURIComponent(month)}`)) + } catch (loadError) { + setError(loadError instanceof Error ? loadError.message : '配置加载失败') + } finally { + setLoading(false) + } + }, [month, request]) + + useEffect(() => { + void load() + }, [load]) + + return ( +
+
+
+

{mode === 'positions' ? '岗位配置' : '模板管理'}

+

草稿保存后按月份发布,已发布版本保持不变

+
+ +
+ {notice &&
{notice}
} + {error &&
{error}
} + {loading &&
配置加载中...
} + {!loading && data && mode === 'positions' && ( + { + setNotice(message) + await load() + }} + /> + )} + {!loading && data && mode === 'templates' && ( + { + setNotice(message) + await load() + }} + /> + )} +
+ ) +} + +function PositionConfigWorkspace({ + data, + month, + request, + onError, + onChanged, +}: { + data: AdminConfig + month: string + request: RequestFn + onError: (message: string | null) => void + onChanged: (message: string) => Promise +}) { + const [selectedId, setSelectedId] = useState(data.groups[0]?.id || '') + const selected = data.groups.find((group) => group.id === selectedId) || data.groups[0] + const [name, setName] = useState(selected?.name || '') + const [sortOrder, setSortOrder] = useState(selected?.sortOrder || 0) + const [isActive, setIsActive] = useState(selected?.isActive ?? true) + const [rules, setRules] = useState(selected?.rules.map((rule) => ({ + departmentPathPrefix: rule.departmentPathPrefix || '', + positionTitle: rule.positionTitle || '', + })) || []) + const [templateVersionIds, setTemplateVersionIds] = useState( + selected?.draftPlan?.templateVersionIds || selected?.effectivePlan?.templateVersionIds || [], + ) + const [saving, setSaving] = useState(false) + const editorRef = useRef(null) + + useEffect(() => { + if (!selected) return + setName(selected.name) + setSortOrder(selected.sortOrder) + setIsActive(selected.isActive) + setRules(selected.rules.map((rule) => ({ + departmentPathPrefix: rule.departmentPathPrefix || '', + positionTitle: rule.positionTitle || '', + }))) + setTemplateVersionIds(selected.draftPlan?.templateVersionIds || selected.effectivePlan?.templateVersionIds || []) + }, [selected]) + + const publishedVersions = useMemo(() => data.templates.flatMap((template) => ( + template.versions + .filter((version) => version.status === 'published') + .map((version) => ({ template, version })) + )), [data.templates]) + + if (!selected) return
暂无岗位组
+ + const save = async () => { + setSaving(true) + onError(null) + try { + await request(`/admin/position-groups/${selected.id}`, { + method: 'PATCH', + body: JSON.stringify({ name, sortOrder, isActive, rules, templateVersionIds }), + }) + await onChanged('岗位方案草稿已保存') + } catch (actionError) { + onError(actionError instanceof Error ? actionError.message : '岗位方案保存失败') + } finally { + setSaving(false) + } + } + + const publish = async () => { + setSaving(true) + onError(null) + try { + await request(`/admin/position-groups/${selected.id}/publish`, { + method: 'POST', + body: JSON.stringify({ effectiveMonth: month }), + }) + await onChanged(`${selected.name} 已从 ${month} 起生效`) + } catch (actionError) { + onError(actionError instanceof Error ? actionError.message : '岗位方案发布失败') + } finally { + setSaving(false) + } + } + + const selectGroup = (groupId: string) => { + setSelectedId(groupId) + if (window.matchMedia('(max-width: 767px)').matches) { + window.requestAnimationFrame(() => editorRef.current?.scrollIntoView({ behavior: 'smooth', block: 'start' })) + } + } + + return ( +
+ + +
+
正在编辑:{selected.name}
+
+ + setSortOrder(Number(value) || 0)} type="number" /> + +
+ +
+
+
+

人员匹配规则

+

每行内条件同时满足,多行之间满足任意一行即可

+
+ +
+
+ {rules.map((rule, index) => ( +
+ setRules((current) => current.map((item, itemIndex) => itemIndex === index ? { ...item, departmentPathPrefix: event.target.value } : item))} + placeholder="部门路径前缀,例如 品牌中心/品牌创意A部" + className="h-10 rounded border border-[#e2e2e2] px-3 text-[13px] outline-none focus:border-[#0050cb]" + /> + setRules((current) => current.map((item, itemIndex) => itemIndex === index ? { ...item, positionTitle: event.target.value } : item))} + placeholder="职位名称(精确匹配)" + className="h-10 rounded border border-[#e2e2e2] px-3 text-[13px] outline-none focus:border-[#0050cb]" + /> + +
+ ))} + {rules.length === 0 &&
未配置规则,岗位不能发布
} +
+
+ +
+

考核项与顺序

+
+ {publishedVersions.map(({ template, version }) => { + const checked = templateVersionIds.includes(version.id) + return ( + + ) + })} +
+
+ +
+ + +
+ + {(data.issues.conflicts.length > 0 || data.issues.unmatched.length > 0) && ( +
+

配置问题

+
+ 未匹配 {data.issues.unmatched.length} 人 · 重复匹配 {data.issues.conflicts.length} 人 +
+
+ {data.issues.unmatched.length > 0 && ( +
+
未匹配人员
+
+ {data.issues.unmatched.map((item) => ( +
+ {item.displayName} + {item.departmentPath || item.departmentName || '未填写部门'} · {item.positionTitle || '未填写职位'} +
+ ))} +
+
+ )} + {data.issues.conflicts.length > 0 && ( +
+
重复匹配人员
+
+ {data.issues.conflicts.map((item) => ( +
+ {item.displayName}:{item.groupNames.join('、')} +
+ ))} +
+
+ )} +
+
+ )} +
+
+ ) +} + +function TemplateConfigWorkspace({ + data, + month, + request, + onError, + onChanged, +}: { + data: AdminConfig + month: string + request: RequestFn + onError: (message: string | null) => void + onChanged: (message: string) => Promise +}) { + const firstTemplate = data.templates[0] + const [selectedTemplateId, setSelectedTemplateId] = useState(firstTemplate?.id || 'new') + const selectedTemplate = data.templates.find((template) => template.id === selectedTemplateId) || null + const selectedVersion = selectedTemplate?.versions.find((version) => version.status === 'draft') + || selectedTemplate?.versions[0] + || null + const [versionId, setVersionId] = useState(selectedVersion?.id || null) + const [definition, setDefinition] = useState(() => clone(selectedVersion?.definition || newTemplateDefinition())) + const [saving, setSaving] = useState(false) + const editorRef = useRef(null) + + useEffect(() => { + const nextVersion = selectedTemplate?.versions.find((version) => version.status === 'draft') + || selectedTemplate?.versions[0] + || null + setVersionId(nextVersion?.id || null) + setDefinition(clone(nextVersion?.definition || newTemplateDefinition())) + }, [selectedTemplate]) + + const version = selectedTemplate?.versions.find((item) => item.id === versionId) || null + const editable = !version || version.status === 'draft' + + const save = async () => { + setSaving(true) + onError(null) + try { + const saved = versionId + ? await request<{ id: string }>(`/admin/templates/${versionId}`, { + method: 'PATCH', + body: JSON.stringify({ definition }), + }) + : await request<{ id: string }>('/admin/templates', { + method: 'POST', + body: JSON.stringify({ definition }), + }) + setVersionId(saved.id) + await onChanged('模板草稿已保存') + } catch (actionError) { + onError(actionError instanceof Error ? actionError.message : '模板草稿保存失败') + } finally { + setSaving(false) + } + } + + const cloneVersion = async () => { + if (!versionId) return + setSaving(true) + onError(null) + try { + const draft = await request<{ id: string }>(`/admin/templates/${versionId}/clone`, { method: 'POST', body: '{}' }) + setVersionId(draft.id) + await onChanged('已创建新的模板草稿') + } catch (actionError) { + onError(actionError instanceof Error ? actionError.message : '模板草稿创建失败') + } finally { + setSaving(false) + } + } + + const publish = async () => { + if (!versionId) return + setSaving(true) + onError(null) + try { + await request(`/admin/templates/${versionId}/publish`, { + method: 'POST', + body: JSON.stringify({ effectiveMonth: month }), + }) + await onChanged(`${definition.name} 已从 ${month} 起发布`) + } catch (actionError) { + onError(actionError instanceof Error ? actionError.message : '模板发布失败') + } finally { + setSaving(false) + } + } + + const selectTemplate = (templateId: string) => { + setSelectedTemplateId(templateId) + if (window.matchMedia('(max-width: 767px)').matches) { + window.requestAnimationFrame(() => editorRef.current?.scrollIntoView({ behavior: 'smooth', block: 'start' })) + } + } + + return ( +
+ + +
+
正在编辑:{selectedTemplate?.name || '新建模板'}
+ {selectedTemplate && ( +
+ {selectedTemplate.versions.map((item) => ( + + ))} +
+ )} + +
+ setDefinition((current) => ({ ...current, code: value }))} disabled={Boolean(selectedTemplate)} /> + setDefinition((current) => ({ ...current, name: value }))} disabled={!editable} /> + setDefinition((current) => ({ ...current, shortName: value }))} disabled={!editable} /> + +