소프트웨어 스펙의 모든 것 (프로젝트를 성공으로 이끄는 소프트웨어 스펙 작성법)

김익환

서울대학교공과대학졸업후미국산호세주립대학교에서전산학학사,스탠퍼드대학교에서전산학석사를취득했다.GE,썬마이크로시스템즈,GTEGovernmentSystems등세계적인실리콘밸리기업에서17년간소프트웨어개발실무내공을쌓았으며,글로벌기업에인터넷통합메시지솔루션을제공하는‘스탠퍼드소프트웨어(StanfordSoftwareCorp,USA)’를설립했다.국내에서는안철수연구소부사장및CTO를지내고,카이스트소프트웨어대학원겸임교수를역임했다.현재는다양한기업을대상으로경영/개발컨설팅을진행하며실리콘밸리의선진소프트웨어를전파하고있다.
『대한민국에는소프트웨어가없다』,『소프트웨어개발의모든것』,『글로벌소프트웨어를꿈꾸다』,『글로벌소프트웨어를말하다,지혜』를집필하고『세상을바꾼32개의통찰』을번역했으며,소프트웨어공학블로그ikwisdom.com을운영한다.

1부소프트웨어스펙이란?

1장소프트웨어스펙의개요
1.1소프트웨어프로젝트실패의원인
1.2스펙에대한오해
1.3스펙의역할
1.4스펙을제대로작성하지않으면
1.5스펙과프로젝트의성공

2장SRS
2.1SRS란무엇인가?
2.2어떻게소프트웨어를빠르게개발할것인가?
2.3스펙문서의유형
2.4요구사항과스펙의차이
2.5스펙문서에대한착각
2.6스펙인것과스펙이아닌것
2.7스펙과프로젝트일정의관계
2.8스펙과설계의구분

3장스펙작성의현주소,현실과관행
3.1현재의관행과문제점
3.2스펙에대한잘못된통념
3.3부실한스펙후설계는사상누각
3.4시간만있으면누구나스펙을쓸수있는가?
3.5소프트웨어공학,약인가?독인가?

4장사례연구
4.1A사의해외프로젝트_부실한분석에의한계약
4.2B사의부품교체_허술한변경관리
4.3C사의갑을관계_고객의의무소홀
4.4D사의SI수행_분석역량부족
4.5E사의소프트웨어개발_있는것은소스코드뿐
4.6F사의공공프로젝트_과도한산출물
4.7해외사례_초기분석부실

5장기업문화
5.1스펙과기업문화
5.2잘작성한스펙의혜택
5.3좋은관행만들기
5.4전사아키텍처전략을선도하는기술위원회
5.5사수/부사수시스템탈피방법
5.6스펙을제대로작성하려면

6장프로세스
6.1소프트웨어프로젝트의개발단계
6.2스펙작성프로세스
6.3SRS관점으로바라본방법론비교
6.4스펙작성에시간을얼마나할애해야하는가?
6.5스펙은얼마나자세히적어야하는가?
6.6스펙리뷰
6.7코드리뷰보다는설계리뷰,설계리뷰보다는스펙리뷰
6.8스펙과베이스라인
6.9스펙변경프로세스
6.10종결된프로젝트의스펙,업데이트할것인가?
6.11종결된프로젝트의스펙일부삭제
6.12대형프로젝트분석의협업

7장Who?
7.1스펙은누가쓰는가?
7.2분석아키텍트의역할
7.3분석아키텍트의자질
7.4소프트웨어개발자는글을잘써야한다
7.5문서작성기술
7.6시뮬레이션능력
7.7문제해결능력
7.8프로젝트이해관계자

8장What?
8.1why,what,how
8.2목표와범위정의하기
8.3요구사항에우선순위부여하기
8.4외주시외주업체에전달할문서는?
8.5스펙체크리스트의효용성

9장How?
9.1스펙의재료
9.2스펙가독성높이기
9.3문장바르게쓰기
9.4스펙작성팁
9.5스펙재사용하기
9.6소스코드로스펙작성하기
9.7유닛테스트로스펙작성하기
9.8중복최소화하기
9.9품질특성명시하기
9.10프로토타입만들기
9.11스펙을적기위해서는why를알아야한다
9.12훔쳐보기는이제그만
9.13인터페이스개선하기
9.14인터페이스정의하기

10장도구
10.1SRS작성을돕는도구
10.2UI작성방법
10.3스펙문서의템플릿

2부SRS작성법

1장Introduction(개요)
1.1Purpose(목표)
1.2ProductScope(범위)
1.3DocumentConventions(문서규칙)
1.4TermsandAbbreviations(정의및약어)
1.5RelatedDocuments(관련문서)
1.6IntendedAudienceandReadingSuggestions(대상및읽는방법)
1.7ProjectOutput(프로젝트산출물)

2장OverallDescription(전체설명)
2.1ProductPerspective(제품조망)
2.2OverallSystemConfiguration(전체시스템구성)
2.3OverallOperation(전체동작방식)
2.4ProductFunctions(제품주요기능)
2.5UserClassesandCharacteristics(사용자계층과특징)
2.6AssumptionsandDependencies(가정과종속관계)
2.7ApportioningofRequirements(단계별요구사항)
2.8BackwardCompatibility(하위호환성)

3장Environment(환경)
3.1OperatingEnvironment(운영환경)
3.2ProductInstallationandConfiguration(제품설치및설정)
3.3DistributionEnvironment(배포환경)
3.4DevelopmentEnvironment(개발환경)
3.5TestEnvironment(테스트환경)
3.6ConfigurationManagement(형상관리)
3.7BugtrackSystem(버그트래킹시스템)

4장ExternalInterfaceRequirements(외부인터페이스요구사항)
4.1SystemInterface(시스템인터페이스)
4.2UserInterface(사용자인터페이스)
4.3HardwareInterface(하드웨어인터페이스)
4.4SoftwareInterface(소프트웨어인터페이스)
4.5CommunicationInterface(통신인터페이스)

5장PerformanceRequirements(성능요구사항)
5.1Throughput(작업처리량)
5.2ConcurrentSession(동시세션)
5.3ResponseTime(대응시간)
5.4PerformanceDependency(성능종속관계)
5.5OtherPerformanceRequirements(그외성능요구사항)

6장Non-functionalRequirements(비기능요구사항)
6.1Safety(안전성요구사항)
6.2Security(보안요구사항)
6.3SystemAttributes(소프트웨어시스템특성)
6.4LogicalDatabaseRequirements(데이터베이스요구사항)
6.5BusinessRules(비즈니스규칙)
6.6DesignandImplementationConstraints(설계와구현제한사항)
6.7MemoryConstraints(메모리제한사항)
6.8Operations(운영요구사항)
6.9SiteAdaptationRequirements(사이트적용요구사항)
6.10InternationalizationRequirements(다국어지원요구사항)
6.11UnicodeSupport(유니코드지원)
6.1264bitSupport(64비트지원)
6.13Certification(제품인증)

7장FunctionalRequirements(기능요구사항)

8장ChangeManagementProcess(변경관리프로세스)

9장DocumentApprovals(최종승인자)

프로젝트의불확실성을줄이는소프트웨어스펙,제대로작성하고있었을까?

프로젝트의가장많은실패원인은스펙과관련있다.소프트웨어버그의절반이상이부실하거나잘못작성된스펙때문에발생한다.프로젝트성공률을높이는가장좋은방법은스펙을제대로작성하는것이다.여기서‘제대로’는‘자세히’가아니다.어려움과미지수까지사실을그대로보고,스펙을작성하면서검증해불확실성을줄여가는것이다.누구나알고싶어하지만쉽게알수없는소프트웨어스펙작성의거의모든것을정리했다.훌륭한소프트웨어를만드는데힌트가되기를바란다.

-1부소프트웨어스펙이란?
소프트웨어스펙원리를이해하고이를잘작성하는역량을키우는방법을알아본다.스펙,SRS(SoftwareRequirementsSpecification)라는용어는글로벌소프트웨어업계에서널리통용되는표준용어이며기능명세서,시방서등과는의미가다르다.

-2부SRS작성법
실제SRS템플릿을제공하고각항목별작성내용을설명한다.