프레젠테이션 Admin Manual
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 46
2018-11-23
일자 버전 변경 내용 작성자 비고
2018/11/26 0.1.0 최초 작성 최희진
2018/11/29 0.1.1 GS 인증에 버전으로 수정 최희진
2018/11/30 0.1.2 세부 내용 추가 최희진
01 개발환경 다운로드
02 소스 다운로드 및설정
03 데이터베이스 설정
04 실행하기
05 관리자 환경 설정
06 데이터 등록
5
mago3D 관리자 매뉴얼
Install
1. 개발환경 다운로드
•Java
java jdk-8u161 (8버전 설치)
시스템 변수 추가 → Path) C:\Program Files\Java\jdk1.8.0_161\bin
•eclipse
eclipse Oxygen(neon버전 이상 설치)
IntelliJ IDEA 에서 InternalResourceViewResolver 에서 jsp 찾지 못하는 치명적 버그 있음
•PostgreSQL
PostgreSQL 9.6 or 최신버전
설치경로 C:/PostgreSQL → mago3d-core/src/doc/database/dbinit.bat 에서 설치 경로와 일치
•PostGIS
PostGIS 2.4 or 최신 버전
설치경로 C:/PostGIS
6
mago3D 관리자 매뉴얼
Install
1. 개발환경 다운로드
•gradle
설치경로 C:/gradle
시스템 변수 추가 → Path) C:\gradle\gradle-4.1
eclipse BuildShip Gradle Plugin을 이용하여 gradle을 사용할 수 있습니다.
•lombok
설치한 뒤에 다운로드 폴더 이동 후실행
eclipse 설치 위치 [Specify location..]를 검색해서 'eclipse.exe' 파일을 선택합니다.
install/update 클릭합니다.
•Git
git hub에있는 mago3D 소스를 git을통해 다운 받습니다.
•웹 브라우저
웹 브라우저로는 Chrome 최신 버전을 권장합니다.
8
mago3D 관리자 매뉴얼
mago3D 프로젝트 Import
2. 소스 다운로드 및 설정
•이클립스에 프로젝트를 Import 합니다.
•File > Import → Gradle →Existing Gradle Project 를 클릭합니다.
•다운받은 소스가 있는 경로를 지정해 줍니다.
9
mago3D 관리자 매뉴얼
디렉토리 구조
2. 소스 다운로드 및 설정
•mago3D의 디렉토리 구조는 다음과 같습니다.
mago3D 관리자
mago3D Database 관리
mago3D 사용자
3D Data Symbolic Link
10
mago3D 관리자 매뉴얼
Database 생성
3. 데이터베이스 설정
•PostgreSQL을 실행하고 Database를 생성합니다.
11
mago3D 관리자 매뉴얼
PostgreSQL Extensions
3. 데이터베이스 설정
•공간 정보를 다루기 위해PostgreSQL Extensions PostGIS 를 실시합니다.
•SQL 실행창을 클릭하여 CREATE EXTENTION postgis; 를 입력합니다.
13
mago3D 관리자 매뉴얼
Database 배치 파일
3. 데이터베이스 설정
PostgreSQL이 설치된 경로
Database 명
14
mago3D 관리자 매뉴얼
Database Schema 생성
3. 데이터베이스 설정
•mago3d-core/src /doc/database/ddl 에 있는 파일을 실행합니다.
•mago3d-core/src /doc/database/ddl/sequence 에있는 파일을 실행합니다.
•mago3d-core/src /doc/database/index 에 있는 파일을 실행합니다.
•mago3d-core/src /doc/database/trigger 에 있는 파일을 실행합니다.
15
mago3D 관리자 매뉴얼
Database 초기 데이터 생성
3. 데이터베이스 설정
•mago3d-core/src /doc/database/dml 에 있는 파일을 실행합니다.
16
mago3D 관리자 매뉴얼
IDE 실행 및 Import
5. 실행하기
•mago3d-admin/src/main/java에서 Mago3dAdminApplication을 실행
•mago3dAdminApplication 우클릭 -> Run As -> Spring Boot App 클릭
•Spring Boot가 실행되는 것을 확인
Click
Click
Right Click
17
mago3D 관리자 매뉴얼
mago3D 관리자를 로컬에서 실행
4. 실행하기
•Spring Boot가 실행되면 콘솔창에서 로그를 확인
18
mago3D 관리자 매뉴얼
mago3D 관리자 환경 설정
5. 관리자 환경 설정
•가나다
19
mago3D 관리자 매뉴얼
샘플 데이터 서비스 디렉토리 지정
6. 데이터 등록
•가나다
20
mago3D 관리자 매뉴얼
샘플 데이터
6. 데이터 등록
•가나다
01 로그인
02 대시보드
03 환경 설정
04 사용자 관리
05 데이터 관리
24
mago3D 관리자 매뉴얼
1. 로그인
mago3D 로그인 사용자 등록
•슈퍼 관리자 등록
mago3d-core / src / doc / database / ko / database / dml
•비밀번호, salt 암호화
mago3d-admin / src / test / java / com / gaia3d / PasswordTest.java
25
mago3D 관리자 매뉴얼
2. 대시보드
메인 화면 대시보드
•프로젝트별 데이터 현황, 데이터 상태별 현황, 데이터 변경 요청 이력, 사용자 상태별 현황, DB
Connection Pool 현황 등을 시각화하여chart로 표시합니다.
mago3D 관리자 매뉴얼
26
운영정책 -(1) 사용자
3. 환경 설정
•사용자 등록, 로그인 시에 필요한 정책을 설정합니다.
번호 설명
①사용자 아이디 최소 길이를 지정합니다.
②
로그인 실패 횟수를 초과하면 사용자 상태
가‘잠금＇으로 변경됩니다.
-0:사용중
-1:사용중지(관리자)
-2:잠금(비밀번호 실패 횟수 초과)
-3:휴면(로그인 기간)
-4:만료(사용기간 종료)
-5:삭제(논리적)
-6:임시비밀번호
③로그인 실패 잠금 해제 기간을 설정합니다.
④마지막 로그인으로부터 잠금 시간을 설정
합니다.
⑤중복 로그인 사용 유무를 설정합니다.
⑥정보 삭제 방법을 지정합니다.
- 0: 논리적 삭제
- 1: 물리적 DB 삭제
①
②
③
④
⑤
⑥
기능 설명
mago3D 관리자 매뉴얼
27
운영정책 -(2) 비밀번호
3. 환경 설정
•사용자의 비밀번호 정책을 설정합니다.
번호 설명
①비밀번호의 변경 주기를 설정합니다.
②비밀번호의 최소 길이를 설정합니다.
③비밀번호의 최대 길이를 설정합니다.
④비밀번호의 영어 대문자 개수를 설정합니
다.
⑤비밀번호의 영어 소문자 개수를 설정합니
다.
⑥비밀번호의 숫자 개수를 설정합니다.
⑦비밀번호의 특수문자 개수를 설정합니다.
⑧비밀번호의 연속 문자 제한 개수를 설정합
니다.
⑨사용자 등록 시 초기 패스워드 생성 방법을
설정합니다.
⑩초기 패스워드를 생성할 때사용되는 기본
문자열을 설정합니다.
⑪패스워드에 사용 불가능한 문자 설정합니
다.
①
②
③
④
⑤
⑥
⑦
⑧
⑨
⑩
기능 설명
⑪
mago3D 관리자 매뉴얼
28
운영정책 -(3) 공간정보
3. 환경 설정
•프로젝트 시작 시 로딩 할 프로젝트 및 초기 카레라의 이동 위치,
LOD(Level of Detail) 등의 공간정보 정책을 설정합니다 .번호 설명
①기본 Globe Engine을 선택합니다.
- World Wind Web, Cesium
②3D 샘플 데이터의 root 디렉토리를 지정합
니다.
③웹 브라우저로 처음 접속할 때 해당 프로젝
트로 이동합니다.
④
자동승인으로 설정하면 데이터 변경 요청
시 변경사항이 즉시 반영되고, 결재로 설정
하면 데이터 변경 요청을 확인 후 결재 받은
뒤에 변경사항이 반영됩니다.
⑤
초기 카메라 이동 유무를 사용하면 웹 브라
우저로 초기 접속 시 해당 위치로 화면이 이
동합니다.보통 시작시 로딩 프로젝트와 동
일하게 지정합니다.
⑥초기 카메라 이동 위도를 설정합니다.
⑦초기 카메라 이동 경도를 설정합니다.
⑧초기 카메라 이동 높이를 설정합니다.
⑨초기 카메라 이동 시간을 설정합니다.
⑩카메라 위치와 오브젝트 거리값을 지정하
여LOD를조절합니다. LOD 레벨이 낮을수
록 정밀한 데이터를 표시합니다.
①
②
③
④
⑤
⑥
⑦
⑧
⑨
⑩
기능 설명
mago3D 관리자 매뉴얼
29
운영정책 -(4) Callback
3. 환경 설정
•API처리 결과, 데이터 정보, 클릭 지점의 위치 등을 설정합니다.
번호 설명
①callback 사용 유무를 설정합니다.
②API 처리 결과에 대한 callback을 지정합니다
.
③DATA 정보 표시에 대한 callback을 지정합니
다.
④Moved Dat에대한callback을 지정합니다.
⑤Objecet Select에 대한 callback을 지정합니
다.
⑥Mouse Click 위치에 대한 callback을 지정합
니다.
①
②
③
④
⑤
⑥
기능 설명
mago3D 관리자 매뉴얼
30
운영정책 -(5) 컨텐트
3. 환경 설정
•캐시 버전, 메인 화면 갱신, 최상위 그룹명 등을 설정합니다.
번호 설명
①Cache version을 갱신합니다.
②메인 화면에 표시될 위젯의 개수를 지정합
니다.
③메인 화면의 갱신 간격을 설정합니다.
④메뉴 그룹의 최상위 그룹명을 지정합니다.
⑤사용자 그룹의 최상위 그룹명을 지정합니다
.
⑥서버 그룹의 최상위 그룹명을 지정합니다.
⑦데이터 그룹의 최상위 그룹명을 지정합니다
.
①
②
③
④
⑤
⑥
기능 설명
⑦
mago3D 관리자 매뉴얼
31
운영정책 -(6) 사용자 업로딩 파일
3. 환경 설정
•파일 업로드 가능한 확장자, 파일 크기 등을 설정합니다.
①
②
③
기능 설명
번호 설명
①업로드 가능한 파일의 확장자를 지정합니
다.
②업로드 가능한 파일의 최대 사이즈를 지정
합니다.
③1회에 한번에 업로드 가능한 파일의 개수를
지정합니다.
32
mago3D 관리자 매뉴얼
3. 환경 설정
메뉴설정
•메뉴를 추가하거나, 삭제, 이동하여 구성할 수 있습니다.
33
mago3D 관리자 매뉴얼
3. 환경 설정
위젯 설정
•메인 화면의 대시보드에 표시할 위젯을 설정합니다.
-프로젝트 데이터 현황 , 데이터 상태별 현황, 데이터 변경 요청 이력, 사용자 상태별 현황, 사용자 추적, 최근 이슈, 스케줄
실행 이력 ,DB Connection Pool 현황, DB 세션 현황
34
mago3D 관리자 매뉴얼
3. 환경 설정
권한 설정
•데이터 접근 권한, 페이지 접근 권한 등을 설정하여 권한에 따라 사용자의 접근과 역할을 관리할
수 있습니다 .
35
mago3D 관리자 매뉴얼
4. 사용자 관리
사용자 그룹 관리
•사용자를 등록하고 그룹별로 권한을 부여할 수 있습니다. 사용자 그룹은 상위 그룹과 하위 그룹의
트리 형태로 보여지며 추가, 삭제, 이동할수있습니다. 사용자 권한은 해당 역할이 사용자 그룹에
존재하는지 판단합니다.
36
mago3D 관리자 매뉴얼
4. 사용자 관리
사용자 그룹 관리
•사용자를 등록하여 그룹별로 권한을 부여할 수 있습니다. 등록된 사용자는 권한별로 데이터에 접근
하여 데이터를 조작하거나 수정을 요청 할 수 있습니다.
[권한 관리]
[사용자 관리]
37
mago3D 관리자 매뉴얼
4. 사용자 관리
사용자 등록
•사용자 그룹에서 사용자를 추가, 수정, 삭제하여 관리할 수 있습니다.
38
mago3D 관리자 매뉴얼
4. 사용자 관리
사용자 목록
•등록된 사용자의 정보 및 상태를 조회하고 검색할 수 있습니다.
39
mago3D 관리자 매뉴얼
5. 데이터 관리
프로젝트 목록
•등록한 프로젝트 목록과 상세 정보를 확인합니다.
프로젝트 초기 이동 위치
40
mago3D 관리자 매뉴얼
5. 데이터 관리
프로젝트 등록
•등록한 프로젝트 목록과 상세 정보를 확인합니다.
41
mago3D 관리자 매뉴얼
5. 데이터 관리
데이터 등록
•상위 프로젝트를 지정하여 데이터를 등록 할 수 있습니다. 데이터의 key 값은 해당 프로젝트의
‘F4D_’ 이하의 폴더명과 같은 이름으로 등록해 줍니다.
42
mago3D 관리자 매뉴얼
5. 데이터 관리
데이터 일괄 등록
•json파일이 있다면 데이터를 해당 프로젝트에 일괄 등록할 수 있습니다.
43
mago3D 관리자 매뉴얼
5. 데이터 관리
데이터 목록
•등록한 데이터 목록과 상세 정보를 확인합니다. 프로젝트명, 데이터명, 등록일로 데이터를 검색하거
나 정렬할 수 있습니다.
44
mago3D 관리자 매뉴얼
5. 데이터 관리
데이터 변경 이력
•사용자가 데이터 속성에 대한 변경을 요청하면 관리자가 확인 후 승인 혹은 반려 할 수 있습니다.
Address 서울시 금천구 벚꽃로 278 702호
Phone 02-3397-3475
Fax 02-3397-3478
Email info@gaia3d.com
천정대 jdcheon@gaia3d.com
최희진 hjchoi@gaia3d.com
