💡

Core Philosophy

测试不是独立的阶段，而是贯穿整个开发过程的质量内建活动。

01 / Quality Assurance

Agile
Testing

敏捷测试概述
测试验证的全新范式

Traditional编码完成后才测试

Agile DevOps编码与测试同步进行

Continuous

Automated

3-5

min
feedback

100%

automated
testing

manual
test phase

Section 01

对比分析

敏捷测试 vs 传统测试
本质差异的深度剖析

Traditional瀑布测试

Agile DevOps敏捷测试

编码完成后才测试

编码与测试同步进行

独立测试团队执行

开发人员编写自动化测试

手工执行测试用例

CI 自动执行测试（每次提交）

数周后发现缺陷

分钟级反馈，即时修复

修复成本高昂

修复成本极低

季度发布

每日可部署

Section 02

关键指标

数量化呈现核心差异

反馈周期

数周～数月3-5 分钟

测试频率

阶段性每次提交

缺陷修复成本

高低

文档依赖

重轻（自动化测试即文档）

核心洞察

敏捷测试将反馈周期从数周～数月压缩至3-5分钟，这不仅是效率提升，更是开发模式的本质变革。

Section 03

流水线位置

测试验证在敏捷流水线中的关键位置

代码提交

CI 触发

代码检查

✓

通过?

构建镜像

推送镜像

蓝绿部署

健康检查

✓

流量切换

Testing Phase

Success

Failure

✗

检查失败

流水线终止，阻止合并

❌ 阻止合并

✓

检查通过

继续构建与部署

✅ 流量切换

02 / Testing Strategy

Test
Pyramid

多层次测试体系
从静态检查到端到端测试

E2E 测试

集成测试

单元测试

静态检查

大量

单元测试

大量

集成测试

适量

E2E 测试

少量

↑

执行频率

每次提交 → 每周

↓

执行速度

毫秒级 → 分钟级

↓

维护成本

低 → 高

Section 01

各层职责

测试金字塔各层的工具与执行时机

静态检查

✅ 已启用

代码规范、类型安全

工具:ESLint / flake8

执行:每次提交

单元测试

🔧 规划中

函数、组件、模块

工具:pytest / Vitest

执行:每次提交

集成测试

🔧 规划中

API 接口、服务交互

工具:pytest + httpx

执行:每次 PR

E2E 测试

📋 待规划

用户完整操作流程

工具:Playwright / Cypress

执行:每日/发布前

部署验证

✅ 已启用

服务健康、可用性

工具:Shell 脚本

执行:每次部署

✅ 已启用生产环境运行中

🔧 规划中开发迭代计划

📋 待规划后续版本规划

Section 02

测试工具

前端与后端测试工具链

Frontend

Vue / Nuxt.js

ESLint

代码规范检查

Active

vue-tsc

TypeScript 类型检查

Active

Vitest

单元测试框架

Planned

Backend

Python / FastAPI

flake8

PEP8 代码风格检查

Active

black

代码格式化

Active

pytest

单元/集成测试框架

Planned

03 / Quality Assurance

Quality
Gates

代码质量的第一道防线，每次提交自动检查。

Check Types

<1s

Check Time

100%

Automated

Trigger:push → main / develop

READY

Click to simulate

ESLint

TypeScript

flake8

black

mypy

Section 01

检查流程

GitHub Actions lint-and-test Job

Frontend

pnpm install安装依赖

pnpm lintESLint 检查

Backend

flake8 app/PEP8 风格

black --check app/格式验证

mypy app/类型检查

Section 02

工具配置

frontend/eslint.config.mjs

1// frontend/eslint.config.mjs

2import nuxt from "@nuxt/eslint";

4export default nuxt({

5 rules: {

6 "vue/multi-word-component-names": "off",

7 "@typescript-eslint/no-explicit-any": "warn",

8 },

9});

Section 03

本地命令

terminal

# Frontend

$pnpm lint

$pnpm lint:fix

# Backend

$flake8 app/ --max-line-length=100

$black --check app/

$black app/ # 自动修复

$mypy app/

04 / Quality Assurance

Automated
Testing

单元测试与集成测试规划
构建可靠的质量保障体系

🔧规划中

test runner

test_health.py2 tests

pending

test_resume.py3 tests

pending

Vitest

Frontend Testing

pytest

Backend Testing

Test Suites

Test Cases

Section 01

单元测试

前后端单元测试目录结构

Backend (pytest)

backend/tests/

📄conftest.py

📄test_health.py

📄test_resume.py

📄test_models.py

Example

@pytest.mark.asyncio
async def test_health():
    response = await client.get("/health")
    assert response.status_code == 200

Frontend (Vitest)

frontend/tests/

📄components/Button.test.ts

📄composables/useDownload.test.ts

📄utils/format.test.ts

Example

test('renders button', () => {
  render(Button)
  expect(screen.getByRole('button'))
    .toBeInTheDocument()
})

Section 02

集成测试

API 接口集成测试示例

backend/tests/test_api.py

1import pytest
2from httpx import AsyncClient
3from app.main import app
4
5@pytest.fixture
6async def client():
7    """创建测试客户端"""
8    async with AsyncClient(app=app, base_url="http://test") as ac:
9        yield ac
10
11@pytest.mark.asyncio
12async def test_download_count(client: AsyncClient):
13    response = await client.get("/api/v1/resume/count")
14    assert response.status_code == 200
15    data = response.json()
16    assert "total_downloads" in data

✓test_download_count

测试获取下载次数

✓test_record_download

测试记录下载

05 / Quality Assurance

Deployment
Verify

部署后的健康检查与验证流程
确保服务正常上线

Check Steps

<30s

Verify Time

✓

Auto Rollback

deployment flow

current: blue

获取活跃环境

读取 .deployment-state

WAIT

容器健康检查

Docker exec curl

WAIT

Nginx 代理验证

HTTP 健康检查

WAIT

HTTPS 访问验证

可选的外部检查

WAIT

镜像数量检查

清理警告

WAIT

Backend

:8000/health

Frontend

:3000

Nginx

:80/health

Section 01

验证脚本

部署后自动化验证脚本

scripts/deploy/post-deploy-verify.sh

1#!/bin/bash

2set -euo pipefail

4# 获取当前活跃环境

5ACTIVE_ENV=$(cat .deployment-state 2>/dev/null || echo "blue")

7echo "📊 当前活跃环境: $ACTIVE_ENV"

8docker ps --filter "name=backend-$ACTIVE_ENV"

10# 后端健康检查

11if docker exec backend-$ACTIVE_ENV curl -sf http://localhost:8000/health; then

12 echo "✅ 后端健康检查通过"

13else

14 echo "❌ 后端健康检查失败"

15 exit 1

16fi

Step 1

获取环境

读取部署状态

Step 2

容器检查

Docker exec curl

Step 3

代理验证

Nginx 健康检查

Section 02

健康端点

FastAPI 健康检查端点实现

backend/app/routers/health.py

1from fastapi import APIRouter

2from pydantic import BaseModel

4router = APIRouter(prefix="/api/v1")

6class HealthResponse(BaseModel):

7 status: str

8 service: str

9 version: str

11@router.get("/health")

12async def health_check():

13 return HealthResponse(

14 status="healthy",

15 service="ningshen-backend",

16 version="1.0.0"

17 )

RequestGET /api/v1/health

Response

{
  "status": "healthy",
  "service": "ningshen-backend",
  "version": "1.0.0"
}

Usage

•CI/CD 部署验证

•负载均衡器探活

•监控系统检测

06 / Quality Assurance

Test
Coverage

测试覆盖率演进路线
分阶段提升质量保障能力

Phase 1静态检查已启用

100%

静态检查

目标 100%

单元测试

目标 60%

E2E测试

目标 70%

已完成

规划中

未来目标

阶段

100%

静态检查覆盖

70%+

最终目标

Section 01

演进路线

三阶段覆盖率提升计划

当前状态

已完成

✓ 静态代码检查 100% 覆盖
✓ 部署健康检查 100% 覆盖
✓ 代码格式化规范 100% 执行

基础测试

规划中

✓ 后端核心 API 单元测试覆盖率 > 60%
✓ 关键工具函数测试覆盖率 > 80%
✓ CI 集成 pytest 自动执行

完善测试

未来

✓ 整体测试覆盖率 > 70%
✓ 前端组件测试覆盖核心交互
✓ E2E 测试覆盖关键用户路径

Section 02

核心理念

覆盖率不是目的，质量保障才是

核心逻辑优先

优先测试核心业务逻辑

边界条件优先

优先测试容易出错的地方

避免无意义

不为了覆盖率写无用测试

07 / Quality Assurance

Traditional
vs Agile

传统测试与敏捷测试的根本差异
从"事后把关"到"质量内建"

数周

传统反馈

→

3分钟

敏捷反馈

Traditional

瀑布测试

Agile

敏捷测试

📅编码完成后测试

🔄编码同时测试

🔍数周后发现缺陷

⚡3分钟内反馈

💸修复成本高昂

💵即时低成本修复

Section 01

测试时机

维度

传统瀑布

→

敏捷测试

测试启动时机

编码完成后

编码同时进行

缺陷发现时机

数周至数月后

提交后 3-5 分钟

修复成本

高（追溯设计）

低（即时修复）

反馈周期

阶段性反馈

持续反馈

⚡反馈周期从数周缩短至 3-5 分钟

Section 02

测试自动化

自动化程度

主要手工执行

自动化程度

高度自动化 CI/CD 集成

回归测试

耗时费力，选择性执行

回归测试

自动执行，每次全量回归

测试环境

手工搭建，环境差异大

测试环境

Docker 容器化，环境一致

部署验证

手工验收

部署验证

自动化检查 + 蓝绿回滚

关键差异

敏捷测试实现 100% 自动化回归，每次提交触发全量测试，无需人工干预。

Section 03

角色分工

单元测试

集成测试

验收测试

单元测试

开发人员（可选）

开发人员（必须）

集成测试

独立测试团队

开发 + 自动化

验收测试

客户/测试团队

自动化 + 部署验证

质量责任

测试团队为主

团队共同负责

质量责任

团队共同负责

核心理念

质量内建

Quality Assurance

Git Workflow

测试驱动的 Git 工作流 — 从本地检查到 CI/CD，每一步都有质量保障

~1 min

Local Check

本地代码质量检查

pnpm lint

flake8 app/

black --check

~1 min

CI Quality Gate

CI 代码质量门禁

lint-and-test job

阻止不合格代码

~2 min

Build & Deploy

构建与部署验证

Docker build

health check

blue-green switch

阶段

3-5

分钟

100%

自动化

Section 01

本地检查

提交代码前必须通过的检查

1# Frontend

2$ cd frontend

3$ pnpm lint

5# Backend

6$ flake8 app/

7$ black --check app/

9# Git

10$ git push origin main

前端代码检查

pnpm lint

必须通过

后端代码检查

flake8 app/

必须通过

代码格式验证

black --check app/

必须通过

单元测试

pytest tests/

规划中

Section 02

CI/CD 流水线

🔍

~1 min

lint-and-test

→前端 lint

→后端 flake8+black

→单元测试(规划中)

失败时

阻止合并

📦

~2 min

build-and-push

→Docker 镜像构建

→推送到 Registry

失败时

流水线终止

🚀

~1 min

deploy

→蓝绿部署

→健康检查

→流量切换

失败时

自动回滚

Quality Assurance

核心产出物

测试相关配置文件与自动化产出清单

Section

测试相关配置文件

ESLint 配置

frontend/eslint.config.mjs

前端代码检查规则

flake8 配置

backend/setup.cfg

后端风格检查配置

pytest 配置规划中

backend/pytest.ini

测试框架配置

开发依赖

backend/requirements-dev.txt

测试相关依赖

CI/CD 工作流

.github/workflows/ci-cd-*.yml

自动化测试流水线

部署验证脚本

scripts/deploy/post-deploy-*.sh

部署验证脚本

Section

测试自动化产出

CI 检查结果

每次提交的检查状态

获取方式

GitHub Actions UI

代码检查报告

ESLint/flake8 详细输出

获取方式

CI Logs

部署验证日志

健康检查执行结果

获取方式

CI LogsServer Logs

测试覆盖率报告

代码覆盖率统计

获取方式

CI Artifacts

Total

10 项

配置文件

自动化产出

Final Chapter

Summary

敏捷测试的核心价值与理念总结

Core Values

3-5

Minutes

100%

Automated

Chapters

Section 01

Core Values

敏捷测试的五大核心价值

快速反馈

每次提交 3-5 分钟内获得代码质量反馈，问题早发现早解决

质量内建

测试不是独立阶段，而是开发过程中持续进行的活动

自动化驱动

CI/CD 流水线自动执行测试，无需人工干预，保障一致性

安全部署

蓝绿部署 + 健康检查 + 自动回滚，确保生产环境稳定

持续改进

从静态检查起步，逐步完善单元测试、集成测试、E2E 测试

Section 02

Philosophy

测试不是终点
而是持续的质量守护

与传统瀑布模型将测试视为独立的验证阶段不同，敏捷测试将 质量内建到每一次提交、每一次部署中。

问题早发现

成本最低化

交付最快化

What We Achieve

通过自动化测试，我们能够

第一时间发现

在问题发生的第一时间发现它

最低成本修复

以最低的成本修复问题

最快速度交付

以最快的速度将修复交付给用户

AgileTesting

对比分析

关键指标

流水线位置

TestPyramid

各层职责

静态检查

单元测试

集成测试

E2E 测试

部署验证

测试工具

QualityGates

检查流程

Frontend

Backend

工具配置

本地命令

AutomatedTesting

单元测试

集成测试

DeploymentVerify

验证脚本

健康端点

TestCoverage

演进路线

当前状态

基础测试

完善测试

核心理念

核心逻辑优先

边界条件优先

避免无意义

Traditionalvs Agile

测试时机

测试自动化

角色分工

Git Workflow

本地检查

CI/CD 流水线

核心产出物

测试相关配置文件

测试自动化产出

Summary

Core Values

快速反馈

质量内建

自动化驱动

安全部署

持续改进

Philosophy

通过自动化测试，我们能够

第一时间发现

最低成本修复

最快速度交付

Agile
Testing

Test
Pyramid

Quality
Gates

Automated
Testing

Deployment
Verify

Test
Coverage

Traditional
vs Agile