4-2. ⚡ 핵심 기능 고급기능

4.6 통계 및 로그

4.6.1 접속 통계(구글,옵션)

구글 Analytics(GA4)를 이용하여 사이트 방문자에 대한 다양한 통계 정보를 수집하고 분석하는 기능을 제공합니다.

주요 기능

• 일/월/요일/시간대별 방문자 통계
• 사이트/메뉴별 방문 통계
• 브라우저/OS 통계

통계 데이터 수집 방식

주요 클래스

• humanframe.backoffice.controller.stats.AdminStatsController: 구글 통계 관리 컨트롤러
• humanframe.core.service.GoogleAnalyticsService: 구글 통계 관리 서비스

<c:if test="${!empty curSiteVO.googleKey }">
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=${curSiteVO.googleKey}"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', '${curSiteVO.googleKey}');
</script>
</c:if>

4.6.2 메뉴 통계

사이트 메뉴에 대한 방문자수,페이지뷰 등 통계 정보를 제공합니다.

주요 기능

• 년/월/일별 기간에 따른 메뉴 방문 통계
• 그래프 및 엑셀 다운로드

통계 데이터 수집 방식

주요 클래스

• humanframe.backoffice.controller.stats.AdminStatsMenuController: 메뉴 통계 관리 컨트롤러
• humanframe.backoffice.service.StatsMenuService: 메뉴 통계 관리 서비스
• humanframe.backoffice.dao.StatsMenuDAO: 메뉴 통계 관리 DAO
• humanframe.backoffice.scheduler.statsMenuSchedulerBatch: 메뉴 통계 데이터 생성 스케줄러

@Service("statsMenuScheduling")
public class statsMenuSchedulerBatch {

    @Resource(name="statsMenuService")
    private StatsMenuService statsMenuService;

    public void statsMenuMonth() throws Exception{
        
        String day = getYesterdayYmd();

        StatsMenuVO statsMenuVO = new StatsMenuVO();
        statsMenuVO.setStatsYyyy(day.substring(0,4));
        statsMenuVO.setStatsMm(day.substring(4,6));

        statsMenuService.deleteStatsMenuMonth(statsMenuVO);
        int result = statsMenuService.createStatsMenuMonth(statsMenuVO);
    }
}

4.6.3 로그 관리

시스템 로그 및 사용자 활동 로그를 관리하는 기능을 제공합니다.

주요 기능

• 시스템 로그 관리
• 사용자 활동 로그 관리
• 오류 로그 관리
• 보안 로그 관리
• 로그 검색 및 필터링

주요 클래스

• humanframe.backoffice.aop.aspect.admin.AdminLogAspect: 로그 기록 AOP
• humanframe.backoffice.controller.mng.AdminMngrController: 로그 관리 컨트롤러
• humanframe.backoffice.service.MngLogService: 로그 관리 서비스
• humanframe.backoffice.dao.MngLogDAO: 로그 관리 DAO

@Aspect
@Order(2)
@Component
public class AdminLogAspect {

    @Resource(name = "mngLogService")
    private MngLogService mngLogService;

    // 관리자 권한 체크
    @Pointcut("execution(* humanframe.backoffice..Admin*Controller.form(..))"
            + "|| execution(* humanframe.backoffice..Admin*Controller.list(..))"
            + "|| execution(* humanframe.backoffice..Admin*Controller.view(..))"
            + "|| execution(* humanframe.backoffice..Admin*Controller.action(..))"
            + "|| execution(* humanframe.backoffice..Admin*Controller.logout(..))")
    private void checkAdminLog() {}

    @Before(value = "checkAdminLog()")
    private void beforecheckAdminLog(
            JoinPoint joinPoint)throws Exception {
        // ... 중간 생략 (로그 저장 로직) ...
    }
}

4.7 스케줄러

4.7.1 배치 작업 설정

주기적으로 실행되어야 하는 작업을 설정하고 관리하는 기능을 제공합니다.

주요 기능

• 배치 작업 등록/수정/삭제
• 실행 주기 설정
• 작업 상태 모니터링
• 작업 이력 관리

<bean id="bbsCreateTrigger" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">
    <property name="jobDetail" ref="bbsCreateJob" />
    <property name="cronExpression" value="0 */10 * * * ?" />
</bean>
<bean id="statsMenuYearTrigger" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">
    <property name="jobDetail" ref="statsMenuYearCreateJob" />
    <property name="cronExpression" value="0 0 0 1 1 ?" />
</bean>
<bean id="statsMenuMonthTrigger" class="org.springframework.scheduling.quartz.CronTriggerFactoryBean">
    <property name="jobDetail" ref="statsMenuMonthCreateJob" />
    <property name="cronExpression" value="0 0 0 1 * ?" />
</bean>

4.7.2 주기적 작업 관리

홍익인간CMS에서 기본적으로 제공하는 주기적 작업들을 관리합니다.

주요 작업

• 메뉴 통계 데이터 생성
• 미니게시판 JSON 데이터 생성

주요 클래스

• humanframe.backoffice.scheduler.statsMenuSchedulerBatch: 메뉴 통계 생성
• humanframe.backoffice.scheduler.BbsSchedulerBatch: 미니게시판 관련 배치 작업

public class BbsSchedulerBatch extends HumanAbstractController {

    @Resource(name="bbsMiniService")
    private BbsMiniService bbsMiniService;
    
    /**
     * 미니게시판 JSON 데이터 생성
     */
    public void bbsCreate() throws Exception {
        int result = 0;
        List<Map<String, Object>> bbsMiniAllList = bbsMiniService.selectMiniListAll();

        if(!bbsMiniAllList.isEmpty()) {
            // JSON 파일 생성
        }
        Map<String, Object> resultObjectMap = new HashMap<String, Object>();
        resultObjectMap.put("count", result);
        logger.info("##### Json " +result+ "건 생성 완료");
        logger.info("##### Json Create End");
    }
}

4.8 서버 환경 및 시스템 기능

4.8.1 개발 서버 환경

홍익인간CMS는 다음과 같은 서버 환경에서 동작합니다:

4.8.2 주요 시스템 기능

홍익인간CMS는 다음과 같은 주요 시스템 기능을 제공합니다:

4.9 유틸리티 클래스

홍익인간CMS는 다양한 유틸리티 클래스를 제공하여 개발 편의성을 높입니다.

주요 유틸리티 클래스

String fileString = FileUtil.readFile(filePath);

MngrSiteService mngrSiteService = (MngrSiteService)HumanComUtil.getBean("mngrSiteService");

String encryptedText = HumanCryptoUtil.encrypt(plainText);
String plainText = HumanCryptoUtil.decrypt(encryptedText);

String response = HumanHttpUtil.getHttpForm(url, paramMap);

HumanMailUtil.sendMail(from, to, subject, content);

String ip = HumanReqUtil.getIp(request);

String stringDate = HumanStringUtil.convertDateFormat(date, "yyyy-MM-dd" );

String formUri = HumanUriUtil.getCurrUri(curSite, curMenu);

LoginManager loginManager = LoginManager.getInstance();
loginManager.setSession(session, mngrVO.getMngrId());

4.10 Tag Library

홍익인간CMS는 다양한 태그 라이브러리를 제공하여 JSP 페이지 개발을 용이하게 합니다.

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/functions" prefix="fn" %>
<%@ taglib uri="http://java.sun.com/jsp/jstl/fmt" prefix="fmt" %>
<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles" %>
<%@ taglib uri="http://www.springframework.org/tags" prefix="spring" %>
<%@ taglib uri="http://www.springframework.org/tags/form" prefix="f" %>
<%@ taglib uri="/WEB-INF/tld/double-submit" prefix="double-submit"  %>
<%@ taglib uri="/WEB-INF/tld/cms.tld" prefix="cms" 	 %>
<%@ taglib uri="/WEB-INF/tld/cms-function.tld" prefix="cmsFn" %>
<%@ taglib uri="/WEB-INF/tld/cms-button.tld" prefix="cmsBtn" %>
<%@ taglib uri="/WEB-INF/tld/cms-button2.tld" prefix="cmsBtn2" %>

주요 태그 라이브러리

<cms:paging listVO="${listVO}"
                    firstIcon="<i class='fa fa-angle-double-left'></i>"
                    prevIcon="<i class='fa fa-angle-left'></i>"
                    nextIcon="<i class='fa fa-angle-right'></i>"
                    lastIcon="<i class='fa fa-angle-double-right'></i>"
                    cssClass="pagination pull-right"/>

<cmsBtn:list admin="true" cssClass="btn btn-default">목록</cmsBtn:list>

<cmsBtn2:btn btnTy="save" path="${curPath}" mngrSession="${mngrSession }" >저장</cmsBtn2:btn>

${cmsFn:convertDate(item.value, 'yyyy.MM.dd') }

<button type="submit" class="btn btn-primary hidden-xs">계정 신청</button>
<double-submit:preventer/>

4.11 관리자 페이지 주요 기능별 관련 소스

홍익인간CMS의 관리자 페이지는 다양한 기능을 제공하며, 각 기능별로 관련된 소스 코드를 이해하는 것이 중요합니다. 이 섹션에서는 관리자 페이지의 주요 기능별 관련 소스 코드 구조를 설명합니다.

4.11.1 로그인 및 인증 관련 소스

관리자 로그인 및 인증 관련 소스 코드는 다음과 같습니다.

주요 클래스

주요 JSP 파일

• /WEB-INF/jsp/admin/login/login.jsp: 로그인 페이지
• /WEB-INF/jsp/admin/login/mngrReqForm.jsp: 관리자 계정 신청 페이지

4.11.2 메뉴 관리 관련 소스

관리자 메뉴 관리 기능 관련 소스 코드는 다음과 같습니다.

주요 클래스

주요 파일

• JSP: /WEB-INF/jsp/admin/site/menu/form.jsp (메뉴 등록/수정 폼)
• JSP: /WEB-INF/jsp/admin/site/menu/popup (메뉴 관련 팝업 디렉토리)
• SQL 매퍼: human-mng-menu.xml

4.11.3 게시판 관리 관련 소스

게시판 관리 기능 관련 소스 코드는 다음과 같습니다.

주요 컨트롤러

주요 서비스 및 DAO

• 서비스: BbsSettingServiceImpl, BbsTypeServiceImpl
• DAO: BbsSettingDAO, BbsTypeDAO
• VO: BbsSettingVO, BbsTypeVO, BbsType1VO

주요 파일

• JSP: /WEB-INF/jsp/admin/bbs/list.jsp (게시판 목록)
• JSP: /WEB-INF/jsp/admin/bbs/setting_form.jsp (게시판 등록/수정 폼)
• JSP: /WEB-INF/jsp/admin/bbs/type1/list.jsp (일반형 게시판 목록)
• SQL 매퍼: human-bbs-st.xml, human-bbs-type.xml, human-bbs-type1.xml

4.11.4 회원 관리 관련 소스

4.11.5 콘텐츠 관리 관련 소스

4.11.6 배너 관리 관련 소스

4.11.7 팝업 관리 관련 소스

4.11.8 메뉴 통계 관리 관련 소스

4.11.9 시스템 관리 관련 소스

시스템 관리 기능 관련 소스 코드는 다음과 같습니다.

주요 컨트롤러

주요 서비스

• CodeServiceImpl: 코드 관리 서비스
• MngrServiceImpl: 관리자 관리 서비스
• MngAuthorServiceImpl: 권한 관리 서비스
• MngMenuServiceImpl: 시스템메뉴 관리 서비스

주요 파일

• JSP: /WEB-INF/jsp/admin/mng/code/form.jsp (코드 관리)
• JSP: /WEB-INF/jsp/admin/mng/mngr/list.jsp (관리자 목록)
• JSP: /WEB-INF/jsp/admin/mng/author/list.jsp (권한 목록)
• JSP: /WEB-INF/jsp/admin/mng/menu/form.jsp (시스템메뉴 목록)
• SQL 매퍼: human-code.xml, human-mngr.xml, human-mng-author.xml, human-mng-menu.xml