가이드 · 요구사항
좋은 시스템 요구사항 작성법: 예제와 체크리스트
이 가이드 듣기(영어 오디오) 26분
좋은 요구사항은 시스템이 해야 하거나 갖춰야 하는 것 하나를, 두 엔지니어가 똑같이 읽는 말로, 시험이나 분석으로 확인할 수 있는 값과 함께 말합니다. 이 가이드는 니즈와 요구사항의 차이, 요구사항 문장의 구성 요소, ISO/IEC/IEEE 29148과 INCOSE Guide to Writing Requirements의 품질 특성, 수정 전후 예제가 포함된 체크리스트, 검증과 합격 기준, TBD와 TBR 값, 요구사항 유형을 다루며, 모두 하나의 CubeSat 사양서로 실습합니다.
이 페이지의 내용
요구사항의 문구가 중요한 이유
요구사항은 시스템을 요청하는 사람과 만드는 사람 사이의 계약입니다. 이후의 모든 것이 요구사항을 읽습니다. 설계자는 그에 맞춰 구성 요소의 크기를 정하고, 시험 엔지니어는 그로부터 합격 기준을 쓰고, 변경 위원회는 그에 비추어 변경을 따지고, 고객은 그에 따라 시스템을 인수합니다. 이들은 모두 같은 문장을, 대개 작성자가 없는 자리에서 읽습니다. 문장을 두 가지로 읽을 수 있다면 실제로 두 가지로 읽히며, 그 차이는 늦게 드러납니다. 아무도 합의하지 않은 기준에 대해 "합격"하는 시험에서, 또는 고객이 다른 것을 뜻했던 인수 시점에서입니다.
부실한 문구는 모델의 나머지 부분도 망가뜨립니다. 값이 없는 요구사항은 구성 요소가 이를 충족하는지 아무도 말할 수 없으므로 구성 요소에 할당할 수 없습니다. 검증할 수 없으므로 추적성과 검증 매트릭스에 커버리지 공백으로 나타납니다. 그리고 바뀌었을 때 연결된 설계가 여전히 유효한지 아무도 알 수 없습니다. 요구사항을 잘 쓰는 것은 프로젝트에서 가장 저렴한 품질 작업입니다. 시작할 때 문장 하나에 들인 한 시간이 끝에서 시험 캠페인 하나를 아껴 줍니다.
이 가이드는 하나의 예제를 계속 사용합니다. 농경지를 네 개의 분광 밴드로 촬영하는 가상의 6U CubeSat인 EO-1입니다. 그 사양서 SRS-001 EO-1 System Requirements Specification에는 32개의 요구사항이 있으며, 대부분은 건전하고 세 개는 일부러 약하게 작성되었습니다. 처음부터 끝까지의 MBSE 예제 프로젝트와 같은 모델입니다. 여기서 인용하는 이해관계자 니즈 N1~N3은 추적성 가이드에서 모델에 추가하는 것입니다.
이해관계자 니즈와 요구사항
요구사항 작성은 한 단계 앞, 니즈에서 시작합니다. 이해관계자 니즈는 사용자, 운영자, 고객 또는 규제 기관이 자신의 언어로 기대하는 것입니다. 요구사항은 시스템을 설계하고 검증하는 기준이 되는 공학적 진술입니다. ISO/IEC/IEEE 15288은 둘을 별도의 기술 프로세스로 나눕니다. 이해관계자 니즈 및 요구사항 정의(6.4.2)와 시스템 요구사항 정의(6.4.3)입니다. INCOSE Needs and Requirements Manual도 같은 구분을 하며, 니즈를 요구사항의 거친 초안이 아니라 그 자체로 독립된 항목으로 다룹니다.
| EO-1 예 | 확인 방법 | |
|---|---|---|
| 니즈(N2 Twice-Weekly Revisit) | Farm customers need fresh imagery of their fields at least twice a week in the growing season. | 확인: 고객이 인도된 시스템에서 필요한 것을 얻습니까? |
| 요구사항(1.6 Revisit Time) | The mission shall revisit each target region within 72 hours. | 검증: 시스템이 시험, 분석, 검사 또는 시연으로 진술을 충족합니까? |
차이는 각각을 확인하는 방식에서 드러납니다. 요구사항은 검증됩니다. 시스템을 진술에 대해 측정합니다. 니즈는 확인됩니다. 누군가 시스템이 의도된 용도에서 이해관계자가 원한 것을 하는지 확인합니다. 요구사항이 핵심을 놓쳤다면 시스템은 모든 검증을 통과하고도 확인에 실패할 수 있습니다. 이 간극은 검증과 확인 가이드에서 다룹니다. 작성에 대한 실질적인 결론은 간단합니다. 니즈를 먼저 쓰고, 충족되면 그 니즈를 만족시킬 요구사항을 쓰고, 각 요구사항을 그것이 답하는 니즈에 다시 연결합니다.
변환이 일대일인 경우는 드뭅니다. N2는 1.6 Revisit Time이 되고, 이는 다시 1.6.1 Ground Track Repeat(3일)와 1.6.2 Off-Nadir Imaging(25도)으로 분해됩니다. 어떤 요구사항은 어느 니즈에도 직접 답하지 않습니다. 3.1 Orbit Average Power는 촬영 부하가 어레이가 공급해야 할 전력을 정하기 때문에 1.5 Daily Collection Volume에서 파생됩니다. 어떤 고객도 30 W를 요청하지 않았지만, 고객이 요청한 촬영은 그것 없이는 이루어질 수 없습니다.
요구사항의 구조
요구사항은 문장 이상입니다. 문장은 의무를 담고, 그 주위의 속성 집합은 이유, 입증 계획, 관리 정보를 담습니다. 두 부분 모두 작성의 일부입니다.
문장
좋은 요구사항 문장은 대부분 하나의 패턴에 맞습니다. ISO/IEC/IEEE 29148(5.2.4)은 이를 주어, 행위, 목적어, 행위에 대한 제약으로 설명하며, 앞에 선택적인 조건이 붙습니다. INCOSE Guide to Writing Requirements도 같은 순서와, 요구사항 종류별로 합의된 템플릿을 권장합니다.
| 구성 요소 | 말하는 내용 | EO-1 4.3 Fault Detection |
|---|---|---|
| 조건(선택) | 요구사항이 언제, 어떤 모드나 상태에서 적용되는지 | "…of undervoltage detection"(촉발 사건) |
| 주어 | 준수해야 하는 시스템이나 요소, 정확한 이름으로 | "The C&DH" |
| 조동사 | 의무의 강도 | "shall" |
| Action | 주어가 하는 것 또는 갖추는 것, 능동 동사로 | "enter" |
| 목적어 | 행위가 적용되는 대상 | "safe mode" |
| 성능 또는 제약 | 단위와 한계 방향이 포함된 측정 가능한 값 | "within 10 seconds" |
합치면 "The C&DH shall enter safe mode within 10 seconds of undervoltage detection."입니다. 순서는 바뀔 수 있지만("When undervoltage is detected, the C&DH shall…"은 많은 팀이 쓰는 EARS 템플릿처럼 조건을 앞에 둡니다), 모든 구성 요소가 있거나 의도적으로 빠져 있어야 합니다.
세 단어가 대부분의 무게를 집니다. shall은 구속력 있는 요구사항을 나타내고, will은 시스템 밖의 무언가에 대한 사실이나 의도를 진술하며, should는 검증하지 않는 목표를 진술합니다. 프로젝트가 어떤 관례를 쓰든 사양서에서 한 번 정의하고 지킵니다. EO-1 1.1 Reference Orbit("The mission assumes a 500 km sun-synchronous orbit…")은 요구사항이 아니라 가정으로 올바르게 작성되었습니다. 이는 그것에 의존하는 요구사항의 맥락이며, 모델은 이를 점수를 매기거나 검증하지 않는 진술로 저장합니다.
속성
다음은 PDR 후 28 W에서 30 W로 변경된 뒤 EO-1 모델에 기록된 3.1 Orbit Average Power입니다.
| 속성 | 3.1 Orbit Average Power | 있는 이유 |
|---|---|---|
| 식별자와 이름 | 3.1 Orbit Average Power | 연결, 검토, 변경 요청을 위한 안정적인 핸들 |
| 진술 | The solar arrays shall generate at least 30 W orbit-average power at end of life. | 의무 그 자체 |
| 근거 | Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin. | 나중에 읽는 사람이 작성자 없이도 변경을 판단할 수 있게 함 |
| 출처와 상위 요구사항 | Derived (systems analysis), 1.5 Daily Collection Volume에서 파생 | 역방향 추적성: 요구사항이 존재하는 이유 |
| 검증 방법과 수준 | 시험, 서브시스템 수준 | 입증 계획, 작성하면서 정함 |
| 성공 기준 | End-of-life orbit-average power predicted from measured peak power. | 어떤 결과를 충족으로 볼지 |
| 소유자, 우선순위, 중요도 | Power Engineer, 높음, 높음 | 누가 책임지고 얼마나 중요한지 |
| 상태 | 검토 중(승인됨 상태였으나 승인 후 텍스트가 바뀜) | 합의 프로세스에서의 위치 |
| TBD/TBR | 없음 | 값이 아직 미결인지 여부 |
ISO/IEC/IEEE 29148(5.2.8)은 이런 종류의 속성을 나열하고, INCOSE 가이드는 더 많은 속성을 추가합니다. 프로젝트는 실제로 관리할 속성을 고릅니다. 근거는 가장 자주 생략되고 나중에 가장 아쉬워하는 속성입니다. "26 W 부하, 15% 여유"가 없으면 3.1을 다음에 보는 사람은 30 W가 엄격한 물리적 한계인지, 고객의 숫자인지, 여유를 위한 선택인지 알 수 없고, 따라서 부하가 바뀌면 그것이 3.1에 무엇을 뜻하는지도 알 수 없습니다.
좋은 요구사항의 품질 특성
스타일 규칙은 그것이 무엇을 보호하는지 알면 적용하기 쉽습니다. ISO/IEC/IEEE 29148(5.2.5)은 개별 요구사항의 아홉 가지 특성을 들고, INCOSE Guide to Writing Requirements는 같은 아홉 가지를 C1~C9로 사용하며 각각에 짧은 정의와 이를 뒷받침하는 규칙을 붙입니다. 표는 각 특성을 검토자가 물을 수 있는 질문으로 바꾸어 보여 줍니다.
| 특성 | 물어야 할 질문 | EO-1 예 |
|---|---|---|
| 필요성(Necessary) | 삭제하면 이해관계자에게 필요한 무언가가 사라집니까? 중복은 아닙니까? | 3.1은 필요합니다. 이것이 없으면 촬영 부하에 맞춰 어레이의 크기를 정하는 것이 없습니다. |
| 적절성(Appropriate) | 하위 수준이 내려야 할 설계 선택을 고정하지 않고 알맞은 수준에서 작성되었습니까? | 3.1은 셀 유형이나 패널 수가 아니라 어레이의 전력 수준을 정합니다. |
| 명확성(Unambiguous) | 한 가지로만 읽힙니까? | 6.4 "user friendly"는 불합격입니다. 두 검토자가 충족 여부에 대해 서로 다른 의견을 낼 것입니다. |
| 완전성(Complete) | 빠진 조건이나 값 없이 필요한 모든 것을 말합니까? | 3.5 "warm enough (TBD)"는 불합격입니다. 값이 빠져 있습니다. |
| 단일성(Singular) | 의무를 하나만 진술합니까? | 2.5는 불합격입니다. "and"로 이어 복구와 촬영 재개를 함께 요구합니다. |
| 실현 가능성(Feasible) | 기술, 비용, 일정의 알려진 제약 안에서 충족할 수 있습니까? | 30 W의 3.1은 의문입니다. 현재 설계된 어레이는 궤도 평균 약 28 W를 냅니다. |
| 검증 가능성(Verifiable) | 시험, 분석, 검사 또는 시연으로 충족됨을 보일 수 있습니까? | 2.5 "quickly"는 불합격, "within 6 hours"는 합격입니다. |
| 정확성(Correct) | 출처의 실제 니즈를 올바른 값으로 진술합니까? | 1.2의 지상 표본 거리 4.5 m는 N3의 필지 수준 지도를 여유를 두고 정확히 표현합니다. |
| 적합성(Conforming) | 프로젝트에서 합의한 템플릿과 어휘를 따릅니까? | EO-1의 각 요구사항은 "shall", 명시된 주어, SI 단위를 사용합니다. |
요구사항 집합에는 어떤 단일 진술도 보여 줄 수 없는 고유한 특성이 있습니다. ISO/IEC/IEEE 29148(5.2.6)은 집합의 특성으로 완전성, 일관성, 전체로서의 실현 가능성, 이해 가능성, 확인 가능성을 들고, INCOSE 가이드는 C15로 정확성을 더하며 집합 특성에 C10~C15의 번호를 붙입니다.
- 완전성: 집합이 니즈를 모두 다룹니다. EO-1은 저전압 시 일어나는 일(4.3)을 진술하지만, 안전 모드 복구 요구사항은 작성된 대로는 검증할 수 없는 2.5 하나뿐이므로 복구는 사실상 규정되지 않은 셈입니다.
- 일관성: 서로 충돌하는 요구사항이 없고, 용어와 단위가 같은 방식으로 쓰입니다. 1.5는 하루 3.2 GB의 영상 데이터를, 5.4는 지상에서 수신하는 3 GB를 요구합니다. 둘이 일치하는 것은 5.4의 근거가 "after compression"이라고 말하기 때문입니다. 근거가 없으면 충돌처럼 보입니다.
- 실현 가능성: 요구사항을 함께 충족할 수 있습니다. 각 전력 요구사항은 단독으로는 실현 가능할 수 있지만, 궤도 평균 30 W, 어레이 면적, 질량 예산을 함께 놓으면 그렇지 않을 수 있습니다.
- 이해 가능성: 읽는 사람이 시스템에 무엇이 기대되는지, 요구사항들이 서로 어떻게 관련되는지 알 수 있습니다. 이는 문구만큼이나 구조, 번호 체계, 추적성에 달려 있습니다.
- 확인 가능성: 집합이 니즈를 충족하는 시스템으로 이어진다는 것을 보일 수 있습니다. 그래서 각 최상위 요구사항은 니즈로 다시 연결됩니다.
체크리스트: 수정 전후 예제가 있는 규칙
특성은 구체적인 작성 규칙을 통해 쓸모 있게 됩니다. INCOSE Guide to Writing Requirements는 규칙에 번호(R1, R2 등)를 붙이고, NASA Systems Engineering Handbook(부록 C)에는 같은 취지의 더 짧은 체크리스트가 있습니다. 표는 실제로 대부분의 문제를 잡아내는 규칙을 모아 각각에 EO-1 사양서의 예를 붙였습니다. "수정 전"은 데모에 있는 그대로의 텍스트이고, "수정 후"는 재작성한 것입니다. 예시로 표시된 값은 형식을 보여 줄 뿐 EO-1 분석 결과가 아닙니다.
| 규칙 | 물어야 할 질문 | 수정 전(EO-1) | 수정 후 |
|---|---|---|---|
| 진술 하나에 의무 하나 | "shall"이 정확히 하나이고, 두 요구를 잇는 "and", "or", "and/or"가 없습니까? | 2.5: "The spacecraft should recover from safe mode quickly and resume imaging as appropriate" | "The spacecraft shall resume imaging within 6 hours of a safe mode entry." 중요한 추가 복구 단계는 각각 별도의 요구사항으로 만듭니다. |
| 의무를 나타내는 문구 | 구속력 있는 요구사항에 "should", "will", "may"가 아니라 "shall"을 씁니까? | 2.5: "should recover" | "shall resume" |
| 단위가 있는 측정 가능한 값 | 모든 성능 관련 단어에 숫자와 단위가 있습니까? | 2.5: "quickly" | "within 6 hours of a safe mode entry" |
| 한계 방향 명시 | 값이 최솟값인지 최댓값인지 분명합니까? | 1.6.2: "image targets up to 25 degrees off nadir" | "image targets at off-nadir angles from 0 to 25 degrees"(지향의 상한이 아니라 능력의 범위) |
| 빠져나갈 구멍 없음 | 공급자의 판단에 맡기는 것("as appropriate", "if possible", "where practical")이 있습니까? | 2.5: "as appropriate" | 삭제하고, 중요한 조건을 명시함 |
| 모호하거나 주관적인 용어 없음 | 두 검토자가 충족 여부에 대해 의견이 갈릴 수 있습니까("user friendly", "easy", "adequate", "enough")? | 6.4: "The operator interface shall be user friendly and/or easy to use." | "The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes."(예시. 중요한 작업마다 요구사항 하나) |
| 대명사 대신 명시적인 명사 | 모든 "it", "its", "this"가 가리킬 수 있는 대상이 정확히 하나입니까? | 1.6.1: "The reference orbit shall repeat its ground track every 3 days." | "The reference orbit shall repeat the ground track every 3 days." 여기서는 대명사가 해롭지 않지만, 더 긴 문장에서는 가장 먼저 어긋나는 부분입니다. |
| 조건 명시 | 값이 언제 적용되는지, 즉 수명 단계, 모드, 환경을 말합니까? | "The solar arrays shall generate 30 W." | "…at least 30 W orbit-average power at end of life." |
| 확정된 값 또는 추적되는 TBD | 모든 미결 값이 텍스트에 적혀 있기만 한 것이 아니라 담당자와 마감일과 함께 추적됩니까? | 3.5: "The thermal design shall keep the battery warm enough (TBD)." | "The thermal design shall keep the battery cell temperature at or above 0 °C while charging."(예시. 열 해석이 값을 정할 때까지 TBD 속성에 Thermal Engineer와 마감일을 지정함) |
| 진술 안에 이유나 메모 없음 | 목적 구문("so that", "in order to")과 괄호 메모를 근거로 옮겼습니까? | 3.5: "(TBD)" | 괄호 없는 진술, 이유는 근거에 |
| 방법이 아니라 무엇을 | 하위 수준이 골라야 할 해결책을 강요하지 않고 니즈를 진술합니까? | "The thermal design shall keep the battery warm by means of a 2 W film heater."(예시) | 위의 3.5 재작성: 온도 한계를 정하고 히터는 열 설계에 맡김 |
| 긍정적이고 달성 가능한 표현 | 측정 가능한 한계를 뜻할 때 "not", "never", "always", "100%"를 피합니까? | "The C&DH shall never lose a stored command."(예시) | "The C&DH shall execute each stored command within 1 second of the scheduled time."(작성된 그대로의 4.2) |
| 근거 기록 | 값을 선택한 이유를 말합니까? | 근거가 없는 3.1 | 근거: "Orbit-average load grew to 26 W after PDR; 30 W keeps 15% margin." |
| 검증 방법과 기준 | 방법이 정해져 있고 합격 기준이 진술에서 도출되었습니까? | 3.1: 방법 시험, TC-06은 최대 전력 ≥ 72 W를 기대 | 전력 예산을 통해 도출한 합격 기준: 궤도 평균 30 W에 대해 최대 약 80.6 W(다음 섹션 참조) |
| 상향 추적 가능 | 니즈, 상위 요구사항 또는 출처 요구사항에 연결되어 있습니까? | 상위 연결이 없는 3.1 | 1.5 Daily Collection Volume에서 파생된 3.1 |
| 고유성 | 같은 내용을 다른 말로 하는 요구사항이 또 있습니까? | 열 섹션 아래의 두 번째 "The battery shall store 77 Wh"(예시) | 요구사항 하나, 3.2 Battery Capacity를 두고 필요한 곳에서 참조함 |
체크리스트는 검토자의 도구이지 작성 템플릿이 아닙니다. 규칙을 하나씩 찾아다니지 말고 각 요구사항을 전체 목록에 대해 한 번 읽고, 위반한 규칙과 함께 발견 사항을 기록하여 작성자가 무엇을 바꿔야 할지 알게 합니다. 규칙에는 오탐도 있습니다. 단어 목록 검사는 1.6.1의 "every"를 보편 한정어로 표시하지만, "every 3 days"는 모든 경우에 대한 주장이 아니라 주기입니다. 판단은 검토자가 합니다.
검증 방법과 합격 기준을 요구사항과 함께 작성
검증 가능성은 요구사항을 작성하는 순간에 확인하기가 가장 쉽습니다. 작성자가 충족됨을 어떻게 보일지 말할 수 없다면 그 요구사항은 아직 끝나지 않은 것입니다. 각 요구사항과 함께 두 가지를 기록합니다.
- 검증 방법: 시험, 분석, 검사 또는 시연, 그리고 그것을 수행하는 조립 수준(부품, 서브시스템, 시스템)입니다. EO-1에는 네 가지가 모두 있습니다. 3.1은 시험으로, 1.5 Daily Collection Volume은 분석으로, 3.4 Bus Regulation은 검사로, 6.1 Contact Scheduling은 시연으로 검증합니다. 이 중에서 고르는 방법은 RVTM 가이드에서 설명합니다.
- 성공 기준(합격 기준): 충족으로 인정되는 관찰 가능한 결과로, 그로부터 시험이나 분석을 작성할 수 있도록 진술합니다. 3.2 Battery Capacity의 경우: "Measured capacity of at least 77 Wh at C/2 and 20 °C." 6.2 Image Delivery의 경우: "Products on the portal within 6 h for 95% of passes in rehearsal."
진술 옆에 기준을 쓰면, 그렇지 않으면 마지막에야 발견되는 종류의 오류를 잡아냅니다. EO-1의 3.1은 TC-06 Solar Array Power Test로 검증하는데, 이 테스트는 태양광 시뮬레이터에서 최대 전력을 측정하며 72 W 이상이면 합격입니다. 그러나 요구사항은 궤도 평균 전력에 관한 것이고, 모델은 일조 비율(0.62)과 전력 경로 효율(0.6)로 둘 사이를 변환합니다. 최대 72 W는 궤도 평균 72 × 0.62 × 0.6 = 26.8 W로, 현재의 30 W는 물론 원래의 28 W에도 못 미칩니다. 시험 임계값이 요구사항에서 도출되지 않았던 것입니다. TC-06은 75.1 W를 측정하여 "합격"했지만, 75.1 W는 27.9 W로 환산되어 두 값 모두에 못 미칩니다. 기준을 진술에서 도출했다면 약 30 / (0.62 × 0.6) = 80.6 W 최대 전력이 되었을 것이고, 부족분은 첫 시험에서 드러났을 것입니다. 변경 영향 분석 가이드에서 28 W에서 30 W로의 변경을 통해 같은 발견 사항을 따라갑니다.
이 교훈은 일반화됩니다. 합격 기준은 누군가 확인할 수 있는 계산으로 요구사항의 값까지 추적 가능해야 하며, 그 계산은 엔지니어의 기억이 아니라 근거나 검증 계획에 있어야 합니다.
TBD와 TBR 값 다루기
프로젝트 초기에는 아직 모르는 값이 있습니다. 요구사항을 빼면 공백이 숨고, 숫자를 지어내면 불확실성이 숨습니다. 일반적인 관행은 자리 표시자를 넣어 요구사항을 쓰고 그 자리 표시자를 미결 항목으로 추적하는 것입니다.
- TBD(to be determined, 미정): 아직 값이 없음. "The thermal design shall keep the battery cell temperature at or above TBD °C while charging."
- TBR(to be reviewed, 때로 "to be resolved", 검토 예정): 확정되지 않은 현재 최선의 값. 60에 TBR이 표시된 "…within 60 seconds".
숫자의 근거가 조금이라도 있다면 값 없는 TBD보다 추정치가 있는 TBR을 선택하십시오. 설계자는 추정치에 맞춰 작업할 수 있고, 나중에 값이 바뀌면 그것은 추적성이 따라가는 변경이 됩니다. 각 미결 항목에는 세 가지가 필요하며, 그렇지 않으면 관리되고 있지 않은 것입니다.
- 담당자: 항목을 종결할 사람.
- 마감일 또는 마일스톤: 보통 그에 의존하는 설계 결정보다 앞섭니다.
- 종결 계획: 값을 정할 분석, 시험 또는 결정.
EO-1 사양서에는 미결 항목이 세 개 있습니다. 3.5 Battery Thermal Control은 Thermal Engineer가 담당하는 TBD로 이미 기한이 지났습니다. 2.4 Target Slew("through 30 degrees within 60 seconds")는 ADCS Lead가 담당하는 TBR이고, 5.3 Downlink Link Margin("at least 3 dB link margin at 10 degrees elevation")은 Comms Lead가 담당하는 TBR입니다. 둘 다 분석이 끝나는 동안 설계가 사용하는 작업 값을 가지고 있습니다.
마일스톤마다 미결 항목 수를 세고, 그 수가 줄어들기를 기대하십시오. 미결 TBD가 많은 요구사항 베이스라인은 이름뿐인 베이스라인입니다. NASA Systems Engineering Handbook의 검토 기준은 시스템 요구사항 검토부터 미결 TBD 및 TBR 항목을 종결 계획 및 일정과 함께 식별하도록 요구합니다. 추적은 텍스트에만 두지 말고 속성이나 등록부에 두어야 합니다. 문장에 입력한 "TBD"에는 담당자도 날짜도 없고, 누구에게도 종결하라고 알려 주지 않습니다.
요구사항 유형
요구사항을 분류하면 검토자가 알맞은 질문을 하고 집합이 완전하게 유지되는 데 도움이 됩니다. 아래 범주는 흔히 쓰는 것들입니다. ISO/IEC/IEEE 29148과 INCOSE 가이드도 비슷한 집합을 설명하며, 많은 프로젝트가 자체 범주를 추가합니다.
| 유형 | 진술하는 내용 | EO-1 예 | 주의할 점 |
|---|---|---|---|
| 기능 | 시스템이 해야 하는 일 | 4.3 Fault Detection: "The C&DH shall enter safe mode within 10 seconds of undervoltage detection." | 성능이 붙지 않은 기능. 대부분의 기능 요구사항에는 "얼마나 잘"도 필요하며, 여기서는 "within 10 seconds" |
| 성능 | 기능을 얼마나 잘 수행하는지: 양, 속도, 정확도, 시간 | 2.1 Pointing Accuracy: "The ADCS shall point the payload boresight within 0.1 degrees of the commanded target." | 빠진 조건(어떤 모드, 어떤 수명 단계)과 빠진 한계 방향 |
| 인터페이스 | 다른 시스템이나 요소와의 경계를 넘는 것과 그 특성 | 5.2 UHF Command Uplink: "The UHF transceiver shall receive ground commands at 9.6 kbps." 전체 정의는 인터페이스 통제 문서에 있습니다. | ICD를 가리키지 않고 다시 진술하여 둘이 서로 어긋나게 되는 요구사항 |
| 제약 조건 | 외부에서 부과된, 설계나 시스템 제작 방법에 대한 제한 | 4.4 Downlink Encryption: "The C&DH shall encrypt each downlink frame with 256-bit keys." 근거: 고객 계약이 전송 중인 영상의 암호화를 요구하므로, 이 요구사항은 프로젝트 내부의 트레이드가 아니라 외부에서 옵니다. | 외부의 누구도 부과하지 않았는데 제약 조건으로 작성된 설계 선택 |
| 환경, 신뢰성, 안전 | 견뎌야 할 조건과 달성해야 할 신뢰도 | 1.7 Mission Lifetime: "The spacecraft shall operate in orbit for at least 730 days." | 어떤 확률이나 신뢰 수준에서 주장하는지 빠진 값 |
기능 요구사항과 성능 요구사항의 경계는 흔히 한 문장 안에 그어집니다. 4.3처럼 많은 요구사항이 기능을 성능과 함께 진술합니다. 문장이 여전히 의무 하나만 담는다면 괜찮습니다. 인터페이스 요구사항은 인터페이스 통제 문서 가이드에서, 기능 요구사항 뒤의 기능은 기능 분석 가이드에서 더 자세히 다룹니다.
실습 예제: EO-1 사양서 검토
체크리스트로 SRS-001을 검토하면 32개 요구사항이 세 그룹으로 나뉩니다. 대부분은 합격입니다. 몇 개는 각각 한 문장으로 적을 만한 작은 발견 사항이 있습니다. 세 개는 재작성이 필요합니다.
같은 사양서에 대한 자동 검사도 검토와 일치합니다. 32개 중 29개가 양호로 평가되고, 약한 세 개는 재작업이 필요합니다. 2.5의 발견 사항은 위반한 규칙을 각각 이름과 번호로 나열하며, 작성자가 고치는 데 필요한 것이 바로 이것입니다. 검사는 스스로 판단할 수 없는 것도 표시합니다. 3.1에서는 마지막 검토 후 텍스트가 바뀌었으므로 정확성과 실현 가능성이 검토자를 기다립니다.
작은 발견 사항
- 1.6.2 Off-Nadir Imaging, "up to 25 degrees off nadir": "up to"는 최댓값으로 읽히지만, 의도는 우주선이 0도부터 25도까지 어떤 각도에서든 갖춰야 하는 능력입니다. 잘못 읽으면 천저에서만 촬영하는 설계도 준수하는 것이 됩니다.
- 1.6.1 Ground Track Repeat, "its ground track": 가리킬 수 있는 대상이 하나뿐인 대명사이므로 사소한 발견 사항입니다. 같은 문장의 "every"는 보편 한정어 규칙의 오탐입니다.
- 1.5 Daily Collection Volume에는 방법(분석)과 성공 기준("Simulated daily volume of at least 3.2 GB over a 30-day plan")이 있지만 아직 연결된 분석이 없습니다. 문구는 괜찮지만 검증이 끝나지 않았습니다.
- 3.1 Orbit Average Power는 잘 작성되었지만 승인 후 텍스트가 바뀌었으므로 정확성과 실현 가능성에 다시 검토자의 판단이 필요합니다. 실제 문제는 실현 가능성입니다. 현재 설계된 어레이는 궤도 평균 약 28 W를 냅니다.
세 가지 재작성
2.5 Safe Mode Recovery. "The spacecraft should recover from safe mode quickly and resume imaging as appropriate"는 적어도 여섯 가지 규칙을 위반합니다. "shall" 대신 "should", "and"로 이은 두 가지 의무, 값이 없는 "quickly", 빠져나갈 구멍 "as appropriate", 마침표 누락, 검증 없음입니다. 재작성은 고객에게 중요한 결과 하나만 남기고 값을 붙입니다.
The spacecraft shall resume imaging within 6 hours of a safe mode entry.
근거에는 6시간이 어디서 왔는지 적어야 합니다(N1은 당일 작물 스트레스 경보를 요구하고, 6.2는 하향 전송부터 전달까지 6시간을 허용합니다). 태양 지향 재획득이나 원인 보고처럼 복구 단계 자체가 중요하다면 각각 별도의 요구사항이 됩니다. 방법: 플랫샛에서 고장 주입에 의한 시험. 성공 기준: 주입된 각 안전 모드 진입에서 6시간 이내에 촬영이 재개됨.
3.5 Battery Thermal Control. "The thermal design shall keep the battery warm enough (TBD)."에는 모호한 용어, 텍스트 속의 TBD, 괄호가 있습니다. 수정은 의무, 미결 값, 이유를 분리합니다.
The thermal design shall keep the battery cell temperature at or above 0 °C while charging.
0 °C는 예시입니다. 리튬 이온 셀은 보통 영하에서 충전하지 않지만, 실제 한계는 셀 데이터시트와 열 해석에서 나옵니다. 그 해석이 값을 정할 때까지 이 값은 Thermal Engineer가 담당하는 TBR이며, 마감일은 열 설계 검토 전입니다. 재작성은 원래 문장이 숨기던 공백도 드러냅니다. 방전 온도 범위에 대한 요구사항이 없으며, 이는 별도의 진술이 필요합니다.
6.4 Operator Interface. "The operator interface shall be user friendly and/or easy to use."에는 주관적인 용어 두 개와 "and/or"가 있습니다. 사용성은 규정할 수 있지만, 관찰 가능한 작업을 통해서만 가능합니다.
The operator interface shall let a trained operator book a ground station contact in no more than 5 minutes.
작업과 시간은 예시입니다. 실제 집합에는 중요한 몇 가지 작업(교신 예약, 표적 목록 업로드, 최신 상태 원격 측정 읽기)을 각각 시간 및 오류 한도와 함께 나열하고, 교육을 마친 운영자로 시연하여 측정합니다.
흔한 실수
| 실수 | 무엇이 잘못되는가 | 더 나은 방법 |
|---|---|---|
| 설계 해결책을 요구사항으로 쓰기 | 트레이드를 하기 전에 설계가 고정되고, 아무도 결정하지 않았는데 더 나은 옵션이 배제됩니다. | 니즈("충전 중 셀을 0 °C 이상으로 유지")를 진술하고 히터는 하위 수준이 고르게 합니다. |
| 이해관계자의 언어를 요구사항에 그대로 옮기기 | "주 2회 최신 영상"은 니즈이며, 쓰인 그대로는 검증할 수 없습니다. | 니즈는 유지하고, 이를 충족하는 값과 조건이 있는 요구사항을 씁니다(1.6 within 72 hours). |
| 한 단락에 여러 요구사항 | 식별자 하나가 여러 의무를 담아, 상태 하나, 테스트 하나, 운명 하나를 공유합니다. | 항목 하나에 요구사항 하나, 진술 하나에 "shall" 하나. |
| 조건 없는 값 | 수명 초기의 "30 W"와 수명 말기의 "30 W"는 서로 다른 설계입니다. | 모드, 수명 단계, 환경, 평균 방식을 명시합니다. |
| 근거 없음 | 아무도 이후의 변경을 판단할 수 없고, 요구사항은 그 이유가 사라진 뒤에도 오래 남습니다. | 값 뒤에 있는 이유와 숫자를 적습니다. |
| 요구사항에서 도출하지 않은 시험 임계값 | 요구사항이 충족되지 않았는데 시험이 합격합니다(궤도 평균 28 W에 대해 최대 72 W를 보는 TC-06). | 성공 기준을 계산으로 진술에서 도출하고 기록합니다. |
| 텍스트에 입력하고 잊어버린 TBD | 미결 값에 담당자도 날짜도 없이 베이스라인에 들어갑니다. | 각 TBD와 TBR을 담당자, 마감일, 종결 계획과 함께 추적합니다. |
| 골드 플레이팅 | 아무도 요청하지 않은 요구사항이 설계와 시험 노력을 소모합니다. | 각 최상위 요구사항이 니즈나 출처로 추적되는지 확인합니다. |
| 자동 검사에 대한 과도한 의존 | 단어 검사를 깨끗하게 통과한 것을 올바른 요구사항으로 여깁니다. | 기계적인 규칙에는 도구를 쓰고, 정확성, 실현 가능성, 필요성은 사람이 판단합니다. |
Holarch에서 해 보기
LML 프로젝트에서 각 요구사항은 Requirement 클래스의 엔터티이며, 위에서 설명한 속성인 Rationale, Status, Priority, Criticality, Owner, Source, Verification Method, Verification Level, Success Criteria와 TBD/TBR 필드를 갖습니다.
- 프로젝트 관리 → 프로젝트 파일 ▾ → 새 데모 프로젝트 → CubeSat(안내형 시스템 엔지니어링)으로 데모를 만듭니다. 그 사양서에는 이 가이드에서 사용한 약한 요구사항 세 개와 미결 TBD/TBR 항목이 들어 있습니다.
- 니즈 및 요구사항 → 품질을 열고 범위 목록에서 문서를 선택한 다음 품질 검사를 클릭합니다. 각 요구사항이 아홉 가지 특성으로 평가되고, 제안에는 단어 목록이나 패턴으로 검사할 수 있는 INCOSE 가이드의 규칙 번호가 표시됩니다. 정확성과 실현 가능성에는 검토자가 필요합니다. 표시를 클릭하여 결정을 기록합니다.
- 2.5를 위와 같이 재작성하고 다시 검사합니다. 결합어, 빠져나갈 구멍, 모호한 용어에 대한 발견 사항이 사라집니다.
- 니즈 및 요구사항 → TBD/TBR을 열어 담당자와 마감일이 있는 미결 항목을 보고, 값이 확정되면 닫기로 종결합니다.
- 규칙으로 판단할 수 없는 특성에 대해 다른 의견이 필요하면 ✦ AI ▾ → AI 요구사항 검사를 사용합니다. 모든 판정과 재작성은 무엇이든 바뀌기 전에 검토할 수 있도록 표시됩니다.
전체 참조는 요구사항 품질과 TBD/TBR 등록부 문서에 있습니다.
체크리스트 다운로드
EO-1 수정 전후 예제가 있는 요구사항 품질 체크리스트(CSV)에는 체크리스트 규칙과 검토 질문, 예제가 들어 있어 검토에 사용하거나 프로젝트 자체 작성 규칙의 출발점으로 쓸 수 있습니다. 같은 파일을 추적성 가이드에서도 제공합니다.
요구사항 작성에 관한 질문
shall, must, will 중 무엇을 씁니까?
사양서에서 정의하고 지키기만 하면 어떤 관례든 괜찮습니다. 가장 널리 쓰이는 관례는 구속력 있는 요구사항에 "shall", 시스템 밖의 것에 대한 사실과 의도에 "will", 검증하지 않는 목표에 "should"를 씁니다. 일부 정부 스타일 가이드는 쉬운 언어를 이유로 "must"를 선호합니다. 진짜 문제는 한 사양서 안에서 이것들을 섞어 쓰는 것입니다.
시스템에는 요구사항이 몇 개나 있어야 합니까?
정답인 개수는 없습니다. 소형 우주선에는 시스템 요구사항이 수십 개, 그 아래에 수백 개가 있을 수 있고, 대형 프로그램에는 수천 개가 있습니다. 더 쓸모 있는 질문은 모든 요구사항이 니즈나 상위 요구사항으로 추적되는지, 모든 니즈 아래에 요구사항이 있는지입니다.
사용자 스토리는 요구사항입니까?
사용자 스토리는 사용자의 언어로 니즈와 그 목적을 기록합니다. 이해관계자 니즈의 역할을 하며, 그 인수 기준은 검증 기준에 가깝습니다. 하드웨어와 소프트웨어를 함께 제작, 통합, 검증하는 시스템에서는 여전히 스토리를 할당하고 시험할 수 있는 요구사항으로 바꿔야 합니다.
도구가 요구사항 품질을 검사할 수 있습니까?
도구는 기계적인 규칙, 즉 조동사, 결합어, 모호한 단어, 빠져나갈 구멍, 대명사, 누락된 연결은 신뢰성 있게 검사할 수 있습니다. 30 W가 올바른 값인지, 어레이가 그만큼 낼 수 있는지는 알 수 없습니다. 검토 전에 자동 검사로 기계적인 발견 사항을 정리하여, 검토자가 정확성과 실현 가능성에 시간을 쓰게 하십시오.
다음에 읽을 내용
- 요구사항 추적성과 변경 영향: 이 요구사항을 니즈, 설계, 테스트에 연결하고 변경을 따라갑니다.
- 기능 분석: 요구사항을 기능으로 바꾸고 할당합니다.
- 요구사항 검증 매트릭스: 요구사항별 검증 방법을 계획하고 결과를 기록합니다.
- Holarch의 니즈와 요구사항: 하나의 모델에 있는 문서, 품질 검사, 베이스라인, 추적성.