대규모 프로젝트에서 스펙파일 구조 설계
제시해주신 spec.md 파일은 어떠한 한 기능에 대한 파일로써 적절해보이는데
그렇다면 혹시 대규모 프로젝트를 진행하고 그 안의 무수한 기능들이 있다면
프로젝트의 근간이 되는 스펙 문서가 root 에 존재하고 그 뿌리에 근간하여 각 기능단위를 나누고, 각 기능에 대한 spec.md 파일을 모두 작성하고 관리해주는게 적절할까요?
回答 1
0
안녕하세요. 굉장히 중요한 질문을 해주셔서 정말 감사합니다.
강의를 제대로 보신 분들만 할 수 있는 질문이라 생각합니다.
대규모 프로젝트로 간다면 그때부터 스펙 관리는 꽤 복잡한 부분이 있습니다.
예를 들어보면, 대형 프로젝트가 모노레포로 관리된다고 했을 때는 각 모노레포에 소속된 패키지 별로 스펙 분리를 1차원적으로 할 수 있을 겁니다.
이 경우에는 specs/client, specs/server 이런식으로 분할할 수도 있고, 또는 도메인에 대한 관리를 둘 수도 있을 겁니다. 이를테면, specs/payments, specs/registration.
그렇다면 해당 스펙 디렉터리에 어떤 요소가 들어갈지는 각 달라지게 됩니다. 만약 payment 기능을 개발하는데 client, server로 두 개의 스펙 문서를 만들어 2개로 각각을 관리하게 된다면, 이 두 개의 문서는 서로 다른 분야를 개발하지만 공통된 root 스펙이 필요하게 됩니다. 이를테면 payment에 사용되는 스키마가 되겠죠. 그렇다면 이 경우에는 payment를 담당하는 root 스펙과 더불어 그것을 client, server에 각각 참조할 수 있도록 하는 형태로 스펙 문서를 배치하는 것이 유리합니다.
반면 도메인별로, feature 별로 관리를 하게 된다면 payments/ 디렉터리 안에 root에 대한 스펙(payments/root.spec.md), 각 요소 또는 기능에 대한 스펙(payments/client.spec.md) 등으로 넣을 수도 있지만 실제로는 client에 모든 스펙 요소를 다 넣는 것이 안되서 상세 규칙을 따로 빼야할 경우가 생길 겁니다. 그렇다면 스펙의 구조는
root.spec.md가 가장 뿌리
client.spec.md는 payments의 client측 개발을 위해 참조하는 인덱싱 목록 형태의 스펙 문서
paymemts/rules/ 안에는 세부 규칙 요소 배치
payments/details/ 안에는 세부 스펙 배치
와 같은 형태로 구현할 수 있습니다. 또한 이 과정에서 점진적 참조(skills에서 다룬 것처럼)를 하여 client.spec.md 파일 안에 링크를 넣는 형태로 구현하시면 상황에 따른 참조를 하실 수 있습니다.
스펙 관리는 이처럼 소속된 패키지 단위, 기능 단위 정도로 관리될 수 있으니 현재 대규모 프로젝트의 구조나 기존 개발이 진행될 때의 방향성과 어느정도 맞추는게 좋습니다. 가령 조직이 패키지 단위 개발을 한다면 패키지 단위 스펙 정책이 유효하다고 보이며, 반면 기능 묶음 단위라면 기능 단위로 스펙을 구조화하시는 것을 추천드리겠습니다.
업데이트가 안됩니다.
0
12
0
제공화일 중 일부 화일 오류로 실습이 안되네요
0
11
0
[섹션 6.3]bluekiwi install 오류
0
12
0
컴맹도 들을수있는거맞아요?..
0
13
1
꼭 스탭 순서대로 봐야 하나요?
0
13
1
스탭마다 새로 만들면 안되나요?
0
14
1
cursor 에서 붙여넣기 옵션
0
14
1
VSCode 터미널에서 접속 불가
0
15
1
login expired. please run / login 메세지가 뜹니다.
0
11
0
5.2 질문
0
17
1
완성후 클로드 코드로 점검결과가
0
16
0
진도율 확인 요청
0
17
0
command goto
0
19
1
맥미니에서 배포(?) 해도 되나요?
0
20
1
강의 업로드 일정
0
23
1
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
0
21
1
질문은 아니고, 다른 분을 위해 남겨요!
0
18
1
3.3 Claude Code 설치 오류
0
29
2
실습에서 쓰이는 파일은 어디 있나요?
0
24
1
dev-pipeline 질문
0
57
1
CLAUDE.md 파일 참조 질문
0
112
1
1과업 = 1세션 에대한 질문
0
146
2
완강 후 느낀점
1
157
1
캬 그동안 클로드 코드 100달러 주고 1달러치 사용하고있었네요
1
153
1

