소프트웨어 역추적 및 역공학 문서화 관련

Question

기존의 만들어진 소프트웨어가 있고 그 소프트웨어를 바탕으로 새롭게 만들어진 요구사항 정의서가 있는데 이를 문서와 실제 코드 사이의 간극을 줄이려면 어떻게 해야해요?

Answer 1

안녕하세요. 김상엽 전문가입니다.

역공학 시 코드 분석과 문서 비교를 통해 기능 단위로 매핑하고, 테스트를 병행하여 문서와 실제 동작 간 차이를 지속적으로 보완해야 합니다.

Answer 2

안녕하세요. 김재훈 전문가입니다.

기존 소프트웨어를 기준으로 코드 구조 데이터 흐름 핵심 로직을 역공학적으로 분석해 실제 동작을 정확히 파악한 뒤 이를 현재 요구사항 정의서와 항목별로 매핑하여 차이를 명확히 드러내는 것이 중요합니다 이후 불일치 부분은 코드 수정 또는 문서 보완 중 어느 쪽이 맞는지 기준을 세워 지속적으로 동기화해야 합니다 또한 코드 주석 아키텍처 다이어 그램 인터페이스 명세 등을 함께 정리해 문서와 코드가 동시에 유지 관리 되도록 체계를 만드는 것이 좋습니다

Answer 3

안녕하세요. 박재화 전문가입니다.

먼저 문서가 맞는지 코드가 맞는지 따져보시기 전에, 지금 프로그램이 실제로 어떻게 돌아가는지를 하나씩 확인해보시면서 맞춰보는 작업이 필요하실 것 같습니다.

화면에서 버튼을 눌렀을 때 어떤 결과가 나오는지 한번 보시고, 그 기능과 연결된 코드를 찾아 같이 비교해보신다면 생각보다 차이가 잘 보일 수 있을 것 같습니다. 그리고 문서와 다른 부분이 나오면, 문서를 고칠지 코드를 고칠지 바로 섞지는 마시고, 따로 표시를 해두시면 도움이 될 수 있을 것 같습니다. 그래야 덜 헷갈리거든요 나중에.

Answer 4

안녕하세요.

쉽게 생각하면 코드에서 기능으로, 기능에서 문서를 다시 연결해주는 작업이라고 이해할 수 있을 것 같습니다.

실제 코드 기준으로 기능을 하나씩 나누고, 각 기능들이 어떤 동작을 하는지 간단하게 정리를 해보세요. 그 다음에 기존 요구사항 문서와 비교해서 일치하는지 불일치하는지 이 부분을 체크하시고, 차이가 나는 부분으로 수정을 하시거나 필요한 경우 문서를 최신화하는 방향으로 진행하시면 도움이 되실 것 같습니다.

감사합니다.