체크리스트 개요
TQS 인증 체크리스트는 프로젝트의 TQS 규격 충족 여부를 체계적으로 검증하기 위한 항목 목록입니다. 본 장은 체크리스트의 구성 원칙, 분류 기준, 평가 방법, 분야별 가중치, 통과 기준을 정의합니다.
32.1.1. 체크리스트 구성 원칙
TQS 인증 체크리스트는 다음의 원칙에 따라 구성됩니다.
32.1.1.1. 객관적 검증 가능성
모든 체크리스트 항목은 객관적으로 검증 가능해야 합니다. 심사자의 주관에 따라 결과가 달라지는 항목은 체크리스트에 포함하지 않습니다. 각 항목은 명확한 충족 기준과 검증 방법을 함께 정의하며, 동일한 프로젝트를 다른 심사자가 검증하더라도 동일한 결과가 도출되어야 합니다.
32.1.1.2. 자동화 검증 우선
자동화 도구로 검증 가능한 항목을 우선적으로 체크리스트에 포함합니다. 자동 검증 항목은 CI/CD 파이프라인 실행 결과, 정적 분석 도구 출력, 커버리지 리포트 등 도구의 실행 결과로 충족 여부를 판단합니다. 자동 검증이 불가능한 항목은 수동 리뷰 또는 증빙 확인 방식으로 검증합니다.
32.1.1.3. 기술 스택 정합성
체크리스트 항목은 TQS 규격에서 정의한 기술 스택과 정확히 일치해야 합니다. 백엔드 체크리스트는 Java 21, Spring Boot 3.x, Maven, PostgreSQL, jOOQ, Flyway를 기준으로 작성되며, 프론트엔드 체크리스트는 Vue 3, TypeScript, Vite, Tailwind CSS를 기준으로 작성됩니다.
32.1.1.4. 단일 책임 원칙
하나의 체크리스트 항목은 하나의 검증 대상만 포함합니다. 복수의 검증 대상을 하나의 항목에 결합하지 않으며, 각 항목의 충족/미충족 판정이 독립적으로 이루어져야 합니다.
32.1.2. 분류 기준
체크리스트의 각 항목은 중요도에 따라 3가지 분류로 구분됩니다. 이 분류는 RFC 2119의 요구 수준 정의에 대응합니다.
| 분류 | 기호 | RFC 2119 대응 | 설명 |
|---|---|---|---|
| 필수 | O | MUST | 인증 획득을 위해 반드시 충족해야 하는 항목 |
| 권장 | R | SHOULD | 충족을 강력히 권장하는 항목 |
| 선택 | S | MAY | 프로젝트 특성에 따라 적용 가능한 항목 |
32.1.2.1. 필수 항목
필수 항목은 TQS 인증의 최소 요건입니다. 필수 항목 중 하나라도 미충족 시 인증 등급과 관계없이 불합격 처리됩니다. 필수 항목은 코드 품질, 보안, 테스트, 빌드 등 프로젝트의 기본 품질을 보장하는 항목으로 구성됩니다.
32.1.2.2. 권장 항목
권장 항목은 프로젝트 품질을 한 단계 높이기 위한 항목입니다. 권장 항목의 충족률은 인증 등급 결정에 직접적으로 영향을 미칩니다. 우수 인증은 권장 항목 80% 이상, 최우수 인증은 권장 항목 100%를 충족해야 합니다.
32.1.2.3. 선택 항목
선택 항목은 프로젝트의 특성, 규모, 도메인에 따라 적용 여부를 결정할 수 있는 항목입니다. 선택 항목은 인증 등급 산정에 포함되지 않으며, 적용 시 프로젝트 품질 보고서에 추가 달성 사항으로 기재됩니다.
32.1.3. 평가 방법
체크리스트 항목의 충족 여부는 다음 3가지 평가 방법 중 하나 이상으로 검증합니다.
| 평가 방법 | 설명 | 예시 |
|---|---|---|
| 자동 검증 | 자동화 도구의 실행 결과로 판정 | mvn spotless:check, JaCoCo 리포트, ESLint 실행 결과 |
| 수동 리뷰 | 심사위원이 소스코드 또는 설정을 직접 확인 | 네이밍 규칙 준수, 아키텍처 패턴, 예외 처리 구조 |
| 증빙 확인 | 프로젝트 팀이 제출한 증빙 자료를 확인 | 스크린샷, CI/CD 빌드 리포트, Lighthouse 결과 |
32.1.3.1. 자동 검증
자동 검증은 가장 객관적이고 재현 가능한 평가 방법입니다. TQS 위원회가 CI/CD 파이프라인을 직접 트리거하거나, 프로젝트 팀이 제출한 도구 실행 결과를 검토합니다. 자동 검증 항목은 도구의 출력 결과가 기준값을 충족하면 통과로 판정합니다.
32.1.3.2. 수동 리뷰
수동 리뷰는 자동화 도구로 검증할 수 없는 항목에 대해 심사위원이 직접 확인하는 방법입니다. 코드의 구조적 품질, 설계 패턴 적용 여부, 보안 구현의 적정성 등을 평가합니다. 수동 리뷰는 최소 2인의 심사위원이 독립적으로 수행하며, 판정이 상이한 경우 합의를 통해 최종 결정합니다.
32.1.3.3. 증빙 확인
증빙 확인은 프로젝트 팀이 제출한 스크린샷, 리포트, 로그 등의 자료를 통해 충족 여부를 판단하는 방법입니다. 증빙 자료는 심사 시점 기준 최근 1주 이내의 것이어야 하며, 위변조가 불가능한 형태(CI/CD 로그 URL, 자동 생성 리포트 등)를 권장합니다.
32.1.4. 분야별 가중치
TQS-S/W 인증의 체크리스트는 6개 분야로 구성되며, 각 분야에 가중치가 부여됩니다. 가중치는 해당 분야가 전체 프로젝트 품질에 미치는 영향도를 반영합니다.
| 분야 | 가중치 | 주요 검증 내용 |
|---|---|---|
| 개발환경 | 10% | IDE 설정, 도구 구성, 런타임 버전 |
| 백엔드 코드 | 25% | Java 컨벤션, Spring Boot, 데이터베이스, 빌드 |
| 프론트엔드 코드 | 25% | Vue 3, TypeScript, 스타일링, 테스트 |
| 운영 | 15% | 형상관리, CI/CD, 테스트 표준 |
| 보안 | 15% | 인증/인가, 암호화, 취약점 방어 |
| API | 10% | RESTful 설계, 문서화, 에러 처리 |
32.1.4.1. 가중치 적용 방식
각 분야의 점수는 해당 분야 내 항목의 충족률로 산정합니다. 전체 점수는 각 분야의 점수에 가중치를 곱한 값의 합산으로 계산합니다. 가중치는 TQS 위원회가 정기적으로 검토하며, 기술 환경 변화에 따라 조정될 수 있습니다.
32.1.4.2. 프로젝트 유형별 조정
백엔드만 포함하는 프로젝트의 경우, 프론트엔드 코드 분야의 가중치를 백엔드 코드와 운영 분야에 재배분합니다. 프론트엔드만 포함하는 프로젝트의 경우도 동일한 원칙으로 가중치를 재배분합니다. 재배분 기준은 TQS 위원회가 심사 시 결정합니다.
32.1.5. 통과 기준 요약
TQS 인증의 통과 기준은 인증 등급별로 다음과 같이 정의됩니다.
| 인증 등급 | 필수 항목 충족률 | 권장 항목 충족률 | 선택 항목 |
|---|---|---|---|
| 기본 인증 | 100% | 제한 없음 | 미반영 |
| 우수 인증 | 100% | 80% 이상 | 미반영 |
| 최우수 인증 | 100% | 100% | 미반영 |
32.1.5.1. 기본 인증 통과 기준
기본 인증은 모든 필수(O) 항목을 100% 충족해야 합니다. 필수 항목 중 하나라도 미충족 시 불합격으로 판정됩니다. 기본 인증은 TQS 마크를 사용할 수 있는 최소 기준입니다.
32.1.5.2. 우수 인증 통과 기준
우수 인증은 필수 항목 100% 충족에 더하여, 권장(R) 항목의 80% 이상을 충족해야 합니다. 권장 항목 충족률은 분야별로 별도 산정하지 않으며, 전체 권장 항목 기준으로 계산합니다.
32.1.5.3. 최우수 인증 통과 기준
최우수 인증은 필수 항목과 권장 항목을 모두 100% 충족해야 합니다. 최우수 인증은 TQS 인증의 최고 등급이며, TQS 위원회의 심층 기술 리뷰를 추가로 통과해야 합니다.
32.1.5.4. 부분 인증
프로젝트가 백엔드 또는 프론트엔드 중 하나만 포함하는 경우, 해당 영역의 체크리스트만 적용하여 인증을 수행합니다. 이 경우에도 통과 기준은 동일하게 적용됩니다.