====== 게시물 통계 ======

===== 개요 =====
게시물 통계 기능은 각종 게시물 현황에 대한 통계자료를 게시판 유형, 게시판 템플릿, 게시판 속성에 따라 기간별(연도별, 월별, 일별)로 그래프와 텍스트 형태 두가지 방식으로 제공한다.

  * 기능흐름 

^기능명^기능 흐름^
|게시물통계 집계|//**게시물정보 요약 배치수행**// -> //**게시물요약정보 집계**//|
|게시물통계 검색|검색조건 입력 -> 조건별 게시물 통계 검색|

===== 설명 =====
게시물 통계 수치를 특정 검색 조건에 따라 생성글수, 총조회수, 평균조회수, 최고/최소조회수 게시글 정보, 최고게시자 정보를 조회하는 기능이다.

==== 패키지 참조 관계 ====

게시물통계 패키지는 요소기술의 공통(cmm) 패키지와 리포팅 공통(sts.com) 패키지에 대해서 직접적인 함수적 참조 관계를 가진다. 하지만, 컴포넌트 배포 시 오류 없이 실행되기 위하여 패키지 간의 참조관계에 따라 달력 패키지와 함께 배포 파일을 구성한다. 


  * 패키지 간 참조 관계 : [[egovframework:com:v2:init_pkg_dependency#통계/리포팅|통계/리포팅 Package Dependency]]


==== 관련소스 ====

^유형^대상소스명^비고^
|Controller|egovframework.com.sts.bst.web.EgovBbsStatsController.java|게시물 통계를 위한 컨트롤러 클래스|
|Service|egovframework.com.sts.bst.service.EgovBbsStatsService.java|게시물 통계를 위한 서비스 인터페이스|
|ServiceImpl|egovframework.com.sts.bst.service.impl.EgovBbsStatsServiceImpl.java|게시물 통계를 위한 서비스 구현 클래스|
|Model|egovframework.com.sts.bst.service.BbsSummary.java|게시물 통계를 위한 모델 클래스|
|DAO|egovframework.com.sts.bst.service.impl.BbsStatsDAO.java|게시물 통계를 위한 데이터 처리 클래스|
|Scheduling|egovframework.com.sts.bst.service.EgovBbsStatsScheduling.java|게시물 통계 집계를 위한 스케줄 클래스|
|JSP|WEB_INF/jsp/egovframework/com/sts/bst/EgovBbsStats.jsp|게시물 통계 페이지|
|Query XML|resources/egovframework/mapper/com/sts/bst/EgovBbsStats_SQL_mysql.xml|게시물 통계를 위한 MySQL용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/bst/EgovBbsStats_SQL_cubrid.xml|게시물 통계를 위한 Cubrid용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/bst/EgovBbsStats_SQL_oracle.xml|게시물 통계를 위한 Oracle용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/bst/EgovBbsStats_SQL_tibero.xml|게시물 통계를 위한 Tibero용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/bst/EgovBbsStats_SQL_altibase.xml|게시물 통계를 위한 Altibase용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/bst/EgovBbsStats_SQL_maria.xml|게시물 통계를 위한 Maria용 Query XML|
|Query XML|resources/egovframework/mapper/com/sts/bst/EgovBbsStats_SQL_postgres.xml|게시물 통계를 위한 PostgreSQL용 Query XML|
|Message properties|resources/egovframework/message/com/sts/bst/message_ko.properties|게시물 통계 Message properties(한글)|
|Message properties|resources/egovframework/message/com/sts/bst/message_en.properties|게시물 통계 Message properties(영문)|

==== 클래스 다이어그램 ====

{{:egovframework:com:v2:sts:게시물통계_클래스다이어그램.jpg?740|}}

==== 관련테이블 ====
^테이블명^테이블명(영문)^비고^
|게시물통계요약|COMTSBBSSUMMARY|게시물 통계 정보를 관리한다.|

==== 환경설정 ====
하루에 발생한 게시물을 모두 조회하여 생성글수, 총조회수, 평균조회수, 최고조회게시물, 최소조회게시물, 최고게시자ID 정보를 요약하는 작업이 배치형태로 구성되어야 한다. \\
본 기능은 전자정부 표준프레임워크 실행환경의 **[[egovframework:rte:fdl:scheduling]]** 기능을 활용하여 구성되어있다. \\
  * 작업 클래스 생성(src/main/java/egovframework/com/sts/bst/service/EgovBbsStatsScheduling.java)
<code java>
public class EgovBbsStatsScheduling {
	
	/** EgovBbsStatsService */
	@Resource(name = "bbsStatsService")
	private EgovBbsStatsService bbsStatsService;

	/**
	 * 게시물 통계를 위한 집계를 하루단위로 작업하는 배치 프로그램
	 * @exception Exception
	 */
	public void summaryBbsStats() throws Exception {
		bbsStatsService.summaryBbsStats();
	}
}
</code>
  * 작업 수행 Bean 설정(ssrc/main/resources/egovframework/spring/com/context-scheduling-sts-bst.xml)

<code xml>
<bean id="bbsStats" class="org.springframework.scheduling.quartz.MethodInvokingJobDetailFactoryBean">
    <property name="targetObject" ref="egovBbsStatsScheduling" />
    <property name="targetMethod" value="summaryBbsStats" />
    <property name="concurrent" value="false" />
</bean>
</code>
  * 트리거 Bean 설정(ssrc/main/resources/egovframework/spring/com/context-scheduling-sts-bst.xml)

<code xml>
<bean id="bbsStatsTrigger" class="org.springframework.scheduling.quartz.SimpleTriggerBean">
    <property name="jobDetail" ref="bbsStats" />
    <!-- 시작하고 2분후에 실행한다. (milisecond) -->
    <property name="startDelay" value="120000" />
    <!-- 매 12시간마다 실행한다. (milisecond) -->
    <property name="repeatInterval" value="43200000" />
</bean>
</code>
  * 스케줄러 Bean 설정 (ssrc/main/resources/egovframework/spring/com/context-scheduling-sts-bst.xml)
<code xml>
<bean id="statsSummaryScheduler" class="org.springframework.scheduling.quartz.SchedulerFactoryBean">
    <property name="triggers">
        <list>
            <ref bean="bbsStatsTrigger" />
        </list>
    </property>
</bean>
</code>

===== 관련기능  =====

==== 게시물 통계 ====

=== 비즈니스 규칙 ===
게시판, 동호회, 커뮤니티 등에서 생성되어 하루 단위로 집계되는 게시물 요약 정보를 통해 조건별 게시물 통계 자료를 조회한다.

=== 관련코드  ===
N/A

=== 관련화면 및 수행메뉴얼 ===

^Action^URL^Controller method^QueryID^
|게시물 생성글수 통계검색|/sts/bst/selectBbsStats.do|selectBbsStats|"BbsStatsDAO.selectBbsCretCntStats"|
|게시물 총조회수 통계검색|/sts/bst/selectBbsStats.do|selectBbsStats|"BbsStatsDAO.selectBbsTotCntStats"|
|게시물 평균조회수 통계검색|/sts/bst/selectBbsStats.do|selectBbsStats|"BbsStatsDAO.selectBbsAvgCntStats"|
|게시물 최고조회 게시물 정보검색|/bst/sts/selectBbsStats.do|selectBbsStats|"BbsStatsDAO.selectBbsMaxCntStats"|
|게시물 최소조회 게시물 정보검색|/bst/sts/selectBbsStats.do|selectBbsStats|"BbsStatsDAO.selectBbsMinCntStats"|
|게시물 최고게시자 정보검색|/sts/bst/selectBbsStats.do|selectBbsStats|"BbsStatsDAO.selectBbsMaxUserStats"|


{{:egovframework:com:v3.9:sts:stats1.png|}}

기간: 통계 검색을 할 시작-종료 기간을 입력한다. \\
기간구분: 연도별, 월별, 일별 기간별 통계 형태를 선택한다. \\
통계구분: 게시판유형, 게시판템플릿, 게시판속성별 구분을 선택한다. \\
세부통계구분: 선택된 통계구분에 해당되는 세부 구분을 선택한다. \\
생성글수 탭: 설정한 조건에 맞는 게시물 생성글수 통계를 조회한다. \\
총조회수 탭: 설정한 조건에 맞는 게시물 총조회수 통계를 조회한다. \\
평균조회수 탭: 설정한 조건에 맞는 게시물 평균조회수 통계를 조회한다. \\
최고/최소조회수 탭: 설정한 조건에 맞는 게시물 최고/최소조회 정보를 조회한다. \\
최고게시자 탭: 설정한 조건에 맞는 게시물 최고게시자 정보를 조회한다. \\
초기화: 검색 조건을 초기화한다. \\

===== 참고자료 =====
  * 실행환경 참조 : [[egovframework:rte:fdl:scheduling]]