feat: HR Portal - Complete Multi-Tenant System with Redis Session Storage

Major Features:
-  Multi-tenant architecture (tenant isolation)
-  Employee CRUD with lifecycle management (onboarding/offboarding)
-  Department tree structure with email domain management
-  Company info management (single-record editing)
-  System functions CRUD (permission management)
-  Email account management (multi-account per employee)
-  Keycloak SSO integration (auth.lab.taipei)
-  Redis session storage (10.1.0.254:6379)
  - Solves Cookie 4KB limitation
  - Cross-system session sharing
  - Sliding expiration (8 hours)
  - Automatic token refresh

Technical Stack:
Backend:
- FastAPI + SQLAlchemy
- PostgreSQL 16 (10.1.0.20:5433)
- Keycloak Admin API integration
- Docker Mailserver integration (SSH)
- Alembic migrations

Frontend:
- Next.js 14 (App Router)
- NextAuth 4 with Keycloak Provider
- Redis session storage (ioredis)
- Tailwind CSS

Infrastructure:
- Redis 7 (10.1.0.254:6379) - Session + Cache
- Keycloak 26.1.0 (auth.lab.taipei)
- Docker Mailserver (10.1.0.254)

Architecture Highlights:
- Session管理由 Keycloak + Redis 統一控制
- 支援多系統 (HR/WebMail/Calendar/Drive/Office) 共享 session
- Token 自動刷新,異質服務整合
- 未來可無縫遷移到雲端

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
2026-02-23 20:12:43 +08:00
commit 360533393f
386 changed files with 70353 additions and 0 deletions

View File

@@ -0,0 +1,471 @@
import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest'
import { render, screen, waitFor } from '@testing-library/react'
import userEvent from '@testing-library/user-event'
import EmployeeStatusCard from '../EmployeeStatusCard'
import { onboardingService } from '../../services/onboarding.service'
import type { EmployeeStatusResponse } from '../../types/onboarding'
// Mock the onboarding service
vi.mock('../../services/onboarding.service', () => ({
onboardingService: {
getEmployeeStatus: vi.fn(),
offboardEmployee: vi.fn(),
},
}))
// Mock Next.js navigation
vi.mock('next/navigation', () => ({
useRouter: () => ({
push: vi.fn(),
refresh: vi.fn(),
}),
}))
describe('EmployeeStatusCard', () => {
// Mock window.confirm
const originalConfirm = window.confirm
beforeEach(() => {
// Mock window.confirm to return true by default
window.confirm = vi.fn(() => true)
})
afterEach(() => {
// Restore original confirm
window.confirm = originalConfirm
})
const mockEmployeeStatus: EmployeeStatusResponse = {
employee: {
tenant_id: 1,
seq_no: 1,
tenant_emp_code: 'PWD0001',
name: '王明',
keycloak_user_id: '550e8400-e29b-41d4-a716-446655440000',
keycloak_username: 'wang.ming',
hire_date: '2026-02-21',
resign_date: null,
employment_status: 'active',
storage_quota_gb: 20,
email_quota_mb: 5120,
},
departments: [
{
department_id: 9,
department_name: '玄鐵風能',
position: '資深工程師',
membership_type: 'permanent',
joined_at: '2026-02-21T10:00:00',
},
{
department_id: 10,
department_name: '國際碳權',
position: '顧問',
membership_type: 'concurrent',
joined_at: '2026-02-21T10:00:00',
},
],
roles: [
{
role_id: 1,
role_name: 'HR管理員',
role_code: 'HR_ADMIN',
assigned_at: '2026-02-21T10:00:00',
},
{
role_id: 2,
role_name: '系統管理員',
role_code: 'SYS_ADMIN',
assigned_at: '2026-02-21T10:00:00',
},
],
services: [
{
service_id: 1,
service_name: '單一簽入',
service_code: 'SSO',
quota_gb: null,
quota_mb: null,
enabled_at: '2026-02-21T10:00:00',
},
{
service_id: 2,
service_name: '雲端硬碟',
service_code: 'DRIVE',
quota_gb: 20,
quota_mb: null,
enabled_at: '2026-02-21T10:00:00',
},
{
service_id: 3,
service_name: '電子郵件',
service_code: 'EMAIL',
quota_gb: null,
quota_mb: 5120,
enabled_at: '2026-02-21T10:00:00',
},
],
}
beforeEach(() => {
vi.clearAllMocks()
})
describe('Loading State', () => {
it('should show loading spinner while fetching data', () => {
vi.mocked(onboardingService.getEmployeeStatus).mockImplementation(
() => new Promise(() => {}) // Never resolves
)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
expect(screen.getByText(/Loading/i)).toBeInTheDocument()
})
})
describe('Employee Basic Information', () => {
it('should display employee basic information', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText('王明')).toBeInTheDocument()
expect(screen.getByText('PWD0001')).toBeInTheDocument()
expect(screen.getByText('wang.ming')).toBeInTheDocument()
expect(screen.getByText(/2026-02-21/)).toBeInTheDocument()
})
})
it('should display employment status badge', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText(/Active/i)).toBeInTheDocument()
})
})
it('should display storage and email quotas', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
const storageQuotas = screen.getAllByText(/20 GB/i)
expect(storageQuotas.length).toBeGreaterThan(0)
const emailQuotas = screen.getAllByText(/5120 MB/i)
expect(emailQuotas.length).toBeGreaterThan(0)
})
})
it('should display Keycloak information', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText(/550e8400-e29b-41d4-a716-446655440000/i)).toBeInTheDocument()
})
})
})
describe('Department List', () => {
it('should display all departments', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText('玄鐵風能')).toBeInTheDocument()
expect(screen.getByText('國際碳權')).toBeInTheDocument()
})
})
it('should display department positions', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText('資深工程師')).toBeInTheDocument()
expect(screen.getByText('顧問')).toBeInTheDocument()
})
})
it('should display membership types', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText(/Permanent/i)).toBeInTheDocument()
expect(screen.getByText(/Concurrent/i)).toBeInTheDocument()
})
})
it('should show message when no departments assigned', async () => {
const statusWithNoDepts: EmployeeStatusResponse = {
...mockEmployeeStatus,
departments: [],
}
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(statusWithNoDepts)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText(/No departments assigned/i)).toBeInTheDocument()
})
})
})
describe('Role List', () => {
it('should display all roles', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText('HR管理員')).toBeInTheDocument()
expect(screen.getByText('系統管理員')).toBeInTheDocument()
})
})
it('should display role codes', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText('HR_ADMIN')).toBeInTheDocument()
expect(screen.getByText('SYS_ADMIN')).toBeInTheDocument()
})
})
it('should show message when no roles assigned', async () => {
const statusWithNoRoles: EmployeeStatusResponse = {
...mockEmployeeStatus,
roles: [],
}
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(statusWithNoRoles)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText(/No roles assigned/i)).toBeInTheDocument()
})
})
})
describe('Service List', () => {
it('should display all enabled services', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText('單一簽入')).toBeInTheDocument()
expect(screen.getByText('雲端硬碟')).toBeInTheDocument()
expect(screen.getByText('電子郵件')).toBeInTheDocument()
})
})
it('should display service codes', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText('SSO')).toBeInTheDocument()
expect(screen.getByText('DRIVE')).toBeInTheDocument()
expect(screen.getByText('EMAIL')).toBeInTheDocument()
})
})
it('should display service quotas when available', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
// Drive quota
const driveQuota = screen.getAllByText(/20 GB/i)
expect(driveQuota.length).toBeGreaterThan(0)
// Email quota
const emailQuota = screen.getAllByText(/5120 MB/i)
expect(emailQuota.length).toBeGreaterThan(0)
})
})
it('should show message when no services enabled', async () => {
const statusWithNoServices: EmployeeStatusResponse = {
...mockEmployeeStatus,
services: [],
}
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(statusWithNoServices)
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText(/No services enabled/i)).toBeInTheDocument()
})
})
})
describe('Error Handling', () => {
it('should display error message when API fails', async () => {
const errorMessage = 'Employee not found'
vi.mocked(onboardingService.getEmployeeStatus).mockRejectedValueOnce({
response: {
data: { detail: errorMessage },
status: 404,
},
})
render(<EmployeeStatusCard tenantId={1} seqNo={999} />)
await waitFor(() => {
expect(screen.getByText(errorMessage)).toBeInTheDocument()
})
})
it('should display generic error message for unknown errors', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockRejectedValueOnce(new Error('Network error'))
render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText(/Failed to load employee status/i)).toBeInTheDocument()
})
})
})
describe('Offboard Action', () => {
it('should display offboard button for active employees', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} showActions={true} />)
await waitFor(() => {
expect(screen.getByRole('button', { name: /Offboard/i })).toBeInTheDocument()
})
})
it('should not display offboard button when showActions is false', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
render(<EmployeeStatusCard tenantId={1} seqNo={1} showActions={false} />)
await waitFor(() => {
expect(screen.queryByRole('button', { name: /Offboard/i })).not.toBeInTheDocument()
})
})
it('should call offboardEmployee when offboard button is clicked', async () => {
const user = userEvent.setup()
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
vi.mocked(onboardingService.offboardEmployee).mockResolvedValueOnce({
message: 'Employee offboarded successfully',
employee: { tenant_emp_code: 'PWD0001', resign_date: '2026-02-21' },
summary: { departments_removed: 2, roles_revoked: 2, services_disabled: 3 },
})
render(<EmployeeStatusCard tenantId={1} seqNo={1} showActions={true} />)
await waitFor(() => {
expect(screen.getByRole('button', { name: /Offboard/i })).toBeInTheDocument()
})
const offboardButton = screen.getByRole('button', { name: /Offboard/i })
await user.click(offboardButton)
await waitFor(() => {
expect(onboardingService.offboardEmployee).toHaveBeenCalledWith(1, 1)
})
})
it('should show success message after offboarding', async () => {
const user = userEvent.setup()
const offboardedStatus = {
...mockEmployeeStatus,
employee: { ...mockEmployeeStatus.employee, employment_status: 'resigned' as const, resign_date: '2026-02-21' },
}
vi.mocked(onboardingService.getEmployeeStatus)
.mockResolvedValueOnce(mockEmployeeStatus) // Initial load
.mockResolvedValueOnce(offboardedStatus) // After offboard refresh
vi.mocked(onboardingService.offboardEmployee).mockResolvedValueOnce({
message: 'Employee offboarded successfully',
employee: { tenant_emp_code: 'PWD0001', resign_date: '2026-02-21' },
summary: { departments_removed: 2, roles_revoked: 2, services_disabled: 3 },
})
render(<EmployeeStatusCard tenantId={1} seqNo={1} showActions={true} />)
await waitFor(() => {
expect(screen.getByRole('button', { name: /Offboard/i })).toBeInTheDocument()
})
const offboardButton = screen.getByRole('button', { name: /Offboard/i })
await user.click(offboardButton)
await waitFor(() => {
expect(screen.getByText(/Employee offboarded successfully/i)).toBeInTheDocument()
})
})
it('should handle offboard errors gracefully', async () => {
const user = userEvent.setup()
const errorMessage = 'Failed to offboard employee'
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValueOnce(mockEmployeeStatus)
vi.mocked(onboardingService.offboardEmployee).mockRejectedValueOnce({
response: {
data: { detail: errorMessage },
status: 500,
},
})
render(<EmployeeStatusCard tenantId={1} seqNo={1} showActions={true} />)
await waitFor(() => {
expect(screen.getByRole('button', { name: /Offboard/i })).toBeInTheDocument()
})
const offboardButton = screen.getByRole('button', { name: /Offboard/i })
await user.click(offboardButton)
await waitFor(() => {
expect(screen.getByText(errorMessage)).toBeInTheDocument()
})
})
})
describe('Refresh Functionality', () => {
it('should refresh employee status when refresh is called', async () => {
vi.mocked(onboardingService.getEmployeeStatus).mockResolvedValue(mockEmployeeStatus)
const { rerender } = render(<EmployeeStatusCard tenantId={1} seqNo={1} />)
await waitFor(() => {
expect(screen.getByText('王明')).toBeInTheDocument()
})
expect(onboardingService.getEmployeeStatus).toHaveBeenCalledTimes(1)
// Trigger refresh by rerendering with key change
rerender(<EmployeeStatusCard tenantId={1} seqNo={1} key="refresh" />)
await waitFor(() => {
expect(onboardingService.getEmployeeStatus).toHaveBeenCalledTimes(2)
})
})
})
})

View File

@@ -0,0 +1,319 @@
import { describe, it, expect, beforeEach, vi } from 'vitest'
import { render, screen, waitFor } from '@testing-library/react'
import userEvent from '@testing-library/user-event'
import OnboardingForm from '../OnboardingForm'
import { onboardingService } from '../../services/onboarding.service'
import type { OnboardingResponse } from '../../types/onboarding'
// Mock the onboarding service
vi.mock('../../services/onboarding.service', () => ({
onboardingService: {
onboardEmployee: vi.fn(),
},
}))
// Mock Next.js navigation
vi.mock('next/navigation', () => ({
useRouter: () => ({
push: vi.fn(),
refresh: vi.fn(),
}),
}))
describe('OnboardingForm', () => {
beforeEach(() => {
vi.clearAllMocks()
})
describe('Rendering', () => {
it('should render all required fields', () => {
render(<OnboardingForm />)
// 必填欄位
expect(screen.getByLabelText(/Resume ID/i)).toBeInTheDocument()
expect(screen.getByLabelText(/Keycloak User ID/i)).toBeInTheDocument()
expect(screen.getByLabelText(/Keycloak Username/i)).toBeInTheDocument()
expect(screen.getByLabelText(/Hire Date/i)).toBeInTheDocument()
// 選填欄位
expect(screen.getByLabelText(/Storage Quota \(GB\)/i)).toBeInTheDocument()
expect(screen.getByLabelText(/Email Quota \(MB\)/i)).toBeInTheDocument()
// 提交按鈕
expect(screen.getByRole('button', { name: /Submit/i })).toBeInTheDocument()
})
it('should render department assignment section', () => {
render(<OnboardingForm />)
expect(screen.getByText(/Department Assignments/i)).toBeInTheDocument()
expect(screen.getByRole('button', { name: /Add Department/i })).toBeInTheDocument()
})
it('should render role assignment section', () => {
render(<OnboardingForm />)
expect(screen.getByText(/Role Assignments/i)).toBeInTheDocument()
})
})
describe('Form Validation', () => {
it('should show validation errors for required fields', async () => {
const user = userEvent.setup()
render(<OnboardingForm />)
const submitButton = screen.getByRole('button', { name: /Submit/i })
await user.click(submitButton)
await waitFor(() => {
expect(screen.getByText(/Resume ID is required/i)).toBeInTheDocument()
expect(screen.getByText(/Keycloak User ID is required/i)).toBeInTheDocument()
expect(screen.getByText(/Keycloak Username is required/i)).toBeInTheDocument()
expect(screen.getByText(/Hire Date is required/i)).toBeInTheDocument()
})
})
it('should validate Keycloak User ID format (UUID)', async () => {
const user = userEvent.setup()
render(<OnboardingForm />)
const keycloakUserIdInput = screen.getByLabelText(/Keycloak User ID/i)
await user.type(keycloakUserIdInput, 'invalid-uuid')
const submitButton = screen.getByRole('button', { name: /Submit/i })
await user.click(submitButton)
await waitFor(() => {
expect(screen.getByText(/Invalid UUID format/i)).toBeInTheDocument()
})
})
it('should validate storage quota is a positive number', async () => {
const user = userEvent.setup()
render(<OnboardingForm />)
const storageQuotaInput = screen.getByLabelText(/Storage Quota \(GB\)/i)
await user.clear(storageQuotaInput)
await user.type(storageQuotaInput, '-10')
const submitButton = screen.getByRole('button', { name: /Submit/i })
await user.click(submitButton)
await waitFor(() => {
expect(screen.getByText(/Storage quota must be positive/i)).toBeInTheDocument()
})
})
})
describe('Department Assignment', () => {
it('should add a new department assignment', async () => {
const user = userEvent.setup()
render(<OnboardingForm />)
const addButton = screen.getByRole('button', { name: /Add Department/i })
await user.click(addButton)
await waitFor(() => {
expect(screen.getByLabelText(/Department ID/i)).toBeInTheDocument()
expect(screen.getByLabelText(/Position/i)).toBeInTheDocument()
expect(screen.getByLabelText(/Membership Type/i)).toBeInTheDocument()
})
})
it('should remove a department assignment', async () => {
const user = userEvent.setup()
render(<OnboardingForm />)
// 添加部門
const addButton = screen.getByRole('button', { name: /Add Department/i })
await user.click(addButton)
// 刪除部門
const removeButton = screen.getByRole('button', { name: /Remove/i })
await user.click(removeButton)
await waitFor(() => {
expect(screen.queryByLabelText(/Department ID/i)).not.toBeInTheDocument()
})
})
it('should validate department assignment fields', async () => {
const user = userEvent.setup()
render(<OnboardingForm />)
const addButton = screen.getByRole('button', { name: /Add Department/i })
await user.click(addButton)
const submitButton = screen.getByRole('button', { name: /Submit/i })
await user.click(submitButton)
await waitFor(() => {
expect(screen.getByText(/Department ID is required/i)).toBeInTheDocument()
expect(screen.getByText(/Position is required/i)).toBeInTheDocument()
})
})
})
describe('Form Submission', () => {
it('should submit form successfully with valid data', async () => {
const user = userEvent.setup()
const mockResponse: OnboardingResponse = {
message: 'Employee onboarded successfully',
employee: {
tenant_id: 1,
seq_no: 1,
tenant_emp_code: 'PWD0001',
keycloak_user_id: '550e8400-e29b-41d4-a716-446655440000',
keycloak_username: 'wang.ming',
name: '王明',
hire_date: '2026-02-21',
},
summary: {
departments_assigned: 1,
roles_assigned: 2,
services_enabled: 5,
},
}
vi.mocked(onboardingService.onboardEmployee).mockResolvedValueOnce(mockResponse)
render(<OnboardingForm />)
// 填寫表單
await user.type(screen.getByLabelText(/Resume ID/i), '1')
await user.type(
screen.getByLabelText(/Keycloak User ID/i),
'550e8400-e29b-41d4-a716-446655440000'
)
await user.type(screen.getByLabelText(/Keycloak Username/i), 'wang.ming')
await user.type(screen.getByLabelText(/Hire Date/i), '2026-02-21')
// 提交表單
const submitButton = screen.getByRole('button', { name: /Submit/i })
await user.click(submitButton)
await waitFor(() => {
expect(onboardingService.onboardEmployee).toHaveBeenCalledWith(
expect.objectContaining({
resume_id: 1,
keycloak_user_id: '550e8400-e29b-41d4-a716-446655440000',
keycloak_username: 'wang.ming',
hire_date: '2026-02-21',
})
)
})
// 驗證成功訊息
await waitFor(() => {
expect(screen.getByText(/Employee onboarded successfully/i)).toBeInTheDocument()
})
})
it('should handle API errors gracefully', async () => {
const user = userEvent.setup()
const errorMessage = 'Resume ID not found'
vi.mocked(onboardingService.onboardEmployee).mockRejectedValueOnce({
response: {
data: { detail: errorMessage },
status: 404,
},
})
render(<OnboardingForm />)
// 填寫表單
await user.type(screen.getByLabelText(/Resume ID/i), '999')
await user.type(
screen.getByLabelText(/Keycloak User ID/i),
'550e8400-e29b-41d4-a716-446655440000'
)
await user.type(screen.getByLabelText(/Keycloak Username/i), 'test.user')
await user.type(screen.getByLabelText(/Hire Date/i), '2026-02-21')
// 提交表單
const submitButton = screen.getByRole('button', { name: /Submit/i })
await user.click(submitButton)
await waitFor(() => {
expect(screen.getByText(errorMessage)).toBeInTheDocument()
})
})
it('should show loading state during submission', async () => {
const user = userEvent.setup()
// 模擬延遲的 API 回應
vi.mocked(onboardingService.onboardEmployee).mockImplementation(
() => new Promise((resolve) => setTimeout(resolve, 100))
)
render(<OnboardingForm />)
// 填寫表單
await user.type(screen.getByLabelText(/Resume ID/i), '1')
await user.type(
screen.getByLabelText(/Keycloak User ID/i),
'550e8400-e29b-41d4-a716-446655440000'
)
await user.type(screen.getByLabelText(/Keycloak Username/i), 'wang.ming')
await user.type(screen.getByLabelText(/Hire Date/i), '2026-02-21')
// 提交表單
const submitButton = screen.getByRole('button', { name: /Submit/i })
await user.click(submitButton)
// 驗證載入狀態
expect(screen.getByText(/Submitting.../i)).toBeInTheDocument()
expect(submitButton).toBeDisabled()
})
it('should reset form after successful submission', async () => {
const user = userEvent.setup()
const mockResponse: OnboardingResponse = {
message: 'Employee onboarded successfully',
employee: {
tenant_id: 1,
seq_no: 1,
tenant_emp_code: 'PWD0001',
keycloak_user_id: '550e8400-e29b-41d4-a716-446655440000',
keycloak_username: 'wang.ming',
name: '王明',
hire_date: '2026-02-21',
},
summary: {
departments_assigned: 0,
roles_assigned: 0,
services_enabled: 5,
},
}
vi.mocked(onboardingService.onboardEmployee).mockResolvedValueOnce(mockResponse)
render(<OnboardingForm />)
// 填寫表單
const resumeIdInput = screen.getByLabelText(/Resume ID/i) as HTMLInputElement
await user.type(resumeIdInput, '1')
await user.type(
screen.getByLabelText(/Keycloak User ID/i),
'550e8400-e29b-41d4-a716-446655440000'
)
await user.type(screen.getByLabelText(/Keycloak Username/i), 'wang.ming')
await user.type(screen.getByLabelText(/Hire Date/i), '2026-02-21')
// 提交表單
const submitButton = screen.getByRole('button', { name: /Submit/i })
await user.click(submitButton)
await waitFor(() => {
expect(screen.getByText(/Employee onboarded successfully/i)).toBeInTheDocument()
})
// 驗證表單已重置
await waitFor(() => {
expect(resumeIdInput.value).toBe('')
})
})
})
})

View File

@@ -0,0 +1,345 @@
import { describe, it, expect, beforeEach, vi } from 'vitest'
import { render, screen, waitFor } from '@testing-library/react'
import userEvent from '@testing-library/user-event'
import { tenantService } from '../../services/tenant.service'
import TenantCreateForm from '../TenantCreateForm'
// Mock tenant service
vi.mock('../../services/tenant.service', () => ({
tenantService: {
createTenant: vi.fn(),
},
}))
describe('TenantCreateForm', () => {
beforeEach(() => {
vi.clearAllMocks()
})
describe('Form Rendering', () => {
it('should render all required form fields', () => {
// Act
render(<TenantCreateForm onSuccess={vi.fn()} onCancel={vi.fn()} />)
// Assert - Basic Info Section
expect(screen.getByLabelText(/^tenant code/i)).toBeInTheDocument()
expect(screen.getByLabelText(/^company name \*$/i)).toBeInTheDocument()
expect(screen.getByLabelText(/company name \(english\)/i)).toBeInTheDocument()
expect(screen.getByLabelText(/^tax id$/i)).toBeInTheDocument()
expect(screen.getByLabelText(/employee prefix/i)).toBeInTheDocument()
// Assert - Contact Info Section
expect(screen.getByLabelText(/phone/i)).toBeInTheDocument()
expect(screen.getByLabelText(/address/i)).toBeInTheDocument()
expect(screen.getByLabelText(/website/i)).toBeInTheDocument()
// Assert - Plan Settings Section
expect(screen.getByLabelText(/plan id/i)).toBeInTheDocument()
expect(screen.getByLabelText(/max users/i)).toBeInTheDocument()
expect(screen.getByLabelText(/storage quota/i)).toBeInTheDocument()
// Assert - Admin Account Section
expect(screen.getByLabelText(/admin username/i)).toBeInTheDocument()
expect(screen.getByLabelText(/admin email/i)).toBeInTheDocument()
expect(screen.getByLabelText(/admin name/i)).toBeInTheDocument()
expect(screen.getByLabelText(/admin password/i)).toBeInTheDocument()
// Assert - Buttons
expect(screen.getByRole('button', { name: /create tenant/i })).toBeInTheDocument()
expect(screen.getByRole('button', { name: /cancel/i })).toBeInTheDocument()
})
it('should have default values for plan settings', () => {
// Act
render(<TenantCreateForm onSuccess={vi.fn()} />)
// Assert
const planIdInput = screen.getByLabelText(/plan id/i) as HTMLInputElement
const maxUsersInput = screen.getByLabelText(/max users/i) as HTMLInputElement
const storageQuotaInput = screen.getByLabelText(/storage quota/i) as HTMLInputElement
expect(planIdInput.value).toBe('starter')
expect(maxUsersInput.value).toBe('5')
expect(storageQuotaInput.value).toBe('100')
})
})
describe('Form Validation', () => {
it('should show error when tenant code is empty', async () => {
// Arrange
const user = userEvent.setup()
render(<TenantCreateForm onSuccess={vi.fn()} />)
// Act
const submitButton = screen.getByRole('button', { name: /create tenant/i })
await user.click(submitButton)
// Assert
await waitFor(() => {
expect(screen.getByText(/tenant code is required/i)).toBeInTheDocument()
})
})
it('should show error when company name is empty', async () => {
// Arrange
const user = userEvent.setup()
render(<TenantCreateForm onSuccess={vi.fn()} />)
// Act
const submitButton = screen.getByRole('button', { name: /create tenant/i })
await user.click(submitButton)
// Assert
await waitFor(() => {
expect(screen.getByText(/company name is required/i)).toBeInTheDocument()
})
})
it('should validate tax id format (8 digits)', async () => {
// Arrange
const user = userEvent.setup()
render(<TenantCreateForm onSuccess={vi.fn()} />)
// Act
const taxIdInput = screen.getByLabelText(/tax id/i)
await user.type(taxIdInput, '123') // Invalid: less than 8 digits
const submitButton = screen.getByRole('button', { name: /create tenant/i })
await user.click(submitButton)
// Assert
await waitFor(() => {
expect(screen.getByText(/tax id must be 8 digits/i)).toBeInTheDocument()
})
})
it.skip('should validate email format', async () => {
// Arrange
const user = userEvent.setup()
render(<TenantCreateForm onSuccess={vi.fn()} />)
// Act - Fill required fields first
await user.type(screen.getByLabelText(/^tenant code/i), 'TEST')
await user.type(screen.getByLabelText(/^company name \*$/i), '測試公司')
await user.type(screen.getByLabelText(/employee prefix/i), 'T')
await user.type(screen.getByLabelText(/admin username/i), 'admin')
await user.type(screen.getByLabelText(/admin email/i), 'invalidemail') // Missing @
await user.type(screen.getByLabelText(/admin name/i), 'Admin User')
await user.type(screen.getByLabelText(/admin password/i), 'TempPass123!')
const submitButton = screen.getByRole('button', { name: /create tenant/i })
await user.click(submitButton)
// Assert
await waitFor(() => {
const errorElement = screen.queryByText(/invalid email format/i)
expect(errorElement).toBeInTheDocument()
}, { timeout: 3000 })
})
it('should validate password length (minimum 8 characters)', async () => {
// Arrange
const user = userEvent.setup()
render(<TenantCreateForm onSuccess={vi.fn()} />)
// Act
const passwordInput = screen.getByLabelText(/admin password/i)
await user.type(passwordInput, '12345') // Less than 8 characters
const submitButton = screen.getByRole('button', { name: /create tenant/i })
await user.click(submitButton)
// Assert
await waitFor(() => {
expect(screen.getByText(/password must be at least 8 characters/i)).toBeInTheDocument()
})
})
it('should validate employee prefix is required', async () => {
// Arrange
const user = userEvent.setup()
render(<TenantCreateForm onSuccess={vi.fn()} />)
// Act
const submitButton = screen.getByRole('button', { name: /create tenant/i })
await user.click(submitButton)
// Assert
await waitFor(() => {
expect(screen.getByText(/employee prefix is required/i)).toBeInTheDocument()
})
})
})
describe('Form Submission', () => {
it('should submit form with valid data', async () => {
// Arrange
const user = userEvent.setup()
const onSuccess = vi.fn()
const mockResponse = {
message: 'Tenant created successfully',
tenant: {
id: 1,
code: 'TEST',
name: '測試公司',
keycloak_realm: 'porscheworld-test',
},
admin_user: {
id: 1,
username: 'admin',
email: 'admin@test.com',
},
keycloak_realm: 'porscheworld-test',
temporary_password: 'TempPass123!',
}
vi.mocked(tenantService.createTenant).mockResolvedValueOnce(mockResponse)
render(<TenantCreateForm onSuccess={onSuccess} />)
// Act - Fill in form
await user.type(screen.getByLabelText(/tenant code/i), 'TEST')
await user.type(screen.getByLabelText(/^company name \*$/i), '測試公司')
await user.type(screen.getByLabelText(/tax id/i), '12345678')
await user.type(screen.getByLabelText(/employee prefix/i), 'T')
await user.type(screen.getByLabelText(/admin username/i), 'admin')
await user.type(screen.getByLabelText(/admin email/i), 'admin@test.com')
await user.type(screen.getByLabelText(/admin name/i), 'Admin User')
await user.type(screen.getByLabelText(/admin password/i), 'TempPass123!')
const submitButton = screen.getByRole('button', { name: /create tenant/i })
await user.click(submitButton)
// Assert
await waitFor(() => {
expect(tenantService.createTenant).toHaveBeenCalledWith({
code: 'TEST',
name: '測試公司',
name_eng: '',
tax_id: '12345678',
prefix: 'T',
tel: '',
add: '',
url: '',
plan_id: 'starter',
max_users: 5,
storage_quota_gb: 100,
admin_username: 'admin',
admin_email: 'admin@test.com',
admin_name: 'Admin User',
admin_temp_password: 'TempPass123!',
})
expect(onSuccess).toHaveBeenCalledWith(mockResponse)
})
})
it('should handle API error gracefully', async () => {
// Arrange
const user = userEvent.setup()
vi.mocked(tenantService.createTenant).mockRejectedValueOnce({
response: {
data: {
detail: "Tenant code 'TEST' already exists",
},
},
})
render(<TenantCreateForm onSuccess={vi.fn()} />)
// Act - Fill in minimum required fields
await user.type(screen.getByLabelText(/tenant code/i), 'TEST')
await user.type(screen.getByLabelText(/^company name \*$/i), '測試公司')
await user.type(screen.getByLabelText(/employee prefix/i), 'T')
await user.type(screen.getByLabelText(/admin username/i), 'admin')
await user.type(screen.getByLabelText(/admin email/i), 'admin@test.com')
await user.type(screen.getByLabelText(/admin name/i), 'Admin User')
await user.type(screen.getByLabelText(/admin password/i), 'TempPass123!')
const submitButton = screen.getByRole('button', { name: /create tenant/i })
await user.click(submitButton)
// Assert
await waitFor(() => {
expect(screen.getByText(/tenant code 'TEST' already exists/i)).toBeInTheDocument()
})
})
it('should show loading state during submission', async () => {
// Arrange
const user = userEvent.setup()
vi.mocked(tenantService.createTenant).mockImplementation(
() => new Promise((resolve) => setTimeout(resolve, 100))
)
render(<TenantCreateForm onSuccess={vi.fn()} />)
// Act - Fill in minimum required fields
await user.type(screen.getByLabelText(/tenant code/i), 'TEST')
await user.type(screen.getByLabelText(/^company name \*$/i), '測試公司')
await user.type(screen.getByLabelText(/employee prefix/i), 'T')
await user.type(screen.getByLabelText(/admin username/i), 'admin')
await user.type(screen.getByLabelText(/admin email/i), 'admin@test.com')
await user.type(screen.getByLabelText(/admin name/i), 'Admin User')
await user.type(screen.getByLabelText(/admin password/i), 'TempPass123!')
const submitButton = screen.getByRole('button', { name: /create tenant/i })
await user.click(submitButton)
// Assert
expect(screen.getByText(/creating/i)).toBeInTheDocument()
expect(submitButton).toBeDisabled()
})
it('should reset form after successful submission', async () => {
// Arrange
const user = userEvent.setup()
const mockResponse = {
message: 'Tenant created successfully',
tenant: { id: 1, code: 'TEST', name: '測試公司' },
admin_user: { id: 1, username: 'admin' },
keycloak_realm: 'porscheworld-test',
temporary_password: 'TempPass123!',
}
vi.mocked(tenantService.createTenant).mockResolvedValueOnce(mockResponse)
render(<TenantCreateForm onSuccess={vi.fn()} />)
// Act - Fill and submit form
await user.type(screen.getByLabelText(/tenant code/i), 'TEST')
await user.type(screen.getByLabelText(/^company name \*$/i), '測試公司')
await user.type(screen.getByLabelText(/employee prefix/i), 'T')
await user.type(screen.getByLabelText(/admin username/i), 'admin')
await user.type(screen.getByLabelText(/admin email/i), 'admin@test.com')
await user.type(screen.getByLabelText(/admin name/i), 'Admin User')
await user.type(screen.getByLabelText(/admin password/i), 'TempPass123!')
const submitButton = screen.getByRole('button', { name: /create tenant/i })
await user.click(submitButton)
// Assert - Form should be reset
await waitFor(() => {
const codeInput = screen.getByLabelText(/tenant code/i) as HTMLInputElement
const nameInput = screen.getByLabelText(/^company name \*$/i) as HTMLInputElement
expect(codeInput.value).toBe('')
expect(nameInput.value).toBe('')
})
})
})
describe('Cancel Functionality', () => {
it('should call onCancel when cancel button is clicked', async () => {
// Arrange
const user = userEvent.setup()
const onCancel = vi.fn()
render(<TenantCreateForm onSuccess={vi.fn()} onCancel={onCancel} />)
// Act
const cancelButton = screen.getByRole('button', { name: /cancel/i })
await user.click(cancelButton)
// Assert
expect(onCancel).toHaveBeenCalledTimes(1)
})
})
})

View File

@@ -0,0 +1,268 @@
import { describe, it, expect, beforeEach, vi } from 'vitest'
import { render, screen, waitFor } from '@testing-library/react'
import { tenantService } from '../../services/tenant.service'
import TenantList from '../TenantList'
// Mock tenant service
vi.mock('../../services/tenant.service', () => ({
tenantService: {
getTenants: vi.fn(),
},
}))
describe('TenantList', () => {
beforeEach(() => {
vi.clearAllMocks()
})
describe('Loading State', () => {
it('should show loading spinner while fetching tenants', () => {
// Arrange
vi.mocked(tenantService.getTenants).mockImplementation(
() => new Promise(() => {}) // Never resolves
)
// Act
render(<TenantList />)
// Assert
expect(screen.getByText(/loading/i)).toBeInTheDocument()
})
})
describe('Tenant List Display', () => {
it('should display all tenants', async () => {
// Arrange
const mockTenants = [
{
id: 1,
code: 'PWD',
name: '匠耘營造股份有限公司',
keycloak_realm: 'porscheworld-pwd',
status: 'active',
is_initialized: true,
max_users: 50,
created_at: '2026-01-01T00:00:00',
},
{
id: 2,
code: 'TEST',
name: '測試公司',
keycloak_realm: 'porscheworld-test',
status: 'trial',
is_initialized: false,
max_users: 10,
created_at: '2026-02-01T00:00:00',
},
]
vi.mocked(tenantService.getTenants).mockResolvedValueOnce({
total: 2,
items: mockTenants,
})
// Act
render(<TenantList />)
// Assert
await waitFor(() => {
expect(screen.getByText('匠耘營造股份有限公司')).toBeInTheDocument()
expect(screen.getByText('測試公司')).toBeInTheDocument()
})
})
it('should display tenant codes', async () => {
// Arrange
const mockTenants = [
{
id: 1,
code: 'PWD',
name: '匠耘營造',
keycloak_realm: 'porscheworld-pwd',
status: 'active',
is_initialized: true,
max_users: 50,
created_at: '2026-01-01T00:00:00',
},
]
vi.mocked(tenantService.getTenants).mockResolvedValueOnce({
total: 1,
items: mockTenants,
})
// Act
render(<TenantList />)
// Assert
await waitFor(() => {
expect(screen.getByText('PWD')).toBeInTheDocument()
})
})
it('should display tenant status badges', async () => {
// Arrange
const mockTenants = [
{
id: 1,
code: 'PWD',
name: '匠耘營造',
keycloak_realm: 'porscheworld-pwd',
status: 'active',
is_initialized: true,
max_users: 50,
created_at: '2026-01-01T00:00:00',
},
]
vi.mocked(tenantService.getTenants).mockResolvedValueOnce({
total: 1,
items: mockTenants,
})
// Act
render(<TenantList />)
// Assert
await waitFor(() => {
expect(screen.getByText('Active')).toBeInTheDocument()
})
})
it('should display initialization status', async () => {
// Arrange
const mockTenants = [
{
id: 1,
code: 'INIT',
name: '已初始化公司',
keycloak_realm: 'porscheworld-init',
status: 'active',
is_initialized: true,
max_users: 50,
created_at: '2026-01-01T00:00:00',
},
{
id: 2,
code: 'NOINIT',
name: '未初始化公司',
keycloak_realm: 'porscheworld-noinit',
status: 'trial',
is_initialized: false,
max_users: 10,
created_at: '2026-02-01T00:00:00',
},
]
vi.mocked(tenantService.getTenants).mockResolvedValueOnce({
total: 2,
items: mockTenants,
})
// Act
render(<TenantList />)
// Assert
await waitFor(() => {
const initialized = screen.getAllByText(/initialized/i)
expect(initialized.length).toBeGreaterThan(0)
})
})
it('should show empty state when no tenants exist', async () => {
// Arrange
vi.mocked(tenantService.getTenants).mockResolvedValueOnce({
total: 0,
items: [],
})
// Act
render(<TenantList />)
// Assert
await waitFor(() => {
expect(screen.getByText(/no tenants found/i)).toBeInTheDocument()
})
})
})
describe('Error Handling', () => {
it('should display error message when API fails', async () => {
// Arrange
vi.mocked(tenantService.getTenants).mockRejectedValueOnce(
new Error('Network error')
)
// Act
render(<TenantList />)
// Assert
await waitFor(() => {
expect(screen.getByText(/failed to load tenants/i)).toBeInTheDocument()
})
})
})
describe('Tenant Actions', () => {
it('should display view details button for each tenant', async () => {
// Arrange
const mockTenants = [
{
id: 1,
code: 'PWD',
name: '匠耘營造',
keycloak_realm: 'porscheworld-pwd',
status: 'active',
is_initialized: true,
max_users: 50,
created_at: '2026-01-01T00:00:00',
},
]
vi.mocked(tenantService.getTenants).mockResolvedValueOnce({
total: 1,
items: mockTenants,
})
// Act
render(<TenantList />)
// Assert
await waitFor(() => {
expect(screen.getByText(/view details/i)).toBeInTheDocument()
})
})
})
describe('Initial Load', () => {
it('should call getTenants API on mount', async () => {
// Arrange
const mockTenants = [
{
id: 1,
code: 'PWD',
name: '匠耘營造',
keycloak_realm: 'porscheworld-pwd',
status: 'active',
is_initialized: true,
max_users: 50,
created_at: '2026-01-01T00:00:00',
},
]
vi.mocked(tenantService.getTenants).mockResolvedValueOnce({
total: 1,
items: mockTenants,
})
// Act
render(<TenantList />)
// Assert
await waitFor(() => {
expect(tenantService.getTenants).toHaveBeenCalledTimes(1)
expect(screen.getByText('匠耘營造')).toBeInTheDocument()
})
})
})
})