프로젝트 산출물 및 기술 문서 관리를 위한 그누보드5 활용

Posted by taeho Tae-Ho
2015.03.08 16:10 나의 일

중소규모의 솔루션을 공급하는 IT 업체의 엔지니어들은 하루에도 두 개 이상의 프로젝트를 지원해야 하는 경우가 많다. 일 년 내내 그렇게 프로젝트를 지원하다 보면 프로젝트별로 작성된 산출물에 대한 관리가 무척 어렵다. 개인적으로는 노트북이나 외장하드에 고객사나 프로젝트 별로 폴더를 만들어 저장해 두는 경우가 대부분이다. 그리고 혼자 사용한다면 폴더에 의한 관리만 잘해도 크게 문제가 되지 않는다.


하지만 문제는 산출물의 공유에서 발생한다. 


산출물이나 기술자료의 공유를 위해 FTP서버나 게시판을 이용하는 경우가 많은데 이 또한 고객사나 프로젝트 혹은 문서내의 목차 등에 의한 검색에 한계를 갖는 경우가 대부분이다. 그래서 기술 지원 업무 관리 시스템을 재구축 하면서 그누보드5를 이용해 문서 관리를 위한 기능을 만들어 보기로 했다.


아래 화면이 그누보드의 스킨을 조금 수정하고 그누보드에서 지원하는 확장필드를 이용해 만든 문서 저장 게시판이다.


그누보드5의 리스트 스킨 수정



맨 위의 문서 종류는 그누보드에서 지원하는 식별자다. 아래 게시판의 글 목록에서 "제목" 대신 확장필드에 지정한 "고객사"와 "프로젝트"를 보여주도록 했다. 


그리고 아래의 검색창에도 "고객사명"과 "프로젝트명"을 이용해 검색할 수 있도록 했다. 그누보드에서 검색창에 확장필드의 값을 지정할 경우 자동으로 확장필드에서 검색하도록 편리하게 만들어져 있었다.


그누보드5 글쓰기 스킨에 확장 필드 값 입력하기

글쓰기 스킨에서 확장필드의 값을 입력하는 입력상자를 만들고 기술지원 관리시스템에서 등록한 프로젝트를 선택하여 입력할 수 있도록 그누보드5의 write.skin.php를 수정하였다.

아래 화면처럼 "찾기"버튼을 클릭하면 고객사/프로젝트 (단위업무) 선택 창이 뜨고 특정 단위업무(프로젝트)를 선택하면 입력이 된다.


아래 화면은 프로젝트가 선택되어진 화면이다.



등록된 산출물...


아키텍쳐 설계서가 등록되었고 "제목" 부분에 "고객사"와 "프로젝트명"이 표시되는 것을 볼 수 있다. 고객사와 프로젝트 명으로도 검색이 가능하다. 그누보드5에서 지원하는 구분자와 함께 사용하면 특정 프로젝트의 특정 산출물을 검색할 수 있겠다.



등록된 산출물 게시글의 내용을 보는 화면에도 고객사와 프로젝트명, 그리고 문서 종류를 함께 표시하도록 하였다.




산출물 관리에서 이렇게 도구를 만들어 제공하는 것 보다 더욱 중요한 것은 이 도구를 얼마나 효율적으로 사용하느냐다. 


문서의 작성자, 작성일, 버전은 물론...

문서를 등록할 때 등록자가 문서 내용의 목차,문서의 주요 내용 등을 함께 기재하여 검색의 효율을 높일 수 있도록 하는 것이 더욱 중요하다. 아무리 좋은 도구를 제공해도 사용자들이 등록된 문서를 제대로 검색해 볼 수 없다면 그 활용도는 매우 떨어질 수 밖에 없다.


다음에는...


위키를 이용한 문서 관리를 한번 연구해볼 필요가 있겠다. 위키에서도 수십..수백개의 고객사와 프로젝트 같은 키에 의한 문서 식별이 가능할까 모르겠다.


<추가 2015.03.18>

실제로 사용해 볼 수 있는 환경을 공개합니다. 언제까지 공개될지는 알 수 없지만 사용해보시고 좋은 의견(?) 주시면 감사하겠습니다


** 호스팅이 만료되어 폐쇄합니다. (2016/01/05) **


신고
이 댓글을 비밀 댓글로
    • 2016.01.05 00:18
    비밀댓글입니다
    • 안녕하세요. 뭐 검토하고 자시고할게 있나요? 저도 오픈소스가져다 고쳐서 쓰고 있는데..당연히 도움드려야죠..
      그런데 저도 전문개발자도 아니고 수정한지 1년이 다돼가는지라 기억을 더듬어 찾아야 하네요. ^^ 어떤 식으로 도움을 드려야할지 모르겠습니다. 블로그의 메일주소로 메일주시면 답신드리겠습니다.
    • 2016.01.05 22:25
    비밀댓글입니다