4-2. ⚡ Core Features Advanced Features

4.6 Statistics and Logs

4.6.1 Access Statistics (Google, Optional)

Provides functionality to collect and analyze various statistical information about site visitors using Google Analytics (GA4).

Main Features

• Visitor statistics by day/month/day of week/time zone
• Visit statistics by site/menu
• Browser/OS statistics

Statistical Data Collection Method

Main Classes

• humanframe.backoffice.controller.stats.AdminStatsController: Google statistics management controller
• humanframe.core.service.GoogleAnalyticsService: Google statistics management service

<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 Menu Statistics

Provides statistical information such as visitor count and page views for site menus.

Main Features

• Menu visit statistics by year/month/day periods
• Graph and Excel download

Statistical Data Collection Method

Main Classes

• humanframe.backoffice.controller.stats.AdminStatsMenuController: Menu statistics management controller
• humanframe.backoffice.service.StatsMenuService: Menu statistics management service
• humanframe.backoffice.dao.StatsMenuDAO: Menu statistics management DAO
• humanframe.backoffice.scheduler.statsMenuSchedulerBatch: Menu statistics data generation scheduler

@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 Log Management

Provides functionality to manage system logs and user activity logs.

Main Features

• System log management
• User activity log management
• Error log management
• Security log management
• Log search and filtering

Main Classes

• humanframe.backoffice.aop.aspect.admin.AdminLogAspect: Log recording AOP
• humanframe.backoffice.controller.mng.AdminMngrController: Log management controller
• humanframe.backoffice.service.MngLogService: Log management service
• humanframe.backoffice.dao.MngLogDAO: Log management DAO

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

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

    // Admin permission check
    @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 {
        // ... Omitted (log storage logic) ...
    }
}

4.7 Scheduler

4.7.1 Batch Job Configuration

Provides functionality to configure and manage jobs that need to be executed periodically.

Main Features

• Batch job registration/modification/deletion
• Execution cycle configuration
• Job status monitoring
• Job history management

<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 Periodic Task Management

Manages periodic tasks provided by default in HONGIKINGAN CMS.

Main Tasks

• Menu statistics data generation
• Mini board JSON data generation

Main Classes

• humanframe.backoffice.scheduler.statsMenuSchedulerBatch: Menu statistics generation
• humanframe.backoffice.scheduler.BbsSchedulerBatch: Mini board related batch jobs

public class BbsSchedulerBatch extends HumanAbstractController {

    @Resource(name="bbsMiniService")
    private BbsMiniService bbsMiniService;
    
    /**
     * Mini board JSON data generation
     */
    public void bbsCreate() throws Exception {
        int result = 0;
        List<Map<String, Object>> bbsMiniAllList = bbsMiniService.selectMiniListAll();

        if(!bbsMiniAllList.isEmpty()) {
            // JSON file generation
        }
        Map<String, Object> resultObjectMap = new HashMap<String, Object>();
        resultObjectMap.put("count", result);
        logger.info("##### Json " +result+ " items generated successfully");
        logger.info("##### Json Create End");
    }
}

4.8 Server Environment and System Features

4.8.1 Development Server Environment

HONGIKINGAN CMS operates in the following server environment:

4.8.2 Main System Features

HONGIKINGAN CMS provides the following main system features:

4.9 Utility Classes

HONGIKINGAN CMS provides various utility classes to enhance development convenience.

Main Utility Classes

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

HONGIKINGAN CMS provides various tag libraries to facilitate JSP page development.

<%@ 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" %>

Main Tag Libraries

<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">List</cmsBtn:list>

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

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

<button type="submit" class="btn btn-primary hidden-xs">Apply Account</button>
<double-submit:preventer/>

4.11 Admin Page Main Function-Related Sources

The admin page of HONGIKINGAN CMS provides various functions, and it is important to understand the source code related to each function. This section explains the source code structure related to the main functions of the admin page.

4.11.1 Login and Authentication Related Sources

The source code related to admin login and authentication is as follows.

Main Classes

Main JSP Files

• /WEB-INF/jsp/admin/login/login.jsp: Login page
• /WEB-INF/jsp/admin/login/mngrReqForm.jsp: Admin account application page

4.11.2 Menu Management Related Sources

The source code related to admin menu management functionality is as follows.

Main Classes

Main Files

• JSP: /WEB-INF/jsp/admin/site/menu/form.jsp (Menu registration/modification form)
• JSP: /WEB-INF/jsp/admin/site/menu/popup (Menu-related popup directory)
• SQL Mapper: human-mng-menu.xml

4.11.3 Board Management Related Sources

The source code related to board management functionality is as follows.

Main Controllers

Main Services and DAOs

• Service: BbsSettingServiceImpl, BbsTypeServiceImpl
• DAO: BbsSettingDAO, BbsTypeDAO
• VO: BbsSettingVO, BbsTypeVO, BbsType1VO

Main Files

• JSP: /WEB-INF/jsp/admin/bbs/list.jsp (Board list)
• JSP: /WEB-INF/jsp/admin/bbs/setting_form.jsp (Board registration/modification form)
• JSP: /WEB-INF/jsp/admin/bbs/type1/list.jsp (General board list)
• SQL Mapper: human-bbs-st.xml, human-bbs-type.xml, human-bbs-type1.xml

4.11.4 Member Management Related Sources

4.11.5 Content Management Related Sources

4.11.6 Banner Management Related Sources

4.11.7 Popup Management Related Sources

4.11.8 Menu Statistics Management Related Sources

4.11.9 System Management Related Sources

The source code related to system management functionality is as follows.

Main Controllers

Main Services

• CodeServiceImpl: Code management service
• MngrServiceImpl: Admin management service
• MngAuthorServiceImpl: Permission management service
• MngMenuServiceImpl: System menu management service

Main Files

• JSP: /WEB-INF/jsp/admin/mng/code/form.jsp (Code management)
• JSP: /WEB-INF/jsp/admin/mng/mngr/list.jsp (Admin list)
• JSP: /WEB-INF/jsp/admin/mng/author/list.jsp (Permission list)
• JSP: /WEB-INF/jsp/admin/mng/menu/form.jsp (System menu list)
• SQL Mapper: human-code.xml, human-mngr.xml, human-mng-author.xml, human-mng-menu.xml