Files

DonaldFang 方士碩 a6af297623 backup: 完成 HR_position_ 表格前綴重命名與欄位對照表整理

變更內容：
- 所有資料表加上 HR_position_ 前綴
- 整理完整欄位顯示名稱與 ID 對照表
- 模組化 JS 檔案 (admin.js, ai.js, csv.js 等)
- 專案結構優化 (docs/, scripts/, tests/ 等)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2025-12-09 12:05:20 +08:00

28 KiB

Raw Permalink Blame History

Test Driven Development (TDD) Document

系統名稱：那都AI寫的，不要問我

HR Position Management System - 人力資源崗位管理系統

文件版本: v1.0 建立日期: 2024-12-04 最後更新: 2024-12-04 維護者: Development Team

測試策略概述

測試金字塔

         /\
        /  \  E2E Tests (10%)
       /----\
      /      \  Integration Tests (30%)
     /--------\
    /          \  Unit Tests (60%)
   /____________\

測試原則

先寫測試，後寫代碼 - TDD 核心原則
小步快跑 - 每個測試覆蓋一個小功能點
紅綠重構 - 測試失敗(紅) → 實現功能(綠) → 優化代碼(重構)
獨立性 - 每個測試案例獨立運行
可重複性 - 測試結果一致且可重現
覆蓋率目標 - 核心業務邏輯 ≥ 80%

測試環境配置

環境變數設置

# 測試環境 .env.test
DB_HOST=localhost
DB_PORT=3306
DB_NAME=hr_position_system_test
DB_USER=test_user
DB_PASSWORD=test_password

# LLM API 測試配置
GEMINI_API_KEY=test_key
DEEPSEEK_API_KEY=test_key
OPENAI_API_KEY=test_key
OLLAMA_API_URL=https://ollama_pjapi.theaken.com
GPTOSS_API_URL=https://ollama_pjapi.theaken.com

# Flask 測試配置
FLASK_ENV=testing
FLASK_DEBUG=false
SECRET_KEY=test_secret_key_for_testing_only

測試依賴

# 安裝測試依賴
pip install pytest pytest-cov pytest-flask pytest-mock requests-mock

測試目錄結構

tests/
├── unit/                    # 單元測試
│   ├── test_llm_config.py
│   ├── test_utils.py
│   └── test_validators.py
├── integration/             # 整合測試
│   ├── test_api_positions.py
│   ├── test_api_jobs.py
│   └── test_api_llm.py
├── e2e/                     # 端到端測試
│   ├── test_user_flow.py
│   └── test_admin_flow.py
├── fixtures/                # 測試固定數據
│   ├── positions.json
│   └── users.json
└── conftest.py             # Pytest 配置

單元測試

1. LLM 配置模組測試

測試文件: tests/unit/test_llm_config.py

Test Case 1.1: LLM API 配置加載

def test_llm_config_initialization():
    """測試 LLM 配置初始化"""
    from llm_config import LLMConfig

    config = LLMConfig()

    # 驗證所有 5 個 API 都已配置
    assert len(config.apis) == 5
    assert 'gemini' in config.apis
    assert 'deepseek' in config.apis
    assert 'openai' in config.apis
    assert 'ollama' in config.apis
    assert 'gptoss' in config.apis

    # 驗證預設模型
    assert config.apis['ollama']['model'] == 'deepseek-reasoner'
    assert config.apis['gptoss']['model'] == 'gpt-oss:120b'

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 0.05s

Test Case 1.2: Ollama API 文字生成

def test_ollama_text_generation():
    """測試 Ollama API 文字生成功能"""
    from llm_config import LLMConfig

    config = LLMConfig()
    prompt = "請說明測試驅動開發的重要性"

    success, response = config.generate_text_ollama(
        prompt=prompt,
        max_tokens=100,
        model='deepseek-reasoner'
    )

    assert success == True
    assert isinstance(response, str)
    assert len(response) > 0

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 3.2s

Test Case 1.3: GPT-OSS API 文字生成

def test_gptoss_text_generation():
    """測試 GPT-OSS 120B 模型文字生成"""
    from llm_config import LLMConfig

    config = LLMConfig()
    prompt = "寫一個簡短的崗位描述範例"

    success, response = config.generate_text_gptoss(
        prompt=prompt,
        max_tokens=100,
        model='gpt-oss:120b'
    )

    assert success == True
    assert isinstance(response, str)
    assert len(response) > 0

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 5.8s

2. 資料驗證測試

Test Case 2.1: 崗位編號格式驗證

def test_position_code_validation():
    """測試崗位編號格式驗證"""
    from utils import validate_position_code

    # 有效的崗位編號
    assert validate_position_code('P001') == True
    assert validate_position_code('POS-2024-001') == True

    # 無效的崗位編號
    assert validate_position_code('') == False
    assert validate_position_code(None) == False
    assert validate_position_code('   ') == False

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 0.01s

3. 階層式下拉選單數據測試

Test Case 3.1: 事業體到處級單位映射

def test_business_to_division_mapping():
    """測試事業體到處級單位的映射關係"""
    import json

    # 載入階層數據
    with open('hierarchical_data.js', 'r', encoding='utf-8') as f:
        content = f.read()

    # 驗證數據結構
    assert 'businessToDivision' in content
    assert 'divisionToDepartment' in content
    assert 'departmentToPosition' in content

    # 驗證至少有一個事業體
    assert '半導體事業群' in content or '汽車事業體' in content

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 0.02s

整合測試

1. 崗位管理 API 測試

測試文件: tests/integration/test_api_positions.py

Test Case 4.1: 新增崗位 (POST /api/positions)

def test_create_position(client):
    """測試新增崗位 API"""
    data = {
        'basicInfo': {
            'positionCode': 'TEST001',
            'positionName': '測試工程師',
            'positionCategory': 'ENG',
            'effectiveDate': '2024-12-04'
        },
        'recruitInfo': {
            'minEducation': 'BA',
            'workExperience': '3'
        }
    }

    response = client.post('/api/positions', json=data)

    assert response.status_code == 201
    json_data = response.get_json()
    assert json_data['success'] == True
    assert json_data['data']['id'] == 'TEST001'

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 0.15s

Test Case 4.2: 查詢所有崗位 (GET /api/positions)

def test_get_all_positions(client):
    """測試查詢所有崗位 API"""
    response = client.get('/api/positions')

    assert response.status_code == 200
    json_data = response.get_json()
    assert json_data['success'] == True
    assert 'data' in json_data
    assert isinstance(json_data['data'], list)

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 0.08s

Test Case 4.3: 查詢單一崗位 (GET /api/positions/)

def test_get_position_by_id(client):
    """測試查詢單一崗位 API"""
    # 先新增測試數據
    test_create_position(client)

    response = client.get('/api/positions/TEST001')

    assert response.status_code == 200
    json_data = response.get_json()
    assert json_data['success'] == True
    assert json_data['data']['id'] == 'TEST001'
    assert json_data['data']['basicInfo']['positionName'] == '測試工程師'

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 0.12s

Test Case 4.4: 更新崗位 (PUT /api/positions/)

def test_update_position(client):
    """測試更新崗位 API"""
    # 先新增測試數據
    test_create_position(client)

    update_data = {
        'basicInfo': {
            'positionName': '高級測試工程師'
        }
    }

    response = client.put('/api/positions/TEST001', json=update_data)

    assert response.status_code == 200
    json_data = response.get_json()
    assert json_data['success'] == True
    assert json_data['data']['basicInfo']['positionName'] == '高級測試工程師'

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 0.18s

Test Case 4.5: 刪除崗位 (DELETE /api/positions/)

def test_delete_position(client):
    """測試刪除崗位 API"""
    # 先新增測試數據
    test_create_position(client)

    response = client.delete('/api/positions/TEST001')

    assert response.status_code == 200
    json_data = response.get_json()
    assert json_data['success'] == True

    # 驗證已刪除
    get_response = client.get('/api/positions/TEST001')
    assert get_response.status_code == 404

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 0.14s

Test Case 4.6: 重複崗位編號檢查

def test_duplicate_position_code(client):
    """測試重複崗位編號的錯誤處理"""
    data = {
        'basicInfo': {
            'positionCode': 'DUP001',
            'positionName': '測試崗位'
        }
    }

    # 第一次新增應該成功
    response1 = client.post('/api/positions', json=data)
    assert response1.status_code == 201

    # 第二次新增相同編號應該失敗
    response2 = client.post('/api/positions', json=data)
    assert response2.status_code == 409
    json_data = response2.get_json()
    assert json_data['success'] == False
    assert '已存在' in json_data['error']

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 0.16s

2. 崗位描述 API 測試

Test Case 5.1: 新增崗位描述 (POST /api/position-descriptions)

def test_create_position_description(client):
    """測試新增崗位描述 API"""
    data = {
        'positionCode': 'JD001',
        'positionName': 'QA工程師',
        'effectiveDate': '2024-12-04',
        'jobDuties': '負責軟體測試和品質保證',
        'requiredSkills': 'Python, Selenium, Pytest',
        'workEnvironment': '辦公室'
    }

    response = client.post('/api/position-descriptions', json=data)

    assert response.status_code == 201
    json_data = response.get_json()
    assert json_data['success'] == True

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 0.11s

3. LLM 生成 API 測試

Test Case 6.1: LLM 文字生成 (POST /api/llm/generate)

def test_llm_generate_text(client):
    """測試 LLM 文字生成 API"""
    data = {
        'api': 'ollama',
        'prompt': '請生成一個簡短的職位描述',
        'model': 'deepseek-reasoner',
        'max_tokens': 100
    }

    response = client.post('/api/llm/generate', json=data)

    assert response.status_code == 200
    json_data = response.get_json()
    assert json_data['success'] == True
    assert 'text' in json_data
    assert len(json_data['text']) > 0

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 3.5s

Test Case 6.2: GPT-OSS 模型生成測試

def test_gptoss_model_generation(client):
    """測試 GPT-OSS 120B 模型生成"""
    data = {
        'api': 'gptoss',
        'prompt': '請列出軟體工程師的核心技能',
        'model': 'gpt-oss:120b',
        'max_tokens': 150
    }

    response = client.post('/api/llm/generate', json=data)

    assert response.status_code == 200
    json_data = response.get_json()
    assert json_data['success'] == True
    assert 'text' in json_data

預期結果: ✅ PASS 實際結果: ✅ PASS 執行時間: 6.2s

前端功能測試