4-1. 🏗️ Үндсэн функц үндсэн бүтэц

4.1 Төслийн эх кодын бүтэц

HONGIKINGAN CMS нь хоёр гол модулиас бүрдэнэ.

4.2 Нөөцийн бүтэц

4.2.1 Spring Context тохиргооны файл

HONGIKINGAN CMS нь олон төрлийн Spring Context тохиргооны файлаар дамжуулан системийн үйл ажиллагааг тодорхойлдог.

4.2.2 Веб апп-ын бүтэц

Веб аппликейшн нь дараах үндсэн лавлахуудаас бүрдэнэ:

4.3 Хэрэглэгчийн удирдлага

4.3.1 Баталгаажуулалт болон эрхийн удирдлага

HONGIKINGAN CMS нь хэрэглэгчийн баталгаажуулалт болон эрхийн удирдлагад зориулж Spring Security болон өөрөө хөгжүүлсэн эрхийн удирдлагын системийг хамтад ашигладаг.

Үндсэн функц

• Хэрэглэгчийн нэвтрэх/гарах
• Эрхийн бүлгийн удирдлага
• Цэс тус бүрийн хандалтын эрх тохируулах
• Самбар тус бүрийн эрх тохируулах
• IP суурьтай хандалтын хяналт

Эрхийн удирдлагын бүтэц

Үндсэн класс

• humanframe.backoffice.interceptor.CMSAdminInterceptor: Админ эрх шалгах
• humanframe.backoffice.aop.aspect.admin.AdminBbsAspect: Эрх шалгах AOP
• humanframe.backoffice.aop.aspect.admin.AdminPrivacyAspect: Хувийн мэдээлэлд хандах шалгах AOP

// [Кодын байршил] humanframe.backoffice.aop.aspect.admin.AdminBbsAspect
@Aspect
@Order(1)
@Component
public class AdminBbsAspect {

    // Админ эрх шалгах
    @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 {
        // ... дунд хэсэг орхигдсон (эрх шалгах логик) ...
    }
}

4.3.2 Сэшний удирдлага

HONGIKINGAN CMS нь хэрэглэгч болон админ сэшнийг тусад нь удирдаж, сэшний хугацаа дуусах, зэрэг нэвтрэх хяналт зэрэг функцийг өгдөг.

Үндсэн функц

• Сэшн үүсгэх болон удирдах
• Сэшний хугацаа дуусах тохиргоо
• Зэрэг нэвтрэх хяналт
• Сэшний мэдээлэл шифрлэх

Үндсэн класс

• humanframe.backoffice.session.MngrSession: Админ сэшний класс
• humanframe.backoffice.session.MberSession: Хэрэглэгчийн сэшний класс

// [Кодын байршил] 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
    
    // Сэшний мэдээлэл тохируулах болон харах арга
    // ...
}

4.3.3 Хэрэглэгчийн мэдээллийн удирдлага

Хэрэглэгчийн мэдээллийн удирдлага нь гишүүнчлэл, мэдээлэл засах, гарах зэрэг функцийг агуулна.

Үндсэн функц

• Гишүүнчлэл/засах/гарах
• Нууц үг шифрлэх
• Имэйл/SMS баталгаажуулалт
• Нийгмийн нэвтрэх холбох
• Хувийн мэдээлэл хамгаалах функц

Үндсэн класс

• humanframe.backoffice.controller.mber.AdminMberController: Гишүүн удирдлагын контроллер
• humanframe.backoffice.service.MberService: Гишүүн удирдлагын сервис
• humanframe.backoffice.dao.MberDAO: Гишүүн удирдлагын DAO

4.4 Контентийн удирдлага

4.4.1 Цэсний удирдлага

HONGIKINGAN CMS нь вебсайтын цэсний бүтцийг үр ашигтай удирдах боломжийг олгодог.

Үндсэн функц

• Давхаргат цэсний бүтэц удирдах
• Цэсний дараалал өөрчлөх
• Цэс тус бүрийн эрх тохируулах
• Цэс идэвхжүүлэх/идэвхгүй болгох
• Цэсний статистик удирдах

Үндсэн класс

• humanframe.backoffice.controller.mng.AdminMngMenuController: Цэс удирдлагын контроллер
• humanframe.backoffice.service.MngMenuService: Цэс удирдлагын сервис
• humanframe.backoffice.dao.MngMenuDAO: Цэс удирдлагын DAO

4.4.2 Сайт/Цэс тараах систем

HONGIKINGAN CMS нь админ хуудас дээрх сайт болон цэсний өөрчлөлт хэрэглэгчийн хуудсанд шууд тусгагдахгүй, харин 'тараалт (Publication)' үйл явцаар дамжуулан тусгагддаг бүтэцтэй. Энэ нь админ өөрчлөлтийг хянаж, баталгаажуулсны дараа бодит хэрэглэгчийн хуудсанд хэрэглэх боломжийг олгодог аюулгүй байдлын арга юм.

Хүснэгтийн харилцаа

1. TN_SITE ↔ TN_PBLCATE_SITE
   • TN_SITE: Админ засварладаг сайтын мэдээллийн хүснэгт
   • TN_PBLCATE_SITE: Тараасны дараа хэрэглэгчид бодитоор харагдах сайтын мэдээллийн хүснэгт
2. TN_SITE_MENU ↔ TN_PBLCATE_SITE_MENU
   • TN_SITE_MENU: Админ засварладаг цэсний мэдээллийн хүснэгт
   • TN_PBLCATE_SITE_MENU: Тараасны дараа хэрэглэгчид бодитоор харагдах цэсний мэдээллийн хүснэгт

Тараах үйл явц

Тараах системийн давуу тал

4.4.3 Самбарын удирдлага

Төрөл бүрийн самбар үүсгэж удирдах боломжийг олгодог.

Самбарын төрөл

Үндсэн функц

• Самбар үүсгэх/засах/устгах
• Нийтлэл удирдах
• Сэтгэгдэл удирдах
• Хавсралт файл удирдах
• Самбар тус бүрийн эрх тохируулах
• Нийтлэл хайх болон шүүх

Үндсэн класс

• humanframe.backoffice.controller.bbs.AdminBbsController: Самбар удирдлагын контроллер
• humanframe.backoffice.controller.bbs.AdminBbsSettingController: Самбар тохиргооны контроллер
• humanframe.backoffice.controller.bbs.AdminBbsType1Controller: Ерөнхий самбарын контроллер
• humanframe.backoffice.service.BbsSettingService: Самбар удирдлагын сервис
• humanframe.backoffice.dao.BbsSettingDAO: Самбар тохиргооны DAO
• humanframe.backoffice.dao.BbsTypeDAO: Самбарын төрөл бүрийн DAO

// [Кодын байршил] humanframe.backoffice.service.BbsSettingService
@SuppressWarnings("rawtypes")
public interface BbsSettingService {
    
    /**
     * Самбарын жагсаалтыг харах.
     * 
     * @param listVO хайлтын нөхцөл
     * @return самбарын жагсаалт
     */
    public HumanListVO boardListVo(HumanListVO listVO) throws Exception;
    
    /**
     * Самбарын мэдээллийг харах.
     * 
     * @param bbsNo самбарын дугаар
     * @return самбарын мэдээлэл
     */
    public BbsSettingVO retrieveBoardSetting(int bbsNo) throws Exception;
    
    // ... бусад арга
}

4.4.4 Контентийн удирдлага

Хуудас бүрдүүлэх контентийг удирдах боломжийг олгодог.

Үндсэн функц

• Контент үүсгэх/засах/устгах
• Загвар суурьтай хуудас удирдах
• HTML засварлагч дэмжих
• SEO оновчлолын тохиргоо
• Контент урьдчилан харах
• Контентийн хувилбар удирдах

Үндсэн класс

• humanframe.backoffice.controller.cntnts.AdminCntntsController: Контент удирдлагын контроллер
• humanframe.backoffice.service.CntntsService: Контент удирдлагын сервис
• humanframe.backoffice.dao.CntntsDAO: Контент удирдлагын DAO
• humanframe.backoffice.vo.CntntsVO: Контентийн VO

4.5 Файл болон медиа удирдлага

4.5.1 Файл оруулах/татах

HONGIKINGAN CMS нь төрөл бүрийн файлын оруулах болон татахыг аюулгүй боловсруулах функцийг олгодог.

Үндсэн функц

• Олон файл оруулах
• Файлын төрөл хязгаарлах
• Файлын хэмжээ хязгаарлах
• Файл шифрлэх
• Татах эрхийн удирдлага
• Татах статистик

Файл оруулах боловсруулалтын урсгал

Үндсэн класс

• humanframe.backoffice.controller.media.AdminMediaController: Медиа удирдлагын контроллер
• humanframe.backoffice.service.FileService: Файл удирдлагын сервис
• humanframe.backoffice.util.FileDownload: Файл татах утилит
• humanframe.backoffice.util.FileUtil: Файл туслах утилит

// FileUtil классын хэсэг
/** Файлын нэрийн зөв эсэх шалгах **/
public static boolean isValidFileName(String fileName) {
    // Үсэг, тоо, монгол, хятад, япон үсэг, хаалт, дөрвөлжин хаалт, бүдүүн хаалт, зураас, доогуур зураас, цэг, хоосон зайг зөвшөөрч
    // Windows-д файлын нэрэнд ашиглах боломжгүй тэмдэгт (\ / : * ? " < > |)-ийг хасан тогтмол илэрхийлэл
    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 Зураг боловсруулах

Зургийн файлд зориулсан тусгай боловсруулалтын функцийг олгодог.

Үндсэн функц

• Зургийн хэмжээ өөрчлөх
• Жижиг зураг үүсгэх
• Зургийн усны тэмдэг
• Зураг оновчлох
• Зургийн цомог

Үндсэн класс

• humanframe.backoffice.service.FileService: Файл удирдлагын сервис
• humanframe.backoffice.util.ImageProcess: Зураг татах утилит
• net.coobird.thumbnailator.Thumbnails: Жижиг зураг үүсгэх номын сан

public void creatFileInfo(
        Map<String, MultipartFile> fileMap
        , int upperNo
        , String srvcId
        , Map<String,Object> reqMap) throws Exception {
    // ... (дунд хэсэг орхигдсон)
    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)));
            }
        }
        // ... (дунд хэсэг орхигдсон)
    }
    // ... (дунд хэсэг орхигдсон)
}

4.5.3 Медиа удирдлага

Зураг, видео зэрэг төрөл бүрийн медиа файлыг удирдах функцийг олгодог.

Үндсэн функц

• Медиа файл оруулах
• Медиа мета өгөгдөл удирдах
• Медиа тоглуулагч холбох
• Стрийминг үйлчилгээ холбох

Үндсэн класс

• humanframe.backoffice.controller.media.AdminMediaController: Медиа удирдлагын контроллер
• humanframe.backoffice.service.MediaService: Медиа удирдлагын сервис
• humanframe.backoffice.dao.MediaDAO: Медиа удирдлагын DAO
• humanframe.backoffice.vo.MediaVO: Медиа VO