LSCable CMS V2 프로젝트 분석 문서

문서 요약

1. 프로젝트 개요

기본 정보

프로젝트 설명

기술 스택

2. 프로젝트 구조

LSCable CMS V2/
├── src/
│ ├── main/
│ │ ├── java/com/i52soft/lscable/cms/
│ │ │ ├── App.java # 메인 애플리케이션
│ │ │ ├── config/ # 설정
│ │ │ │ ├── SecurityConfig.java # 보안 설정
│ │ │ │ ├── WebConfig.java # 웹 설정
│ │ │ │ ├── WebSocketConfig.java # 웹소켓 설정
│ │ │ │ ├── ThymeleafConfig.java # 템플릿 설정
│ │ │ │ └── MyTomcatEmbeddedServletContainerFactory.java
│ │ │ ├── controller/ # 컨트롤러
│ │ │ │ ├── AdminController.java # 관리자 컨트롤러
│ │ │ │ ├── DefaultController.java # 기본 컨트롤러
│ │ │ │ ├── HTBackendRestController.java
│ │ │ │ ├── WebSocketController.java # 웹소켓
│ │ │ │ └── WidgetDataProviderRestController.java
│ │ │ ├── service/ # 서비스 인터페이스
│ │ │ │ ├── HTBackendService.java # 핵심 비즈니스 로직
│ │ │ │ ├── WidgetDataProviderService.java
│ │ │ │ └── impl/
│ │ │ │ ├── HTBackendServiceImpl.java
│ │ │ │ ├── LogInServiceImpl.java
│ │ │ │ └── WidgetDataProviderServiceImpl.java
│ │ │ ├── dao/ # 데이터 접근
│ │ │ │ ├── HTBackendDao.java
│ │ │ │ ├── LogInDao.java
│ │ │ │ └── WidgetDataProviderDao.java
│ │ │ ├── domain/ # 도메인 객체
│ │ │ │ ├── UserVO.java # 일반 사용자
│ │ │ │ ├── SystemUserVO.java # 시스템 관리자
│ │ │ │ ├── EndUserVO.java # 최종 사용자
│ │ │ │ ├── ProductVO.java # 제품
│ │ │ │ ├── NetworkVO.java # 네트워크 세그먼트
│ │ │ │ ├── IPAddressVO.java # IP 주소
│ │ │ │ ├── CMSSiteVO.java # CMS 사이트
│ │ │ │ ├── RegionVO.java # 지역
│ │ │ │ ├── EntityVO.java # 물리적 엔티티
│ │ │ │ ├── InterfaceVO.java # 네트워크 인터페이스
│ │ │ │ ├── SiteTreeVO.java # 사이트 트리
│ │ │ │ ├── SiteTreeNodeVO.java
│ │ │ │ ├── LinkageConnectionVO.java # 연결 정보
│ │ │ │ ├── ConnectorVO.java
│ │ │ │ ├── ConnectionVO.java
│ │ │ │ ├── MainPageLayoutVO.java # 대시보드 레이아웃
│ │ │ │ ├── MainPageWidgetVO.java # 대시보드 위젯
│ │ │ │ ├── MapWidgetVO.java # 맵 위젯
│ │ │ │ ├── ChartWidgetVO.java # 차트 위젯
│ │ │ │ ├── WidgetParam.java
│ │ │ │ ├── MapParam.java
│ │ │ │ ├── DeviceParam.java
│ │ │ │ ├── NetworkSwitchVO.java # 네트워크 스위치
│ │ │ │ ├── PPInvalidVO.java
│ │ │ │ ├── SampleWidgetVO.java
│ │ │ │ ├── SampleWidgetVO2.java
│ │ │ │ ├── SiteTreePlacementVO.java
│ │ │ │ ├── SiteTreeRackspacePositionVO.java
│ │ │ │ ├── device.java
│ │ │ │ ├── deviceInfo.java
│ │ │ │ ├── regions.java
│ │ │ │ └── regionInfo.java
│ │ │ └── common/ # 공통 유틸리티
│ │ │ ├── CmsAuthenticationProvider.java # 인증 제공자
│ │ │ ├── KeyUtil.java # 키 유틸
│ │ │ ├── PemFile.java # PEM 파일 처리
│ │ │ ├── IPAddress.java # IP 주소 처리
│ │ │ ├── SimpleCORSFilter.java # CORS 필터
│ │ │ └── CmsACLHandler.java # ACL 핸들러
│ │ └── resources/
│ │ ├── application.properties # 스프링 부트 설정
│ │ ├── application.yml
│ │ ├── database.properties # DB 연결 설정
│ │ ├── data.sql # 초기 데이터
│ │ ├── db_reset_sql.txt # DB 리셋 SQL
│ │ ├── LicensedMac # 라이선스 MAC 주소
│ │ ├── logback-spring.xml # 로깅 설정
│ │ ├── templates/ # Thymeleaf 템플릿
│ │ │ ├── login.html # 로그인 페이지
│ │ │ ├── layout/ # 레이아웃 템플릿
│ │ │ │ ├── default.html ~ default8.html
│ │ │ │ └── public.html
│ │ │ ├── cms/ # CMS 모듈 (원본 테마)
│ │ │ │ ├── index.html, view.html, new.html
│ │ │ │ ├── modifySite.html, setting.html
│ │ │ │ ├── siteset.html, adminAuth.html
│ │ │ │ ├── catalog.html, regions.html
│ │ │ │ ├── manufacturer.html, linkage.html
│ │ │ │ └── adminSearch.html, adminPortUsage.html
│ │ │ ├── cms2/ # CMS 모듈 (v2 테마)
│ │ │ ├── setting/ # 설정 모듈 (원본)
│ │ │ │ ├── main.html, view.html
│ │ │ │ ├── new.html, modify.html
│ │ │ │ ├── system.html, adminsysuser.html
│ │ │ │ ├── map-list.html
│ │ │ │ └── manage-widget-*.html # 위젯 관리
│ │ │ ├── setting2/ # 설정 모듈 (v2)
│ │ │ ├── ipam/ # IPAM 모듈 (원본)
│ │ │ │ ├── user.html, setting.html
│ │ │ ├── ipam2/ # IPAM 모듈 (v2)
│ │ │ │ ├── index.html, user.html
│ │ │ │ ├── setting.html, terminalUser.html
│ │ │ │ ├── terminalList.html, adminNetwork.html
│ │ │ ├── main-widgetMap.html
│ │ │ └── pace.html
│ │ └── themes/
│ │ ├── bright.properties # 밝은 테마
│ │ └── dark.properties # 어두운 테마
│ └── test/
│ └── java/
│ └── com/mysample/
│ └── AppTest.java
├── target/
│ ├── LSCableCMS-2.0.jar # 빌드된 JAR
│ ├── config.properties # 실행 설정
│ ├── startCMS.bat / startCMS.sh # 시작 스크립트
│ └── stopCMS.bat / stopCMS.sh # 중지 스크립트
├── doc/ # Javadoc 문서
├── pom.xml # Maven 설정
├── .classpath
└── .project

3. 모듈 설명

3.1 컨트롤러 계층

AdminController.java

HTBackendRestController.java

WidgetDataProviderRestController.java

WebSocketController.java

DefaultController.java

3.2 서비스 계층

HTBackendService (인터페이스 + 구현)

WidgetDataProviderService

3.3 도메인 객체

3.4 보안

4. API 엔드포인트

인증

관리자 - 설정

관리자 - CMS

관리자 - IPAM

5. 데이터베이스 설정

커넥션 풀

ORM

6. 빌드 및 배포

빌드

mvn clean package

실행

# Windows
target\startCMS.bat
# Linux
sh target/startCMS.sh

중지

# Windows
target\stopCMS.bat
# Linux
sh target/stopCMS.sh

7. 주요 기능

핵심 기능

8. 설정 파일

application.properties

database.properties

config.properties

LicensedMac

9. 의존성 요약

10. 참고 사항