협업 - 커뮤니티 사용기능
개요
커뮤니티 사용기능 서비스는 관리자가 생성한 커뮤니티에 대한 가입/탈퇴 신청을 할 수 있으며,
협업의 게시판 기능을 통해 방명록 및 갤러리를 포함한 공지 게시판, 자유게시판, 자료실의 기본적인 커뮤니티 서비스가 제공된다.
해당 패키지는 배포시점에 게시판 패키지 및 협업 공통패키지와 함께 배포되어 적용하여야 한다.
커뮤니티 사용기능 서비스는 HTML5, jQuery와 함께 jQM(jQuery Mobile)을 바탕으로 개발된 모바일 공통 컴포넌트이다.
자세한 사항은 모바일 실행환경 가이드를 통해 안내되고 있다.
컴포넌트와 관련된 css로는 기본적으로 적용되는 EgovMobile.css와 함께 egovBoard.css, ussCommon.css가 사용된다.
또한 공통으로 지원하고 있는 jAlert가 사용되고 있으며, 아래와 같은 js 파일에 정의되어 있다.
- EgovMobile.js
지원대상
본 컴포넌트는 모바일 디바이스에서 사용 가능한 브라우저를 대상으로 개발 및 테스트를 완료하였으며
PC용 브라우저와 mobile용 브라우저의 HTML5, CSS3 에 대한 지원이 상이함으로 개발, 적용 시에 주의가 필요하다.
개발 및 테스트를 위해 갤럭시S2, 갤럭시S, 갤럭시탭, iPad2, iPhone4 등의 모바일 기기와
Android 기본 브라우저, Firefox, Safari, Opera Mobile 등의 모바일 브라우저를 사용하였다.
Android
테스트 디바이스로는 갤럭시S, 갤럭시S2, 갤럭시탭을 사용하였으며,
브라우저는 Android 기본 브라우저, Firefox(6.xx), Opera Mobile 브라우저를 사용하였다.
- Android OS 2.3 (GingerBread) : HTML5, CSS3 및 컴포넌트의 실행을 안정적으로 지원하였다.
- Android OS 2.1 (Eclair), 2.2 (Froyo) : HTML5, CSS3 지원이 부족하여 컴포넌트의 UI 구현이 원할하지 못하였다.
하지만, Opera Mobile의 경우에는 색상 및 이벤트 처리에 일부 문제가 발생하여 3종지원 브라우저 대상에서 제외되었다.
iOS
테스트 디바이스로는 iPhone4, iPad2를 사용하였다.
- iOS 4.2, 4.3 : 두 버전 모두 HTML5, CSS3를 비교적 원활하게 지원하였다.
기능흐름도
설명
커뮤니티 사용기능은 사용자의 가입 및 탈퇴신청을 처리하는 기능, 방명록을 조회하고 관리하는 기능, 갤러리를 통한 이미지 조회 기능을 제공한다.
클래스 다이어그램
관련소스
| 유형 | 대상소스 | 비고 |
|---|---|---|
| Controller | egovframework.com.cop.cmy.web.EgovCommunityManageController.java | 커뮤니티 관리를 위한 컨트롤러 클래스 |
| Controller | egovframework.mbl.com.cop.cmy.web.EgovMblCommunityManageController.java | 커뮤니티 관리를 위한 컨트롤러 클래스 |
| Service | egovframework.com.cop.cmy.service.EgovCommunityManageService.java | 커뮤니티 관리를 위한 서비스 인터페이스 |
| ServiceImpl | egovframework.com.cop.cmy.service.impl.EgovCommunityManageServiceImpl.java | 커뮤니티 관리를 위한 서비스 구현 클래스 |
| VO | egovframework.com.cop.cmy.service.Community.java | 커뮤니티 관리를 위한 모델 클래스 |
| VO | egovframework.com.cop.cmy.service.CommunityVO.java | 커뮤니티 관리를 위한 VO 클래스 |
| DAO | egovframework.com.cop.cmy.service.impl.CommunityManageDAO.java | 커뮤니티 관리를 위한 데이터처리 클래스 |
| JSP | /WEB-INF/jsp/egovframework/mbl/com/cop/com/tpl/EgovCmmntyBaseTmpl.jsp | 커뮤니티 기본 템플릿 메인화면 jsp페이지 |
| JSP | /WEB-INF/jsp/egovframework/com/cop/com/template/EgovCmmntyBaseTmplContents.jsp | 커뮤니티 기본 템플릿 메인화면 컨텍츠 부분 jsp페이지 |
| Query XML | resources/egovframework/sqlmap/com/cop/cmy/EgovCmmnty_SQL.xml | 커뮤니티 관리를 위한 Query |
관련소스 (관리자 메뉴 관련)
| 유형 | 대상소스 | 비고 |
|---|---|---|
| Controller | egovframework.com.cop.bbs.web.EgovBBSAttributeManageController.java | 커뮤니티 관련 게시판 관리를 위한 컨트롤러 클래스 |
| Controller | egovframework.com.cop.com.web.EgovCopUserInfController.java | 커뮤니티 관련 사용자 관리를 위한 컨트롤러 클래스 |
| Controller | egovframework.com.cop.com.web.EgovBBSUseInfoManageController.java | 커뮤니티 관련 게시판 사용 관리를 위한 컨트롤러 클래스 |
| Controller | egovframework.com.cop.clb.web.EgovClubManageController.java | 커뮤니티 관련 동호회 관리를 위한 컨트롤러 클래스 |
| Service | egovframework.com.cop.bbs.service.EgovBBSAttributeManageService.java | 커뮤니티 관련 게시판 관리를 위한 서비스 인터페이스 |
| Service | egovframework.com.cop.com.service.EgovUserInfManageService.java | 커뮤니티 관련 사용자 관리를 위한 서비스 인터페이스 |
| Service | egovframework.com.cop.com.service.EgovBBSUseInfoManageService.java | 커뮤니티 관련 게시판 사용 관리를 위한 서비스 인터페이스 |
| Service | egovframework.com.cop.clb.service.EgovClubManageService.java | 커뮤니티 관련 동호회 관리를 위한 서비스 인터페이스 |
| ServiceImpl | egovframework.com.cop.bbs.service.impl.EgovBBSAttributeManageServiceImpl.java | 커뮤니티 관련 게시판 관리를 위한 서비스 구현 클래스 |
| ServiceImpl | egovframework.com.cop.com.service.impl.EgovUserInfManageServiceImpl.java | 커뮤니티 관련 사용자 관리를 위한 서비스 구현 클래스 |
| ServiceImpl | egovframework.com.cop.com.service.impl.EgovBBSUseInfoManageServiceImpl.java | 커뮤니티 관련 게시판 사용 관리를 위한 서비스 구현 클래스 |
| ServiceImpl | egovframework.com.cop.clb.service.impl.EgovClubManageServiceImpl.java | 커뮤니티 관련 동호회 관리를 위한 서비스 구현 클래스 |
| VO | egovframework.com.cop.bbs.service.BoardMaster.java | 커뮤니티 관련 게시판 관리를 위한 모델 클래스 |
| VO | egovframework.com.cop.bbs.service.BoardMasterVO.java | 커뮤니티 관련 게시판 관리를 위한 VO 클래스 |
| VO | egovframework.com.cop.com.service.UserInfVO.java | 커뮤니티 관련 사용자 관리를 위한 VO 클래스 |
| VO | egovframework.com.cop.com.service.BoardUseInf.java | 커뮤니티 관련 게시판 사용 관리를 위한 모델 클래스 |
| VO | egovframework.com.cop.com.service.BoardUseInfVO.java | 커뮤니티 관련 게시판 사용 관리를 위한 VO 클래스 |
| VO | egovframework.com.cop.clb.service.Club.java | 커뮤니티 관련 동호회 관리를 위한 모델 클래스 |
| VO | egovframework.com.cop.clb.service.ClubVO.java | 커뮤니티 관련 동호회 관리를 위한 VO 클래스 |
| DAO | egovframework.com.cop.bbs.service.impl.BBSAttributeManageDAO.java | 커뮤니티 관련 게시판 관리를 위한 데이터처리 클래스 |
| DAO | egovframework.com.cop.com.service.impl.EgovUserInfManageDAO.java | 커뮤니티 관련 사용자 관리를 위한 데이터처리 클래스 |
| DAO | egovframework.com.cop.com.service.impl.BBSUseInfoManageDAO.java | 커뮤니티 관련 게사판 사용 관리를 위한 데이터처리 클래스 |
| DAO | egovframework.com.cop.clb.service.impl.ClubManageDAO.java | 커뮤니티 관련 동호회 관리를 위한 데이터처리 클래스 |
| JSP | /WEB-INF/jsp/egovframework/com/cop/bbs/EgovBBSListByTrget.jsp | 커뮤니티 관련 게시판 관리 화면 jsp페이지 |
| JSP | /WEB-INF/jsp/egovframework/com/cop/com/EgovUserList.jsp | 커뮤니티 관련 사용자 관리 화면 jsp페이지 |
| JSP | /WEB-INF/jsp/egovframework/com/cop/com/EgovBdUseInfListByTrget.jsp | 커뮤니티 관련 게시판 사용 관리 화면 jsp페이지 |
| JSP | /WEB-INF/jsp/egovframework/com/cop/clb/EgovClubListByTrget.jsp | 커뮤니티 관련 동호회 관리 화면 jsp페이지 |
| Query XML | resources/egovframework/sqlmap/com/cop/bbs/EgovBBSMaster_SQL.xml | 커뮤니티 관련 게시판 관리를 위한 Query |
| Query XML | resources/egovframework/sqlmap/com/cop/com/EgovUserInf_SQL.xml | 커뮤니티 관련 사용자 관리를 위한 Query |
| Query XML | resources/egovframework/sqlmap/com/cop/com/EgovBBSUse_SQL.xml | 커뮤니티 관련 게시판 사용 관리를 위한 Query |
| Query XML | resources/egovframework/sqlmap/com/cop/com/EgovClub_SQL.xml | 커뮤니티 관련 동호회 관리를 위한 Query |
관련테이블
| 테이블명 | 테이블명(영문) | 비고 |
|---|---|---|
| 커뮤니티속성 | COMTNCMMNTY | 커뮤니티의 속성정보를 관리 |
| 커뮤니티사용자 | COMTNCMMNTYUSER | 커뮤니티 사용자 관리 |
| 템플릿 | COMTNTMPLATINFO | 템플릿 관리 |
관련된 참조 소스 및 테이블은 다음을 참조한다.
- 게시판 기능 : 게시판 설명을 참조
환경설정
게시판을 사용하기 위해서는 게시판 관리기능에 의해 게시판이 생성되어야 하며, 커뮤니티가 새롭게 생성 될 때에는 다음과 같은 기본적인 게시판이 생성된다.
| 게시판 이름 | 게시판 유형 | 게시판 속성 | 비고 |
|---|---|---|---|
| 방명록 | 방명록 | 일반게시판 | |
| 공지게시판 | 공지게시판 | 유효게시판 | 게시 시작일/종료일 |
| 자유게시판 | 일반게시판 | 일반게시판 | |
| 자료실 | 일반게시판 | 일반게시판 | |
| 갤러리 | 일반게시판 | 갤러리 |
게시판 유형 및 속성에 대한 내용은 게시판 관리기능을 참조한다.
사용방법
커뮤니티 메인화면
비즈니스 규칙
커뮤니티에서 제공하는 게시판 목록을 조회할 수 있으며, 미가입 사용자에 대한 가입신청 기능과 이미 가입된 사용자에 대한 탈퇴신청 기능을 제공한다.
커뮤니티에 대한 메인 화면은 다음과 같은 URL로 접근한다.
/cop/cmy/CmmntyMainPage.mdo?cmmntyId=커뮤니티ID
관련코드
N/A
관련 화면 및 수행 매뉴얼
| Action | URL | Controller method | QueryID |
|---|---|---|---|
| 게시판 | /cop/cmy/CmmntyMainPage.mdo | selectCmmntyMainPage | “BBSAttributeManageDAO.selectAllBdMstrByTrget” |
| 동호회 | “ClubManageDAO.selectClubListPortletByTrget” |
홈: 홈 화면으로 이동한다.
메뉴 클릭: 해당 화면으로 이동한다.
가입신청 클릭: 가입신청 완료 메세지를 보여준다.
탈퇴신청 클릭: 탈퇴신청 완료 메세지를 보여준다.
방명록
비즈니스 규칙
방명록 목록 화면에서는 커뮤니티 방명록에 대한 목록의 조회, 등록 및 수정 화면으로의 이동, 방명록에 대한 삭제처리를 할 수 있다.
방명록 쓰기 화면에서는 하나의 화면으로 방명록에 대한 등록 및 수정을 처리한다.
방명록에 대한 화면은 다음과 같은 URL로 접근한다.
/cop/bbs/selectGuestList.mdo?bbsId=방명록ID&bbsAttrbCode=방명록속성
관련코드
N/A
관련 화면 및 수행 매뉴얼
| Action | URL | Controller method | QueryID |
|---|---|---|---|
| 방명록속성 | /cop/bbs/selectGuestList.mdo | selectGuestList | “BBSAttributeManageDAO.selectBBSMasterInf” |
| 방명록목록 | “BBSManageDAO.selectBoardArticleList” | ||
| 수정 | /cop/cmt/updateComment.mdo | updateCommentList | “BBSCommentDAO.updateComment” |
| 삭제 | /cop/cmt/deleteComment.mdo | deleteComment | “BBSCommentDAO.deleteComment” |
방명록 목록
홈: 홈 화면으로 이동한다.
등록 : 방명록 등록 화면으로 이동한다.
수정 : 방명록 수정 화면으로 이동한다.
삭제 : 삭제여부를 확인하는 메세지를 보여주고 해당 방명록을 삭제한다.
방명록 등록 및 수정
뒤로: 방명록 목록 화면으로 이동한다.
저장 : 입력 또는 변경된 방명록 내용을 저장한다.
초기화: 입력한 정보들이 초기화된다.
갤러리
비즈니스 규칙
갤러리는 기본적인 게시판 기능과 함께 이미지 보기((BMP,JPG,GIF,PNG 포맷의 이미지 파일에 한함)를 지원하며, 갤러리 게시글의 등록시 모바일에서는 이미지 파일에 대한 첨부 기능이 제공되지 않는다.
갤러리에 대한 화면은 다음과 같은 URL로 접근한다.
/cop/bbs/selectBoardList.mdo?bbsId=게시판ID&bbsAttrbCode=게시판속성
관련코드
N/A
관련 화면 및 수행 매뉴얼
| Action | URL | Controller method | QueryID |
|---|---|---|---|
| 갤러리속성 | /cop/bbs/selectGuestList.mdo | selectAnonymousBoardArticles | “BBSAttributeManageDAO.selectBBSMasterInf” |
| 갤러리목록 | “BBSManageDAO.selectBoardArticleList” | ||
| 갤러리상세 | /cop/bbs/selectBoardArticle.mdo | selectBoardArticle | “BBSManageDAO.selectBoardArticle” |
뒤로: 갤러리 목록조회 화면으로 이동한다.
수정: 수정버튼 클릭 시 게시물을 수정할 수 있는 갤러리 수정 화면으로 이동한다.
삭제: 삭제버튼 클릭 시 삭제여부를 확인하는 메세지를 보여주고 삭제처리를 할 수 있다. 삭제처리 후 갤러리 목록조회 화면으로 이동한다.
목록: 갤러리 목록조회 화면으로 이동한다.
참고자료
- 게시판 관리기능 참조(기존 웹 버전) : 게시판 관리기능
- 커뮤니티 관리기능 참조(기존 웹 버전) : 커뮤니티 관리기능
- 커뮤니티 사용기능 참조(기존 웹 버전) : 커뮤니티 사용기능
- 커뮤니티 템플릿 참조(기존 웹 버전) : 커뮤니티 템플릿
- 배포 및 테스트 관련 : 모바일 공통컴포넌트란 및 배포 패키지 구성안