4-1. 🏗️ Core Features Basic Structure

4.1 Project Source Structure

HONGIKINGAN CMS consists of two main modules.

4.2 Resource Configuration

4.2.1 Spring Context Configuration Files

HONGIKINGAN CMS defines system behavior through various Spring Context configuration files.

4.2.2 Web Application Structure

The web application consists of the following main directories:

4.3 User Management

4.3.1 Authentication and Authorization Management

HONGIKINGAN CMS uses Spring Security and a self-developed authorization management system together for user authentication and authorization management.

Main Features

• User login/logout
• Permission group management
• Menu-specific access permission settings
• Board-specific permission settings
• IP-based access control

Authorization Management Structure

Main Classes

• humanframe.backoffice.interceptor.CMSAdminInterceptor: Admin permission verification
• humanframe.backoffice.aop.aspect.admin.AdminBbsAspect: Permission verification AOP
• humanframe.backoffice.aop.aspect.admin.AdminPrivacyAspect: Personal information access verification AOP

// [Code Location] humanframe.backoffice.aop.aspect.admin.AdminBbsAspect
@Aspect
@Order(1)
@Component
public class AdminBbsAspect {

    // Admin permission check
    @Pointcut("execution(* humanframe.backoffice..AdminBbsType*Controller.form(..))"
            + "|| execution(* humanframe.backoffice..AdminBbsType*Controller.list(..))"
            + "|| execution(* humanframe.backoffice..AdminBbsType*Controller.view(..))"
            + "|| execution(* humanframe.backoffice..AdminBbsType*Controller.action(..))"
            + "|| execution(* humanframe.backoffice..AdminBbsType*Controller.answer(..))")
    private void checkAdminBbsAuth() {}

    @Before(value = "checkAdminBbsAuth()")
    private void beforeCheckAdminBbsAuth(
            JoinPoint joinPoint)throws Exception {
        // ... Omitted (permission verification logic) ...
    }
}

4.3.2 Session Management

HONGIKINGAN CMS manages user and admin sessions separately and provides features such as session timeout and concurrent access control.

Main Features

• Session creation and management
• Session timeout settings
• Concurrent access control
• Session information encryption

Main Classes

• humanframe.backoffice.session.MngrSession: Admin session class
• humanframe.backoffice.session.MberSession: User session class

// [Code Location] humanframe.backoffice.session.MngrSession
public class MngrSession implements Serializable {
    private static final long serialVersionUID = 1L;
    
    private String mngrId;
    private String mngrNm;
    private String authorTy;
    private String[] siteNos;
    private String[] siteMenus;//for cntnts
    private String[] fnctNos;//for fnct
    private String[] bbsNos;//for bbs
    
    // Session information setting and retrieval methods
    // ...
}

4.3.3 User Information Management

User information management includes functions such as member registration, information modification, and withdrawal.

Main Features

• Member registration/modification/withdrawal
• Password encryption
• Email/SMS authentication
• Social login integration
• Personal information protection features

Main Classes

• humanframe.backoffice.controller.mber.AdminMberController: Member management controller
• humanframe.backoffice.service.MberService: Member management service
• humanframe.backoffice.dao.MberDAO: Member management DAO

4.4 Content Management

4.4.1 Menu Management

HONGIKINGAN CMS provides functionality to efficiently manage the menu structure of websites.

Main Features

• Hierarchical menu structure management
• Menu order changes
• Menu-specific permission settings
• Menu activation/deactivation
• Menu statistics management

Main Classes

• humanframe.backoffice.controller.mng.AdminMngMenuController: Menu management controller
• humanframe.backoffice.service.MngMenuService: Menu management service
• humanframe.backoffice.dao.MngMenuDAO: Menu management DAO

4.4.2 Site/Menu Publication System

HONGIKINGAN CMS has a structure where site and menu changes in the admin page are not immediately reflected on the user page, but are reflected through a 'Publication' process. This is a safety mechanism that allows administrators to review and confirm changes before applying them to the actual user page.

Table Relationships

1. TN_SITE ↔ TN_PBLCATE_SITE
   • TN_SITE: Site information table edited by admin
   • TN_PBLCATE_SITE: Site information table actually shown to users after publication
2. TN_SITE_MENU ↔ TN_PBLCATE_SITE_MENU
   • TN_SITE_MENU: Menu information table edited by admin
   • TN_PBLCATE_SITE_MENU: Menu information table actually shown to users after publication

Publication Process

Advantages of Publication System

4.4.3 Board Management

Provides functionality to create and manage various types of boards.

Board Types

Main Features

• Board creation/modification/deletion
• Post management
• Comment management
• Attachment management
• Board-specific permission settings
• Post search and filtering

Main Classes

• humanframe.backoffice.controller.bbs.AdminBbsController: Board management controller
• humanframe.backoffice.controller.bbs.AdminBbsSettingController: Board settings controller
• humanframe.backoffice.controller.bbs.AdminBbsType1Controller: General board controller
• humanframe.backoffice.service.BbsSettingService: Board management service
• humanframe.backoffice.dao.BbsSettingDAO: Board settings DAO
• humanframe.backoffice.dao.BbsTypeDAO: Board type-specific DAO

// [Code Location] humanframe.backoffice.service.BbsSettingService
@SuppressWarnings("rawtypes")
public interface BbsSettingService {
    
    /**
     * Retrieve board list.
     * 
     * @param listVO Search conditions
     * @return Board list
     */
    public HumanListVO boardListVo(HumanListVO listVO) throws Exception;
    
    /**
     * Retrieve board information.
     * 
     * @param bbsNo Board number
     * @return Board information
     */
    public BbsSettingVO retrieveBoardSetting(int bbsNo) throws Exception;
    
    // ... Other methods
}

4.4.4 Content Management

Provides functionality to manage content that will compose pages.

Main Features

• Content creation/modification/deletion
• Template-based page management
• HTML editor support
• SEO optimization settings
• Content preview
• Content version management

Main Classes

• humanframe.backoffice.controller.cntnts.AdminCntntsController: Content management controller
• humanframe.backoffice.service.CntntsService: Content management service
• humanframe.backoffice.dao.CntntsDAO: Content management DAO
• humanframe.backoffice.vo.CntntsVO: Content VO

4.5 File and Media Management

4.5.1 File Upload/Download

HONGIKINGAN CMS provides functionality to safely handle upload and download of various files.

Main Features

• Multiple file upload
• File type restrictions
• File size restrictions
• File encryption
• Download permission management
• Download statistics

File Upload Processing Flow

Main Classes

• humanframe.backoffice.controller.media.AdminMediaController: Media management controller
• humanframe.backoffice.service.FileService: File management service
• humanframe.backoffice.util.FileDownload: File download utility
• humanframe.backoffice.util.FileUtil: File auxiliary utility

// Part of FileUtil class
/** Validate filename validity **/
public static boolean isValidFileName(String fileName) {
    // Regular expression that allows alphabets, numbers, Korean, Chinese, Japanese, parentheses, brackets, braces, hyphens, underscores, periods, spaces
    // and excludes characters that cannot be used in Windows filenames (\ / : * ? " < > |)
    final String FILE_NAME_PATTERN = "^[\w\-.()\[\]{} 가-힣一-鿿぀-ゟ゠-ヿ]+$";
    final Pattern pattern = Pattern.compile(FILE_NAME_PATTERN);
    if (fileName == null || fileName.trim().isEmpty()) {
        return false;
    }
    Matcher matcher = pattern.matcher(fileName);
    return matcher.matches();
}

4.5.2 Image Processing

Provides specialized processing functionality for image files.

Main Features

• Image resizing
• Thumbnail generation
• Image watermark
• Image optimization
• Image gallery

Main Classes

• humanframe.backoffice.service.FileService: File management service
• humanframe.backoffice.util.ImageProcess: Image download utility
• net.coobird.thumbnailator.Thumbnails: Thumbnail generation library

public void creatFileInfo(
        Map<String, MultipartFile> fileMap
        , int upperNo
        , String srvcId
        , Map<String,Object> reqMap) throws Exception {
    // ... (Omitted)
    for (Map.Entry<String, MultipartFile> entity : fileMap.entrySet()) {
        try {
            if ((EgovStringUtil.equals("jpg", fileExtsn)
                    || EgovStringUtil.equals("gif", fileExtsn)
                    || EgovStringUtil.equals("png", fileExtsn)
                    || EgovStringUtil.equals("bmp", fileExtsn))) {
                Thumbnails.of(tempFile).size(StaticValues.SMALL_THUMB_SIZE_X, StaticValues.SMALL_THUMB_SIZE_Y)
                        .toFile(new File(WebUtil.filePathReplaceAll(filePath + "/"+ srvcId +"/" + toDay + "/" + StaticValues.SMALL_THUMB_PREFIX+"_"+ newFileName)));
                Thumbnails.of(tempFile).size(StaticValues.MEDIUM_THUMB_SIZE_X, StaticValues.MEDIUM_THUMB_SIZE_Y)
                        .toFile(new File(WebUtil.filePathReplaceAll(filePath + "/"+ srvcId +"/" + toDay + "/" + StaticValues.MEDIUM_THUMB_PREFIX+"_"+ newFileName)));
                Thumbnails.of(tempFile).size(StaticValues.LARGE_THUMB_SIZE_X, StaticValues.LARGE_THUMB_SIZE_Y)
                        .toFile(new File(WebUtil.filePathReplaceAll(filePath + "/"+ srvcId +"/" + toDay + "/" + StaticValues.LARGE_THUMB_PREFIX+"_"+ newFileName)));
            }
        }
        // ... (Omitted)
    }
    // ... (Omitted)
}

4.5.3 Media Management

Provides functionality to manage various media files such as images and videos.

Main Features

• Media file upload
• Media metadata management
• Media player integration
• Streaming service integration

Main Classes

• humanframe.backoffice.controller.media.AdminMediaController: Media management controller
• humanframe.backoffice.service.MediaService: Media management service
• humanframe.backoffice.dao.MediaDAO: Media management DAO
• humanframe.backoffice.vo.MediaVO: Media VO