Web Guide코드 품질유지보수개발 표준
코드 품질과 유지보수성의 관계
겉으로 똑같아 보이는 두 사이트도 속은 전혀 다를 수 있습니다.
그 차이는 완성 시점이 아니라 1년 뒤 수정할 때 드러납니다.
01발주자는 볼 수 없다
화면만 보고는 코드 품질을 알 수 없습니다. 급하게 만든 사이트도 처음에는 잘 동작합니다.
차이는 기능을 추가하거나 문제를 고칠 때 나타납니다.
1
수정 비용
간단해 보이는 수정에 며칠이 걸립니다.
2
연쇄 오류
한 곳을 고치면 다른 곳이 깨집니다.
3
업체 변경 곤란
다른 업체가 파악을 못 해 인수를 거절합니다.
4
확장 불가
기능을 추가하려면 다시 만들어야 합니다.
5
보안 취약
정리되지 않은 코드에 취약점이 숨습니다.
02품질을 만드는 요소
품질은 개인의 실력만이 아니라 팀의 규칙에서 나옵니다. 규칙이 있으면 누가 작업해도 일정한 수준이 유지됩니다.
코딩 규칙
이름 짓기와 구조에 일관된 기준이 있는지.
코드 리뷰
다른 개발자가 확인하는 절차가 있는지.
중복 제거
같은 코드를 여러 곳에 복사하지 않는지.
주석과 문서
왜 이렇게 만들었는지 설명이 남는지.
테스트
수정 후 기존 기능이 동작하는지 확인하는지.
구조 분리
화면, 로직, 데이터가 섞이지 않았는지.
03발주자가 확인하는 방법
코드를 읽을 수는 없어도 간접적으로 확인할 수 있는 신호가 있습니다.
개발 규칙 문서팀 규칙이 문서로 있는지 물어보세요.
리뷰 절차코드 리뷰를 하는지 확인하세요.
이전 프로젝트 인수 사례다른 업체 작업을 이어받은 경험이 있는지.
산출물 목록설계 문서와 운영 매뉴얼을 제공하는지.
수정 요청 대응 속도제작 중 수정 요청 처리 속도가 신호가 됩니다.
04계약으로 담보하기
품질을 계약서에 수치로 적기는 어렵지만, 산출물과 절차는 명시할 수 있습니다.
01
산출물 명시
소스코드, 설계 문서, 운영 매뉴얼 제공.
02
저장소 접근
발주자가 코드를 받을 수 있게.
03
하자보수 기간
기간과 범위를 명확히.
04
제3자 점검 허용
필요 시 외부 점검을 받을 수 있게.
CHECK POINT
□ 개발 규칙이 문서로 있는지 확인했는가
□ 코드 리뷰 절차가 있는가
□ 산출물 목록이 계약에 명시되어 있는가
□ 소스코드와 문서를 제공받는가
□ 하자보수 기간과 범위가 명확한가
□ 다른 업체가 이어받을 수 있는 상태인가
#코드 품질#유지보수#개발 표준#코드 리뷰#산출물#인수인계#하자보수#홈페이지 개발#웹비스타#홈페이지 제작