개념
양식을 정하는 사람이 바뀐다
레슨 1~6 은 의뢰 기반 성적서 를 다뤘다. 그 세계에서 양식은 시험기관이 정한다. 기관의 품질 체계가 양식을 규정하고, 의뢰인은 그 양식으로 받는다.
SI 납품은 반대다. 발주처가 양식을 정한다. 그리고 발주처의 양식은 시험 문서로 설계된 것이 아니다 — 대개 검수 서류 묶음의 한 장 으로 설계되어 있다. 그래서 우리가 보기에 중요한 칸이 없고, 우리가 안 쓰던 칸이 필수다.
여기서 생기는 긴장이 이 레슨의 주제다. 우리는 재현 가능하고 판정 근거가 분명한 문서 를 만들고 싶고, 발주처는 검수 서류 묶음에 끼워지는 한 장 을 원한다. 둘을 동시에 만족시키는 방법이 있고, 그것이 템플릿 설계다.
먼저 경계를 긋는다
이 레슨이 다루지 않는 것이 있다.
- 감리 대응, 검수조서 작성, 하자보수 절차 는 모듈 56 레슨 3 이 맡는다. 거기는 사업을 인수받는 절차 이고, 이 레슨은 그 절차에 들어가는 성적서 한 문서 를 만드는 일이다
- 제안요청서(RFP) 의 요구사항을 인수 기준으로 읽는 일 은 모듈 56 레슨 4 다. 이 레슨은 그 읽기 결과를 성적서 양식 으로 옮긴다
- 전자정부 표준프레임워크·접근성 검수·망분리 환경 같은 공공 사업의 기술 규격은 모듈 64 가 맡는다. 이 레슨은 어느 도메인이든 공통인 문서 형식 맞추기 다
한 사업에서 셋이 이어진다 — 모듈 56 레슨 4 에서 무엇이 인수 기준인지 를 읽고, 이 레슨에서 그 판정을 담는 문서 를 만들고, 모듈 56 레슨 3 에서 그 문서로 검수를 받는다.
발주 문서에서 성적서 요구를 캐낸다
가장 흔한 실패는 성적서 요구를 늦게 발견하는 것 이다. 사업 막바지에 제출 목록을 보고 "시험성적서 1부" 를 처음 읽고, 양식을 받아 보니 우리가 모은 증거로는 채울 수 없는 칸이 있다. 그때는 다시 시험할 시간이 없다.
그래서 착수 때 발주 문서를 성적서 관점으로 한 번 훑는다. 캐낼 항목은 일곱이다.
| 캐낼 것 | 어디에 적혀 있기 쉬운가 |
|---|---|
| 제출 산출물 목록에 성적서가 있는가, 몇 종인가 | 과업지시서 산출물 목록, 계약 특수조건 |
| 양식이 지정되어 있는가 | 별첨 양식, 기관 표준 서식집 |
| 제3자 공인 성적서를 요구하는가 | 과업지시서 품질 요구, 평가 기준 |
| 시험 항목이 지정되어 있는가 | 요구사항 목록, 성능 요구, 품질 목표 |
| 판정 기준이 숫자로 적혀 있는가 | 성능 요구, 서비스 수준 |
| 증빙 범위와 형태 | 산출물 작성 지침, 감리 요구 |
| 제출 형태(부수·서명·날인·전자문서) | 계약 조건, 제출 요령 |
세 번째 항목이 일정에 가장 큰 영향을 준다. "제3자 공인 시험기관의 성적서" 를 요구하면 우리가 쓰는 문서가 아니고, 기관 접수·대기·시험·발행에 걸리는 리드타임이 붙는다. 그 리드타임을 역산하지 않으면 사업 종료일에 성적서가 없다. 성적서 종류별 제도 차이와 어느 기관에 맡길지의 판단은 레슨 5 에서 다뤘다 — 여기서는 일정 역산 만 기억한다.
그리고 다섯 번째 항목이 비어 있는 경우가 매우 흔하다. "응답 속도가 빠를 것" 같은 문장만 있고 숫자가 없다. 이때 숫자를 우리가 정해 성적서에 적으면, 검수에서 "누가 정했습니까" 가 나온다. 판정 기준은 합의해서 문서로 받아 두고 성적서에 그 출처를 적는다. 판정 기준 선언의 원칙은 레슨 3 에서 다룬 그대로다.
발주처 양식에 우리 결과를 옮기는 문제
발주처 양식을 받으면 거의 항상 세 가지 문제가 생긴다.
1) 칸이 부족하다. 환경 기재 칸이 한 줄이거나, 판정 근거 칸이 없다. 재현 가능성이 사라진다.
2) 칸이 남는다. 우리가 측정하지 않은 항목의 칸이 있다. 비워 두면 미비로 보이고, 억지로 채우면 틀린 기재가 된다.
3) 용어가 다르다. 우리는 "적합/부적합" 을 쓰는데 양식은 "양호/미흡" 을 쓴다.
우리는 p95 를 쓰는데 양식은 "평균 응답시간" 칸만 있다.
해결의 원칙은 하나다. 양식은 바꾸지 않고, 부족한 것은 붙인다.
- 칸이 부족하면 별첨으로 보낸다. 본문 칸에는 요약과 별첨 참조 번호 를 적고, 상세는 별첨에 담는다. 양식을 고쳐 칸을 늘리면 "지정 양식이 아니다" 로 되돌아온다
- 칸이 남으면 비우지 않고 표시한다. "해당 없음(근거: 과업 범위 외)" 처럼 왜 비었는지 를 적는다. 빈칸은 누락으로 읽히고, 사유가 적힌 칸은 판단으로 읽힌다
- 용어가 다르면 대응표를 만들어 첨부한다. 양식의 용어로 적고, 별첨 첫 장에
"양식 용어 ↔ 시험 용어" 대응표를 둔다.
p95를 "평균" 칸에 적는 것이 가장 위험한 선택이다 — 값의 의미가 바뀐다. 칸 이름을 바꿀 수 없으면 그 칸에 평균을 적고 별첨에 분포를 담고, 판정은 분포 기준으로 했음을 명시 한다
세 번째 원칙이 레슨 4 와 직접 이어진다. 평균만 적으면 안 되는 이유를 알고 있다면, 양식이 평균 칸만 주더라도 분포를 잃지 않는 방법 을 설계할 수 있다.
템플릿은 두 층으로 만든다
실무에서 쓰이는 구조는 지정 양식(1층) + 표준 별첨(2층) 이다.
| 층 | 내용 | 누가 정하는가 |
|---|---|---|
| 1층 — 지정 양식 | 요약, 판정, 서명 | 발주처 |
| 2층 — 표준 별첨 | 범위·환경·절차·원시 결과·분포·증빙 색인 | 우리 |
2층을 우리 표준으로 고정해 두는 것 이 이 레슨의 핵심 산출물이다. 사업마다 1층은 바뀌지만 2층은 거의 같다. 2층을 한 번 잘 만들어 두면, 새 사업에서 하는 일이 1층 양식에 맞춰 요약을 옮기고 참조 번호를 붙이는 일 로 줄어든다.
2층 표준 별첨에 들어갈 것은 레슨 1~4 의 내용 그대로다.
- A. 시험 범위와 제외 범위 — 레슨 1. 제외 범위를 적는 것이 특히 중요하다
- B. 시험 환경과 구성 — 레슨 2. 버전·구성·설정이 재현 가능한 수준으로
- C. 판정 기준과 그 출처 — 레슨 3. "누가 정했는가" 가 반드시 들어간다
- D. 시험 절차와 수행 기록 — 일시, 수행자, 반복 횟수
- E. 결과 — 요약과 분포 — 레슨 4. 평균·중위·p95·최대와 표본 수
- F. 증빙 색인 — 아래에서 다룬다
- G. 용어 대응표 — 양식 용어와 시험 용어의 매핑
증빙은 색인으로 관리한다
SI 납품에서 증빙은 양이 많다. 로그, 캡처, 측정 원본, 설정 파일, 실행 기록. 이것을 그냥 폴더에 담아 보내면 검수자가 열어 보지 못한다. 그러면 증빙이 있어도 판정 근거로 쓰이지 않는다.
증빙 색인이 하는 일은 판정과 파일을 잇는 것 이다. 색인 한 줄의 구성은 이렇다.
| 열 | 예 |
|---|---|
| 증빙 번호 | E-012 |
| 대응 시험 항목 | TC-ADM-07 |
| 대응 판정 | 적합 |
| 증빙 종류 | 부하 생성기 결과 원본 |
| 파일 경로·이름 | 02_결과/ADM-07_k6_20261003.json |
| 생성 일시·생성자 | 2026-10-03 14:22 / 수행자 |
| 확인 방법 | "요약 통계 절의 p95 값과 대조" |
마지막 열이 색인의 가치를 만든다. 검수자가 그 파일을 열어 무엇을 보면 판정을 확인할 수 있는지 를 알려 준다. 이 열이 없으면 증빙은 양만 많은 첨부가 된다.
파일 이름 규칙도 미리 정한다. 시험 항목 식별자가 파일 이름에 들어가면 색인과 파일이 어긋나지 않는다. 그리고 증빙을 덮어쓰지 않는다 — 재시험 회차를 파일명에 넣어 구분한다.
제출 형태를 마지막에 확인하지 않는다
가장 허무하게 일이 늘어나는 지점이다. 내용을 다 만들고 나서 제출 형태가 안 맞아 다시 만든다. 미리 확인할 항목은 이렇다.
- 문서 형식 — 기관이 쓰는 문서 형식이 정해져 있는 경우가 많다. 변환 과정에서 표가 깨지거나 글꼴이 바뀌는 문제가 생기므로, 최종 형식으로 한 장을 미리 만들어 확인 한다. 공공 기관의 문서 형식 호환성 문제는 모듈 64 레슨 4 가 다룬다
- 부수와 원본 — 인쇄 부수, 원본 서명이 필요한 부수
- 서명·날인 — 누가 서명하는가(수행자·책임자·대표), 직인이 필요한가, 전자서명이 인정되는가
- 일련번호 체계 — 기관이 문서 번호 체계를 지정하는 경우가 있다
- 제출 경로 — 전자 조달 시스템 업로드인지, 대면 제출인지. 업로드라면 파일 크기 제한과 허용 확장자를 확인한다(증빙 묶음이 제한을 넘는 일이 흔하다)
- 제출 마감과 보정 기간 — 보정 기간이 있으면 1차 제출을 일찍 하고 피드백을 받는 것이 유리하다
마지막 항목을 전략으로 쓸 수 있다. 양식 해석이 애매할 때, 완성도를 100% 로 올려 마감에 맞추기보다 초안을 일찍 내고 형식 피드백을 받는 편 이 훨씬 빠르다. 형식 지적은 내용 지적보다 고치기 쉽고, 미리 받으면 본작업에 반영할 수 있다.
양식이 주어지지 않았을 때 — 먼저 제안한다
의외로 자주 있는 상황이다. 발주 문서에 "시험성적서 제출" 만 적혀 있고 양식이 없다. 이때 선택지는 둘이다.
나쁜 선택 — 우리 양식으로 만들어 제출한다. 검수에서 "이런 양식으로 받은 적 없다", "이 항목이 없다" 가 나오고, 그때의 수정은 사업 막바지에 일어난다.
좋은 선택 — 착수 단계에 우리 양식 초안을 보내 승인을 받는다. 제안 메일에 담을 것은 셋이다.
- 양식 초안(1층 요약 + 2층 별첨 목차)
- 각 절이 무엇을 보장하는지 한 줄 설명(왜 이 칸이 필요한가)
- "다른 양식을 쓰셔야 하면 알려 주십시오. 그 양식에 맞춰 드립니다"
이 한 통으로 두 가지를 얻는다. 승인되면 우리가 설계한 양식으로 간다. 발주처 양식이 있으면 착수 때 받게 되고, 그것이 애초에 원한 결과다. 어느 쪽이든 사업 막바지의 재작업이 사라진다.
사례 — 양식을 검수 2주 전에 받은 일
과업지시서 본문에 "시험성적서를 제출한다" 한 줄만 있었다. 양식 언급이 없어서 우리 양식으로 작성해 두고 개발을 진행했다.
검수 2주 전, 발주처 담당자가 별첨 양식 파일을 보내 왔다. 과업지시서 별첨에 처음부터 있었던 파일이었다.
| 우리 양식 | 발주처 양식 | 결과 |
|---|---|---|
| 시험항목 자유 기술 | 분류 코드 체계 고정 | 전 항목 재분류 |
| 결과를 통과/실패 | 적합·부적합·해당없음 3단계 | 판정 재작성 |
| 증빙을 링크로 | 출력물 첨부 + 쪽수 색인 | 증빙 전량 출력·색인 |
| 서명 1인 | 작성·검토·승인 3인 | 승인 일정 추가 |
| 제출 PDF 1건 | 지정 시스템 업로드, 파일당 용량 제한 | 증빙 분할 |
시험을 다시 한 것은 없었다. 전부 형식 변환 작업이었고, 그런데 그 작업에 9일이 걸렸다. 특히 세 번째와 네 번째가 오래 걸렸다 — 증빙 출력·색인은 사람 손이 가고, 3인 서명은 일정을 잡아야 한다.
그 뒤 바꾼 것은 착수 시점의 두 가지 확인이다.
① 과업지시서의 첨부를 전부 열어 본다
"성적서" 로 검색하지 말고 파일 목록을 눈으로 훑는다
양식·작성 지침은 본문이 아니라 별첨에 있다
② 담당자에게 세 줄로 묻는다
- 지정 양식이 있습니까(있으면 파일을)
- 서명은 몇 분이 필요합니까
- 제출은 어떤 형태입니까(시스템·형식·용량 제한)②의 두 번째·세 번째 질문이 일정을 바꾼다. 양식만 받고 서명·제출 형태를 안 물으면, 같은 일을 마지막에 또 겪는다.
교훈이 셋이다.
- 양식은 본문이 아니라 별첨에 있다 — 첨부를 전부 열어 보는 것이 착수 작업이다
- 형식 변환은 시험이 아닌데 시간이 든다 — 재분류·출력·색인·서명은 전부 사람 손이고 일정 항목이다
- 서명자 수와 제출 형태를 먼저 묻는다 — 둘 다 우리가 통제할 수 없는 리드타임이다(모듈 28 레슨 1의 시험 기관 일정과 같은 성질)
실무에서 왜 필요한가
이 레슨의 내용은 일정 사고를 막는 쪽 으로 가치가 크다. SI 사업에서 성적서 때문에 생기는 사고는 대개 세 가지 모양이다.
첫째, 제3자 공인 성적서 요구를 늦게 발견한다. 기관 리드타임이 사업 일정에 들어가 있지 않아 종료일을 넘긴다. 이것은 착수 때 발주 문서를 성적서 관점으로 한 번 훑으면 끝나는 일이다.
둘째, 양식을 늦게 받는다. 우리 양식으로 다 만들었는데 지정 양식이 나타난다. 칸이 맞지 않아 결과를 옮길 수 없고, 어떤 칸은 측정하지 않은 항목이다.
셋째, 증빙이 쓰이지 않는다. 증빙은 충분히 모았는데 검수자가 어느 파일에서 무엇을 봐야 할지 몰라 "근거 부족" 으로 보완 요청이 온다. 색인 한 장으로 막을 수 있는 일이다.
세 사고 모두 문서 작업 에서 나오고, 셋 다 착수 시점의 몇 시간으로 예방된다. 그래서 이 레슨의 실제 가치는 "성적서를 잘 쓰는 법" 이 아니라 착수 때 무엇을 확인해 둘지 아는 것 이다.
그리고 2층 표준 별첨을 한 번 만들어 두면 조직 자산이 된다. SI 조직에서 QA 가 만들 수 있는 가장 재사용성 높은 산출물 중 하나다. 사업마다 다시 설계하지 않고 1층만 맞추게 되면, 성적서 작성에 드는 시간이 눈에 띄게 줄어든다.
채용시장에서의 위치
이 레슨이 겨냥하는 자리는 SI 기업과 솔루션 공급사의 QA·품질보증 담당 이다. 국내 QA 채용에서 물량이 큰 쪽이고, 공고에는 "산출물 작성", "검수 대응", "품질 문서 관리", "공공 프로젝트 경험" 같은 말로 나타난다.
이쪽 시장에서 평가받는 능력은 시험 설계보다 문서를 끝내는 능력 이다. 시험을 잘해도 산출물이 검수를 통과하지 못하면 사업이 끝나지 않고, 그 구간에서 사람이 가장 많이 소모된다. 그래서 양식을 읽고 맞추고 증빙을 연결하는 사람 의 수요가 꾸준하다.
면접에서 차이를 만드는 대답은 구체적이다. "성적서를 작성해 봤습니다" 와 "착수 때 발주 문서에서 성적서 요구 7가지를 캐내고, 지정 양식에 표준 별첨을 붙이는 2층 구조로 만들고, 증빙 색인에 확인 방법 열을 넣어 검수 보완 요청을 줄였습니다" 는 다르게 들린다. 후자는 사고를 겪고 장치를 만든 사람 의 말투다.
경력 축으로 보면 이 역량은 모듈 56(인수·검수) 과 모듈 25·32·33(제도·인증) 과 붙어 하나의 묶음을 이룬다. 성적서·검수·인증을 함께 다룰 수 있는 사람은 SI 조직에서 품질 쪽 중심 역할로 옮겨 가기 쉽다.