Merge branch 'design' of http://172.30.1.50:3000/djb-eapim/eapim-portal into design
This commit is contained in:
hong
@@ -80,6 +80,21 @@ pipeline {
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// SBOM(CycloneDX) -> xlsx. 산출물 eapim-portal-sbom.xlsx 를 아티팩트로 보관.
|
||||
// 실패해도 배포는 진행하도록 UNSTABLE 로만 표시한다.
|
||||
stage('SBOM') {
|
||||
steps {
|
||||
catchError(buildResult: 'UNSTABLE', stageResult: 'FAILURE') {
|
||||
sh 'gradle sbomXlsx --no-daemon -Pprofile=weblogic'
|
||||
}
|
||||
}
|
||||
post {
|
||||
always {
|
||||
archiveArtifacts allowEmptyArchive: true, artifacts: 'build/reports/sbom/*.xlsx', fingerprint: true
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -101,5 +101,20 @@ pipeline {
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// SBOM(CycloneDX) -> xlsx. 산출물 eapim-portal-sbom.xlsx 를 아티팩트로 보관.
|
||||
// 실패해도 빌드는 진행하도록 UNSTABLE 로만 표시한다.
|
||||
stage('SBOM') {
|
||||
steps {
|
||||
catchError(buildResult: 'UNSTABLE', stageResult: 'FAILURE') {
|
||||
sh 'gradle sbomXlsx --no-daemon'
|
||||
}
|
||||
}
|
||||
post {
|
||||
always {
|
||||
archiveArtifacts allowEmptyArchive: true, artifacts: 'build/reports/sbom/*.xlsx', fingerprint: true
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -521,6 +521,7 @@ ls -lh src/main/resources/static/css/main.min.css # minified
|
||||
## 문서
|
||||
|
||||
- **개발환경 준비 사항**: [`djb-docs/개발환경-준비-사항.md`](djb-docs/개발환경-준비-사항.md) — JDK·Gradle·Node.js·SASS 설치 가이드
|
||||
- **메뉴 관리 개발 가이드**: [`readme-docs/메뉴-관리-개발-가이드.md`](readme-docs/메뉴-관리-개발-가이드.md) — menu.yml/roles.yml 스키마·시딩 규칙·캐시 리로드·admin 포탈메뉴관리 연동
|
||||
- **프로젝트 상세 지침**: `CLAUDE.md` (한글)
|
||||
- **사용자 가이드**: `개발자포탈.md` (한글)
|
||||
- **빌드 스크립트**: `build-gf63.sh`, `deploy_portal.sh`
|
||||
|
||||
+3
-1
@@ -203,4 +203,6 @@ task printSourceSets {
|
||||
println " Output dir : ${srcSet.output.classesDirs.asPath}"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
// CycloneDX SBOM -> xlsx 변환 (gradle sbomXlsx)
|
||||
apply from: "$projectDir/gradle/sbom-xlsx.gradle"
|
||||
|
||||
@@ -0,0 +1,326 @@
|
||||
/*
|
||||
* CycloneDX SBOM(bom.json) -> Excel(xlsx) 변환 태스크.
|
||||
*
|
||||
* gradle sbomXlsx # cyclonedxBom 실행 후 변환
|
||||
* gradle sbomXlsx -PsbomJson=path.json # 기존 bom.json 사용(cyclonedxBom 생략)
|
||||
* gradle sbomXlsx -PsbomOut=out.xlsx # 출력 경로 지정
|
||||
*
|
||||
* buildscript 블록이 이 스크립트에만 적용되므로 POI 의존성이 메인 빌드
|
||||
* classpath 나 WAR 산출물에는 포함되지 않는다.
|
||||
*
|
||||
* 시트: 요약 / WAR 기준
|
||||
* 산출 기준은 war 태스크의 classpath(= runtimeClasspath) 이므로
|
||||
* test·annotationProcessor·developmentOnly·compileOnly 의존은 모두 제외된다.
|
||||
* bom.json 은 라이선스/해시/설명/직접-전이 판별을 위한 메타 소스로만 쓴다.
|
||||
*/
|
||||
buildscript {
|
||||
repositories {
|
||||
maven {
|
||||
url "https://nexus.eactive.synology.me:8090/repository/maven-public/"
|
||||
allowInsecureProtocol = true
|
||||
}
|
||||
mavenCentral()
|
||||
}
|
||||
dependencies {
|
||||
classpath 'org.apache.poi:poi-ooxml:3.17'
|
||||
}
|
||||
}
|
||||
|
||||
import groovy.json.JsonSlurper
|
||||
import org.apache.poi.ss.usermodel.BorderStyle
|
||||
import org.apache.poi.ss.usermodel.FillPatternType
|
||||
import org.apache.poi.ss.usermodel.HorizontalAlignment
|
||||
import org.apache.poi.ss.usermodel.IndexedColors
|
||||
import org.apache.poi.ss.usermodel.VerticalAlignment
|
||||
import org.apache.poi.ss.util.CellRangeAddress
|
||||
import org.apache.poi.xssf.usermodel.XSSFWorkbook
|
||||
|
||||
// 엑셀 셀 문자열 상한(32767)보다 여유를 둔 절단 길이
|
||||
ext.SBOM_CELL_LIMIT = 32000
|
||||
|
||||
task sbomXlsx {
|
||||
group = 'sbom'
|
||||
description = 'CycloneDX bom.json 을 WAR 수록 기준 xlsx 로 변환한다'
|
||||
|
||||
// -PsbomJson 으로 기존 산출물을 지정하면 재생성하지 않는다
|
||||
if (!project.hasProperty('sbomJson')) {
|
||||
dependsOn 'cyclonedxBom'
|
||||
}
|
||||
|
||||
doLast {
|
||||
File src = resolveBomJson(project)
|
||||
File out = project.hasProperty('sbomOut')
|
||||
? project.file(project.property('sbomOut'))
|
||||
: new File(project.buildDir, "reports/sbom/${sbomFileName(project)}")
|
||||
out.parentFile.mkdirs()
|
||||
|
||||
def bom = new JsonSlurper().parse(src, 'UTF-8')
|
||||
def deploy = collectDeployJars(project)
|
||||
def warRows = joinWarRows(deploy.jars, indexComponents(bom))
|
||||
|
||||
def wb = new XSSFWorkbook()
|
||||
def st = createStyles(wb)
|
||||
writeSummarySheet(wb, st, bom, warRows, src, deploy.label)
|
||||
writeWarSheet(wb, st, warRows)
|
||||
|
||||
out.withOutputStream { os -> wb.write(os) }
|
||||
wb.close()
|
||||
|
||||
int unmatched = warRows.count { it.matched == 'N' }
|
||||
logger.lifecycle("SBOM xlsx 생성: ${out.absolutePath} " +
|
||||
"(배포 수록 ${warRows.size()}개, SBOM 미매칭 ${unmatched}개, 원본 ${src.name})")
|
||||
}
|
||||
}
|
||||
|
||||
/** 산출 파일명: 배포 패키지명 기준 (war 있으면 war 파일명, 없으면 project 이름[-버전]) */
|
||||
String sbomFileName(Project p) {
|
||||
def warTask = p.tasks.findByName('war')
|
||||
if (warTask != null) {
|
||||
String archive = warTask.archiveFileName.get()
|
||||
return archive.replaceAll(/\.(war|jar|ear)$/, '') + '-sbom.xlsx'
|
||||
}
|
||||
String ver = (p.version == null || p.version.toString() in ['', 'unspecified']) ? '' : "-${p.version}"
|
||||
return "${p.name}${ver}-sbom.xlsx"
|
||||
}
|
||||
|
||||
/** bom.json 위치 결정: -PsbomJson > cyclonedxBom 산출 경로 후보 */
|
||||
File resolveBomJson(Project p) {
|
||||
if (p.hasProperty('sbomJson')) {
|
||||
File f = p.file(p.property('sbomJson'))
|
||||
if (!f.exists()) {
|
||||
throw new GradleException("bom.json 없음: ${f.absolutePath}")
|
||||
}
|
||||
return f
|
||||
}
|
||||
def candidates = [
|
||||
new File(p.buildDir, 'reports/cyclonedx/bom.json'),
|
||||
new File(p.buildDir, 'reports/bom.json'),
|
||||
]
|
||||
File found = candidates.find { it.exists() }
|
||||
if (found == null) {
|
||||
throw new GradleException(
|
||||
"bom.json 을 찾지 못했다. 확인한 경로: " + candidates*.absolutePath.join(', ') +
|
||||
"\n'gradle cyclonedxBom' 실행 후 재시도하거나 -PsbomJson=<경로> 로 지정한다.")
|
||||
}
|
||||
return found
|
||||
}
|
||||
|
||||
/**
|
||||
* 실제 배포물에 packaging 되는 jar 목록.
|
||||
* war 프로젝트는 war 태스크 classpath(= runtimeClasspath), 그 외는 runtimeClasspath 를
|
||||
* 기준으로 하므로 test/annotationProcessor/developmentOnly/compileOnly 는 자동으로 빠진다.
|
||||
*
|
||||
* @return [label: 기준 설명, jars: 행 목록]
|
||||
*/
|
||||
Map collectDeployJars(Project p) {
|
||||
def cfg = p.configurations.findByName('runtimeClasspath')
|
||||
if (cfg == null) {
|
||||
p.logger.warn("[${p.name}] runtimeClasspath 가 없어 배포 기준 시트를 비운다")
|
||||
return [label: '(없음)', jars: []]
|
||||
}
|
||||
|
||||
def warTask = p.tasks.findByName('war')
|
||||
def files
|
||||
String label
|
||||
if (warTask != null) {
|
||||
files = warTask.classpath.files
|
||||
label = 'WAR WEB-INF/lib (war 태스크 classpath)'
|
||||
} else {
|
||||
files = cfg.files
|
||||
label = 'runtimeClasspath (war 태스크 없음)'
|
||||
}
|
||||
|
||||
def coordByFile = [:]
|
||||
cfg.resolvedConfiguration.resolvedArtifacts.each { a ->
|
||||
def id = a.moduleVersion.id
|
||||
coordByFile[a.file] = [group: id.group, name: id.name, version: id.version]
|
||||
}
|
||||
def jars = files.findAll { it.name.endsWith('.jar') }.collect { f ->
|
||||
def c = coordByFile[f]
|
||||
[
|
||||
file : f.name,
|
||||
group : c?.group ?: '',
|
||||
name : c?.name ?: f.name.replaceAll(/\.jar$/, ''),
|
||||
version: c?.version ?: '',
|
||||
coord : c ? "${c.group}:${c.name}:${c.version}".toString() : '',
|
||||
]
|
||||
}.sort { it.file }
|
||||
|
||||
return [label: label, jars: jars]
|
||||
}
|
||||
|
||||
/** bom.json 컴포넌트를 'group:name:version' 키로 색인 (라이선스/해시/설명/직접-전이) */
|
||||
Map indexComponents(bom) {
|
||||
String rootRef = bom.metadata?.component?.'bom-ref'
|
||||
Set directRefs = (bom.dependencies?.find { it.ref == rootRef }?.dependsOn ?: []) as Set
|
||||
|
||||
def index = [:]
|
||||
bom.components?.each { c ->
|
||||
def hashes = [:]
|
||||
c.hashes?.each { h -> hashes[h.alg] = h.content }
|
||||
|
||||
def licenses = (c.licenses ?: []).collect { l ->
|
||||
l.license?.id ?: l.license?.name ?: l.expression ?: ''
|
||||
}.findAll { it }
|
||||
|
||||
index["${c.group ?: ''}:${c.name ?: ''}:${c.version ?: ''}".toString()] = [
|
||||
direct : directRefs.contains(c.'bom-ref') ? '직접' : '전이',
|
||||
licenses : licenses.join('; '),
|
||||
licenseList: licenses.isEmpty() ? ['(미상)'] : licenses,
|
||||
purl : c.purl ?: '',
|
||||
sha256 : hashes['SHA-256'] ?: '',
|
||||
sha1 : hashes['SHA-1'] ?: '',
|
||||
description: c.description ?: '',
|
||||
]
|
||||
}
|
||||
return index
|
||||
}
|
||||
|
||||
/** WAR jar 목록에 SBOM 메타를 좌표로 결합 */
|
||||
List joinWarRows(List warJars, Map index) {
|
||||
def result = []
|
||||
warJars.eachWithIndex { j, i ->
|
||||
def m = j.coord ? index[j.coord] : null
|
||||
result << [
|
||||
no : i + 1,
|
||||
file : j.file,
|
||||
group : j.group,
|
||||
name : j.name,
|
||||
version : j.version,
|
||||
direct : m?.direct ?: '',
|
||||
licenses : m?.licenses ?: '',
|
||||
licenseList: m?.licenseList ?: ['(미상)'],
|
||||
purl : m?.purl ?: '',
|
||||
sha256 : m?.sha256 ?: '',
|
||||
sha1 : m?.sha1 ?: '',
|
||||
matched : (m != null) ? 'Y' : 'N',
|
||||
description: m?.description ?: '',
|
||||
]
|
||||
}
|
||||
return result
|
||||
}
|
||||
|
||||
Map createStyles(wb) {
|
||||
def headFont = wb.createFont()
|
||||
headFont.setBold(true)
|
||||
headFont.setColor(IndexedColors.WHITE.getIndex())
|
||||
|
||||
def head = wb.createCellStyle()
|
||||
head.setFont(headFont)
|
||||
head.setFillForegroundColor(IndexedColors.DARK_BLUE.getIndex())
|
||||
head.setFillPattern(FillPatternType.SOLID_FOREGROUND)
|
||||
head.setAlignment(HorizontalAlignment.CENTER)
|
||||
head.setVerticalAlignment(VerticalAlignment.CENTER)
|
||||
head.setBorderBottom(BorderStyle.THIN)
|
||||
|
||||
def body = wb.createCellStyle()
|
||||
body.setVerticalAlignment(VerticalAlignment.TOP)
|
||||
|
||||
def wrap = wb.createCellStyle()
|
||||
wrap.setVerticalAlignment(VerticalAlignment.TOP)
|
||||
wrap.setWrapText(true)
|
||||
|
||||
def labelFont = wb.createFont()
|
||||
labelFont.setBold(true)
|
||||
def label = wb.createCellStyle()
|
||||
label.setFont(labelFont)
|
||||
|
||||
return [head: head, body: body, wrap: wrap, label: label]
|
||||
}
|
||||
|
||||
/** 헤더 행 생성 + 폭 지정 + 틀고정 */
|
||||
def writeHeader(sheet, style, List<String> headers, List<Integer> widths) {
|
||||
def row = sheet.createRow(0)
|
||||
row.setHeightInPoints(20f)
|
||||
headers.eachWithIndex { h, i ->
|
||||
def cell = row.createCell(i)
|
||||
cell.setCellValue(h)
|
||||
cell.setCellStyle(style)
|
||||
sheet.setColumnWidth(i, widths[i] * 256)
|
||||
}
|
||||
sheet.createFreezePane(0, 1)
|
||||
}
|
||||
|
||||
def cellOf(row, int idx, value, style) {
|
||||
def cell = row.createCell(idx)
|
||||
String s = (value == null) ? '' : value.toString()
|
||||
if (s.length() > SBOM_CELL_LIMIT) {
|
||||
s = s.substring(0, SBOM_CELL_LIMIT) + '…(생략)'
|
||||
}
|
||||
cell.setCellValue(s)
|
||||
cell.setCellStyle(style)
|
||||
return cell
|
||||
}
|
||||
|
||||
def writeSummarySheet(wb, st, bom, List warRows, File src, String basisLabel) {
|
||||
def sheet = wb.createSheet('요약')
|
||||
def comp = bom.metadata?.component ?: [:]
|
||||
def tool = bom.metadata?.tools?.components?.getAt(0)
|
||||
Set licenseKinds = warRows.collectMany { it.licenseList } as Set
|
||||
|
||||
def items = [
|
||||
['대상 프로젝트', "${comp.group ?: ''}:${comp.name ?: ''}:${comp.version ?: ''}"],
|
||||
['산출 기준', "${basisLabel} — test/annotationProcessor/compileOnly 제외"],
|
||||
['BOM 포맷', "${bom.bomFormat ?: ''} ${bom.specVersion ?: ''}"],
|
||||
['serialNumber', bom.serialNumber ?: ''],
|
||||
['생성 시각', bom.metadata?.timestamp ?: ''],
|
||||
['생성 도구', tool ? "${tool.name} ${tool.version}" : ''],
|
||||
['원본 파일', src.absolutePath],
|
||||
['배포 수록 jar', warRows.size()],
|
||||
[' └ 직접 의존', warRows.count { it.direct == '직접' }],
|
||||
[' └ 전이 의존', warRows.count { it.direct == '전이' }],
|
||||
[' └ SBOM 미매칭', warRows.count { it.matched == 'N' }],
|
||||
['라이선스 종류', licenseKinds.size()],
|
||||
['라이선스 미상', warRows.count { it.licenses.isEmpty() }],
|
||||
]
|
||||
|
||||
writeHeader(sheet, st.head, ['항목', '값'], [30, 90])
|
||||
items.eachWithIndex { item, i ->
|
||||
def row = sheet.createRow(i + 1)
|
||||
cellOf(row, 0, item[0], st.label)
|
||||
cellOf(row, 1, item[1], st.body)
|
||||
}
|
||||
|
||||
// 라이선스 분포 (요약 하단)
|
||||
def byLicense = [:].withDefault { 0 }
|
||||
warRows.each { r -> r.licenseList.each { lic -> byLicense[lic] = byLicense[lic] + 1 } }
|
||||
def sorted = byLicense.entrySet().sort { a, b -> (b.value <=> a.value) ?: (a.key <=> b.key) }
|
||||
|
||||
int base = items.size() + 2
|
||||
def hdr = sheet.createRow(base)
|
||||
cellOf(hdr, 0, '라이선스', st.head)
|
||||
cellOf(hdr, 1, 'jar 수', st.head)
|
||||
sorted.eachWithIndex { e, i ->
|
||||
def row = sheet.createRow(base + 1 + i)
|
||||
cellOf(row, 0, e.key, st.body)
|
||||
cellOf(row, 1, e.value, st.body)
|
||||
}
|
||||
}
|
||||
|
||||
/** 실제 배포물(WAR WEB-INF/lib) 기준 시트 */
|
||||
def writeWarSheet(wb, st, List warRows) {
|
||||
def sheet = wb.createSheet('WAR 기준')
|
||||
def headers = ['No', 'jar 파일명', 'Group', 'Name', 'Version', '구분',
|
||||
'License', 'purl', 'SHA-256', 'SHA-1', 'SBOM매칭', 'Description']
|
||||
def widths = [6, 46, 32, 34, 16, 7, 30, 60, 40, 30, 10, 60]
|
||||
writeHeader(sheet, st.head, headers, widths)
|
||||
|
||||
warRows.eachWithIndex { r, i ->
|
||||
def row = sheet.createRow(i + 1)
|
||||
cellOf(row, 0, r.no, st.body)
|
||||
cellOf(row, 1, r.file, st.body)
|
||||
cellOf(row, 2, r.group, st.body)
|
||||
cellOf(row, 3, r.name, st.body)
|
||||
cellOf(row, 4, r.version, st.body)
|
||||
cellOf(row, 5, r.direct, st.body)
|
||||
cellOf(row, 6, r.licenses, st.body)
|
||||
cellOf(row, 7, r.purl, st.body)
|
||||
cellOf(row, 8, r.sha256, st.body)
|
||||
cellOf(row, 9, r.sha1, st.body)
|
||||
cellOf(row, 10, r.matched, st.body)
|
||||
cellOf(row, 11, r.description, st.wrap)
|
||||
}
|
||||
if (!warRows.isEmpty()) {
|
||||
sheet.setAutoFilter(new CellRangeAddress(0, warRows.size(), 0, headers.size() - 1))
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,85 @@
|
||||
# 메뉴 관리 개발 가이드
|
||||
|
||||
포탈 GNB/마이페이지 메뉴는 `menu.yml` → DB(PTL_MENU_*) → 캐시 → 템플릿 렌더 구조로 동작하며,
|
||||
노출/배치 관리는 eapim-admin **포탈메뉴관리**(파트너포탈 > 포탈관리 > 메뉴 관리)에서 수행한다.
|
||||
|
||||
## 구성 요소
|
||||
|
||||
| 구성 | 위치 | 역할 |
|
||||
|---|---|---|
|
||||
| `menu.yml` | `src/main/resources/menu.yml` | 기본 메뉴 정의 (id/노출명/path/권한/기본 배치) |
|
||||
| `roles.yml` | `src/main/resources/roles.yml` | 역할 정의 (`portal.portal_security` 이동분) |
|
||||
| 엔티티/공유 서비스 | `elink-portal-common` `com.eactive.apim.portal.menu.*` | PTL_MENU_ITEM·PTL_MENU_PLACEMENT·PTL_ROLE(+AUTHORITY), `PortalMenuDataService` |
|
||||
| 시더 | `djb/menu/MenuSeeder.java` | 부팅 시 yml→DB 적재 (ApplicationReadyEvent) |
|
||||
| 캐시 | `djb/menu/MenuService.java` | role 비의존 트리 스냅샷, TTL 1시간(PTL_PROPERTY) |
|
||||
| 렌더 | `djb/menu/MenuModelAdvice.java` → 모델 `menuView` | 요청별 노출(EXPOSE_ROLES) 필터 |
|
||||
| 접근 제어 | `djb/menu/MenuAccessInterceptor.java` | ACCESS_ROLES 서버측 집행 (경로 정확 일치) |
|
||||
| 내부 API | `djb/menu/MenuInternalController.java` | `POST /internal/menu/reload` (admin 캐시 리로드 수신) |
|
||||
|
||||
메뉴를 소비하는 템플릿: `fragment/djbank/header_container.html`(데스크톱 nav·마이페이지 드롭다운·모바일 drawer),
|
||||
`fragment/djbank/service_sidebar.html`. 모두 `${menuView}` 를 반복 렌더하므로 **메뉴 추가 시 템플릿 수정 불필요**.
|
||||
|
||||
## menu.yml 스키마
|
||||
|
||||
```yaml
|
||||
portal-menu:
|
||||
items:
|
||||
- id: support # kebab-case 필수 (^[a-z0-9-]+$). 변경 금지(변경=신규 항목)
|
||||
name: "고객지원"
|
||||
group: true # 상위 그룹. path 생략 시 클릭 없음(자식 있어야 노출)
|
||||
section: GNB # GNB(기본) | MYPAGE. 자식은 부모 섹션 상속
|
||||
expose-roles: [] # 생략=전체(익명 포함), AUTHENTICATED=로그인자, 그 외 역할코드 any-of
|
||||
children:
|
||||
- { id: support-faq, name: "FAQ", path: /faq_list }
|
||||
- { id: my-page-webhook, name: "Webhook 관리", path: /webhook, icon: fa-bell,
|
||||
expose-roles: [ROLE_WEBHOOK], access-roles: [ROLE_WEBHOOK] }
|
||||
```
|
||||
|
||||
- `expose-roles` = 메뉴 **노출** 조건, `access-roles` = URL **접근** 조건(인터셉터 차단, redirect).
|
||||
- `icon` 은 마이페이지 드롭다운 전용(FontAwesome 클래스).
|
||||
- 정렬은 yml 나열 순서(기본 배치 sort = index×10).
|
||||
|
||||
## 시딩 규칙 (MenuSeeder)
|
||||
|
||||
1. **항목**: id 기준 upsert. yml 값이 바뀌면 DFLT_*(기본값 스냅샷)를 갱신하고,
|
||||
**관리자가 수정하지 않은 필드(현재값==구 기본값)만** 새 기본값을 따라간다.
|
||||
구조 필드(`group`/`section`/`icon`/`new-window`)는 항상 yml 이 이긴다.
|
||||
2. **배치**: `PTL_MENU_PLACEMENT` 가 **비어있을 때만** 기본 배치로 최초 시딩.
|
||||
이후 배치는 admin 이 소유한다 — 재배포/재기동에도 보존됨.
|
||||
3. yml 에서 항목을 제거해도 DB 는 삭제하지 않고 경고 로그만 남긴다(수동 정리).
|
||||
4. 부팅 시딩 주체는 인증 사용자가 없으므로 `CREATED_BY=SYSTEM`.
|
||||
|
||||
## 캐시와 리로드
|
||||
|
||||
- 스냅샷 TTL: PTL_PROPERTY `Portal / menu.cache.ttl-seconds` (기본 3600초).
|
||||
- 즉시 반영: `curl -X POST http://127.0.0.1:39130/internal/menu/reload`
|
||||
(admin 포탈메뉴관리의 [캐시 Reload] 버튼이 동일 호출 수행).
|
||||
- 내부 API 가드: `Portal / menu.internal.allow-ips` 허용 IP 목록(기본 loopback)
|
||||
+ X-Forwarded-For 동반 요청 거부. CSRF 면제(`/internal/menu/**`).
|
||||
- admin 측 호출 URL: `Portal / portal.internal.menu-reload-url`.
|
||||
|
||||
## 새 메뉴 추가 절차
|
||||
|
||||
**기본 메뉴(코드 배포와 함께)**
|
||||
1. 페이지/라우트 준비 (`portal.pages` 또는 `@GetMapping` — 기존 방식 그대로)
|
||||
2. `menu.yml` 에 항목 추가 (필요 시 breadcrumb 용 `page.home` 트리도 갱신 — 별도 체계 유지)
|
||||
3. 재기동 → 시딩 로그 확인 → 헤더/드로어 노출 확인
|
||||
4. 이미 운영 중인 DB 라면 배치는 자동 추가되지 않음(배치 시딩은 최초 1회) —
|
||||
admin 화면에서 미배치 → 원하는 위치로 드래그 후 저장
|
||||
|
||||
**운영자 임시 메뉴(외부 링크 등)**: admin 포탈메뉴관리 [메뉴 추가] → 미배치 생성 → 드래그 배치 → 저장 → 캐시 Reload.
|
||||
커스텀 항목은 미배치 시 삭제된다.
|
||||
|
||||
## 로컬 개발 주의
|
||||
|
||||
- `gradle bootRun` 으로 시딩까지 확인하려면 damo-manager 가 classpath 에 필요:
|
||||
`JAVA_TOOL_OPTIONS="-Xbootclasspath/a:<...>/apache-tomcat-9.0.115-djb/lib/damo-manager.jar"`
|
||||
(미지정 시 감사 컬럼 암호화 컨버터에서 NoClassDefFoundError).
|
||||
- 템플릿/메뉴 반영 확인은 서버 재시작 후 curl 로.
|
||||
- elink-portal-common 수정 후 Q클래스 duplicate 컴파일 오류 시 각 모듈 `build/generated` 삭제 후 재컴파일.
|
||||
|
||||
## 역할(roles.yml) 변경
|
||||
|
||||
- 로그인 권한 확장은 `PortalRolesProperties`(yml 바인딩)를 직접 사용 — DB 미러(PTL_ROLE*)는
|
||||
admin 권한 선택 체크박스 소스 전용.
|
||||
- 역할 추가 시 `roles.yml` 의 `authority-names` 에 한글 라벨을 함께 등록해야 admin 화면에 표기된다.
|
||||
@@ -0,0 +1,36 @@
|
||||
package com.eactive.apim.gateway.data.statistics.entity;
|
||||
|
||||
import lombok.Data;
|
||||
|
||||
import javax.persistence.Column;
|
||||
import javax.persistence.Entity;
|
||||
import javax.persistence.Id;
|
||||
import javax.persistence.Table;
|
||||
import java.time.LocalDateTime;
|
||||
|
||||
/**
|
||||
* API 상태 모니터링 결과 (AGWAPP.API_STATUS).
|
||||
*
|
||||
* <p>eapim-admin 의 {@code ApiStatusMonitorJob} 이 상태 변화가 있을 때만 upsert 한다.
|
||||
* 포털은 읽기 전용으로 "마지막 상태 변경 시각" 표시에 사용한다.</p>
|
||||
*/
|
||||
@Entity
|
||||
@Table(name = "API_STATUS")
|
||||
@Data
|
||||
public class GwApiStatus {
|
||||
|
||||
/** EAI 서비스명 */
|
||||
@Id
|
||||
@Column(name = "EAISVCNAME", length = 30)
|
||||
private String eaisvcname;
|
||||
|
||||
/** N 정상 / C 점검 / D 지연 / E 장애 */
|
||||
@Column(name = "STATUS_CODE", length = 1)
|
||||
private String statusCode;
|
||||
|
||||
@Column(name = "MODIFIED_BY", length = 20)
|
||||
private String modifiedBy;
|
||||
|
||||
@Column(name = "MODIFIED_DATE")
|
||||
private LocalDateTime modifiedDate;
|
||||
}
|
||||
+17
@@ -0,0 +1,17 @@
|
||||
package com.eactive.apim.gateway.data.statistics.repository;
|
||||
|
||||
import com.eactive.apim.gateway.data.statistics.entity.GwApiStatus;
|
||||
import org.springframework.data.jpa.repository.Query;
|
||||
import org.springframework.data.repository.Repository;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.Optional;
|
||||
|
||||
public interface GwApiStatusRepository extends Repository<GwApiStatus, String> {
|
||||
|
||||
/**
|
||||
* API 상태가 마지막으로 변경된 시각. 데이터가 없으면 empty.
|
||||
*/
|
||||
@Query("SELECT MAX(s.modifiedDate) FROM GwApiStatus s")
|
||||
Optional<LocalDateTime> findLastModifiedDate();
|
||||
}
|
||||
@@ -9,6 +9,7 @@ import com.eactive.apim.portal.apps.apiservice.dto.ApiServiceDTO;
|
||||
import com.eactive.apim.portal.apps.apiservice.service.ApiServiceService;
|
||||
import com.eactive.apim.portal.common.exception.NotFoundException;
|
||||
import com.eactive.apim.portal.common.util.SecurityUtil;
|
||||
import com.eactive.apim.portal.djb.apistatus.service.ApiStatusCatalogService;
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
@@ -31,6 +32,7 @@ public class ApiController {
|
||||
private final ApiService apiService;
|
||||
private final ApiServiceService apiServiceService;
|
||||
private final ApiSearchFacade apiSearchFacade;
|
||||
private final ApiStatusCatalogService apiStatusCatalogService;
|
||||
private static final String DEFAULT_TOKEN_API_ID = "default-token-api-spec";
|
||||
private static final String DEFAULT_TOKEN_API_NAME = "인증";
|
||||
|
||||
@@ -86,6 +88,8 @@ public class ApiController {
|
||||
model.addAttribute("totalApiCount", searchResult.get("totalApiCount"));
|
||||
model.addAttribute("selectedApiCount", searchResult.get("selectedApiCount"));
|
||||
model.addAttribute("selected", search.getGroupIds().size() > 0 ? search.getGroupIds().get(0) : "-1");
|
||||
// 카드의 현재 상태 태그 노출 여부 (PTL_PROPERTY djb.apistatus.api-list-status-badge)
|
||||
model.addAttribute("apiStatusBadgeEnabled", apiStatusCatalogService.isApiListStatusBadgeEnabled());
|
||||
|
||||
return "apps/apis/mainApiList";
|
||||
}
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
package com.eactive.apim.portal.apps.community.notice.dto;
|
||||
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.TimelineEntryDTO;
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
@@ -53,6 +54,14 @@ public class PortalNoticeDTO {
|
||||
private String state;
|
||||
private String previousState;
|
||||
private List<IncidentAffectedApiDTO> affectedApis = Collections.emptyList();
|
||||
/** 개발자포탈에 게시되지 않아 개별 노출하지 않는 GW 인터페이스 건수 */
|
||||
private int hiddenApiCount;
|
||||
/** 장애 처리 타임라인. 최신순(내림차순), 공개(visibleYn='Y') 항목만 담는다. */
|
||||
private List<TimelineEntryDTO> timeline = Collections.emptyList();
|
||||
|
||||
public boolean hasTimeline() {
|
||||
return timeline != null && !timeline.isEmpty();
|
||||
}
|
||||
|
||||
public boolean isIncidentType() {
|
||||
return NOTICE_TYPE_INCIDENT.equals(noticeType);
|
||||
|
||||
+7
@@ -2,11 +2,18 @@ package com.eactive.apim.portal.apps.community.notice.repository;
|
||||
|
||||
import com.eactive.apim.portal.portalNotice.entity.PortalNotice;
|
||||
import com.eactive.eai.rms.data.EMSDataSource;
|
||||
import java.util.Collection;
|
||||
import java.util.List;
|
||||
import org.springframework.data.jpa.repository.JpaRepository;
|
||||
import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
|
||||
|
||||
@EMSDataSource
|
||||
public interface PortalNoticeRepository extends JpaRepository<PortalNotice, String>, JpaSpecificationExecutor<PortalNotice> {
|
||||
|
||||
/**
|
||||
* 게시 중인 공지만 골라 한 번에 읽는다. API Status 카드가 연결 공지 본문을 붙일 때 사용한다.
|
||||
* 미게시(USE_YN='N')·삭제된 공지는 결과에서 자연히 빠진다.
|
||||
*/
|
||||
List<PortalNotice> findByIdInAndUseYn(Collection<String> ids, String useYn);
|
||||
}
|
||||
|
||||
|
||||
+31
-4
@@ -5,6 +5,9 @@ import com.eactive.apim.portal.apps.community.notice.dto.PortalNoticeDTO;
|
||||
import com.eactive.apim.portal.apps.community.notice.dto.PortalNoticeSearch;
|
||||
import com.eactive.apim.portal.apps.community.notice.mapper.PortalNoticeMapper;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncident;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncidentApi;
|
||||
import com.eactive.apim.portal.djb.apistatus.service.ApiStatusAssembler;
|
||||
import com.eactive.apim.portal.djb.apistatus.service.ApiStatusCatalogService;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.repository.DjbApistatusIncidentApiRepository;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.repository.DjbApistatusIncidentRepository;
|
||||
import com.eactive.apim.portal.portalNotice.entity.PortalNotice;
|
||||
@@ -16,8 +19,10 @@ import org.springframework.data.domain.Sort;
|
||||
import org.springframework.data.jpa.domain.Specification;
|
||||
import org.springframework.stereotype.Service;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.Collections;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.Optional;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
@@ -29,6 +34,8 @@ public class PortalNoticeFacadeImpl implements PortalNoticeFacade {
|
||||
private final PortalNoticeMapper portalNoticeMapper;
|
||||
private final DjbApistatusIncidentRepository incidentRepository;
|
||||
private final DjbApistatusIncidentApiRepository incidentApiRepository;
|
||||
private final ApiStatusAssembler apiStatusAssembler;
|
||||
private final ApiStatusCatalogService apiStatusCatalogService;
|
||||
|
||||
@Override
|
||||
public List<PortalNoticeDTO> getLatestNotices() {
|
||||
@@ -67,11 +74,13 @@ public class PortalNoticeFacadeImpl implements PortalNoticeFacade {
|
||||
private void populateIncident(PortalNoticeDTO dto) {
|
||||
if (!dto.isIncidentOrMaintenance()) {
|
||||
dto.setAffectedApis(Collections.emptyList());
|
||||
dto.setTimeline(Collections.emptyList());
|
||||
return;
|
||||
}
|
||||
Optional<DjbApistatusIncident> incidentOpt = incidentRepository.findByNoticeId(dto.getId());
|
||||
if (!incidentOpt.isPresent()) {
|
||||
dto.setAffectedApis(Collections.emptyList());
|
||||
dto.setTimeline(Collections.emptyList());
|
||||
return;
|
||||
}
|
||||
DjbApistatusIncident incident = incidentOpt.get();
|
||||
@@ -81,10 +90,28 @@ public class PortalNoticeFacadeImpl implements PortalNoticeFacade {
|
||||
dto.setState(incident.getState() == null ? null : incident.getState().name());
|
||||
dto.setPreviousState(incident.getPreviousState() == null ? null : incident.getPreviousState().name());
|
||||
|
||||
List<IncidentAffectedApiDTO> apis = incidentApiRepository
|
||||
.findByIncidentIdOrderByApiId(incident.getIncidentId()).stream()
|
||||
.map(api -> new IncidentAffectedApiDTO(api.getApiId(), api.getApiName()))
|
||||
.collect(Collectors.toList());
|
||||
// 영향 인터페이스 중 개발자포탈에 게시된 API 만 개별 노출한다.
|
||||
// 나머지 GW 인터페이스는 이름·ID 를 감추고 건수로만 알린다.
|
||||
Map<String, String> visibleNames = apiStatusCatalogService.getVisibleApiNames();
|
||||
List<IncidentAffectedApiDTO> apis = new ArrayList<>();
|
||||
int hiddenCount = 0;
|
||||
for (DjbApistatusIncidentApi api :
|
||||
incidentApiRepository.findByIncidentIdOrderByApiId(incident.getIncidentId())) {
|
||||
String publishedName = visibleNames.get(api.getApiId());
|
||||
if (publishedName == null) {
|
||||
hiddenCount++;
|
||||
continue;
|
||||
}
|
||||
apis.add(new IncidentAffectedApiDTO(api.getApiId(), publishedName));
|
||||
}
|
||||
dto.setAffectedApis(apis);
|
||||
dto.setHiddenApiCount(hiddenCount);
|
||||
|
||||
// 장애·지연만 타임라인을 붙인다 (점검은 타임라인을 쌓지 않음 — ADR-F15)
|
||||
boolean degrading = incident.getKind() != null && incident.getKind().isDegrading();
|
||||
dto.setTimeline(degrading
|
||||
? apiStatusAssembler.loadTimelines(Collections.singletonList(incident.getIncidentId()))
|
||||
.getOrDefault(incident.getIncidentId(), Collections.emptyList())
|
||||
: Collections.emptyList());
|
||||
}
|
||||
}
|
||||
|
||||
@@ -10,7 +10,7 @@ import com.eactive.apim.portal.common.exception.UserNotFoundException;
|
||||
import com.eactive.apim.portal.common.user.PortalAuthenticatedUser;
|
||||
import com.eactive.apim.portal.common.util.EncryptionUtil;
|
||||
import com.eactive.apim.portal.common.util.SecurityUtil;
|
||||
import com.eactive.apim.portal.config.PortalProperties;
|
||||
import com.eactive.apim.portal.djb.menu.PortalRolesProperties;
|
||||
import com.eactive.apim.portal.portaluser.entity.PortalUser;
|
||||
import com.eactive.apim.portal.portaluser.entity.PortalUserEnums;
|
||||
import com.eactive.apim.portal.portaluser.entity.PortalUserEnums.RoleCode;
|
||||
@@ -50,7 +50,7 @@ public class PortalUserAuthService implements UserDetailsService {
|
||||
|
||||
private final PortalUserRepository portalUserRepository;
|
||||
private final PortalUserMapper portalUserMapper;
|
||||
private final PortalProperties portalProperties;
|
||||
private final PortalRolesProperties portalRolesProperties;
|
||||
private final PasswordEncoder passwordEncoder;
|
||||
private final MessageHandlerService messageHandlerService;
|
||||
private final MessageRequestRepository messageRequestRepository;
|
||||
@@ -76,7 +76,7 @@ public class PortalUserAuthService implements UserDetailsService {
|
||||
*/
|
||||
public PortalAuthenticatedUser buildAuthenticatedUser(PortalUser portalUser) {
|
||||
RoleCode userRole = portalUser.getRoleCode() == null ? RoleCode.ROLE_USER : portalUser.getRoleCode();
|
||||
List<String> roles = portalProperties.getPortalSecurity().get(userRole);
|
||||
List<String> roles = portalRolesProperties.getAuthorities(userRole);
|
||||
PortalAuthenticatedUser authenticatedUser = portalUserMapper.portalUserToAuthenticatedUser(portalUser);
|
||||
|
||||
authenticatedUser.getAuthorities().add(new SimpleGrantedAuthority(userRole.name()));
|
||||
|
||||
@@ -7,6 +7,7 @@ import com.eactive.apim.portal.portaluser.repository.UserRoleHistoryRepository;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Propagation;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
@@ -35,7 +36,7 @@ public class UserRoleHistoryService {
|
||||
* 역할 변경 이력을 기록한다. 감사 목적이므로 실패해도 본 트랜잭션을 롤백시키지 않도록
|
||||
* 호출부에서 예외를 전파하지 않는다(내부에서 로깅만).
|
||||
*/
|
||||
@Transactional
|
||||
@Transactional(propagation = Propagation.REQUIRES_NEW)
|
||||
public void record(String targetLoginId, RoleCode before, RoleCode after, ChangeType changeType) {
|
||||
try {
|
||||
String actor = SecurityUtil.getCurrentLoginId();
|
||||
|
||||
@@ -12,6 +12,8 @@ import com.eactive.apim.portal.config.PortalProperties;
|
||||
import com.eactive.apim.portal.apps.auth.AuthNoticeProperties;
|
||||
import com.eactive.apim.portal.apps.session.service.UserSessionService;
|
||||
import com.eactive.apim.portal.common.security.ClientGuardService;
|
||||
import com.eactive.apim.portal.djb.footer.RelatedSite;
|
||||
import com.eactive.apim.portal.djb.footer.RelatedSiteService;
|
||||
import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;
|
||||
|
||||
@ControllerAdvice
|
||||
@@ -35,6 +37,9 @@ public class GlobalControllerAdvice {
|
||||
@Autowired
|
||||
private AuthNoticeProperties authNoticeProperties;
|
||||
|
||||
@Autowired
|
||||
private RelatedSiteService relatedSiteService;
|
||||
|
||||
@Autowired
|
||||
private Environment environment;
|
||||
|
||||
@@ -111,4 +116,21 @@ public class GlobalControllerAdvice {
|
||||
return portalPropertyService.getOrCreateProperty(
|
||||
"Portal", "customer.center.contact", "1588-3388", "고객센터 연락처");
|
||||
}
|
||||
|
||||
/**
|
||||
* 푸터 관련 사이트 셀렉트 라벨. PortalProperty(Portal/footer.related-sites.label)에서 조회.
|
||||
*/
|
||||
@ModelAttribute("relatedSitesLabel")
|
||||
public String relatedSitesLabel() {
|
||||
return relatedSiteService.getLabel();
|
||||
}
|
||||
|
||||
/**
|
||||
* 푸터 관련 사이트 목록. PortalProperty(Portal/footer.related-sites)의 '이름=URL' 줄 목록을 파싱한 결과.
|
||||
* 비어 있으면 푸터에서 셀렉트 자체를 렌더하지 않는다.
|
||||
*/
|
||||
@ModelAttribute("relatedSites")
|
||||
public List<RelatedSite> relatedSites() {
|
||||
return relatedSiteService.getSites();
|
||||
}
|
||||
}
|
||||
|
||||
@@ -109,6 +109,7 @@ public class PortalConfigSecurity {
|
||||
.csrfTokenRepository(csrfTokenRepository)
|
||||
.ignoringRequestMatchers(new AntPathRequestMatcher("/_proxy/**/*"))
|
||||
.ignoringRequestMatchers(new AntPathRequestMatcher("/internal/migration/**"))
|
||||
.ignoringRequestMatchers(new AntPathRequestMatcher("/internal/menu/**"))
|
||||
)
|
||||
// 로그인 페이지에 오래 머물러 세션(=CSRF 토큰 저장소)이 타임아웃되면
|
||||
// 로그인 제출 시 CsrfFilter가 AnonymousAuthenticationFilter보다 먼저 예외를 던져
|
||||
|
||||
@@ -44,6 +44,7 @@ public class PortalConfigWebDispatcherServlet implements WebMvcConfigurer {
|
||||
private final Environment environment;
|
||||
private final com.eactive.apim.portal.apps.auth.twofactor.TwoFactorService twoFactorService;
|
||||
private final com.eactive.apim.portal.apps.auth.twofactor.TwoFactorProperties twoFactorProperties;
|
||||
private final com.eactive.apim.portal.djb.menu.MenuService menuService;
|
||||
|
||||
// 정적자원 해시 버전닝 토글(application.yml: app.resource-versioning.enabled).
|
||||
// prod 는 이 값을 무시하고 항상 ON 으로 동작한다(isResourceVersioningEnabled 참고).
|
||||
@@ -58,10 +59,12 @@ public class PortalConfigWebDispatcherServlet implements WebMvcConfigurer {
|
||||
|
||||
public PortalConfigWebDispatcherServlet(Environment environment,
|
||||
com.eactive.apim.portal.apps.auth.twofactor.TwoFactorService twoFactorService,
|
||||
com.eactive.apim.portal.apps.auth.twofactor.TwoFactorProperties twoFactorProperties) {
|
||||
com.eactive.apim.portal.apps.auth.twofactor.TwoFactorProperties twoFactorProperties,
|
||||
com.eactive.apim.portal.djb.menu.MenuService menuService) {
|
||||
this.environment = environment;
|
||||
this.twoFactorService = twoFactorService;
|
||||
this.twoFactorProperties = twoFactorProperties;
|
||||
this.menuService = menuService;
|
||||
}
|
||||
|
||||
|
||||
@@ -131,6 +134,14 @@ public class PortalConfigWebDispatcherServlet implements WebMvcConfigurer {
|
||||
.addPathPatterns("/**")
|
||||
.excludePathPatterns(staticExcludes)
|
||||
.excludePathPatterns("/auth/2fa/**");
|
||||
|
||||
// 메뉴 접근 권한(ACCESS_ROLES) 가드. 메뉴 경로 정확 일치 시에만 검사하며
|
||||
// 하위 경로는 기존 @Secured / PageRoute.role 안전망에 위임한다.
|
||||
registry.addInterceptor(new com.eactive.apim.portal.djb.menu.MenuAccessInterceptor(menuService))
|
||||
.addPathPatterns("/**")
|
||||
.excludePathPatterns(staticExcludes)
|
||||
.excludePathPatterns("/internal/**", "/auth/2fa/**",
|
||||
"/login", "/actionLogin.do", "/actionLogout.do", "/error");
|
||||
}
|
||||
|
||||
@Bean
|
||||
|
||||
@@ -1,13 +1,11 @@
|
||||
package com.eactive.apim.portal.config;
|
||||
|
||||
import com.eactive.apim.portal.common.pagerouter.property.PageRoute;
|
||||
import com.eactive.apim.portal.portaluser.entity.PortalUserEnums.RoleCode;
|
||||
import lombok.Data;
|
||||
import org.springframework.boot.context.properties.ConfigurationProperties;
|
||||
import org.springframework.stereotype.Component;
|
||||
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
@Data
|
||||
@Component
|
||||
@@ -25,8 +23,6 @@ public class PortalProperties {
|
||||
|
||||
private String authVirtualCode = "";
|
||||
|
||||
private Map<RoleCode, List<String>> portalSecurity;
|
||||
|
||||
private FileProperties file = new FileProperties();
|
||||
|
||||
/**
|
||||
|
||||
+211
@@ -0,0 +1,211 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.controller;
|
||||
|
||||
import com.eactive.apim.portal.common.util.SecurityUtil;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.ActiveIncidentDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.ApiCurrentStatusDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.ApiOptionDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.DailyStatDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.IssueDateEntryDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.MaintenanceCardDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.MyApiStatusDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.PastIssueCardDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.service.ApiCurrentStatusService;
|
||||
import com.eactive.apim.portal.djb.apistatus.service.ApiStatusCatalogService;
|
||||
import com.eactive.apim.portal.djb.apistatus.service.ApiStatusIssueHistoryService;
|
||||
import com.eactive.apim.portal.djb.apistatus.service.ApiStatusQueryService;
|
||||
import com.eactive.apim.portal.djb.apistatus.service.ApiStatusSupport;
|
||||
import com.eactive.apim.portal.djb.apistatus.service.ApiStatusUptimeService;
|
||||
import com.eactive.apim.portal.djb.apistatus.service.MyApiStatusQueryService;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.data.domain.Page;
|
||||
import org.springframework.data.domain.PageRequest;
|
||||
import org.springframework.format.annotation.DateTimeFormat;
|
||||
import org.springframework.http.HttpStatus;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.stereotype.Controller;
|
||||
import org.springframework.web.bind.annotation.GetMapping;
|
||||
import org.springframework.web.bind.annotation.PathVariable;
|
||||
import org.springframework.web.bind.annotation.RequestMapping;
|
||||
import org.springframework.web.bind.annotation.RequestParam;
|
||||
import org.springframework.web.bind.annotation.ResponseBody;
|
||||
import org.springframework.web.servlet.ModelAndView;
|
||||
|
||||
import java.time.LocalDate;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.Collections;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 개발자포탈 API Status 화면.
|
||||
*
|
||||
* <p>장애/점검 데이터는 관리자 공지사항(PTL_NOTICE + DJB_APISTATUS_INCIDENT)과
|
||||
* 자동 탐지(eapim-admin ApiStatusDetectionService)가 채운다. 본 컨트롤러는 읽기 전용이다.</p>
|
||||
*
|
||||
* <p>비로그인 사용자도 모두 조회 가능하며, "내 API 현황"만 로그인을 요구한다.</p>
|
||||
*/
|
||||
@Slf4j
|
||||
@Controller
|
||||
@RequestMapping("/apistatus")
|
||||
@RequiredArgsConstructor
|
||||
public class ApiStatusController {
|
||||
|
||||
private static final int DEFAULT_RECENT_ISSUE_SIZE = 5;
|
||||
private static final int MAX_PAGE_SIZE = 50;
|
||||
/** 현재 상태 일괄 조회 시 한 번에 물어볼 수 있는 API 수 */
|
||||
private static final int MAX_STATUS_BATCH = 100;
|
||||
|
||||
private final ApiStatusQueryService apiStatusQueryService;
|
||||
private final ApiStatusUptimeService uptimeService;
|
||||
private final ApiStatusIssueHistoryService issueHistoryService;
|
||||
private final MyApiStatusQueryService myApiStatusQueryService;
|
||||
private final ApiStatusCatalogService catalogService;
|
||||
private final ApiCurrentStatusService apiCurrentStatusService;
|
||||
|
||||
/** P1 - API Status 메인 */
|
||||
@GetMapping
|
||||
public ModelAndView index() {
|
||||
ModelAndView mav = new ModelAndView("djb/apistatus/index");
|
||||
mav.addObject("windowDays", catalogService.getWindowDays());
|
||||
mav.addObject("authenticated", SecurityUtil.isAuthenticated());
|
||||
LocalDateTime lastFireAt = catalogService.getLastMonitorFireAt();
|
||||
mav.addObject("lastFireAt", lastFireAt);
|
||||
mav.addObject("lastFireRelative",
|
||||
ApiStatusSupport.relativeTime(lastFireAt, ApiStatusSupport.now()));
|
||||
mav.addObject("lastStatusChangedAt", catalogService.getLastStatusChangedAt());
|
||||
return mav;
|
||||
}
|
||||
|
||||
/**
|
||||
* P8 - 전체 이슈 이력. 날짜를 지정하지 않으면 조회 기간(90일) 전체를 본다.
|
||||
* 날짜 선택 가능 범위는 서버 기준 일자로 내려 클라이언트 timezone 차이를 없앤다.
|
||||
*/
|
||||
@GetMapping("/issues")
|
||||
public ModelAndView issues(
|
||||
@RequestParam(value = "date", required = false)
|
||||
@DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
|
||||
@RequestParam(value = "apiId", required = false) String apiId,
|
||||
@RequestParam(value = "kind", required = false) String kind) {
|
||||
|
||||
LocalDate today = ApiStatusSupport.now().toLocalDate();
|
||||
int windowDays = catalogService.getWindowDays();
|
||||
|
||||
ModelAndView mav = new ModelAndView("djb/apistatus/issues");
|
||||
mav.addObject("windowDays", windowDays);
|
||||
mav.addObject("today", today);
|
||||
mav.addObject("minDate", today.minusDays(windowDays - 1L));
|
||||
mav.addObject("selectedDate", date);
|
||||
mav.addObject("selectedApiId", apiId);
|
||||
mav.addObject("selectedKind", kind);
|
||||
return mav;
|
||||
}
|
||||
|
||||
/** 이슈 이력 API 필터 - 현재 사용자가 조회 가능한 API 목록 */
|
||||
@GetMapping("/apis.json")
|
||||
@ResponseBody
|
||||
public List<ApiOptionDTO> selectableApis() {
|
||||
return catalogService.getSelectableApis();
|
||||
}
|
||||
|
||||
/** P2 - 90일 가동률 */
|
||||
@GetMapping("/uptime.json")
|
||||
@ResponseBody
|
||||
public List<DailyStatDTO> uptime(
|
||||
@RequestParam(value = "days", defaultValue = "0") int days) {
|
||||
return uptimeService.getDailyStats(days > 0 ? days : catalogService.getWindowDays());
|
||||
}
|
||||
|
||||
/** P3 - 진행 중 장애 */
|
||||
@GetMapping("/active.json")
|
||||
@ResponseBody
|
||||
public List<ActiveIncidentDTO> active() {
|
||||
return apiStatusQueryService.getActiveIncidents();
|
||||
}
|
||||
|
||||
/** P4 - 내 API 현황 (로그인 필수) */
|
||||
@GetMapping("/my-apis.json")
|
||||
@ResponseBody
|
||||
public ResponseEntity<List<MyApiStatusDTO>> myApis() {
|
||||
if (!SecurityUtil.isAuthenticated()) {
|
||||
return new ResponseEntity<>(Collections.emptyList(), HttpStatus.UNAUTHORIZED);
|
||||
}
|
||||
return ResponseEntity.ok(myApiStatusQueryService.getMyApiStatuses());
|
||||
}
|
||||
|
||||
/** P5 - 예정/진행 중 점검 */
|
||||
@GetMapping("/maintenance.json")
|
||||
@ResponseBody
|
||||
public List<MaintenanceCardDTO> maintenance() {
|
||||
return apiStatusQueryService.getOngoingMaintenance();
|
||||
}
|
||||
|
||||
/** P6 - 지난 이슈 (종결) */
|
||||
@GetMapping("/recent-issues.json")
|
||||
@ResponseBody
|
||||
public List<PastIssueCardDTO> recentIssues(
|
||||
@RequestParam(value = "size", defaultValue = "" + DEFAULT_RECENT_ISSUE_SIZE) int size) {
|
||||
return apiStatusQueryService.getRecentClosedIssues(size);
|
||||
}
|
||||
|
||||
/** P7 - 이슈 상세 */
|
||||
@GetMapping("/incident/{incidentId}")
|
||||
@ResponseBody
|
||||
public ResponseEntity<PastIssueCardDTO> incidentDetail(@PathVariable Long incidentId) {
|
||||
return apiStatusQueryService.getIssueDetail(incidentId)
|
||||
.map(ResponseEntity::ok)
|
||||
.orElseGet(() -> ResponseEntity.notFound().build());
|
||||
}
|
||||
|
||||
/** P9 - 90일 이슈 일자 인덱스 */
|
||||
@GetMapping("/issues/dates.json")
|
||||
@ResponseBody
|
||||
public List<IssueDateEntryDTO> issueDates(
|
||||
@RequestParam(value = "days", defaultValue = "0") int days,
|
||||
@RequestParam(value = "apiId", required = false) String apiId,
|
||||
@RequestParam(value = "kind", required = false) String kind) {
|
||||
return issueHistoryService.getIssueDates(days > 0 ? days : catalogService.getWindowDays(), apiId, kind);
|
||||
}
|
||||
|
||||
/** P10 - 이슈 목록 (날짜/API/유형 필터) */
|
||||
@GetMapping("/issues/list.json")
|
||||
@ResponseBody
|
||||
public Page<PastIssueCardDTO> issueList(
|
||||
@RequestParam(value = "date", required = false)
|
||||
@DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate date,
|
||||
@RequestParam(value = "apiId", required = false) String apiId,
|
||||
@RequestParam(value = "kind", required = false) String kind,
|
||||
@RequestParam(value = "page", defaultValue = "0") int page,
|
||||
@RequestParam(value = "size", defaultValue = "20") int size) {
|
||||
|
||||
int safePage = Math.max(page, 0);
|
||||
int safeSize = size <= 0 ? 20 : Math.min(size, MAX_PAGE_SIZE);
|
||||
return issueHistoryService.getIssues(date, apiId, kind, PageRequest.of(safePage, safeSize));
|
||||
}
|
||||
|
||||
/**
|
||||
* P11 - API 한 건의 현재 상태 (정상/점검/지연/장애). API 상세 화면이 사용한다.
|
||||
*
|
||||
* <p>게시된 장애·점검만 반영하므로 비로그인도 조회 가능하다.</p>
|
||||
*/
|
||||
@GetMapping("/current.json")
|
||||
@ResponseBody
|
||||
public ResponseEntity<ApiCurrentStatusDTO> currentStatus(@RequestParam("apiId") String apiId) {
|
||||
return apiCurrentStatusService.getStatus(apiId)
|
||||
.map(ResponseEntity::ok)
|
||||
.orElseGet(() -> ResponseEntity.badRequest().build());
|
||||
}
|
||||
|
||||
/**
|
||||
* P11 - 여러 API 의 현재 상태. {@code ?apiId=A&apiId=B} 로 반복 지정한다.
|
||||
*/
|
||||
@GetMapping("/current-list.json")
|
||||
@ResponseBody
|
||||
public ResponseEntity<List<ApiCurrentStatusDTO>> currentStatuses(
|
||||
@RequestParam(value = "apiId", required = false) List<String> apiIds) {
|
||||
|
||||
if (apiIds != null && apiIds.size() > MAX_STATUS_BATCH) {
|
||||
return ResponseEntity.badRequest().build();
|
||||
}
|
||||
return ResponseEntity.ok(apiCurrentStatusService.getStatuses(apiIds));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,34 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.dto;
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
import lombok.Data;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 진행 중 장애 카드 (P3)
|
||||
*/
|
||||
@Data
|
||||
public class ActiveIncidentDTO {
|
||||
|
||||
private Long incidentId;
|
||||
private String noticeId;
|
||||
/** 연결된 공지 제목. 게시 중인 공지가 없으면 null */
|
||||
private String noticeSubject;
|
||||
/** 연결된 공지 본문(HTML). 게시 중인 공지가 없으면 null */
|
||||
private String noticeDetail;
|
||||
private String kind;
|
||||
private String state;
|
||||
private String stateLabel;
|
||||
private String title;
|
||||
private String summary;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime startedAt;
|
||||
private long elapsedMinutes;
|
||||
private List<AffectedApiDTO> apis = new ArrayList<>();
|
||||
/** 개발자포탈에 게시되지 않아 개별 노출하지 않는 GW 인터페이스 건수 */
|
||||
private int hiddenApiCount;
|
||||
private List<TimelineEntryDTO> recentTimeline = new ArrayList<>();
|
||||
}
|
||||
@@ -0,0 +1,22 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.dto;
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
|
||||
/**
|
||||
* 이슈 영향 API
|
||||
*/
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
public class AffectedApiDTO {
|
||||
|
||||
private String apiId;
|
||||
private String apiName;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime recoveredAt;
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.dto;
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
import lombok.Data;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
|
||||
/**
|
||||
* API 한 건의 현재 상태 (정상/점검/지연/장애).
|
||||
*
|
||||
* <p>게시된 장애·점검 공지(PTL_NOTICE + DJB_APISTATUS_INCIDENT)만 근거로 한다.
|
||||
* 미게시(초안/USE_YN='N') 건은 다른 API Status 화면과 동일하게 보이지 않는다.</p>
|
||||
*/
|
||||
@Data
|
||||
public class ApiCurrentStatusDTO {
|
||||
|
||||
private String apiId;
|
||||
|
||||
/** 공개 API 목록(PTL_API_SPEC_INFO, DISPLAY_YN='Y')에 없으면 null */
|
||||
private String apiName;
|
||||
|
||||
/** NORMAL / DEGRADED / OUTAGE / MAINTENANCE */
|
||||
private String currentStatus;
|
||||
|
||||
/** 정상 / 지연 / 장애 / 점검 */
|
||||
private String currentStatusLabel;
|
||||
|
||||
/** 현재 상태의 근거가 된 이슈. 정상이면 null */
|
||||
private Long activeIncidentId;
|
||||
|
||||
/** INCIDENT / MAINTENANCE */
|
||||
private String activeIncidentKind;
|
||||
|
||||
private String activeIncidentTitle;
|
||||
|
||||
/** 현재 상태가 시작된 시각 (근거 이슈의 시작 시각) */
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime statusSince;
|
||||
|
||||
/** 점검 종료 예정 시각. 장애이거나 미정이면 null */
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime expectedEndAt;
|
||||
|
||||
/** 조회 기간 내 마지막 장애 발생 시각 */
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime lastIncidentAt;
|
||||
|
||||
/** 조회 기간 가동률 (0.0 ~ 1.0). 상태만 계산하는 경로에서는 채우지 않는다 */
|
||||
private Double uptimeRatio;
|
||||
|
||||
/** 가동률·최근 장애 집계 기간(일) */
|
||||
private int windowDays;
|
||||
}
|
||||
@@ -0,0 +1,20 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.dto;
|
||||
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Data;
|
||||
import lombok.NoArgsConstructor;
|
||||
|
||||
/**
|
||||
* 이슈 이력 API 필터 옵션. 화면에는 API 명만 노출하고 apiId 는 조회 파라미터로만 쓴다.
|
||||
*/
|
||||
@Data
|
||||
@NoArgsConstructor
|
||||
@AllArgsConstructor
|
||||
public class ApiOptionDTO {
|
||||
|
||||
private String apiId;
|
||||
private String apiName;
|
||||
|
||||
/** 소속 API 그룹명 (오픈 API 목록과 동일 기준) */
|
||||
private String groupName;
|
||||
}
|
||||
@@ -0,0 +1,50 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.dto;
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
import lombok.Data;
|
||||
|
||||
import java.time.LocalDate;
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 90일 가동률 일별 집계 (P2)
|
||||
*/
|
||||
@Data
|
||||
public class DailyStatDTO {
|
||||
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd")
|
||||
private LocalDate statDate;
|
||||
|
||||
/** 0.0000 ~ 1.0000 */
|
||||
private double uptimeRatio;
|
||||
|
||||
/** 장애 + 지연 합계 (가동률 차감분). 지연도 서비스 저하이므로 계속 차감한다 */
|
||||
private long incidentMinutes;
|
||||
|
||||
/** 그 중 지연(자동 탐지) 분 */
|
||||
private long delayMinutes;
|
||||
|
||||
private long maintenanceMinutes;
|
||||
|
||||
/** 막대 색상 구분: NORMAL / DEGRADED / OUTAGE / MAINTENANCE */
|
||||
private String status;
|
||||
|
||||
private List<IssueRefDTO> issues = new ArrayList<>();
|
||||
|
||||
@Data
|
||||
public static class IssueRefDTO {
|
||||
private Long incidentId;
|
||||
private String kind;
|
||||
private String title;
|
||||
|
||||
public IssueRefDTO() {
|
||||
}
|
||||
|
||||
public IssueRefDTO(Long incidentId, String kind, String title) {
|
||||
this.incidentId = incidentId;
|
||||
this.kind = kind;
|
||||
this.title = title;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,29 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.dto;
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
import lombok.Data;
|
||||
|
||||
import java.time.LocalDate;
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 이슈 이력 페이지의 90일 인덱스바 1칸 (P9)
|
||||
*/
|
||||
@Data
|
||||
public class IssueDateEntryDTO {
|
||||
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd")
|
||||
private LocalDate date;
|
||||
|
||||
/** INCIDENT / DELAY / MAINTENANCE - 유형 필터와 같은 값 */
|
||||
private List<String> kinds = new ArrayList<>();
|
||||
|
||||
/** 장애 건수 (자동 탐지 지연 제외) */
|
||||
private int incCount;
|
||||
|
||||
/** 지연 건수 (자동 탐지 지연 - INCIDENT 중 INTERFACE_ID 가 DELAY_START: 인 건) */
|
||||
private int dlyCount;
|
||||
|
||||
private int mntCount;
|
||||
}
|
||||
@@ -0,0 +1,36 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.dto;
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
import lombok.Data;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 점검 사항 카드 (P5). 상태 관리를 하지 않으므로(ADR-F15) 진행 단계는 화면이 현재 시각과 비교해 부여한다.
|
||||
*/
|
||||
@Data
|
||||
public class MaintenanceCardDTO {
|
||||
|
||||
private Long incidentId;
|
||||
private String noticeId;
|
||||
/** 연결된 공지 제목. 게시 중인 공지가 없으면 null */
|
||||
private String noticeSubject;
|
||||
/** 연결된 공지 본문(HTML). 게시 중인 공지가 없으면 null */
|
||||
private String noticeDetail;
|
||||
private String title;
|
||||
private String summary;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime startedAt;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime endAt;
|
||||
private Long durationMinutes;
|
||||
private List<AffectedApiDTO> impactedApis = new ArrayList<>();
|
||||
/** 개발자포탈에 게시되지 않아 개별 노출하지 않는 GW 인터페이스 건수 */
|
||||
private int hiddenApiCount;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime registeredAt;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime lastModifiedAt;
|
||||
}
|
||||
@@ -0,0 +1,25 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.dto;
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
import lombok.Data;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
|
||||
/**
|
||||
* 내가 이용 중인 API 의 현재 상태 (P4)
|
||||
*/
|
||||
@Data
|
||||
public class MyApiStatusDTO {
|
||||
|
||||
private String apiId;
|
||||
private String apiName;
|
||||
|
||||
/** NORMAL / DEGRADED / OUTAGE / MAINTENANCE */
|
||||
private String currentStatus;
|
||||
|
||||
private String currentStatusLabel;
|
||||
private Long activeIncidentId;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime lastIncidentAt;
|
||||
private double uptime90d;
|
||||
}
|
||||
@@ -0,0 +1,39 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.dto;
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
import lombok.Data;
|
||||
|
||||
import java.time.LocalDate;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 지난 이슈 카드 (P6, P10). 장애는 타임라인 전체, 점검은 요약만 담는다.
|
||||
*/
|
||||
@Data
|
||||
public class PastIssueCardDTO {
|
||||
|
||||
private Long incidentId;
|
||||
private String noticeId;
|
||||
/** 연결된 공지 제목. 게시 중인 공지가 없으면 null */
|
||||
private String noticeSubject;
|
||||
/** 연결된 공지 본문(HTML). 게시 중인 공지가 없으면 null */
|
||||
private String noticeDetail;
|
||||
private String kind;
|
||||
private String state;
|
||||
private String stateLabel;
|
||||
private String title;
|
||||
private String summary;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime startedAt;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime endAt;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd")
|
||||
private LocalDate dateGroup;
|
||||
private Long durationMinutes;
|
||||
private List<AffectedApiDTO> impactedApis = new ArrayList<>();
|
||||
/** 개발자포탈에 게시되지 않아 개별 노출하지 않는 GW 인터페이스 건수 */
|
||||
private int hiddenApiCount;
|
||||
private List<TimelineEntryDTO> timeline = new ArrayList<>();
|
||||
}
|
||||
@@ -0,0 +1,21 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.dto;
|
||||
|
||||
import com.fasterxml.jackson.annotation.JsonFormat;
|
||||
import lombok.Data;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
|
||||
/**
|
||||
* 장애 처리 타임라인 1건
|
||||
*/
|
||||
@Data
|
||||
public class TimelineEntryDTO {
|
||||
|
||||
private Long timelineId;
|
||||
@JsonFormat(shape = JsonFormat.Shape.STRING, pattern = "yyyy-MM-dd HH:mm:ss")
|
||||
private LocalDateTime eventAt;
|
||||
private String stateAfter;
|
||||
private String labelKo;
|
||||
private String body;
|
||||
private String authorType;
|
||||
}
|
||||
+118
@@ -0,0 +1,118 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.repository;
|
||||
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncident;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentState;
|
||||
import org.springframework.data.domain.Page;
|
||||
import org.springframework.data.domain.Pageable;
|
||||
import org.springframework.data.jpa.repository.Query;
|
||||
import org.springframework.data.repository.Repository;
|
||||
import org.springframework.data.repository.query.Param;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.Collection;
|
||||
import java.util.List;
|
||||
import java.util.Optional;
|
||||
|
||||
/**
|
||||
* 개발자포탈 API Status 화면 전용 조회. 읽기 전용이며 공개 조건을 항상 적용한다.
|
||||
*
|
||||
* <p>공개 조건({@link #VISIBLE})은 두 갈래다.
|
||||
* <ul>
|
||||
* <li>공지가 붙은 이슈(장애·점검) - 그 공지가 게시(USE_YN='Y')되어 있어야 한다.
|
||||
* 공지가 삭제된 고아 행도 이 조건에서 자연히 빠진다 (물리 FK 없음 - ADR-F10).</li>
|
||||
* <li>공지가 없는 이슈(지연) - 자동 탐지 전용이라 검수할 공지가 없다.
|
||||
* 초안(DRAFT_YN='Y')만 아니면 노출한다.</li>
|
||||
* </ul>
|
||||
*
|
||||
* <p>공지 조건을 EXISTS 로 쓰는 이유: 예전처럼 {@code FROM ... , PortalNotice n} 으로 조인하면
|
||||
* NOTICE_ID 가 없는 지연 이슈가 행 자체에서 사라진다.</p>
|
||||
*/
|
||||
public interface ApiStatusIncidentQueryRepository extends Repository<DjbApistatusIncident, Long> {
|
||||
|
||||
String VISIBLE = " i.draftYn = 'N'"
|
||||
+ " AND (i.noticeId IS NULL"
|
||||
+ " OR EXISTS (SELECT 1 FROM PortalNotice n"
|
||||
+ " WHERE n.id = i.noticeId AND n.useYn = 'Y')) ";
|
||||
|
||||
/** 종결 판정이 STATE 로 이뤄지는 종류 (장애·지연). JPQL 리터럴로 써야 해서 FQCN 을 쓴다 */
|
||||
String KIND_INCIDENT = "com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind.INCIDENT";
|
||||
String KIND_DELAY = "com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind.DELAY";
|
||||
String KIND_MAINTENANCE = "com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind.MAINTENANCE";
|
||||
|
||||
/** 종결 조건 - 장애·지연은 STATE 로, 점검은 종료 시각 경과로 판정한다 */
|
||||
String CLOSED_CONDITION = " ((i.kind IN (" + KIND_INCIDENT + ", " + KIND_DELAY + ")"
|
||||
+ " AND i.state IN :closedStates)"
|
||||
+ " OR (i.kind = " + KIND_MAINTENANCE
|
||||
+ " AND i.endAt IS NOT NULL AND i.endAt < :now)) ";
|
||||
|
||||
/**
|
||||
* 진행 중 이슈 (P3). 장애와 지연을 함께 본다.
|
||||
*/
|
||||
@Query("SELECT i FROM DjbApistatusIncident i"
|
||||
+ " WHERE " + VISIBLE
|
||||
+ " AND i.kind IN :kinds"
|
||||
+ " AND i.state NOT IN :closedStates"
|
||||
+ " ORDER BY i.startedAt DESC")
|
||||
List<DjbApistatusIncident> findVisibleOpenIncidents(@Param("kinds") Collection<IncidentKind> kinds,
|
||||
@Param("closedStates") Collection<IncidentState> closedStates);
|
||||
|
||||
/**
|
||||
* 예정/진행 중 점검 (P5). 종료 시각이 없거나 아직 지나지 않은 점검.
|
||||
*/
|
||||
@Query("SELECT i FROM DjbApistatusIncident i"
|
||||
+ " WHERE " + VISIBLE
|
||||
+ " AND i.kind = :kind"
|
||||
+ " AND (i.endAt IS NULL OR i.endAt >= :now)"
|
||||
+ " ORDER BY i.startedAt ASC")
|
||||
List<DjbApistatusIncident> findVisibleOngoingMaintenance(@Param("kind") IncidentKind kind,
|
||||
@Param("now") LocalDateTime now);
|
||||
|
||||
/**
|
||||
* 종결된 이슈 (P6). 장애·지연은 종결 상태, 점검은 종료 시각 경과.
|
||||
*/
|
||||
@Query(value = "SELECT i FROM DjbApistatusIncident i"
|
||||
+ " WHERE " + VISIBLE
|
||||
+ " AND " + CLOSED_CONDITION
|
||||
+ " ORDER BY i.startedAt DESC",
|
||||
countQuery = "SELECT COUNT(i) FROM DjbApistatusIncident i"
|
||||
+ " WHERE " + VISIBLE
|
||||
+ " AND " + CLOSED_CONDITION)
|
||||
Page<DjbApistatusIncident> findVisibleClosedIssues(@Param("closedStates") Collection<IncidentState> closedStates,
|
||||
@Param("now") LocalDateTime now,
|
||||
Pageable pageable);
|
||||
|
||||
/**
|
||||
* 기간과 겹치는 모든 이슈 (P2 가동률 집계, P9 일자 인덱스, P10 목록).
|
||||
* 진행 중(END_AT IS NULL) 이슈도 포함한다.
|
||||
*/
|
||||
@Query("SELECT i FROM DjbApistatusIncident i"
|
||||
+ " WHERE " + VISIBLE
|
||||
+ " AND i.startedAt < :to"
|
||||
+ " AND (i.endAt IS NULL OR i.endAt >= :from)"
|
||||
+ " ORDER BY i.startedAt DESC")
|
||||
List<DjbApistatusIncident> findVisibleOverlapping(@Param("from") LocalDateTime from,
|
||||
@Param("to") LocalDateTime to);
|
||||
|
||||
/**
|
||||
* 기간과 겹치고 특정 API 에 영향을 준 이슈 (P9/P10 의 apiId 필터).
|
||||
*/
|
||||
@Query("SELECT DISTINCT i FROM DjbApistatusIncident i, DjbApistatusIncidentApi a"
|
||||
+ " WHERE " + VISIBLE
|
||||
+ " AND a.incidentId = i.incidentId"
|
||||
+ " AND a.apiId = :apiId"
|
||||
+ " AND i.startedAt < :to"
|
||||
+ " AND (i.endAt IS NULL OR i.endAt >= :from)"
|
||||
+ " ORDER BY i.startedAt DESC")
|
||||
List<DjbApistatusIncident> findVisibleOverlappingByApi(@Param("from") LocalDateTime from,
|
||||
@Param("to") LocalDateTime to,
|
||||
@Param("apiId") String apiId);
|
||||
|
||||
/**
|
||||
* 공개 상세 (P7)
|
||||
*/
|
||||
@Query("SELECT i FROM DjbApistatusIncident i"
|
||||
+ " WHERE " + VISIBLE
|
||||
+ " AND i.incidentId = :incidentId")
|
||||
Optional<DjbApistatusIncident> findVisibleById(@Param("incidentId") Long incidentId);
|
||||
}
|
||||
+274
@@ -0,0 +1,274 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.service;
|
||||
|
||||
import com.eactive.apim.portal.apispec.entity.ApiSpecInfo;
|
||||
import com.eactive.apim.portal.apispec.repository.ApiSpecInfoRepository;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.ApiCurrentStatusDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncident;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncidentApi;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentState;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.repository.DjbApistatusIncidentApiRepository;
|
||||
import com.eactive.apim.portal.djb.apistatus.repository.ApiStatusIncidentQueryRepository;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import org.apache.commons.lang3.StringUtils;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.ArrayList;
|
||||
import java.util.Collection;
|
||||
import java.util.Collections;
|
||||
import java.util.HashMap;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.LinkedHashSet;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.Optional;
|
||||
import java.util.Set;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
/**
|
||||
* API 별 현재 상태(정상/점검/지연/장애) 조회.
|
||||
*
|
||||
* <p>"내 API 현황"(P4)과 API 상세 화면이 이 서비스를 공유해 판정 기준을 하나로 유지한다.
|
||||
* 근거는 <b>게시된</b> 장애·점검 공지뿐이며(PTL_NOTICE.USE_YN='Y' + DRAFT_YN='N'),
|
||||
* 미게시 건은 다른 API Status 화면과 마찬가지로 반영하지 않는다.</p>
|
||||
*
|
||||
* <p>판정 규칙 (심각한 쪽 우선)
|
||||
* <ul>
|
||||
* <li>진행 중 장애 → 장애(OUTAGE). 단 모니터링 상태이거나 자동 탐지 지연 건이면 지연(DEGRADED)</li>
|
||||
* <li>이미 시작된 점검 → 점검(MAINTENANCE)</li>
|
||||
* <li>해당 없음 → 정상(NORMAL)</li>
|
||||
* </ul>
|
||||
*/
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
@Transactional(readOnly = true)
|
||||
public class ApiCurrentStatusService {
|
||||
|
||||
private final ApiStatusIncidentQueryRepository incidentQueryRepository;
|
||||
private final DjbApistatusIncidentApiRepository incidentApiRepository;
|
||||
private final ApiSpecInfoRepository apiSpecInfoRepository;
|
||||
private final ApiStatusUptimeService uptimeService;
|
||||
private final ApiStatusCatalogService catalogService;
|
||||
|
||||
/** API 한 건의 현재 상태. apiId 가 비어 있으면 empty */
|
||||
public Optional<ApiCurrentStatusDTO> getStatus(String apiId) {
|
||||
if (StringUtils.isBlank(apiId)) {
|
||||
return Optional.empty();
|
||||
}
|
||||
return getStatuses(Collections.singletonList(apiId)).stream().findFirst();
|
||||
}
|
||||
|
||||
/**
|
||||
* 여러 API 의 현재 상태 (API 명·가동률 포함). 요청 순서를 유지하며 중복 apiId 는 한 번만 반환한다.
|
||||
*/
|
||||
public List<ApiCurrentStatusDTO> getStatuses(Collection<String> apiIds) {
|
||||
Set<String> ids = normalize(apiIds);
|
||||
if (ids.isEmpty()) {
|
||||
return Collections.emptyList();
|
||||
}
|
||||
|
||||
Map<String, ApiCurrentStatusDTO> statuses = resolveStatuses(ids);
|
||||
Map<String, String> names = resolveApiNames(ids);
|
||||
Map<String, Double> uptimes = uptimeService.getApiUptimeRatios(ids, catalogService.getWindowDays());
|
||||
|
||||
List<ApiCurrentStatusDTO> result = new ArrayList<>(ids.size());
|
||||
for (String apiId : ids) {
|
||||
ApiCurrentStatusDTO dto = statuses.get(apiId);
|
||||
dto.setApiName(names.get(apiId));
|
||||
dto.setUptimeRatio(uptimes.getOrDefault(apiId, 1.0d));
|
||||
result.add(dto);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* 상태만 계산한다 (API 명·가동률 제외). 대상 API 를 이미 알고 있고 이름·가동률을
|
||||
* 따로 채우는 호출자(P4 내 API 현황)를 위한 경량 경로다.
|
||||
*/
|
||||
public Map<String, ApiCurrentStatusDTO> resolveStatuses(Set<String> apiIds) {
|
||||
if (apiIds == null || apiIds.isEmpty()) {
|
||||
return Collections.emptyMap();
|
||||
}
|
||||
|
||||
LocalDateTime now = ApiStatusSupport.now();
|
||||
int windowDays = catalogService.getWindowDays();
|
||||
|
||||
Map<String, DjbApistatusIncident> openByApi = mapOpenIncidents(apiIds);
|
||||
Map<String, DjbApistatusIncident> maintenanceByApi = mapStartedMaintenance(apiIds, now);
|
||||
Map<String, LocalDateTime> lastIncidentAt = collectLastIncidentAt(apiIds, now, windowDays);
|
||||
|
||||
Map<String, ApiCurrentStatusDTO> result = new LinkedHashMap<>();
|
||||
for (String apiId : apiIds) {
|
||||
DjbApistatusIncident open = openByApi.get(apiId);
|
||||
DjbApistatusIncident maintenance = maintenanceByApi.get(apiId);
|
||||
|
||||
ApiCurrentStatusDTO dto = new ApiCurrentStatusDTO();
|
||||
dto.setApiId(apiId);
|
||||
dto.setCurrentStatus(resolveStatus(open, maintenance != null));
|
||||
dto.setCurrentStatusLabel(ApiStatusSupport.statusLabel(dto.getCurrentStatus()));
|
||||
dto.setLastIncidentAt(lastIncidentAt.get(apiId));
|
||||
dto.setWindowDays(windowDays);
|
||||
|
||||
// 장애가 점검보다 심각하므로 근거 이슈도 장애를 우선한다
|
||||
DjbApistatusIncident active = open != null ? open : maintenance;
|
||||
if (active != null) {
|
||||
dto.setActiveIncidentId(active.getIncidentId());
|
||||
dto.setActiveIncidentKind(active.getKind() == null ? null : active.getKind().name());
|
||||
dto.setActiveIncidentTitle(active.getTitle());
|
||||
dto.setStatusSince(active.getStartedAt());
|
||||
dto.setExpectedEndAt(active.getEndAt());
|
||||
}
|
||||
result.put(apiId, dto);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/** 빈 값·중복 제거. 요청 순서는 유지한다 */
|
||||
private Set<String> normalize(Collection<String> apiIds) {
|
||||
if (apiIds == null || apiIds.isEmpty()) {
|
||||
return Collections.emptySet();
|
||||
}
|
||||
return apiIds.stream()
|
||||
.filter(StringUtils::isNotBlank)
|
||||
.map(StringUtils::trim)
|
||||
.collect(Collectors.toCollection(LinkedHashSet::new));
|
||||
}
|
||||
|
||||
/**
|
||||
* API 명은 공개 목록(DISPLAY_YN='Y')에서만 가져온다. 비공개 API 의 이름이 새어나가지 않게 한다.
|
||||
*/
|
||||
private Map<String, String> resolveApiNames(Set<String> apiIds) {
|
||||
List<ApiSpecInfo> specs =
|
||||
apiSpecInfoRepository.findAllByDisplayYnAndApiIdIn("Y", new ArrayList<>(apiIds));
|
||||
Map<String, String> names = new HashMap<>();
|
||||
for (ApiSpecInfo spec : specs) {
|
||||
names.put(spec.getApiId(), StringUtils.defaultIfBlank(spec.getApiName(), spec.getApiId()));
|
||||
}
|
||||
return names;
|
||||
}
|
||||
|
||||
/** 진행 중(미종결) 장애·지연 중 API 별로 가장 심각한 한 건 */
|
||||
private Map<String, DjbApistatusIncident> mapOpenIncidents(Set<String> apiIds) {
|
||||
List<DjbApistatusIncident> openIncidents = incidentQueryRepository
|
||||
.findVisibleOpenIncidents(IncidentKind.DEGRADING, ApiStatusSupport.CLOSED_STATES);
|
||||
if (openIncidents.isEmpty()) {
|
||||
return Collections.emptyMap();
|
||||
}
|
||||
Map<Long, DjbApistatusIncident> byId = openIncidents.stream()
|
||||
.collect(Collectors.toMap(DjbApistatusIncident::getIncidentId, incident -> incident));
|
||||
|
||||
Map<String, DjbApistatusIncident> byApi = new HashMap<>();
|
||||
for (DjbApistatusIncidentApi api :
|
||||
incidentApiRepository.findByIncidentIdInOrderByIncidentIdAscApiIdAsc(byId.keySet())) {
|
||||
if (!apiIds.contains(api.getApiId()) || api.getRecoveredAt() != null) {
|
||||
continue;
|
||||
}
|
||||
DjbApistatusIncident incident = byId.get(api.getIncidentId());
|
||||
DjbApistatusIncident previous = byApi.get(api.getApiId());
|
||||
// 같은 API 에 여러 장애가 열려 있으면 더 심각한(장애 > 지연, 조사중 > 모니터링) 쪽을 우선한다
|
||||
if (previous == null || severity(incident) < severity(previous)) {
|
||||
byApi.put(api.getApiId(), incident);
|
||||
}
|
||||
}
|
||||
return byApi;
|
||||
}
|
||||
|
||||
/** 이미 시작된 점검 중 API 별로 가장 먼저 시작된 한 건 (예정 점검은 현재 상태가 아니므로 제외) */
|
||||
private Map<String, DjbApistatusIncident> mapStartedMaintenance(Set<String> apiIds, LocalDateTime now) {
|
||||
List<DjbApistatusIncident> maintenances = incidentQueryRepository
|
||||
.findVisibleOngoingMaintenance(IncidentKind.MAINTENANCE, now).stream()
|
||||
.filter(incident -> incident.getStartedAt() != null && !incident.getStartedAt().isAfter(now))
|
||||
.collect(Collectors.toList());
|
||||
if (maintenances.isEmpty()) {
|
||||
return Collections.emptyMap();
|
||||
}
|
||||
Map<Long, DjbApistatusIncident> byId = maintenances.stream()
|
||||
.collect(Collectors.toMap(DjbApistatusIncident::getIncidentId, incident -> incident));
|
||||
|
||||
Map<String, DjbApistatusIncident> byApi = new HashMap<>();
|
||||
for (DjbApistatusIncidentApi api :
|
||||
incidentApiRepository.findByIncidentIdInOrderByIncidentIdAscApiIdAsc(byId.keySet())) {
|
||||
if (!apiIds.contains(api.getApiId())) {
|
||||
continue;
|
||||
}
|
||||
DjbApistatusIncident incident = byId.get(api.getIncidentId());
|
||||
DjbApistatusIncident previous = byApi.get(api.getApiId());
|
||||
if (previous == null
|
||||
|| (incident.getStartedAt() != null && previous.getStartedAt() != null
|
||||
&& incident.getStartedAt().isBefore(previous.getStartedAt()))) {
|
||||
byApi.put(api.getApiId(), incident);
|
||||
}
|
||||
}
|
||||
return byApi;
|
||||
}
|
||||
|
||||
/** 조회 기간 내 마지막 장애·지연 발생 시각 */
|
||||
private Map<String, LocalDateTime> collectLastIncidentAt(Set<String> apiIds, LocalDateTime now, int windowDays) {
|
||||
LocalDateTime windowStart = now.toLocalDate().minusDays(windowDays - 1L).atStartOfDay();
|
||||
List<DjbApistatusIncident> incidents = incidentQueryRepository
|
||||
.findVisibleOverlapping(windowStart, now.toLocalDate().plusDays(1).atStartOfDay()).stream()
|
||||
.filter(incident -> incident.getKind() != null && incident.getKind().isDegrading())
|
||||
.collect(Collectors.toList());
|
||||
if (incidents.isEmpty()) {
|
||||
return Collections.emptyMap();
|
||||
}
|
||||
Map<Long, DjbApistatusIncident> byId = incidents.stream()
|
||||
.collect(Collectors.toMap(DjbApistatusIncident::getIncidentId, incident -> incident));
|
||||
|
||||
Map<String, LocalDateTime> result = new HashMap<>();
|
||||
for (DjbApistatusIncidentApi api :
|
||||
incidentApiRepository.findByIncidentIdInOrderByIncidentIdAscApiIdAsc(byId.keySet())) {
|
||||
if (!apiIds.contains(api.getApiId())) {
|
||||
continue;
|
||||
}
|
||||
LocalDateTime startedAt = byId.get(api.getIncidentId()).getStartedAt();
|
||||
LocalDateTime previous = result.get(api.getApiId());
|
||||
if (startedAt != null && (previous == null || startedAt.isAfter(previous))) {
|
||||
result.put(api.getApiId(), startedAt);
|
||||
}
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* 진행 중 장애·지연 + 점검 여부로 현재 상태를 정한다.
|
||||
*
|
||||
* <p>KIND 가 DELAY 면 지연이다. 장애(INCIDENT)라도 모니터링 단계면 이미 완화된 상태라
|
||||
* 지연으로 표기한다 - 이슈 이력의 유형 필터(KIND 기준)와는 이 지점만 다르다.</p>
|
||||
*/
|
||||
private String resolveStatus(DjbApistatusIncident open, boolean underMaintenance) {
|
||||
if (open != null) {
|
||||
boolean degraded = open.getKind() == IncidentKind.DELAY
|
||||
|| open.getState() == IncidentState.MONITORING;
|
||||
return degraded ? ApiStatusSupport.STATUS_DEGRADED : ApiStatusSupport.STATUS_OUTAGE;
|
||||
}
|
||||
if (underMaintenance) {
|
||||
return ApiStatusSupport.STATUS_MAINTENANCE;
|
||||
}
|
||||
return ApiStatusSupport.STATUS_NORMAL;
|
||||
}
|
||||
|
||||
/**
|
||||
* 같은 API 에 열린 이슈가 여럿일 때의 우선순위 (낮을수록 심각).
|
||||
* 지연은 장애보다 뒤로 민다.
|
||||
*/
|
||||
private int severity(DjbApistatusIncident incident) {
|
||||
if (incident == null) {
|
||||
return 99;
|
||||
}
|
||||
int base = incident.getKind() == IncidentKind.DELAY ? 10 : 0;
|
||||
IncidentState state = incident.getState();
|
||||
if (state == null) {
|
||||
return base + 9;
|
||||
}
|
||||
switch (state) {
|
||||
case INVESTIGATING: return base;
|
||||
case IDENTIFIED: return base + 1;
|
||||
// 모니터링 단계는 지연으로 표기되므로 같은 장애라도 뒤로 민다
|
||||
case MONITORING: return base + 12;
|
||||
default: return base + 8;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,283 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.service;
|
||||
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.ActiveIncidentDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.AffectedApiDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.MaintenanceCardDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.PastIssueCardDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.TimelineEntryDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncident;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncidentApi;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncidentTimeline;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.repository.DjbApistatusIncidentApiRepository;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.repository.DjbApistatusIncidentTimelineRepository;
|
||||
import com.eactive.apim.portal.apps.community.notice.repository.PortalNoticeRepository;
|
||||
import com.eactive.apim.portal.portalNotice.entity.PortalNotice;
|
||||
import lombok.Getter;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import org.apache.commons.lang3.StringUtils;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.ArrayList;
|
||||
import java.util.Collection;
|
||||
import java.util.Collections;
|
||||
import java.util.HashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
/**
|
||||
* 장애/점검 엔티티 → 화면 DTO 변환. 영향 API·타임라인은 한 번에 모아 읽어 1+N 조회를 피한다.
|
||||
*/
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
@Transactional(readOnly = true)
|
||||
public class ApiStatusAssembler {
|
||||
|
||||
private static final int RECENT_TIMELINE_SIZE = 3;
|
||||
|
||||
private final DjbApistatusIncidentApiRepository incidentApiRepository;
|
||||
private final DjbApistatusIncidentTimelineRepository timelineRepository;
|
||||
private final PortalNoticeRepository portalNoticeRepository;
|
||||
private final ApiStatusCatalogService catalogService;
|
||||
|
||||
/**
|
||||
* 영향 인터페이스를 "개발자포탈에 게시된 API" 와 그 외 GW 인터페이스로 가른 결과.
|
||||
* 게시된 것만 개별 노출하고 나머지는 건수로만 알린다.
|
||||
*/
|
||||
@Getter
|
||||
@RequiredArgsConstructor
|
||||
public static class VisibleApis {
|
||||
private final List<AffectedApiDTO> visible;
|
||||
private final int hiddenCount;
|
||||
}
|
||||
|
||||
/**
|
||||
* 이슈 영향 인터페이스에서 현재 사용자에게 공개된 API 만 남긴다.
|
||||
*
|
||||
* <p>이름은 이슈에 캐시된 EAI 서비스명이 아니라 포털 노출명(PTL_API_SPEC_INFO)을 쓴다 -
|
||||
* 같은 API 가 화면마다 다른 이름으로 보이지 않게 한다.</p>
|
||||
*/
|
||||
private VisibleApis splitByVisibility(List<AffectedApiDTO> apis, Map<String, String> visibleNames) {
|
||||
if (apis == null || apis.isEmpty()) {
|
||||
return new VisibleApis(Collections.emptyList(), 0);
|
||||
}
|
||||
List<AffectedApiDTO> visible = new ArrayList<>();
|
||||
int hidden = 0;
|
||||
for (AffectedApiDTO api : apis) {
|
||||
String publishedName = visibleNames.get(api.getApiId());
|
||||
if (publishedName == null) {
|
||||
hidden++;
|
||||
continue;
|
||||
}
|
||||
visible.add(new AffectedApiDTO(api.getApiId(), publishedName, api.getRecoveredAt()));
|
||||
}
|
||||
return new VisibleApis(visible, hidden);
|
||||
}
|
||||
|
||||
public Map<Long, List<AffectedApiDTO>> loadApis(Collection<Long> incidentIds) {
|
||||
if (incidentIds == null || incidentIds.isEmpty()) {
|
||||
return Collections.emptyMap();
|
||||
}
|
||||
Map<Long, List<AffectedApiDTO>> result = new HashMap<>();
|
||||
for (DjbApistatusIncidentApi api :
|
||||
incidentApiRepository.findByIncidentIdInOrderByIncidentIdAscApiIdAsc(incidentIds)) {
|
||||
result.computeIfAbsent(api.getIncidentId(), key -> new ArrayList<>())
|
||||
.add(new AffectedApiDTO(api.getApiId(),
|
||||
StringUtils.defaultIfBlank(api.getApiName(), api.getApiId()),
|
||||
api.getRecoveredAt()));
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* 공개 타임라인. 최신순으로 담는다.
|
||||
*/
|
||||
public Map<Long, List<TimelineEntryDTO>> loadTimelines(Collection<Long> incidentIds) {
|
||||
if (incidentIds == null || incidentIds.isEmpty()) {
|
||||
return Collections.emptyMap();
|
||||
}
|
||||
Map<Long, List<TimelineEntryDTO>> result = new HashMap<>();
|
||||
for (DjbApistatusIncidentTimeline timeline :
|
||||
timelineRepository.findByIncidentIdInAndVisibleYnOrderByEventAtDesc(incidentIds, "Y")) {
|
||||
result.computeIfAbsent(timeline.getIncidentId(), key -> new ArrayList<>())
|
||||
.add(toTimelineEntry(timeline));
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* 이슈에 연결된 공지. 게시 중(USE_YN='Y')인 것만 담는다.
|
||||
*
|
||||
* <p>조회 자체의 공개 조건({@code ApiStatusIncidentQueryRepository.VISIBLE})과 같은 기준이라
|
||||
* 여기서 빠지는 건은 공지가 삭제된 고아 행뿐이다.</p>
|
||||
*/
|
||||
public Map<String, PortalNotice> loadNotices(Collection<String> noticeIds) {
|
||||
if (noticeIds == null || noticeIds.isEmpty()) {
|
||||
return Collections.emptyMap();
|
||||
}
|
||||
List<String> ids = noticeIds.stream()
|
||||
.filter(StringUtils::isNotBlank)
|
||||
.distinct()
|
||||
.collect(Collectors.toList());
|
||||
if (ids.isEmpty()) {
|
||||
return Collections.emptyMap();
|
||||
}
|
||||
Map<String, PortalNotice> result = new HashMap<>();
|
||||
for (PortalNotice notice : portalNoticeRepository.findByIdInAndUseYn(ids, "Y")) {
|
||||
result.put(notice.getId(), notice);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
public List<ActiveIncidentDTO> toActiveIncidents(List<DjbApistatusIncident> incidents, LocalDateTime now) {
|
||||
if (incidents.isEmpty()) {
|
||||
return Collections.emptyList();
|
||||
}
|
||||
List<Long> ids = incidentIds(incidents);
|
||||
Map<Long, List<AffectedApiDTO>> apis = loadApis(ids);
|
||||
Map<Long, List<TimelineEntryDTO>> timelines = loadTimelines(ids);
|
||||
Map<String, String> visibleNames = catalogService.getVisibleApiNames();
|
||||
Map<String, PortalNotice> notices = loadNotices(incidents.stream()
|
||||
.map(DjbApistatusIncident::getNoticeId)
|
||||
.collect(Collectors.toList()));
|
||||
|
||||
List<ActiveIncidentDTO> result = new ArrayList<>();
|
||||
for (DjbApistatusIncident incident : incidents) {
|
||||
ActiveIncidentDTO dto = new ActiveIncidentDTO();
|
||||
dto.setIncidentId(incident.getIncidentId());
|
||||
dto.setNoticeId(incident.getNoticeId());
|
||||
dto.setKind(incident.getKind() == null ? null : incident.getKind().name());
|
||||
dto.setState(incident.getState() == null ? null : incident.getState().name());
|
||||
dto.setStateLabel(ApiStatusSupport.stateLabel(incident.getState()));
|
||||
dto.setTitle(incident.getTitle());
|
||||
dto.setSummary(incident.getSummary());
|
||||
dto.setStartedAt(incident.getStartedAt());
|
||||
dto.setElapsedMinutes(ApiStatusSupport.minutesBetween(incident.getStartedAt(), now));
|
||||
VisibleApis affected = splitByVisibility(
|
||||
apis.getOrDefault(incident.getIncidentId(), Collections.emptyList()), visibleNames);
|
||||
dto.setApis(affected.getVisible());
|
||||
dto.setHiddenApiCount(affected.getHiddenCount());
|
||||
|
||||
PortalNotice notice = incident.getNoticeId() == null ? null : notices.get(incident.getNoticeId());
|
||||
if (notice != null) {
|
||||
dto.setNoticeSubject(notice.getNoticeSubject());
|
||||
dto.setNoticeDetail(notice.getNoticeDetail());
|
||||
}
|
||||
|
||||
List<TimelineEntryDTO> all = timelines.getOrDefault(incident.getIncidentId(), Collections.emptyList());
|
||||
dto.setRecentTimeline(all.size() > RECENT_TIMELINE_SIZE
|
||||
? new ArrayList<>(all.subList(0, RECENT_TIMELINE_SIZE)) : all);
|
||||
result.add(dto);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
public List<MaintenanceCardDTO> toMaintenanceCards(List<DjbApistatusIncident> incidents) {
|
||||
if (incidents.isEmpty()) {
|
||||
return Collections.emptyList();
|
||||
}
|
||||
Map<Long, List<AffectedApiDTO>> apis = loadApis(incidentIds(incidents));
|
||||
Map<String, String> visibleNames = catalogService.getVisibleApiNames();
|
||||
Map<String, PortalNotice> notices = loadNotices(incidents.stream()
|
||||
.map(DjbApistatusIncident::getNoticeId)
|
||||
.collect(Collectors.toList()));
|
||||
|
||||
List<MaintenanceCardDTO> result = new ArrayList<>();
|
||||
for (DjbApistatusIncident incident : incidents) {
|
||||
MaintenanceCardDTO dto = new MaintenanceCardDTO();
|
||||
dto.setIncidentId(incident.getIncidentId());
|
||||
dto.setNoticeId(incident.getNoticeId());
|
||||
|
||||
PortalNotice notice = incident.getNoticeId() == null ? null : notices.get(incident.getNoticeId());
|
||||
if (notice != null) {
|
||||
dto.setNoticeSubject(notice.getNoticeSubject());
|
||||
dto.setNoticeDetail(notice.getNoticeDetail());
|
||||
}
|
||||
|
||||
dto.setTitle(incident.getTitle());
|
||||
dto.setSummary(incident.getSummary());
|
||||
dto.setStartedAt(incident.getStartedAt());
|
||||
dto.setEndAt(incident.getEndAt());
|
||||
dto.setDurationMinutes(incident.getEndAt() == null ? null
|
||||
: ApiStatusSupport.minutesBetween(incident.getStartedAt(), incident.getEndAt()));
|
||||
VisibleApis affected = splitByVisibility(
|
||||
apis.getOrDefault(incident.getIncidentId(), Collections.emptyList()), visibleNames);
|
||||
dto.setImpactedApis(affected.getVisible());
|
||||
dto.setHiddenApiCount(affected.getHiddenCount());
|
||||
dto.setRegisteredAt(incident.getCreatedDate());
|
||||
dto.setLastModifiedAt(incident.getLastModifiedDate());
|
||||
result.add(dto);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* 지난 이슈 카드. 장애·지연은 타임라인 전체를 붙이고 점검은 붙이지 않는다 (ADR-F15).
|
||||
*/
|
||||
public List<PastIssueCardDTO> toPastIssueCards(List<DjbApistatusIncident> incidents) {
|
||||
if (incidents.isEmpty()) {
|
||||
return Collections.emptyList();
|
||||
}
|
||||
List<Long> ids = incidentIds(incidents);
|
||||
Map<Long, List<AffectedApiDTO>> apis = loadApis(ids);
|
||||
Map<String, String> visibleNames = catalogService.getVisibleApiNames();
|
||||
|
||||
List<Long> incidentKindIds = incidents.stream()
|
||||
.filter(incident -> incident.getKind() != null && incident.getKind().isDegrading())
|
||||
.map(DjbApistatusIncident::getIncidentId)
|
||||
.collect(Collectors.toList());
|
||||
Map<Long, List<TimelineEntryDTO>> timelines = loadTimelines(incidentKindIds);
|
||||
Map<String, PortalNotice> notices = loadNotices(incidents.stream()
|
||||
.map(DjbApistatusIncident::getNoticeId)
|
||||
.collect(Collectors.toList()));
|
||||
|
||||
List<PastIssueCardDTO> result = new ArrayList<>();
|
||||
for (DjbApistatusIncident incident : incidents) {
|
||||
PastIssueCardDTO dto = new PastIssueCardDTO();
|
||||
dto.setIncidentId(incident.getIncidentId());
|
||||
dto.setNoticeId(incident.getNoticeId());
|
||||
|
||||
PortalNotice notice = incident.getNoticeId() == null ? null : notices.get(incident.getNoticeId());
|
||||
if (notice != null) {
|
||||
dto.setNoticeSubject(notice.getNoticeSubject());
|
||||
dto.setNoticeDetail(notice.getNoticeDetail());
|
||||
}
|
||||
|
||||
dto.setKind(incident.getKind() == null ? null : incident.getKind().name());
|
||||
dto.setState(incident.getState() == null ? null : incident.getState().name());
|
||||
dto.setStateLabel(ApiStatusSupport.stateLabel(incident.getState()));
|
||||
dto.setTitle(incident.getTitle());
|
||||
dto.setSummary(incident.getSummary());
|
||||
dto.setStartedAt(incident.getStartedAt());
|
||||
dto.setEndAt(incident.getEndAt());
|
||||
dto.setDateGroup(incident.getStartedAt() == null ? null : incident.getStartedAt().toLocalDate());
|
||||
dto.setDurationMinutes(incident.getEndAt() == null ? null
|
||||
: ApiStatusSupport.minutesBetween(incident.getStartedAt(), incident.getEndAt()));
|
||||
VisibleApis affected = splitByVisibility(
|
||||
apis.getOrDefault(incident.getIncidentId(), Collections.emptyList()), visibleNames);
|
||||
dto.setImpactedApis(affected.getVisible());
|
||||
dto.setHiddenApiCount(affected.getHiddenCount());
|
||||
dto.setTimeline(timelines.getOrDefault(incident.getIncidentId(), Collections.emptyList()));
|
||||
result.add(dto);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
private TimelineEntryDTO toTimelineEntry(DjbApistatusIncidentTimeline timeline) {
|
||||
TimelineEntryDTO dto = new TimelineEntryDTO();
|
||||
dto.setTimelineId(timeline.getTimelineId());
|
||||
dto.setEventAt(timeline.getEventAt());
|
||||
dto.setStateAfter(timeline.getStateAfter() == null ? null : timeline.getStateAfter().name());
|
||||
dto.setLabelKo(ApiStatusSupport.stateLabel(timeline.getStateAfter()));
|
||||
dto.setBody(timeline.getBody());
|
||||
dto.setAuthorType(timeline.getAuthorType());
|
||||
return dto;
|
||||
}
|
||||
|
||||
private List<Long> incidentIds(List<DjbApistatusIncident> incidents) {
|
||||
return incidents.stream().map(DjbApistatusIncident::getIncidentId).collect(Collectors.toList());
|
||||
}
|
||||
}
|
||||
+198
@@ -0,0 +1,198 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.service;
|
||||
|
||||
import com.eactive.apim.gateway.data.statistics.repository.GwApiStatusRepository;
|
||||
import com.eactive.apim.portal.apps.apis.dto.ApiSpecInfoDto;
|
||||
import com.eactive.apim.portal.apps.apis.service.ApiSearchFacade;
|
||||
import com.eactive.apim.portal.apps.apiservice.dto.ApiGroupSearch;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.ApiOptionDTO;
|
||||
import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.apache.commons.lang3.StringUtils;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import javax.persistence.EntityManager;
|
||||
import javax.persistence.PersistenceContext;
|
||||
import java.time.Instant;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.Collections;
|
||||
import java.util.Comparator;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
/**
|
||||
* API Status 화면의 부가 조회 - 필터용 API 목록, 상태 모니터링 최근 실행 시각.
|
||||
*/
|
||||
@Slf4j
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
@Transactional(readOnly = true)
|
||||
public class ApiStatusCatalogService {
|
||||
|
||||
public static final String PROPERTY_GROUP = "Portal";
|
||||
|
||||
/** API 상태 모니터링 Quartz Job 이름 (eapim-admin QRTZ_JOB_DETAILS.JOB_NAME) */
|
||||
public static final String KEY_MONITOR_JOB_NAME = "djb.apistatus.monitor.job-name";
|
||||
|
||||
/** 실서버(DAPM) QRTZ_JOB_DETAILS 실사값 (2026-07-31) */
|
||||
private static final String DEFAULT_MONITOR_JOB_NAME = "ApiStatusMonitorJob";
|
||||
|
||||
/** 상태/이력 조회 기간(일). 가동률 바·이슈 인덱스·date picker 범위가 모두 이 값을 따른다 */
|
||||
public static final String KEY_WINDOW_DAYS = "djb.apistatus.window-days";
|
||||
|
||||
/** OPEN API 목록 카드의 현재 상태 태그 노출 여부 (true/false) */
|
||||
public static final String KEY_API_LIST_STATUS_BADGE = "djb.apistatus.api-list-status-badge";
|
||||
|
||||
private static final boolean DEFAULT_API_LIST_STATUS_BADGE = true;
|
||||
|
||||
private static final int MIN_WINDOW_DAYS = 1;
|
||||
private static final int MAX_WINDOW_DAYS = 365;
|
||||
|
||||
private final ApiSearchFacade apiSearchFacade;
|
||||
private final PortalPropertyService portalPropertyService;
|
||||
private final GwApiStatusRepository gwApiStatusRepository;
|
||||
|
||||
@PersistenceContext
|
||||
private EntityManager entityManager;
|
||||
|
||||
/**
|
||||
* 이슈 이력 필터용 API 목록.
|
||||
*
|
||||
* <p>"오픈 API" 목록 화면과 <b>같은 조회 경로</b>({@link ApiSearchFacade#searchApis})를 쓴다.
|
||||
* 즉 API 그룹(AGWAPP.API_GROUP + API_GROUP_API)에 편성된 API 중
|
||||
* PTL_API_SPEC_INFO 에 스펙이 있고 현재 사용자에게 공개된 것만 나온다.</p>
|
||||
*/
|
||||
@SuppressWarnings("unchecked")
|
||||
public List<ApiOptionDTO> getSelectableApis() {
|
||||
Object apis = apiSearchFacade.searchApis(new ApiGroupSearch()).get("apis");
|
||||
if (!(apis instanceof List)) {
|
||||
return Collections.emptyList();
|
||||
}
|
||||
|
||||
return ((List<ApiSpecInfoDto>) apis).stream()
|
||||
.filter(api -> StringUtils.isNotBlank(api.getApiId()))
|
||||
.map(api -> new ApiOptionDTO(api.getApiId(),
|
||||
StringUtils.defaultIfBlank(api.getApiName(), api.getApiId()),
|
||||
api.getApiGroupName()))
|
||||
.sorted(Comparator.comparing(ApiOptionDTO::getApiName,
|
||||
Comparator.nullsLast(Comparator.naturalOrder())))
|
||||
.collect(Collectors.toList());
|
||||
}
|
||||
|
||||
/**
|
||||
* 현재 사용자에게 공개된 API 의 {API ID → 노출명} 맵.
|
||||
*
|
||||
* <p>GW 인터페이스는 전부 이슈 데이터(DJB_APISTATUS_INCIDENT_API)에 들어오지만
|
||||
* 개발자포탈에 게시되는 것은 그 일부(= API)뿐이다. 화면은 이 맵에 있는 것만
|
||||
* 개별 이름으로 노출하고 나머지는 건수로 묶는다.</p>
|
||||
*
|
||||
* <p>{@link #getSelectableApis()} 와 같은 경로라 역할·소속에 따른 공개 범위가 그대로 반영된다.</p>
|
||||
*/
|
||||
public Map<String, String> getVisibleApiNames() {
|
||||
Map<String, String> names = new LinkedHashMap<>();
|
||||
for (ApiOptionDTO api : getSelectableApis()) {
|
||||
names.put(api.getApiId(), api.getApiName());
|
||||
}
|
||||
return names;
|
||||
}
|
||||
|
||||
/**
|
||||
* API 상태 모니터링 Job(eapim-admin Quartz)의 마지막 실행 시각.
|
||||
*
|
||||
* <p>Job 이름은 PTL_PROPERTY({@code Portal} / {@code djb.apistatus.monitor.job-name})로
|
||||
* 바꿀 수 있으며, 최초 접근 시 기본값으로 row 가 자동 생성된다.
|
||||
* Quartz 메타(QRTZ_TRIGGERS)는 EMSAPP 스키마라 EMS EntityManager 로 직접 읽는다.</p>
|
||||
*
|
||||
* <p>readOnly 를 풀어야 최초 접근 시 프로퍼티 row 자동 생성(INSERT)이 가능하다.</p>
|
||||
*/
|
||||
@Transactional
|
||||
public LocalDateTime getLastMonitorFireAt() {
|
||||
try {
|
||||
String jobName = portalPropertyService.getOrCreateProperty(
|
||||
PROPERTY_GROUP, KEY_MONITOR_JOB_NAME, DEFAULT_MONITOR_JOB_NAME,
|
||||
"API 상태 모니터링 Quartz Job 이름 (eapim-admin QRTZ_JOB_DETAILS.JOB_NAME)");
|
||||
if (StringUtils.isBlank(jobName)) {
|
||||
jobName = DEFAULT_MONITOR_JOB_NAME;
|
||||
}
|
||||
|
||||
Object fireTime = entityManager.createNativeQuery(
|
||||
"SELECT MAX(PREV_FIRE_TIME) FROM QRTZ_TRIGGERS WHERE JOB_NAME = :jobName")
|
||||
.setParameter("jobName", jobName)
|
||||
.getSingleResult();
|
||||
if (!(fireTime instanceof Number)) {
|
||||
return null;
|
||||
}
|
||||
long epochMillis = ((Number) fireTime).longValue();
|
||||
if (epochMillis <= 0) {
|
||||
return null;
|
||||
}
|
||||
return LocalDateTime.ofInstant(Instant.ofEpochMilli(epochMillis), ApiStatusSupport.ZONE);
|
||||
} catch (Exception e) {
|
||||
// 스케줄 메타 조회 실패가 화면 전체를 막지 않도록 한다
|
||||
log.warn("API 상태 모니터링 실행 시각 조회 실패", e);
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 상태/이력 조회 기간(일). PTL_PROPERTY({@code Portal} / {@code djb.apistatus.window-days})로
|
||||
* 조절하며 1~365 로 clamp 한다. 값이 이상하면 기본 90일.
|
||||
*/
|
||||
@Transactional
|
||||
public int getWindowDays() {
|
||||
try {
|
||||
String value = portalPropertyService.getOrCreateProperty(
|
||||
PROPERTY_GROUP, KEY_WINDOW_DAYS,
|
||||
String.valueOf(ApiStatusSupport.DEFAULT_WINDOW_DAYS),
|
||||
"API Status 조회 기간(일). 가동률 바·이슈 인덱스·날짜 선택 범위에 적용 (1~365)");
|
||||
int days = Integer.parseInt(StringUtils.trimToEmpty(value));
|
||||
return Math.max(MIN_WINDOW_DAYS, Math.min(MAX_WINDOW_DAYS, days));
|
||||
} catch (Exception e) {
|
||||
log.warn("조회 기간 프로퍼티 해석 실패 - 기본값 {}일 사용", ApiStatusSupport.DEFAULT_WINDOW_DAYS, e);
|
||||
return ApiStatusSupport.DEFAULT_WINDOW_DAYS;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* OPEN API 목록(/apis) 카드에 현재 상태 태그를 노출할지 여부.
|
||||
* PTL_PROPERTY({@code Portal} / {@code djb.apistatus.api-list-status-badge}) 로 켜고 끈다.
|
||||
*
|
||||
* <p>{@code true/Y/1} 이면 노출, {@code false/N/0} 이면 숨김. 값이 비었거나 이상하면 기본 노출.</p>
|
||||
*/
|
||||
@Transactional
|
||||
public boolean isApiListStatusBadgeEnabled() {
|
||||
try {
|
||||
String value = portalPropertyService.getOrCreateProperty(
|
||||
PROPERTY_GROUP, KEY_API_LIST_STATUS_BADGE,
|
||||
String.valueOf(DEFAULT_API_LIST_STATUS_BADGE),
|
||||
"OPEN API 목록 카드에 현재 상태(정상/점검/지연/장애) 태그 노출 여부 (true/false)");
|
||||
String normalized = StringUtils.trimToEmpty(value);
|
||||
if (StringUtils.equalsAnyIgnoreCase(normalized, "false", "n", "0")) {
|
||||
return false;
|
||||
}
|
||||
if (StringUtils.equalsAnyIgnoreCase(normalized, "true", "y", "1")) {
|
||||
return true;
|
||||
}
|
||||
return DEFAULT_API_LIST_STATUS_BADGE;
|
||||
} catch (Exception e) {
|
||||
log.warn("API 목록 상태 태그 노출 프로퍼티 조회 실패 - 기본값 {} 사용", DEFAULT_API_LIST_STATUS_BADGE, e);
|
||||
return DEFAULT_API_LIST_STATUS_BADGE;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* API 상태가 마지막으로 <b>변경</b>된 시각 (AGWAPP.API_STATUS 최근 upsert).
|
||||
* 실행 시각(fire)과 달리 상태 변화가 있을 때만 갱신된다.
|
||||
*/
|
||||
public LocalDateTime getLastStatusChangedAt() {
|
||||
try {
|
||||
return gwApiStatusRepository.findLastModifiedDate().orElse(null);
|
||||
} catch (Exception e) {
|
||||
log.warn("API 상태 변경 시각 조회 실패", e);
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
+159
@@ -0,0 +1,159 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.service;
|
||||
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.IssueDateEntryDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.PastIssueCardDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncident;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind;
|
||||
import com.eactive.apim.portal.djb.apistatus.repository.ApiStatusIncidentQueryRepository;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import org.apache.commons.lang3.StringUtils;
|
||||
import org.springframework.data.domain.Page;
|
||||
import org.springframework.data.domain.PageImpl;
|
||||
import org.springframework.data.domain.Pageable;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.time.LocalDate;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.ArrayList;
|
||||
import java.util.Collections;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
/**
|
||||
* 전체 이슈 이력 페이지 조회 (ADR-F16/F17). 필터는 날짜와 API 두 축만 지원한다.
|
||||
*/
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
@Transactional(readOnly = true)
|
||||
public class ApiStatusIssueHistoryService {
|
||||
|
||||
private final ApiStatusIncidentQueryRepository incidentQueryRepository;
|
||||
private final ApiStatusAssembler assembler;
|
||||
private final ApiStatusCatalogService catalogService;
|
||||
|
||||
/**
|
||||
* P9 - 90일 인덱스바용 일자별 이슈 집계. 이슈가 여러 날에 걸치면 걸친 날짜 모두에 집계한다.
|
||||
*/
|
||||
public List<IssueDateEntryDTO> getIssueDates(int days, String apiId, String kind) {
|
||||
int windowDays = days <= 0 ? ApiStatusSupport.DEFAULT_WINDOW_DAYS : Math.min(days, 365);
|
||||
LocalDateTime now = ApiStatusSupport.now();
|
||||
LocalDate today = now.toLocalDate();
|
||||
LocalDate from = today.minusDays(windowDays - 1L);
|
||||
LocalDateTime windowStart = from.atStartOfDay();
|
||||
LocalDateTime windowEnd = today.plusDays(1).atStartOfDay();
|
||||
|
||||
List<DjbApistatusIncident> incidents = findOverlapping(windowStart, windowEnd, apiId, kind);
|
||||
|
||||
Map<LocalDate, IssueDateEntryDTO> byDate = new LinkedHashMap<>();
|
||||
for (int offset = 0; offset < windowDays; offset++) {
|
||||
LocalDate date = from.plusDays(offset);
|
||||
IssueDateEntryDTO entry = new IssueDateEntryDTO();
|
||||
entry.setDate(date);
|
||||
byDate.put(date, entry);
|
||||
}
|
||||
|
||||
for (DjbApistatusIncident incident : incidents) {
|
||||
if (incident.getStartedAt() == null) {
|
||||
continue;
|
||||
}
|
||||
LocalDate start = incident.getStartedAt().toLocalDate();
|
||||
LocalDateTime effectiveEnd = incident.getEndAt() == null ? now : incident.getEndAt();
|
||||
LocalDate end = effectiveEnd.toLocalDate();
|
||||
|
||||
LocalDate cursor = start.isBefore(from) ? from : start;
|
||||
LocalDate last = end.isAfter(today) ? today : end;
|
||||
|
||||
while (!cursor.isAfter(last)) {
|
||||
IssueDateEntryDTO entry = byDate.get(cursor);
|
||||
if (entry != null) {
|
||||
tally(entry, incident);
|
||||
}
|
||||
cursor = cursor.plusDays(1);
|
||||
}
|
||||
}
|
||||
|
||||
return new ArrayList<>(byDate.values());
|
||||
}
|
||||
|
||||
/**
|
||||
* 인덱스바 1칸에 이슈 1건을 집계한다. 유형은 이슈 목록 필터와 같은 세 축(장애/지연/점검)으로 가른다.
|
||||
*/
|
||||
private void tally(IssueDateEntryDTO entry, DjbApistatusIncident incident) {
|
||||
IncidentKind kind = incident.getKind();
|
||||
if (kind == null) {
|
||||
return;
|
||||
}
|
||||
switch (kind) {
|
||||
case MAINTENANCE: entry.setMntCount(entry.getMntCount() + 1); break;
|
||||
case DELAY: entry.setDlyCount(entry.getDlyCount() + 1); break;
|
||||
default: entry.setIncCount(entry.getIncCount() + 1); break;
|
||||
}
|
||||
if (!entry.getKinds().contains(kind.name())) {
|
||||
entry.getKinds().add(kind.name());
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* P10 - 날짜/API/유형 필터 이슈 목록. 날짜 미지정 시 90일 전체.
|
||||
*/
|
||||
public Page<PastIssueCardDTO> getIssues(LocalDate date, String apiId, String kind, Pageable pageable) {
|
||||
LocalDateTime now = ApiStatusSupport.now();
|
||||
LocalDateTime from;
|
||||
LocalDateTime to;
|
||||
|
||||
if (date == null) {
|
||||
LocalDate today = now.toLocalDate();
|
||||
from = today.minusDays(catalogService.getWindowDays() - 1L).atStartOfDay();
|
||||
to = today.plusDays(1).atStartOfDay();
|
||||
} else {
|
||||
from = date.atStartOfDay();
|
||||
to = date.plusDays(1).atStartOfDay();
|
||||
}
|
||||
|
||||
List<DjbApistatusIncident> incidents = findOverlapping(from, to, apiId, kind);
|
||||
if (incidents.isEmpty()) {
|
||||
return new PageImpl<>(Collections.emptyList(), pageable, 0);
|
||||
}
|
||||
|
||||
int offset = (int) pageable.getOffset();
|
||||
if (offset >= incidents.size()) {
|
||||
return new PageImpl<>(Collections.emptyList(), pageable, incidents.size());
|
||||
}
|
||||
int end = Math.min(offset + pageable.getPageSize(), incidents.size());
|
||||
|
||||
List<PastIssueCardDTO> content = assembler.toPastIssueCards(incidents.subList(offset, end));
|
||||
return new PageImpl<>(content, pageable, incidents.size());
|
||||
}
|
||||
|
||||
private List<DjbApistatusIncident> findOverlapping(LocalDateTime from, LocalDateTime to,
|
||||
String apiId, String kind) {
|
||||
List<DjbApistatusIncident> incidents = StringUtils.isBlank(apiId)
|
||||
? incidentQueryRepository.findVisibleOverlapping(from, to)
|
||||
: incidentQueryRepository.findVisibleOverlappingByApi(from, to, apiId);
|
||||
|
||||
java.util.function.Predicate<DjbApistatusIncident> filter = kindFilter(kind);
|
||||
if (filter == null) {
|
||||
return incidents;
|
||||
}
|
||||
return incidents.stream().filter(filter).collect(Collectors.toList());
|
||||
}
|
||||
|
||||
/**
|
||||
* 유형 필터. 미지정/ALL/알 수 없는 값은 전체(null)로 본다.
|
||||
* 필터 값은 {@link IncidentKind} 이름 그대로다 (INCIDENT / DELAY / MAINTENANCE).
|
||||
*/
|
||||
private java.util.function.Predicate<DjbApistatusIncident> kindFilter(String kind) {
|
||||
if (StringUtils.isBlank(kind) || "ALL".equalsIgnoreCase(kind)) {
|
||||
return null;
|
||||
}
|
||||
try {
|
||||
IncidentKind selected = IncidentKind.valueOf(kind.trim().toUpperCase());
|
||||
return incident -> incident.getKind() == selected;
|
||||
} catch (IllegalArgumentException e) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
+59
@@ -0,0 +1,59 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.service;
|
||||
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.ActiveIncidentDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.MaintenanceCardDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.PastIssueCardDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncident;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind;
|
||||
import com.eactive.apim.portal.djb.apistatus.repository.ApiStatusIncidentQueryRepository;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import org.springframework.data.domain.PageRequest;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.List;
|
||||
import java.util.Optional;
|
||||
|
||||
/**
|
||||
* API Status 메인 화면 조회 (진행 중 장애 / 점검 사항 / 지난 이슈 / 이슈 상세).
|
||||
*/
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
@Transactional(readOnly = true)
|
||||
public class ApiStatusQueryService {
|
||||
|
||||
private final ApiStatusIncidentQueryRepository incidentQueryRepository;
|
||||
private final ApiStatusAssembler assembler;
|
||||
|
||||
/** P3 - 진행 중 장애·지연 */
|
||||
public List<ActiveIncidentDTO> getActiveIncidents() {
|
||||
LocalDateTime now = ApiStatusSupport.now();
|
||||
List<DjbApistatusIncident> incidents = incidentQueryRepository
|
||||
.findVisibleOpenIncidents(IncidentKind.DEGRADING, ApiStatusSupport.CLOSED_STATES);
|
||||
return assembler.toActiveIncidents(incidents, now);
|
||||
}
|
||||
|
||||
/** P5 - 예정/진행 중 점검 */
|
||||
public List<MaintenanceCardDTO> getOngoingMaintenance() {
|
||||
List<DjbApistatusIncident> incidents = incidentQueryRepository
|
||||
.findVisibleOngoingMaintenance(IncidentKind.MAINTENANCE, ApiStatusSupport.now());
|
||||
return assembler.toMaintenanceCards(incidents);
|
||||
}
|
||||
|
||||
/** P6 - 종결된 이슈 최근 N건 */
|
||||
public List<PastIssueCardDTO> getRecentClosedIssues(int size) {
|
||||
int limit = size <= 0 ? 5 : Math.min(size, 50);
|
||||
List<DjbApistatusIncident> incidents = incidentQueryRepository
|
||||
.findVisibleClosedIssues(ApiStatusSupport.CLOSED_STATES, ApiStatusSupport.now(),
|
||||
PageRequest.of(0, limit))
|
||||
.getContent();
|
||||
return assembler.toPastIssueCards(incidents);
|
||||
}
|
||||
|
||||
/** P7 - 이슈 공개 상세 */
|
||||
public Optional<PastIssueCardDTO> getIssueDetail(Long incidentId) {
|
||||
return incidentQueryRepository.findVisibleById(incidentId)
|
||||
.map(incident -> assembler.toPastIssueCards(java.util.Collections.singletonList(incident)).get(0));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,132 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.service;
|
||||
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncident;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentState;
|
||||
|
||||
import java.time.Duration;
|
||||
import java.time.LocalDateTime;
|
||||
import java.time.ZoneId;
|
||||
import java.util.Arrays;
|
||||
import java.util.Collections;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* API Status 조회 서비스 공통 상수/헬퍼.
|
||||
*/
|
||||
public final class ApiStatusSupport {
|
||||
|
||||
/** 일자 경계 기준 timezone (OQ-10) */
|
||||
public static final ZoneId ZONE = ZoneId.of("Asia/Seoul");
|
||||
|
||||
/** 90일 가동률/이력 인덱스 기본 조회 일수 */
|
||||
public static final int DEFAULT_WINDOW_DAYS = 90;
|
||||
|
||||
/** 장애 종결 상태 */
|
||||
public static final List<IncidentState> CLOSED_STATES =
|
||||
Collections.unmodifiableList(Arrays.asList(IncidentState.RESOLVED, IncidentState.CANCELED));
|
||||
|
||||
public static final String STATUS_NORMAL = "NORMAL";
|
||||
public static final String STATUS_DEGRADED = "DEGRADED";
|
||||
public static final String STATUS_OUTAGE = "OUTAGE";
|
||||
public static final String STATUS_MAINTENANCE = "MAINTENANCE";
|
||||
|
||||
private ApiStatusSupport() {
|
||||
}
|
||||
|
||||
public static LocalDateTime now() {
|
||||
return LocalDateTime.now(ZONE);
|
||||
}
|
||||
|
||||
/** 지연 건인지 여부 (장애와 구분) */
|
||||
public static boolean isDelay(DjbApistatusIncident incident) {
|
||||
return incident != null && incident.getKind() == IncidentKind.DELAY;
|
||||
}
|
||||
|
||||
/** 이슈 종류에 대응하는 현재 상태 코드 */
|
||||
public static String statusOf(IncidentKind kind) {
|
||||
if (kind == null) {
|
||||
return STATUS_NORMAL;
|
||||
}
|
||||
switch (kind) {
|
||||
case INCIDENT: return STATUS_OUTAGE;
|
||||
case DELAY: return STATUS_DEGRADED;
|
||||
case MAINTENANCE: return STATUS_MAINTENANCE;
|
||||
default: return STATUS_NORMAL;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 상태 심각도 순위 (낮을수록 심각). 정렬·상태 병합에 함께 쓴다.
|
||||
*/
|
||||
public static int statusRank(String status) {
|
||||
if (status == null) {
|
||||
return 9;
|
||||
}
|
||||
switch (status) {
|
||||
case STATUS_OUTAGE: return 0;
|
||||
case STATUS_MAINTENANCE: return 1;
|
||||
case STATUS_DEGRADED: return 2;
|
||||
default: return 3;
|
||||
}
|
||||
}
|
||||
|
||||
public static String stateLabel(IncidentState state) {
|
||||
if (state == null) {
|
||||
return null;
|
||||
}
|
||||
switch (state) {
|
||||
case INVESTIGATING: return "발생";
|
||||
case IDENTIFIED: return "원인 확인";
|
||||
case MONITORING: return "모니터링";
|
||||
case RESOLVED: return "해소";
|
||||
case CANCELED: return "취소";
|
||||
default: return state.name();
|
||||
}
|
||||
}
|
||||
|
||||
public static String statusLabel(String status) {
|
||||
if (status == null) {
|
||||
return null;
|
||||
}
|
||||
switch (status) {
|
||||
case STATUS_NORMAL: return "정상";
|
||||
case STATUS_DEGRADED: return "지연";
|
||||
case STATUS_OUTAGE: return "장애";
|
||||
case STATUS_MAINTENANCE: return "점검";
|
||||
default: return status;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 두 시각 사이의 분. 종료가 없거나 역순이면 0.
|
||||
*/
|
||||
public static long minutesBetween(LocalDateTime from, LocalDateTime to) {
|
||||
if (from == null || to == null || !to.isAfter(from)) {
|
||||
return 0L;
|
||||
}
|
||||
return Duration.between(from, to).toMinutes();
|
||||
}
|
||||
|
||||
/**
|
||||
* "N분 전" 형태의 상대 시간 표기.
|
||||
*/
|
||||
public static String relativeTime(LocalDateTime past, LocalDateTime now) {
|
||||
if (past == null || now == null) {
|
||||
return null;
|
||||
}
|
||||
long minutes = Duration.between(past, now).toMinutes();
|
||||
if (minutes < 1) {
|
||||
return "방금 전";
|
||||
}
|
||||
if (minutes < 60) {
|
||||
return minutes + "분 전";
|
||||
}
|
||||
long hours = minutes / 60;
|
||||
if (hours < 24) {
|
||||
long restMinutes = minutes % 60;
|
||||
return restMinutes == 0 ? hours + "시간 전" : hours + "시간 " + restMinutes + "분 전";
|
||||
}
|
||||
return (hours / 24) + "일 전";
|
||||
}
|
||||
}
|
||||
+236
@@ -0,0 +1,236 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.service;
|
||||
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.DailyStatDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncident;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.DjbApistatusIncidentApi;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.entity.IncidentKind;
|
||||
import com.eactive.apim.portal.djb.apistatus.incident.repository.DjbApistatusIncidentApiRepository;
|
||||
import com.eactive.apim.portal.djb.apistatus.repository.ApiStatusIncidentQueryRepository;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.time.LocalDate;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.ArrayList;
|
||||
import java.util.Collections;
|
||||
import java.util.HashMap;
|
||||
import java.util.HashSet;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.Set;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
/**
|
||||
* 90일 가동률 집계. 일별 캐시 테이블(DJB_APISTATUS_DAILY_STAT) 없이 이슈 구간을 그때그때 합산한다.
|
||||
*
|
||||
* <p>이슈 건수가 연 1천 건 미만이므로 90일 구간을 메모리에서 합산해도 부담이 없다.
|
||||
* 같은 시간대에 겹치는 이슈는 구간 합집합으로 계산해 중복 차감을 막는다.</p>
|
||||
*/
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
@Transactional(readOnly = true)
|
||||
public class ApiStatusUptimeService {
|
||||
|
||||
private final ApiStatusIncidentQueryRepository incidentQueryRepository;
|
||||
private final DjbApistatusIncidentApiRepository incidentApiRepository;
|
||||
|
||||
/** P2 - 90일 가동률 */
|
||||
public List<DailyStatDTO> getDailyStats(int days) {
|
||||
int windowDays = days <= 0 ? ApiStatusSupport.DEFAULT_WINDOW_DAYS : Math.min(days, 365);
|
||||
LocalDateTime now = ApiStatusSupport.now();
|
||||
LocalDate today = now.toLocalDate();
|
||||
LocalDate from = today.minusDays(windowDays - 1L);
|
||||
|
||||
List<DjbApistatusIncident> incidents = incidentQueryRepository
|
||||
.findVisibleOverlapping(from.atStartOfDay(), today.plusDays(1).atStartOfDay());
|
||||
|
||||
List<DailyStatDTO> result = new ArrayList<>();
|
||||
for (int offset = 0; offset < windowDays; offset++) {
|
||||
LocalDate date = from.plusDays(offset);
|
||||
result.add(buildDailyStat(date, incidents, now));
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* API 별 90일 가동률. 장애(INCIDENT) 구간만 차감한다.
|
||||
*/
|
||||
public Map<String, Double> getApiUptimeRatios(Set<String> apiIds, int days) {
|
||||
if (apiIds == null || apiIds.isEmpty()) {
|
||||
return Collections.emptyMap();
|
||||
}
|
||||
int windowDays = days <= 0 ? ApiStatusSupport.DEFAULT_WINDOW_DAYS : Math.min(days, 365);
|
||||
LocalDateTime now = ApiStatusSupport.now();
|
||||
LocalDateTime windowStart = now.toLocalDate().minusDays(windowDays - 1L).atStartOfDay();
|
||||
|
||||
// 장애와 지연 모두 서비스 저하이므로 가동률에서 차감한다. 점검은 계획된 작업이라 제외.
|
||||
List<DjbApistatusIncident> incidents = incidentQueryRepository
|
||||
.findVisibleOverlapping(windowStart, now.toLocalDate().plusDays(1).atStartOfDay()).stream()
|
||||
.filter(incident -> incident.getKind() != null && incident.getKind().isDegrading())
|
||||
.collect(Collectors.toList());
|
||||
|
||||
Map<String, List<long[]>> intervalsByApi = new HashMap<>();
|
||||
if (!incidents.isEmpty()) {
|
||||
Map<Long, DjbApistatusIncident> byId = incidents.stream()
|
||||
.collect(Collectors.toMap(DjbApistatusIncident::getIncidentId, incident -> incident));
|
||||
|
||||
for (DjbApistatusIncidentApi api :
|
||||
incidentApiRepository.findByIncidentIdInOrderByIncidentIdAscApiIdAsc(byId.keySet())) {
|
||||
if (!apiIds.contains(api.getApiId())) {
|
||||
continue;
|
||||
}
|
||||
DjbApistatusIncident incident = byId.get(api.getIncidentId());
|
||||
LocalDateTime start = max(incident.getStartedAt(), windowStart);
|
||||
// 개별 API 복구 시각이 있으면 그 시점까지만 장애로 본다
|
||||
LocalDateTime end = min(firstNonNull(api.getRecoveredAt(), incident.getEndAt(), now), now);
|
||||
long minutes = ApiStatusSupport.minutesBetween(start, end);
|
||||
if (minutes <= 0) {
|
||||
continue;
|
||||
}
|
||||
intervalsByApi.computeIfAbsent(api.getApiId(), key -> new ArrayList<>())
|
||||
.add(new long[]{toEpochMinute(start), toEpochMinute(end)});
|
||||
}
|
||||
}
|
||||
|
||||
long totalMinutes = Math.max(1L, ApiStatusSupport.minutesBetween(windowStart, now));
|
||||
Map<String, Double> ratios = new HashMap<>();
|
||||
for (String apiId : apiIds) {
|
||||
long down = unionMinutes(intervalsByApi.get(apiId));
|
||||
double ratio = (double) (totalMinutes - Math.min(down, totalMinutes)) / totalMinutes;
|
||||
ratios.put(apiId, round4(ratio));
|
||||
}
|
||||
return ratios;
|
||||
}
|
||||
|
||||
private DailyStatDTO buildDailyStat(LocalDate date, List<DjbApistatusIncident> incidents, LocalDateTime now) {
|
||||
LocalDateTime dayStart = date.atStartOfDay();
|
||||
LocalDateTime dayEnd = min(date.plusDays(1).atStartOfDay(), now);
|
||||
|
||||
DailyStatDTO dto = new DailyStatDTO();
|
||||
dto.setStatDate(date);
|
||||
|
||||
if (!dayEnd.isAfter(dayStart)) {
|
||||
// 아직 시작되지 않은 날짜 (오늘 자정 직후 등)
|
||||
dto.setUptimeRatio(1.0d);
|
||||
dto.setStatus(ApiStatusSupport.STATUS_NORMAL);
|
||||
return dto;
|
||||
}
|
||||
|
||||
// 가동률은 장애+지연을 합쳐 차감하므로 합집합 계산용 리스트를 따로 둔다.
|
||||
// (장애와 지연을 나눠 union 한 뒤 더하면 겹치는 구간이 이중 차감된다)
|
||||
List<long[]> incidentIntervals = new ArrayList<>();
|
||||
List<long[]> outageIntervals = new ArrayList<>();
|
||||
List<long[]> delayIntervals = new ArrayList<>();
|
||||
List<long[]> maintenanceIntervals = new ArrayList<>();
|
||||
Set<Long> seen = new HashSet<>();
|
||||
|
||||
for (DjbApistatusIncident incident : incidents) {
|
||||
LocalDateTime start = max(incident.getStartedAt(), dayStart);
|
||||
LocalDateTime end = min(firstNonNull(incident.getEndAt(), now), dayEnd);
|
||||
if (!end.isAfter(start)) {
|
||||
continue;
|
||||
}
|
||||
long[] interval = new long[]{toEpochMinute(start), toEpochMinute(end)};
|
||||
if (incident.getKind() == IncidentKind.MAINTENANCE) {
|
||||
maintenanceIntervals.add(interval);
|
||||
} else {
|
||||
incidentIntervals.add(interval);
|
||||
if (incident.getKind() == IncidentKind.DELAY) {
|
||||
delayIntervals.add(interval);
|
||||
} else {
|
||||
outageIntervals.add(interval);
|
||||
}
|
||||
}
|
||||
if (seen.add(incident.getIncidentId())) {
|
||||
dto.getIssues().add(new DailyStatDTO.IssueRefDTO(incident.getIncidentId(),
|
||||
incident.getKind() == null ? null : incident.getKind().name(),
|
||||
incident.getTitle()));
|
||||
}
|
||||
}
|
||||
|
||||
long dayMinutes = Math.max(1L, ApiStatusSupport.minutesBetween(dayStart, dayEnd));
|
||||
long incidentMinutes = unionMinutes(incidentIntervals);
|
||||
long outageMinutes = unionMinutes(outageIntervals);
|
||||
long delayMinutes = unionMinutes(delayIntervals);
|
||||
long maintenanceMinutes = unionMinutes(maintenanceIntervals);
|
||||
|
||||
dto.setIncidentMinutes(incidentMinutes);
|
||||
dto.setDelayMinutes(delayMinutes);
|
||||
dto.setMaintenanceMinutes(maintenanceMinutes);
|
||||
|
||||
long downMinutes = Math.min(dayMinutes, incidentMinutes + maintenanceMinutes);
|
||||
dto.setUptimeRatio(round4((double) (dayMinutes - downMinutes) / dayMinutes));
|
||||
|
||||
// 색상은 심각한 순으로 하나만 고른다 (장애 > 점검 > 지연)
|
||||
if (outageMinutes > 0) {
|
||||
dto.setStatus(ApiStatusSupport.STATUS_OUTAGE);
|
||||
} else if (maintenanceMinutes > 0) {
|
||||
dto.setStatus(ApiStatusSupport.STATUS_MAINTENANCE);
|
||||
} else if (delayMinutes > 0) {
|
||||
dto.setStatus(ApiStatusSupport.STATUS_DEGRADED);
|
||||
} else {
|
||||
dto.setStatus(ApiStatusSupport.STATUS_NORMAL);
|
||||
}
|
||||
return dto;
|
||||
}
|
||||
|
||||
/**
|
||||
* 겹치는 구간을 합쳐 총 분을 구한다.
|
||||
*/
|
||||
private long unionMinutes(List<long[]> intervals) {
|
||||
if (intervals == null || intervals.isEmpty()) {
|
||||
return 0L;
|
||||
}
|
||||
intervals.sort((left, right) -> Long.compare(left[0], right[0]));
|
||||
|
||||
long total = 0L;
|
||||
long currentStart = intervals.get(0)[0];
|
||||
long currentEnd = intervals.get(0)[1];
|
||||
|
||||
for (int index = 1; index < intervals.size(); index++) {
|
||||
long[] interval = intervals.get(index);
|
||||
if (interval[0] > currentEnd) {
|
||||
total += currentEnd - currentStart;
|
||||
currentStart = interval[0];
|
||||
currentEnd = interval[1];
|
||||
} else if (interval[1] > currentEnd) {
|
||||
currentEnd = interval[1];
|
||||
}
|
||||
}
|
||||
total += currentEnd - currentStart;
|
||||
return total;
|
||||
}
|
||||
|
||||
private long toEpochMinute(LocalDateTime dateTime) {
|
||||
return dateTime.atZone(ApiStatusSupport.ZONE).toEpochSecond() / 60L;
|
||||
}
|
||||
|
||||
private LocalDateTime max(LocalDateTime left, LocalDateTime right) {
|
||||
if (left == null) {
|
||||
return right;
|
||||
}
|
||||
return left.isAfter(right) ? left : right;
|
||||
}
|
||||
|
||||
private LocalDateTime min(LocalDateTime left, LocalDateTime right) {
|
||||
if (left == null) {
|
||||
return right;
|
||||
}
|
||||
return left.isBefore(right) ? left : right;
|
||||
}
|
||||
|
||||
private LocalDateTime firstNonNull(LocalDateTime... candidates) {
|
||||
for (LocalDateTime candidate : candidates) {
|
||||
if (candidate != null) {
|
||||
return candidate;
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
private double round4(double value) {
|
||||
double clamped = Math.max(0.0d, Math.min(1.0d, value));
|
||||
return Math.round(clamped * 10000.0d) / 10000.0d;
|
||||
}
|
||||
}
|
||||
+94
@@ -0,0 +1,94 @@
|
||||
package com.eactive.apim.portal.djb.apistatus.service;
|
||||
|
||||
import com.eactive.apim.portal.app.entity.Credential;
|
||||
import com.eactive.apim.portal.app.repository.CredentialRepository;
|
||||
import com.eactive.apim.portal.apispec.entity.ApiSpecInfo;
|
||||
import com.eactive.apim.portal.common.user.PortalAuthenticatedUser;
|
||||
import com.eactive.apim.portal.common.util.SecurityUtil;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.ApiCurrentStatusDTO;
|
||||
import com.eactive.apim.portal.djb.apistatus.dto.MyApiStatusDTO;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import org.apache.commons.lang3.StringUtils;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.Collections;
|
||||
import java.util.Comparator;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.TreeMap;
|
||||
|
||||
/**
|
||||
* 로그인 사용자가 이용 중인 API 의 현재 상태 (P4).
|
||||
*
|
||||
* <p>대상 API 는 소속 기관이 발급받은 앱(Credential)의 API 목록(ptl_credential_api)이다.
|
||||
* 상태 판정은 {@link ApiCurrentStatusService} 에 위임해 API 상세 화면과 기준을 맞춘다.</p>
|
||||
*/
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
@Transactional(readOnly = true)
|
||||
public class MyApiStatusQueryService {
|
||||
|
||||
private final CredentialRepository credentialRepository;
|
||||
private final ApiCurrentStatusService apiCurrentStatusService;
|
||||
private final ApiStatusUptimeService uptimeService;
|
||||
private final ApiStatusCatalogService catalogService;
|
||||
|
||||
public List<MyApiStatusDTO> getMyApiStatuses() {
|
||||
PortalAuthenticatedUser user = SecurityUtil.getPortalAuthenticatedUser();
|
||||
if (user == null || user.getPortalOrg() == null || StringUtils.isBlank(user.getPortalOrg().getId())) {
|
||||
return Collections.emptyList();
|
||||
}
|
||||
|
||||
Map<String, String> myApis = collectMyApis(user.getPortalOrg().getId());
|
||||
if (myApis.isEmpty()) {
|
||||
return Collections.emptyList();
|
||||
}
|
||||
|
||||
Map<String, ApiCurrentStatusDTO> statuses = apiCurrentStatusService.resolveStatuses(myApis.keySet());
|
||||
Map<String, Double> uptimes =
|
||||
uptimeService.getApiUptimeRatios(myApis.keySet(), catalogService.getWindowDays());
|
||||
|
||||
List<MyApiStatusDTO> result = new ArrayList<>();
|
||||
for (Map.Entry<String, String> entry : myApis.entrySet()) {
|
||||
String apiId = entry.getKey();
|
||||
ApiCurrentStatusDTO status = statuses.get(apiId);
|
||||
|
||||
MyApiStatusDTO dto = new MyApiStatusDTO();
|
||||
dto.setApiId(apiId);
|
||||
// 기관이 발급받은 앱 기준 목록이므로 API 명은 credential 쪽 값을 그대로 쓴다
|
||||
dto.setApiName(entry.getValue());
|
||||
dto.setCurrentStatus(status == null ? ApiStatusSupport.STATUS_NORMAL : status.getCurrentStatus());
|
||||
dto.setCurrentStatusLabel(ApiStatusSupport.statusLabel(dto.getCurrentStatus()));
|
||||
dto.setActiveIncidentId(status == null ? null : status.getActiveIncidentId());
|
||||
dto.setLastIncidentAt(status == null ? null : status.getLastIncidentAt());
|
||||
dto.setUptime90d(uptimes.getOrDefault(apiId, 1.0d));
|
||||
result.add(dto);
|
||||
}
|
||||
|
||||
result.sort(Comparator
|
||||
.comparingInt((MyApiStatusDTO dto) -> ApiStatusSupport.statusRank(dto.getCurrentStatus()))
|
||||
.thenComparing(MyApiStatusDTO::getApiName, Comparator.nullsLast(Comparator.naturalOrder())));
|
||||
return result;
|
||||
}
|
||||
|
||||
/**
|
||||
* 기관이 보유한 앱들의 API 목록 (중복 제거, API 명 기준 정렬)
|
||||
*/
|
||||
private Map<String, String> collectMyApis(String orgId) {
|
||||
Map<String, String> myApis = new TreeMap<>();
|
||||
for (Credential credential : credentialRepository.findAllByOrgid(orgId)) {
|
||||
if (credential.getApiList() == null) {
|
||||
continue;
|
||||
}
|
||||
for (ApiSpecInfo api : credential.getApiList()) {
|
||||
if (StringUtils.isBlank(api.getApiId())) {
|
||||
continue;
|
||||
}
|
||||
myApis.put(api.getApiId(), StringUtils.defaultIfBlank(api.getApiName(), api.getApiId()));
|
||||
}
|
||||
}
|
||||
return myApis;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,22 @@
|
||||
package com.eactive.apim.portal.djb.footer;
|
||||
|
||||
import lombok.AllArgsConstructor;
|
||||
import lombok.Getter;
|
||||
import lombok.ToString;
|
||||
|
||||
/**
|
||||
* 푸터 "관련 사이트" 셀렉트에 노출되는 사이트 한 건.
|
||||
*
|
||||
* <p>{@link RelatedSiteService} 가 PortalProperty 문자열을 파싱해 만든다.</p>
|
||||
*/
|
||||
@Getter
|
||||
@ToString
|
||||
@AllArgsConstructor
|
||||
public class RelatedSite {
|
||||
|
||||
/** 셀렉트에 표시되는 이름 (예: 신한은행) */
|
||||
private final String name;
|
||||
|
||||
/** 이동 대상 URL (http/https 절대주소 또는 `/` 로 시작하는 사이트 상대주소) */
|
||||
private final String url;
|
||||
}
|
||||
@@ -0,0 +1,131 @@
|
||||
package com.eactive.apim.portal.djb.footer;
|
||||
|
||||
import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.stereotype.Service;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.Collections;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 푸터 "관련 사이트" 셀렉트의 라벨과 목록을 DB(PortalProperty)에서 조회한다.
|
||||
*
|
||||
* <p>group 은 기존 {@code Portal} 을 재사용하여 {@link PortalPropertyService#getOrCreateProperty}
|
||||
* 의 자동 생성(self-seed)이 동작하도록 한다.</p>
|
||||
*
|
||||
* <ul>
|
||||
* <li>{@code footer.related-sites.label} - 셀렉트 첫 항목(플레이스홀더) 문구</li>
|
||||
* <li>{@code footer.related-sites} - 사이트 목록. 한 줄에 하나씩 {@code 이름=URL}</li>
|
||||
* </ul>
|
||||
*
|
||||
* <h3>목록 표기 규칙</h3>
|
||||
* <pre>
|
||||
* # 주석 (# 으로 시작하는 줄은 무시)
|
||||
* 신한은행=http://www.shinhan.com
|
||||
* 제주은행 = https://www.jejubank.co.kr ← = 앞뒤 공백 허용
|
||||
* </pre>
|
||||
* <ul>
|
||||
* <li>빈 줄 · {@code #} 로 시작하는 줄은 건너뛴다.</li>
|
||||
* <li>줄 순서가 곧 화면 노출 순서다.</li>
|
||||
* <li>URL 에 {@code =} 가 들어가도 <b>첫 번째</b> {@code =} 만 구분자로 쓰므로 안전하다.</li>
|
||||
* <li>{@code =} 가 없거나 이름/URL 이 비었거나 허용되지 않은 스킴이면 그 줄만 버리고 WARN 로그를
|
||||
* 남긴다. (한 줄이 잘못돼도 나머지 사이트는 정상 노출)</li>
|
||||
* </ul>
|
||||
*
|
||||
* <p>허용 스킴을 {@code http/https} 와 사이트 상대경로로 제한하는 이유는, 이 값이 관리자 화면에서
|
||||
* 편집되어 그대로 앵커/스크립트 이동 대상이 되기 때문이다({@code javascript:} 등 차단).</p>
|
||||
*/
|
||||
@Slf4j
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
public class RelatedSiteService {
|
||||
|
||||
private static final String GROUP = "Portal";
|
||||
|
||||
static final String NAME_LABEL = "footer.related-sites.label";
|
||||
static final String NAME_SITES = "footer.related-sites";
|
||||
|
||||
static final String DESC_LABEL = "푸터 관련 사이트 셀렉트 라벨(첫 항목 문구)";
|
||||
static final String DESC_SITES = "푸터 관련 사이트 목록. 한 줄에 하나씩 '이름=URL' (빈 줄·# 주석 무시)";
|
||||
|
||||
static final String DEFAULT_LABEL = "DJBank 관련 사이트";
|
||||
|
||||
/** 기본값: 신한금융그룹 Family site (shinhangroup.com 하단 목록 기준) */
|
||||
static final String DEFAULT_SITES = String.join("\n",
|
||||
"신한은행=http://www.shinhan.com",
|
||||
"신한카드=http://www.shinhancard.com",
|
||||
"신한투자증권=http://www.shinhansec.com",
|
||||
"신한라이프=http://www.shinhanlife.co.kr",
|
||||
"신한캐피탈=http://www.shcap.co.kr",
|
||||
"신한자산운용=https://www.shinhanfund.com",
|
||||
"제주은행=https://www.jejubank.co.kr",
|
||||
"신한저축은행=http://www.shinhansavings.co.kr",
|
||||
"신한자산신탁=http://www.shinhantrust.kr",
|
||||
"신한DS=http://www.shinhansys.co.kr",
|
||||
"신한펀드파트너스=https://www.shinhanfundpartners.com",
|
||||
"신한리츠운용=http://shinhanrem.com",
|
||||
"신한벤처투자=http://www.shinhanvc.com",
|
||||
"신한EZ손해보험=http://www.shinhanez.co.kr",
|
||||
"신한장학재단=http://www.shsf.or.kr",
|
||||
"신한금융희망재단=http://www.shinhanfoundation.or.kr");
|
||||
|
||||
private final PortalPropertyService portalPropertyService;
|
||||
|
||||
/** 셀렉트 첫 항목에 노출할 라벨 */
|
||||
@Transactional
|
||||
public String getLabel() {
|
||||
String label = portalPropertyService.getOrCreateProperty(GROUP, NAME_LABEL, DEFAULT_LABEL, DESC_LABEL);
|
||||
return (label == null || label.trim().isEmpty()) ? DEFAULT_LABEL : label.trim();
|
||||
}
|
||||
|
||||
/** 셀렉트에 노출할 사이트 목록. 파싱 결과가 없으면 빈 리스트(푸터에서 셀렉트 미노출) */
|
||||
@Transactional
|
||||
public List<RelatedSite> getSites() {
|
||||
return parse(portalPropertyService.getOrCreateProperty(GROUP, NAME_SITES, DEFAULT_SITES, DESC_SITES));
|
||||
}
|
||||
|
||||
/**
|
||||
* {@code 이름=URL} 줄 목록을 파싱한다. 잘못된 줄은 건너뛴다.
|
||||
*/
|
||||
static List<RelatedSite> parse(String raw) {
|
||||
if (raw == null || raw.trim().isEmpty()) {
|
||||
return Collections.emptyList();
|
||||
}
|
||||
|
||||
List<RelatedSite> sites = new ArrayList<>();
|
||||
for (String rawLine : raw.split("\\r?\\n")) {
|
||||
String line = rawLine.trim();
|
||||
if (line.isEmpty() || line.startsWith("#")) {
|
||||
continue;
|
||||
}
|
||||
|
||||
int sep = line.indexOf('=');
|
||||
if (sep <= 0) {
|
||||
log.warn("관련 사이트 설정 형식 오류(= 구분자 없음) - 해당 줄 무시: {}", line);
|
||||
continue;
|
||||
}
|
||||
|
||||
String name = line.substring(0, sep).trim();
|
||||
String url = line.substring(sep + 1).trim();
|
||||
if (name.isEmpty() || url.isEmpty()) {
|
||||
log.warn("관련 사이트 설정 형식 오류(이름 또는 URL 없음) - 해당 줄 무시: {}", line);
|
||||
continue;
|
||||
}
|
||||
if (!isAllowedUrl(url)) {
|
||||
log.warn("관련 사이트 설정 URL 스킴 불허(http/https 또는 / 로 시작해야 함) - 해당 줄 무시: {}", line);
|
||||
continue;
|
||||
}
|
||||
|
||||
sites.add(new RelatedSite(name, url));
|
||||
}
|
||||
return sites;
|
||||
}
|
||||
|
||||
private static boolean isAllowedUrl(String url) {
|
||||
String lower = url.toLowerCase();
|
||||
return lower.startsWith("http://") || lower.startsWith("https://") || url.startsWith("/");
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,70 @@
|
||||
package com.eactive.apim.portal.djb.menu;
|
||||
|
||||
import com.eactive.apim.portal.menu.entity.PortalMenuItem;
|
||||
import com.eactive.apim.portal.common.util.SecurityUtil;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.web.servlet.HandlerInterceptor;
|
||||
|
||||
import javax.servlet.http.HttpServletRequest;
|
||||
import javax.servlet.http.HttpServletResponse;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 메뉴 접근 권한(ACCESS_ROLES) 서버측 집행.
|
||||
*
|
||||
* <p>요청 경로가 접근 권한이 설정된 메뉴 경로와 정확히 일치할 때만 검사한다
|
||||
* (하위 경로는 기존 안전망 @Secured / PageRoute.role 에 위임 — 사용자 결정).
|
||||
* 미충족 시 익명은 로그인으로, 인증 사용자는 홈으로 리다이렉트한다.
|
||||
* 메뉴에 등록되지 않은 경로는 통과시킨다.
|
||||
*/
|
||||
@Slf4j
|
||||
@RequiredArgsConstructor
|
||||
public class MenuAccessInterceptor implements HandlerInterceptor {
|
||||
|
||||
private final MenuService menuService;
|
||||
|
||||
@Override
|
||||
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
|
||||
throws Exception {
|
||||
String path = currentPath(request);
|
||||
List<String> requiredRoles = menuService.getSnapshot().getAccessRolesByPath().get(path);
|
||||
if (requiredRoles == null || requiredRoles.isEmpty()) {
|
||||
return true;
|
||||
}
|
||||
if (isAllowed(requiredRoles)) {
|
||||
return true;
|
||||
}
|
||||
|
||||
if (!SecurityUtil.isAuthenticated()) {
|
||||
response.sendRedirect(request.getContextPath() + "/login");
|
||||
} else {
|
||||
log.info("메뉴 접근 권한 미충족 - path: {}, 필요 권한: {}, 사용자: {}",
|
||||
path, requiredRoles, SecurityUtil.getCurrentLoginId());
|
||||
response.sendRedirect(request.getContextPath() + "/");
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
private boolean isAllowed(List<String> requiredRoles) {
|
||||
for (String role : requiredRoles) {
|
||||
if (PortalMenuItem.ROLE_AUTHENTICATED.equals(role)) {
|
||||
if (SecurityUtil.isAuthenticated()) {
|
||||
return true;
|
||||
}
|
||||
} else if (SecurityUtil.hasRole(role)) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
private String currentPath(HttpServletRequest request) {
|
||||
String uri = request.getRequestURI();
|
||||
String contextPath = request.getContextPath();
|
||||
if (contextPath != null && !contextPath.isEmpty() && uri.startsWith(contextPath)) {
|
||||
uri = uri.substring(contextPath.length());
|
||||
}
|
||||
return uri;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,99 @@
|
||||
package com.eactive.apim.portal.djb.menu;
|
||||
|
||||
import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.http.HttpStatus;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.web.bind.annotation.PostMapping;
|
||||
import org.springframework.web.bind.annotation.RequestMapping;
|
||||
import org.springframework.web.bind.annotation.RestController;
|
||||
|
||||
import javax.servlet.http.HttpServletRequest;
|
||||
import java.time.LocalDateTime;
|
||||
import java.time.format.DateTimeFormatter;
|
||||
import java.util.Arrays;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.Map;
|
||||
import java.util.Set;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
/**
|
||||
* 메뉴 캐시 내부 API — eapim-admin 의 reload 명령 수신용.
|
||||
*
|
||||
* <p>가드: PTL_PROPERTY {@code Portal / menu.internal.allow-ips} 허용 IP 목록
|
||||
* (기본 loopback) + X-Forwarded-For 동반 요청 거부
|
||||
* ({@code LegacyEncryptionMigrationController.assertLocalOnly} 모델).
|
||||
* CSRF 는 PortalConfigSecurity 에서 {@code /internal/menu/**} 예외 처리.</p>
|
||||
*
|
||||
* <pre>curl -X POST http://127.0.0.1:39130/internal/menu/reload</pre>
|
||||
*/
|
||||
@Slf4j
|
||||
@RestController
|
||||
@RequestMapping("/internal/menu")
|
||||
@RequiredArgsConstructor
|
||||
public class MenuInternalController {
|
||||
|
||||
static final String PROP_GROUP = "Portal";
|
||||
static final String PROP_ALLOW_IPS = "menu.internal.allow-ips";
|
||||
static final String DEFAULT_ALLOW_IPS = "127.0.0.1,::1";
|
||||
|
||||
private final MenuService menuService;
|
||||
private final PortalPropertyService portalPropertyService;
|
||||
|
||||
@PostMapping("/reload")
|
||||
public ResponseEntity<Map<String, Object>> reload(HttpServletRequest request) {
|
||||
if (!isAllowed(request)) {
|
||||
Map<String, Object> denied = new LinkedHashMap<>();
|
||||
denied.put("result", "DENIED");
|
||||
denied.put("message", "허용되지 않은 접근입니다. (menu.internal.allow-ips 확인)");
|
||||
return ResponseEntity.status(HttpStatus.FORBIDDEN).body(denied);
|
||||
}
|
||||
|
||||
MenuService.MenuSnapshot snapshot = menuService.reload();
|
||||
log.info("메뉴 캐시 리로드 명령 수신 - from: {}", request.getRemoteAddr());
|
||||
|
||||
Map<String, Object> body = new LinkedHashMap<>();
|
||||
body.put("result", "OK");
|
||||
body.put("itemCount", snapshot.getItemCount());
|
||||
body.put("reloadedAt", LocalDateTime.now().format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
|
||||
return ResponseEntity.ok(body);
|
||||
}
|
||||
|
||||
/**
|
||||
* 허용 IP 검사. 프록시 경유(X-Forwarded-For 존재) 요청은 IP 신뢰 불가로 거부한다.
|
||||
* (embedded Tomcat 은 forward-headers-strategy: native 로 XFF 가 remoteAddr 에 반영될 수 있으나
|
||||
* 그 경우에도 allowlist 검사로 차단된다. WebLogic WAR 배포에서는 원 소켓 IP 로 검사된다.)
|
||||
*/
|
||||
private boolean isAllowed(HttpServletRequest request) {
|
||||
String remote = canonicalize(request.getRemoteAddr());
|
||||
boolean viaProxy = request.getHeader("X-Forwarded-For") != null;
|
||||
|
||||
Set<String> allowed = Arrays.stream(resolveAllowIps().split(","))
|
||||
.map(String::trim)
|
||||
.filter(ip -> !ip.isEmpty())
|
||||
.map(MenuInternalController::canonicalize)
|
||||
.collect(Collectors.toSet());
|
||||
|
||||
if (viaProxy || !allowed.contains(remote)) {
|
||||
log.warn("메뉴 내부 API 차단 - remote: {}, viaProxy: {}", remote, viaProxy);
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
private String resolveAllowIps() {
|
||||
try {
|
||||
return portalPropertyService.getOrCreateProperty(PROP_GROUP, PROP_ALLOW_IPS,
|
||||
DEFAULT_ALLOW_IPS, "메뉴 내부 API(리로드) 허용 IP 목록(콤마 구분)");
|
||||
} catch (Exception e) {
|
||||
log.warn("허용 IP 목록 조회 실패 - 기본값({}) 사용", DEFAULT_ALLOW_IPS, e);
|
||||
return DEFAULT_ALLOW_IPS;
|
||||
}
|
||||
}
|
||||
|
||||
/** IPv6 loopback 표기 통일 */
|
||||
private static String canonicalize(String ip) {
|
||||
return "0:0:0:0:0:0:0:1".equals(ip) ? "::1" : ip;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,94 @@
|
||||
package com.eactive.apim.portal.djb.menu;
|
||||
|
||||
import com.eactive.apim.portal.menu.entity.PortalMenuItem;
|
||||
import com.eactive.apim.portal.common.util.SecurityUtil;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.web.bind.annotation.ControllerAdvice;
|
||||
import org.springframework.web.bind.annotation.ModelAttribute;
|
||||
|
||||
import javax.servlet.http.HttpServletRequest;
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 모든 뷰 요청에 role 필터가 적용된 {@code menuView} 를 주입한다
|
||||
* (breadcrumb 의 GlobalControllerAdvice 와 동일한 방식).
|
||||
*
|
||||
* <p>노출 판정: EXPOSE_ROLES 비어있음(전체) ∥ AUTHENTICATED(로그인) ∥
|
||||
* 역할 any-of. 경로 없는 그룹은 노출 자식이 하나도 없으면 제외한다.
|
||||
*/
|
||||
@Slf4j
|
||||
@ControllerAdvice
|
||||
@RequiredArgsConstructor
|
||||
public class MenuModelAdvice {
|
||||
|
||||
private final MenuService menuService;
|
||||
|
||||
@ModelAttribute("menuView")
|
||||
public MenuView menuView(HttpServletRequest request) {
|
||||
try {
|
||||
MenuService.MenuSnapshot snapshot = menuService.getSnapshot();
|
||||
boolean authenticated = SecurityUtil.isAuthenticated();
|
||||
|
||||
List<MenuNode> gnb = new ArrayList<>();
|
||||
MenuNode mypage = null;
|
||||
for (MenuNode root : snapshot.getRoots()) {
|
||||
MenuNode filtered = filter(root, authenticated);
|
||||
if (filtered == null) {
|
||||
continue;
|
||||
}
|
||||
if (PortalMenuItem.SECTION_MYPAGE.equals(filtered.getSection())) {
|
||||
if (mypage == null) {
|
||||
mypage = filtered;
|
||||
}
|
||||
} else {
|
||||
gnb.add(filtered);
|
||||
}
|
||||
}
|
||||
return new MenuView(gnb, mypage, request.getRequestURI());
|
||||
} catch (Exception e) {
|
||||
// 메뉴 조회 실패가 화면 전체를 막지 않도록 빈 메뉴로 폴백
|
||||
log.error("메뉴 뷰 구성 실패 - 빈 메뉴로 렌더링합니다.", e);
|
||||
return MenuView.empty();
|
||||
}
|
||||
}
|
||||
|
||||
private MenuNode filter(MenuNode node, boolean authenticated) {
|
||||
if (!isExposed(node, authenticated)) {
|
||||
return null;
|
||||
}
|
||||
MenuNode copy = node.copyWithoutChildren();
|
||||
List<MenuNode> children = new ArrayList<>();
|
||||
for (MenuNode child : node.getChildren()) {
|
||||
MenuNode filteredChild = filter(child, authenticated);
|
||||
if (filteredChild != null) {
|
||||
children.add(filteredChild);
|
||||
}
|
||||
}
|
||||
copy.setChildren(children);
|
||||
|
||||
// 경로 없는 그룹은 노출할 자식이 없으면 통째로 제외
|
||||
if (copy.isGroup() && !copy.hasPath() && children.isEmpty()) {
|
||||
return null;
|
||||
}
|
||||
return copy;
|
||||
}
|
||||
|
||||
private boolean isExposed(MenuNode node, boolean authenticated) {
|
||||
List<String> exposeRoles = node.getExposeRoles();
|
||||
if (exposeRoles.isEmpty()) {
|
||||
return true;
|
||||
}
|
||||
for (String role : exposeRoles) {
|
||||
if (PortalMenuItem.ROLE_AUTHENTICATED.equals(role)) {
|
||||
if (authenticated) {
|
||||
return true;
|
||||
}
|
||||
} else if (SecurityUtil.hasRole(role)) {
|
||||
return true;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,46 @@
|
||||
package com.eactive.apim.portal.djb.menu;
|
||||
|
||||
import lombok.Data;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 렌더용 메뉴 노드. {@link MenuService} 스냅샷 트리와
|
||||
* {@link MenuModelAdvice} 의 요청별 필터 사본 양쪽에 사용한다.
|
||||
*/
|
||||
@Data
|
||||
public class MenuNode {
|
||||
|
||||
private String menuId;
|
||||
private String name;
|
||||
/** 이동 경로 (null = 클릭 없는 그룹) */
|
||||
private String path;
|
||||
private boolean group;
|
||||
/** GNB | MYPAGE */
|
||||
private String section;
|
||||
private String icon;
|
||||
private boolean newWindow;
|
||||
private List<String> exposeRoles = new ArrayList<>();
|
||||
private List<String> accessRoles = new ArrayList<>();
|
||||
private List<MenuNode> children = new ArrayList<>();
|
||||
|
||||
/** 필터 사본 생성 (children 제외 필드 복사) */
|
||||
public MenuNode copyWithoutChildren() {
|
||||
MenuNode copy = new MenuNode();
|
||||
copy.menuId = menuId;
|
||||
copy.name = name;
|
||||
copy.path = path;
|
||||
copy.group = group;
|
||||
copy.section = section;
|
||||
copy.icon = icon;
|
||||
copy.newWindow = newWindow;
|
||||
copy.exposeRoles = exposeRoles;
|
||||
copy.accessRoles = accessRoles;
|
||||
return copy;
|
||||
}
|
||||
|
||||
public boolean hasPath() {
|
||||
return path != null && !path.isEmpty();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,360 @@
|
||||
package com.eactive.apim.portal.djb.menu;
|
||||
|
||||
import com.eactive.apim.portal.menu.entity.PortalMenuItem;
|
||||
import com.eactive.apim.portal.menu.entity.PortalMenuPlacement;
|
||||
import com.eactive.apim.portal.menu.entity.PortalRole;
|
||||
import com.eactive.apim.portal.menu.entity.PortalRoleAuthority;
|
||||
import com.eactive.apim.portal.menu.entity.PortalRoleAuthorityId;
|
||||
import com.eactive.apim.portal.menu.repository.PortalMenuItemRepository;
|
||||
import com.eactive.apim.portal.menu.repository.PortalMenuPlacementRepository;
|
||||
import com.eactive.apim.portal.menu.repository.PortalRoleAuthorityRepository;
|
||||
import com.eactive.apim.portal.menu.repository.PortalRoleRepository;
|
||||
import com.eactive.apim.portal.menu.service.PortalMenuDataService;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.boot.context.event.ApplicationReadyEvent;
|
||||
import org.springframework.context.ApplicationListener;
|
||||
import org.springframework.stereotype.Component;
|
||||
import org.springframework.transaction.annotation.Transactional;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.HashSet;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.Objects;
|
||||
import java.util.Set;
|
||||
import java.util.function.BiConsumer;
|
||||
import java.util.function.Function;
|
||||
import java.util.regex.Pattern;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
/**
|
||||
* 부팅 시 menu.yml / roles.yml → DB 적재.
|
||||
*
|
||||
* <ul>
|
||||
* <li>역할: PTL_ROLE upsert + PTL_ROLE_AUTHORITY 재구축 (roles.yml 미러)</li>
|
||||
* <li>메뉴 항목: id 기준 upsert — yml 기본값이 바뀌면 DFLT_* 를 갱신하고,
|
||||
* 관리자가 수정하지 않은(현재값==구 기본값) 필드만 새 기본값을 따라간다</li>
|
||||
* <li>배치: PTL_MENU_PLACEMENT 가 비어있을 때만 DFLT_* 로 최초 시딩</li>
|
||||
* <li>yml 에서 사라진 PORTAL 항목은 경고 로그만 남기고 삭제하지 않는다</li>
|
||||
* </ul>
|
||||
*
|
||||
* 부팅 컨텍스트에는 인증 주체가 없어 감사(@CreatedBy)가 비므로,
|
||||
* 신규 행은 {@code createdBy=SYSTEM} 을 명시 세팅한다
|
||||
* (AuditingHandler 는 auditor 부재 시 기존 값을 보존).
|
||||
*/
|
||||
@Slf4j
|
||||
@Component
|
||||
@RequiredArgsConstructor
|
||||
public class MenuSeeder implements ApplicationListener<ApplicationReadyEvent> {
|
||||
|
||||
static final String SYSTEM_AUDITOR = "SYSTEM";
|
||||
private static final Pattern MENU_ID_PATTERN = Pattern.compile("^[a-z0-9-]+$");
|
||||
|
||||
private final PortalMenuYmlProperties menuYmlProperties;
|
||||
private final PortalRolesProperties rolesProperties;
|
||||
private final PortalMenuItemRepository menuItemRepository;
|
||||
private final PortalMenuPlacementRepository menuPlacementRepository;
|
||||
private final PortalRoleRepository roleRepository;
|
||||
private final PortalRoleAuthorityRepository roleAuthorityRepository;
|
||||
private final PortalMenuDataService menuDataService;
|
||||
private final MenuService menuService;
|
||||
|
||||
@Override
|
||||
@Transactional
|
||||
public void onApplicationEvent(ApplicationReadyEvent event) {
|
||||
try {
|
||||
seedRoles();
|
||||
seedMenuItems();
|
||||
seedPlacementsIfEmpty();
|
||||
menuService.reload();
|
||||
} catch (Exception e) {
|
||||
// 시딩 실패가 기동 자체를 막지 않도록 로그만 남긴다 (메뉴는 기존 DB 값으로 동작)
|
||||
log.error("메뉴/역할 시딩 실패 - 기존 DB 데이터로 동작합니다.", e);
|
||||
}
|
||||
}
|
||||
|
||||
// ─────────────── 역할 ───────────────
|
||||
|
||||
private void seedRoles() {
|
||||
int sortOrder = 10;
|
||||
int upserted = 0;
|
||||
Set<String> definedCodes = new HashSet<>();
|
||||
|
||||
for (PortalRolesProperties.RoleDef roleDef : rolesProperties.getRoles()) {
|
||||
upserted += upsertRole(roleDef.getCode(), roleDef.getName(), PortalRole.TYPE_BASE, sortOrder) ? 1 : 0;
|
||||
definedCodes.add(roleDef.getCode());
|
||||
sortOrder += 10;
|
||||
}
|
||||
for (Map.Entry<String, String> entry : rolesProperties.getAuthorityNames().entrySet()) {
|
||||
if (definedCodes.contains(entry.getKey())) {
|
||||
continue;
|
||||
}
|
||||
upserted += upsertRole(entry.getKey(), entry.getValue(), PortalRole.TYPE_AUTHORITY, sortOrder) ? 1 : 0;
|
||||
sortOrder += 10;
|
||||
}
|
||||
|
||||
// 역할→권한 매핑은 순수 미러 — 통째로 재구축
|
||||
roleAuthorityRepository.deleteAllInBatch();
|
||||
roleAuthorityRepository.flush();
|
||||
List<PortalRoleAuthority> mappings = rolesProperties.getRoles().stream()
|
||||
.flatMap(roleDef -> roleDef.getAuthorities().stream()
|
||||
.map(authority -> {
|
||||
PortalRoleAuthority mapping = new PortalRoleAuthority();
|
||||
mapping.setId(new PortalRoleAuthorityId(roleDef.getCode(), authority));
|
||||
mapping.setCreatedBy(SYSTEM_AUDITOR);
|
||||
return mapping;
|
||||
}))
|
||||
.collect(Collectors.toList());
|
||||
roleAuthorityRepository.saveAll(mappings);
|
||||
|
||||
log.info("역할 시딩 완료 - PTL_ROLE upsert {}건, PTL_ROLE_AUTHORITY {}건 재구축", upserted, mappings.size());
|
||||
}
|
||||
|
||||
private boolean upsertRole(String code, String name, String type, int sortOrder) {
|
||||
PortalRole role = roleRepository.findById(code).orElse(null);
|
||||
if (role == null) {
|
||||
role = new PortalRole();
|
||||
role.setRoleCode(code);
|
||||
role.setCreatedBy(SYSTEM_AUDITOR);
|
||||
} else if (Objects.equals(role.getRoleName(), name)
|
||||
&& Objects.equals(role.getRoleType(), type)
|
||||
&& Objects.equals(role.getSortOrder(), sortOrder)) {
|
||||
return false;
|
||||
}
|
||||
role.setRoleName(name);
|
||||
role.setRoleType(type);
|
||||
role.setSortOrder(sortOrder);
|
||||
roleRepository.save(role);
|
||||
return true;
|
||||
}
|
||||
|
||||
// ─────────────── 메뉴 항목 ───────────────
|
||||
|
||||
private void seedMenuItems() {
|
||||
List<FlatMenuDef> flatDefs = flatten(menuYmlProperties.getItems());
|
||||
validate(flatDefs);
|
||||
|
||||
int inserted = 0;
|
||||
int updated = 0;
|
||||
for (FlatMenuDef def : flatDefs) {
|
||||
PortalMenuItem existing = menuItemRepository.findById(def.id).orElse(null);
|
||||
if (existing == null) {
|
||||
menuItemRepository.save(newItem(def));
|
||||
inserted++;
|
||||
} else if (updateItem(existing, def)) {
|
||||
menuItemRepository.save(existing);
|
||||
updated++;
|
||||
}
|
||||
}
|
||||
|
||||
// yml 에서 사라진 PORTAL 항목 경고 (자동 삭제 금지)
|
||||
Set<String> ymlIds = flatDefs.stream().map(def -> def.id).collect(Collectors.toSet());
|
||||
menuItemRepository.findAllBySourceType(PortalMenuItem.SOURCE_PORTAL).stream()
|
||||
.map(PortalMenuItem::getMenuId)
|
||||
.filter(id -> !ymlIds.contains(id))
|
||||
.forEach(id -> log.warn("menu.yml 에 없는 기본 메뉴 항목이 DB에 남아 있습니다 (수동 정리 필요): {}", id));
|
||||
|
||||
log.info("메뉴 항목 시딩 완료 - 신규 {}건, 갱신 {}건, 유지 {}건",
|
||||
inserted, updated, flatDefs.size() - inserted - updated);
|
||||
}
|
||||
|
||||
private PortalMenuItem newItem(FlatMenuDef def) {
|
||||
PortalMenuItem item = new PortalMenuItem();
|
||||
item.setMenuId(def.id);
|
||||
item.setSourceType(PortalMenuItem.SOURCE_PORTAL);
|
||||
item.setCreatedBy(SYSTEM_AUDITOR);
|
||||
|
||||
item.setMenuName(def.name());
|
||||
item.setMenuPath(def.path());
|
||||
item.setExposeRoles(def.exposeCsv());
|
||||
item.setAccessRoles(def.accessCsv());
|
||||
|
||||
applyStructure(item, def);
|
||||
applyDefaults(item, def);
|
||||
return item;
|
||||
}
|
||||
|
||||
/**
|
||||
* 기존 항목 upsert 갱신. 내용 필드는 "관리자 미수정(현재값==구 기본값) 시에만"
|
||||
* 새 기본값을 따라가고, 구조 필드(group/section/icon/new-window)와 DFLT_* 는
|
||||
* 항상 yml 값으로 맞춘다.
|
||||
*
|
||||
* @return 변경이 있었으면 true
|
||||
*/
|
||||
private boolean updateItem(PortalMenuItem item, FlatMenuDef def) {
|
||||
boolean[] changed = {false};
|
||||
|
||||
followDefault(item, changed, def.name(), PortalMenuItem::getDfltMenuName,
|
||||
PortalMenuItem::getMenuName, PortalMenuItem::setMenuName, PortalMenuItem::setDfltMenuName);
|
||||
followDefault(item, changed, def.path(), PortalMenuItem::getDfltMenuPath,
|
||||
PortalMenuItem::getMenuPath, PortalMenuItem::setMenuPath, PortalMenuItem::setDfltMenuPath);
|
||||
followDefault(item, changed, def.exposeCsv(), PortalMenuItem::getDfltExposeRoles,
|
||||
PortalMenuItem::getExposeRoles, PortalMenuItem::setExposeRoles, PortalMenuItem::setDfltExposeRoles);
|
||||
followDefault(item, changed, def.accessCsv(), PortalMenuItem::getDfltAccessRoles,
|
||||
PortalMenuItem::getAccessRoles, PortalMenuItem::setAccessRoles, PortalMenuItem::setDfltAccessRoles);
|
||||
|
||||
String groupYn = def.source.isGroup() ? "Y" : "N";
|
||||
String section = def.section();
|
||||
String newWindowYn = def.source.isNewWindow() ? "Y" : "N";
|
||||
if (!Objects.equals(item.getGroupYn(), groupYn)
|
||||
|| !Objects.equals(item.getMenuSection(), section)
|
||||
|| !Objects.equals(item.getIconClass(), def.source.getIcon())
|
||||
|| !Objects.equals(item.getNewWindowYn(), newWindowYn)) {
|
||||
applyStructure(item, def);
|
||||
changed[0] = true;
|
||||
}
|
||||
|
||||
if (!Objects.equals(item.getDfltParentId(), def.parentId)
|
||||
|| !Objects.equals(item.getDfltSortOrder(), def.sortOrder)) {
|
||||
item.setDfltParentId(def.parentId);
|
||||
item.setDfltSortOrder(def.sortOrder);
|
||||
changed[0] = true;
|
||||
}
|
||||
return changed[0];
|
||||
}
|
||||
|
||||
/**
|
||||
* 내용 필드 1개에 대한 기본값 추종 처리: yml 기본값이 바뀌었을 때
|
||||
* 현재값이 구 기본값과 같으면(관리자 미수정) 현재값도 새 기본값으로 갱신한다.
|
||||
*/
|
||||
private void followDefault(PortalMenuItem item, boolean[] changed, String newDefault,
|
||||
Function<PortalMenuItem, String> defaultGetter,
|
||||
Function<PortalMenuItem, String> currentGetter,
|
||||
BiConsumer<PortalMenuItem, String> currentSetter,
|
||||
BiConsumer<PortalMenuItem, String> defaultSetter) {
|
||||
String oldDefault = defaultGetter.apply(item);
|
||||
if (Objects.equals(oldDefault, newDefault)) {
|
||||
return;
|
||||
}
|
||||
if (Objects.equals(currentGetter.apply(item), oldDefault)) {
|
||||
currentSetter.accept(item, newDefault);
|
||||
}
|
||||
defaultSetter.accept(item, newDefault);
|
||||
changed[0] = true;
|
||||
}
|
||||
|
||||
private void applyStructure(PortalMenuItem item, FlatMenuDef def) {
|
||||
item.setGroupYn(def.source.isGroup() ? "Y" : "N");
|
||||
item.setMenuSection(def.section());
|
||||
item.setIconClass(def.source.getIcon());
|
||||
item.setNewWindowYn(def.source.isNewWindow() ? "Y" : "N");
|
||||
}
|
||||
|
||||
private void applyDefaults(PortalMenuItem item, FlatMenuDef def) {
|
||||
item.setDfltMenuName(def.name());
|
||||
item.setDfltMenuPath(def.path());
|
||||
item.setDfltExposeRoles(def.exposeCsv());
|
||||
item.setDfltAccessRoles(def.accessCsv());
|
||||
item.setDfltParentId(def.parentId);
|
||||
item.setDfltSortOrder(def.sortOrder);
|
||||
item.setDfltVisibleYn("Y");
|
||||
}
|
||||
|
||||
// ─────────────── 배치 ───────────────
|
||||
|
||||
private void seedPlacementsIfEmpty() {
|
||||
if (menuPlacementRepository.count() > 0) {
|
||||
log.info("메뉴 배치 존재 - 최초 시딩 건너뜀 (관리자 배치 보존)");
|
||||
return;
|
||||
}
|
||||
List<PortalMenuItem> portalItems =
|
||||
menuItemRepository.findAllBySourceType(PortalMenuItem.SOURCE_PORTAL);
|
||||
List<PortalMenuPlacement> placements = menuDataService.buildDefaultPlacements(portalItems);
|
||||
placements.forEach(placement -> placement.setCreatedBy(SYSTEM_AUDITOR));
|
||||
menuPlacementRepository.saveAll(placements);
|
||||
log.info("메뉴 배치 최초 시딩 완료 - {}건", placements.size());
|
||||
}
|
||||
|
||||
// ─────────────── 평탄화 / 검증 ───────────────
|
||||
|
||||
private List<FlatMenuDef> flatten(List<PortalMenuYmlProperties.MenuItemDef> roots) {
|
||||
List<FlatMenuDef> result = new ArrayList<>();
|
||||
int sortOrder = 10;
|
||||
for (PortalMenuYmlProperties.MenuItemDef root : roots) {
|
||||
result.add(new FlatMenuDef(root, null, sortOrder, null));
|
||||
int childOrder = 10;
|
||||
for (PortalMenuYmlProperties.MenuItemDef child : root.getChildren()) {
|
||||
result.add(new FlatMenuDef(child, root.getId(), childOrder, root));
|
||||
childOrder += 10;
|
||||
}
|
||||
sortOrder += 10;
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
private void validate(List<FlatMenuDef> defs) {
|
||||
Set<String> seen = new HashSet<>();
|
||||
for (FlatMenuDef def : defs) {
|
||||
if (def.id == null || !MENU_ID_PATTERN.matcher(def.id).matches()) {
|
||||
throw new IllegalStateException("menu.yml 항목 id 형식 오류(kebab-case 필수): " + def.id);
|
||||
}
|
||||
if (!seen.add(def.id)) {
|
||||
throw new IllegalStateException("menu.yml 항목 id 중복: " + def.id);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/** yml 트리 항목의 평탄화 뷰 (부모/기본 정렬 포함) */
|
||||
private static class FlatMenuDef {
|
||||
final PortalMenuYmlProperties.MenuItemDef source;
|
||||
final String parentId;
|
||||
final Integer sortOrder;
|
||||
final PortalMenuYmlProperties.MenuItemDef parent;
|
||||
final String id;
|
||||
|
||||
FlatMenuDef(PortalMenuYmlProperties.MenuItemDef source, String parentId, Integer sortOrder,
|
||||
PortalMenuYmlProperties.MenuItemDef parent) {
|
||||
this.source = source;
|
||||
this.parentId = parentId;
|
||||
this.sortOrder = sortOrder;
|
||||
this.parent = parent;
|
||||
this.id = source.getId();
|
||||
}
|
||||
|
||||
String name() {
|
||||
return source.getName();
|
||||
}
|
||||
|
||||
String path() {
|
||||
return trimToNull(source.getPath());
|
||||
}
|
||||
|
||||
/** 자식은 섹션 미지정 시 부모 섹션 상속 */
|
||||
String section() {
|
||||
String own = trimToNull(source.getSection());
|
||||
if (own != null) {
|
||||
return own;
|
||||
}
|
||||
if (parent != null) {
|
||||
String parentSection = trimToNull(parent.getSection());
|
||||
if (parentSection != null) {
|
||||
return parentSection;
|
||||
}
|
||||
}
|
||||
return PortalMenuItem.SECTION_GNB;
|
||||
}
|
||||
|
||||
String exposeCsv() {
|
||||
return toCsv(source.getExposeRoles());
|
||||
}
|
||||
|
||||
String accessCsv() {
|
||||
return toCsv(source.getAccessRoles());
|
||||
}
|
||||
|
||||
private static String toCsv(List<String> roles) {
|
||||
if (roles == null || roles.isEmpty()) {
|
||||
return null;
|
||||
}
|
||||
return String.join(",", roles);
|
||||
}
|
||||
|
||||
private static String trimToNull(String value) {
|
||||
if (value == null || value.trim().isEmpty()) {
|
||||
return null;
|
||||
}
|
||||
return value.trim();
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,179 @@
|
||||
package com.eactive.apim.portal.djb.menu;
|
||||
|
||||
import com.eactive.apim.portal.menu.entity.PortalMenuItem;
|
||||
import com.eactive.apim.portal.menu.entity.PortalMenuPlacement;
|
||||
import com.eactive.apim.portal.menu.service.PortalMenuDataService;
|
||||
import com.eactive.apim.portal.portalproperty.service.PortalPropertyService;
|
||||
import lombok.Getter;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.stereotype.Service;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.Arrays;
|
||||
import java.util.Collections;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
/**
|
||||
* 메뉴 트리 스냅샷 캐시.
|
||||
*
|
||||
* <p>매 요청 DB 조회를 피하기 위해 role 비의존 트리를 메모리에 유지한다
|
||||
* (기존 수제 캐시 관례: PageService 의 volatile 필드). TTL 은
|
||||
* PTL_PROPERTY {@code Portal / menu.cache.ttl-seconds} (기본 3600초)이며,
|
||||
* eapim-admin 의 reload 명령(/internal/menu/reload)으로 즉시 갱신된다.
|
||||
* 요청별 role 필터링은 {@link MenuModelAdvice} 가 수행한다.
|
||||
*/
|
||||
@Slf4j
|
||||
@Service
|
||||
@RequiredArgsConstructor
|
||||
public class MenuService {
|
||||
|
||||
static final String PROP_GROUP = "Portal";
|
||||
static final String PROP_CACHE_TTL = "menu.cache.ttl-seconds";
|
||||
static final String DEFAULT_CACHE_TTL = "3600";
|
||||
/** 스냅샷이 비어있을 때의 재시도 TTL(초) — 시딩 전 기동 직후 요청 대비 */
|
||||
private static final long EMPTY_RETRY_TTL_SECONDS = 60;
|
||||
|
||||
private final PortalMenuDataService menuDataService;
|
||||
private final PortalPropertyService portalPropertyService;
|
||||
|
||||
private volatile MenuSnapshot snapshot;
|
||||
|
||||
public MenuSnapshot getSnapshot() {
|
||||
MenuSnapshot current = snapshot;
|
||||
if (current != null && !current.isExpired()) {
|
||||
return current;
|
||||
}
|
||||
synchronized (this) {
|
||||
current = snapshot;
|
||||
if (current != null && !current.isExpired()) {
|
||||
return current;
|
||||
}
|
||||
return reload();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* DB 에서 트리를 재구축한다. 시더 완료 시점과 admin reload 명령이 호출한다.
|
||||
*/
|
||||
public synchronized MenuSnapshot reload() {
|
||||
long ttlSeconds = resolveTtlSeconds();
|
||||
List<PortalMenuItem> items = menuDataService.loadAllItems();
|
||||
List<PortalMenuPlacement> placements = menuDataService.loadAllPlacements();
|
||||
|
||||
Map<String, PortalMenuItem> itemsById = items.stream()
|
||||
.collect(Collectors.toMap(PortalMenuItem::getMenuId, item -> item, (a, b) -> a, LinkedHashMap::new));
|
||||
|
||||
// 가시(visible=Y) 배치만 렌더 트리에 포함
|
||||
Map<String, List<PortalMenuPlacement>> byParent = placements.stream()
|
||||
.filter(PortalMenuPlacement::isVisible)
|
||||
.filter(placement -> itemsById.containsKey(placement.getMenuId()))
|
||||
.collect(Collectors.groupingBy(
|
||||
placement -> placement.getParentId() == null ? "" : placement.getParentId(),
|
||||
LinkedHashMap::new, Collectors.toList()));
|
||||
|
||||
List<MenuNode> roots = buildNodes(byParent.getOrDefault("", Collections.emptyList()), itemsById, byParent);
|
||||
|
||||
// 접근 권한 맵은 배치/노출과 무관하게 항목 기준으로 구성 (숨김 메뉴도 접근 통제 유지)
|
||||
Map<String, List<String>> accessRolesByPath = new LinkedHashMap<>();
|
||||
for (PortalMenuItem item : items) {
|
||||
if (item.getMenuPath() != null && item.getAccessRoles() != null
|
||||
&& !item.getAccessRoles().trim().isEmpty()) {
|
||||
accessRolesByPath.put(normalizePath(item.getMenuPath()), splitCsv(item.getAccessRoles()));
|
||||
}
|
||||
}
|
||||
|
||||
if (roots.isEmpty()) {
|
||||
ttlSeconds = Math.min(ttlSeconds, EMPTY_RETRY_TTL_SECONDS);
|
||||
}
|
||||
MenuSnapshot rebuilt = new MenuSnapshot(roots, accessRolesByPath, items.size(),
|
||||
System.currentTimeMillis(), ttlSeconds);
|
||||
snapshot = rebuilt;
|
||||
log.info("메뉴 캐시 갱신 - 항목 {}건, 최상위 {}건, TTL {}초", items.size(), roots.size(), ttlSeconds);
|
||||
return rebuilt;
|
||||
}
|
||||
|
||||
private List<MenuNode> buildNodes(List<PortalMenuPlacement> placements,
|
||||
Map<String, PortalMenuItem> itemsById,
|
||||
Map<String, List<PortalMenuPlacement>> byParent) {
|
||||
List<MenuNode> nodes = new ArrayList<>();
|
||||
for (PortalMenuPlacement placement : placements) {
|
||||
PortalMenuItem item = itemsById.get(placement.getMenuId());
|
||||
MenuNode node = toNode(item);
|
||||
node.setChildren(buildNodes(
|
||||
byParent.getOrDefault(item.getMenuId(), Collections.emptyList()), itemsById, byParent));
|
||||
nodes.add(node);
|
||||
}
|
||||
return nodes;
|
||||
}
|
||||
|
||||
private MenuNode toNode(PortalMenuItem item) {
|
||||
MenuNode node = new MenuNode();
|
||||
node.setMenuId(item.getMenuId());
|
||||
node.setName(item.getMenuName());
|
||||
node.setPath(normalizePath(item.getMenuPath()));
|
||||
node.setGroup(item.isGroup());
|
||||
node.setSection(item.getMenuSection());
|
||||
node.setIcon(item.getIconClass());
|
||||
node.setNewWindow("Y".equals(item.getNewWindowYn()));
|
||||
node.setExposeRoles(splitCsv(item.getExposeRoles()));
|
||||
node.setAccessRoles(splitCsv(item.getAccessRoles()));
|
||||
return node;
|
||||
}
|
||||
|
||||
private long resolveTtlSeconds() {
|
||||
try {
|
||||
String value = portalPropertyService.getOrCreateProperty(PROP_GROUP, PROP_CACHE_TTL,
|
||||
DEFAULT_CACHE_TTL, "포탈 메뉴 캐시 TTL(초)");
|
||||
return Long.parseLong(value.trim());
|
||||
} catch (Exception e) {
|
||||
log.warn("메뉴 캐시 TTL 조회 실패 - 기본값 {}초 사용", DEFAULT_CACHE_TTL, e);
|
||||
return Long.parseLong(DEFAULT_CACHE_TTL);
|
||||
}
|
||||
}
|
||||
|
||||
private static List<String> splitCsv(String csv) {
|
||||
if (csv == null || csv.trim().isEmpty()) {
|
||||
return Collections.emptyList();
|
||||
}
|
||||
return Arrays.stream(csv.split(","))
|
||||
.map(String::trim)
|
||||
.filter(token -> !token.isEmpty())
|
||||
.collect(Collectors.toList());
|
||||
}
|
||||
|
||||
private static String normalizePath(String path) {
|
||||
if (path == null || path.trim().isEmpty()) {
|
||||
return null;
|
||||
}
|
||||
String normalized = path.trim();
|
||||
int queryIndex = normalized.indexOf('?');
|
||||
return queryIndex >= 0 ? normalized.substring(0, queryIndex) : normalized;
|
||||
}
|
||||
|
||||
/** role 비의존 메뉴 스냅샷 (불변 취급) */
|
||||
@Getter
|
||||
public static class MenuSnapshot {
|
||||
private final List<MenuNode> roots;
|
||||
private final Map<String, List<String>> accessRolesByPath;
|
||||
private final int itemCount;
|
||||
private final long loadedAt;
|
||||
private final long ttlSeconds;
|
||||
|
||||
MenuSnapshot(List<MenuNode> roots, Map<String, List<String>> accessRolesByPath,
|
||||
int itemCount, long loadedAt, long ttlSeconds) {
|
||||
this.roots = roots;
|
||||
this.accessRolesByPath = accessRolesByPath;
|
||||
this.itemCount = itemCount;
|
||||
this.loadedAt = loadedAt;
|
||||
this.ttlSeconds = ttlSeconds;
|
||||
}
|
||||
|
||||
boolean isExpired() {
|
||||
return System.currentTimeMillis() - loadedAt > ttlSeconds * 1000L;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,108 @@
|
||||
package com.eactive.apim.portal.djb.menu;
|
||||
|
||||
import lombok.Getter;
|
||||
|
||||
import java.util.Collections;
|
||||
import java.util.HashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* 요청별(role 필터 적용) 메뉴 뷰 — 템플릿 모델 {@code menuView}.
|
||||
*
|
||||
* <ul>
|
||||
* <li>{@link #getGnb()} — 상단 글로벌 네비(GNB 섹션 최상위)</li>
|
||||
* <li>{@link #getMypage()} — 마이페이지 드롭다운 루트 (미노출 시 null)</li>
|
||||
* <li>{@link #activeGroup(String)} — service_sidebar 용 활성 그룹 탐색</li>
|
||||
* </ul>
|
||||
*/
|
||||
@Getter
|
||||
public class MenuView {
|
||||
|
||||
/**
|
||||
* service_sidebar 기존 호출부의 activeMenu 키 → 메뉴 ID 브리지.
|
||||
* 호출 페이지 수정 없이 DB 메뉴 기반 사이드바로 전환하기 위한 레거시 맵.
|
||||
*/
|
||||
private static final Map<String, String> LEGACY_ACTIVE_KEYS = new HashMap<>();
|
||||
|
||||
static {
|
||||
LEGACY_ACTIVE_KEYS.put("intro", "service-intro");
|
||||
LEGACY_ACTIVE_KEYS.put("guide", "service-guide");
|
||||
LEGACY_ACTIVE_KEYS.put("oauth2", "service-oauth2-guide");
|
||||
LEGACY_ACTIVE_KEYS.put("webhookGuide", "service-webhook-dev-guide");
|
||||
LEGACY_ACTIVE_KEYS.put("notice", "support-notice");
|
||||
LEGACY_ACTIVE_KEYS.put("faq", "support-faq");
|
||||
LEGACY_ACTIVE_KEYS.put("qna", "support-qna");
|
||||
LEGACY_ACTIVE_KEYS.put("feedback", "support-partnership");
|
||||
LEGACY_ACTIVE_KEYS.put("users", "my-page-users");
|
||||
LEGACY_ACTIVE_KEYS.put("apiKey", "my-page-clients");
|
||||
LEGACY_ACTIVE_KEYS.put("webhook", "my-page-webhook");
|
||||
LEGACY_ACTIVE_KEYS.put("statistics", "my-page-statistics");
|
||||
LEGACY_ACTIVE_KEYS.put("profile", "my-page-profile");
|
||||
LEGACY_ACTIVE_KEYS.put("password", "my-page-password");
|
||||
}
|
||||
|
||||
private final List<MenuNode> gnb;
|
||||
private final MenuNode mypage;
|
||||
private final String currentPath;
|
||||
|
||||
public MenuView(List<MenuNode> gnb, MenuNode mypage, String currentPath) {
|
||||
this.gnb = gnb;
|
||||
this.mypage = mypage;
|
||||
this.currentPath = currentPath;
|
||||
}
|
||||
|
||||
/**
|
||||
* 사이드바용 활성 그룹. legacy activeMenu 키 → 메뉴 ID 우선,
|
||||
* 실패 시 현재 경로(정확/prefix) 매칭으로 폴백.
|
||||
*/
|
||||
public MenuNode activeGroup(String activeMenu) {
|
||||
String targetId = activeMenu == null ? null : LEGACY_ACTIVE_KEYS.get(activeMenu);
|
||||
MenuNode byId = targetId == null ? null : findRootContaining(node -> targetId.equals(node.getMenuId()));
|
||||
if (byId != null) {
|
||||
return byId;
|
||||
}
|
||||
return findRootContaining(this::matchesCurrentPath);
|
||||
}
|
||||
|
||||
/**
|
||||
* 사이드바 항목 활성 여부: legacy 키 매칭 우선, 경로 매칭 폴백.
|
||||
*/
|
||||
public boolean isActive(MenuNode node, String activeMenu) {
|
||||
String targetId = activeMenu == null ? null : LEGACY_ACTIVE_KEYS.get(activeMenu);
|
||||
if (targetId != null) {
|
||||
return targetId.equals(node.getMenuId());
|
||||
}
|
||||
return matchesCurrentPath(node);
|
||||
}
|
||||
|
||||
private MenuNode findRootContaining(java.util.function.Predicate<MenuNode> predicate) {
|
||||
for (MenuNode root : allRoots()) {
|
||||
if (predicate.test(root) || root.getChildren().stream().anyMatch(predicate)) {
|
||||
return root;
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
private List<MenuNode> allRoots() {
|
||||
if (mypage == null) {
|
||||
return gnb;
|
||||
}
|
||||
java.util.ArrayList<MenuNode> roots = new java.util.ArrayList<>(gnb);
|
||||
roots.add(mypage);
|
||||
return roots;
|
||||
}
|
||||
|
||||
private boolean matchesCurrentPath(MenuNode node) {
|
||||
if (!node.hasPath() || currentPath == null) {
|
||||
return false;
|
||||
}
|
||||
return currentPath.equals(node.getPath())
|
||||
|| currentPath.startsWith(node.getPath() + "/");
|
||||
}
|
||||
|
||||
public static MenuView empty() {
|
||||
return new MenuView(Collections.emptyList(), null, null);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
package com.eactive.apim.portal.djb.menu;
|
||||
|
||||
import lombok.Data;
|
||||
import org.springframework.boot.context.properties.ConfigurationProperties;
|
||||
import org.springframework.stereotype.Component;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* menu.yml 바인딩 (spring.config.import 로 로드).
|
||||
* 트리(children 중첩) 형태 그대로 바인딩하며, 평탄화는 {@link MenuSeeder} 가 수행한다.
|
||||
*/
|
||||
@Data
|
||||
@Component
|
||||
@ConfigurationProperties(prefix = "portal-menu")
|
||||
public class PortalMenuYmlProperties {
|
||||
|
||||
private List<MenuItemDef> items = new ArrayList<>();
|
||||
|
||||
@Data
|
||||
public static class MenuItemDef {
|
||||
/** kebab-case 자연키 (^[a-z0-9-]+$) */
|
||||
private String id;
|
||||
private String name;
|
||||
private String path;
|
||||
/** true = 클릭 없는 상위 그룹 */
|
||||
private boolean group;
|
||||
/** GNB(기본) | MYPAGE */
|
||||
private String section;
|
||||
/** FontAwesome 아이콘 클래스 (마이페이지 드롭다운) */
|
||||
private String icon;
|
||||
private boolean newWindow;
|
||||
private List<String> exposeRoles = new ArrayList<>();
|
||||
private List<String> accessRoles = new ArrayList<>();
|
||||
private List<MenuItemDef> children = new ArrayList<>();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,47 @@
|
||||
package com.eactive.apim.portal.djb.menu;
|
||||
|
||||
import com.eactive.apim.portal.portaluser.entity.PortalUserEnums.RoleCode;
|
||||
import lombok.Data;
|
||||
import org.springframework.boot.context.properties.ConfigurationProperties;
|
||||
import org.springframework.stereotype.Component;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.Collections;
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
/**
|
||||
* roles.yml 바인딩 (spring.config.import 로 로드).
|
||||
* 기존 application.yml 의 {@code portal.portal_security} 를 대체한다.
|
||||
* 로그인 시 권한 확장(PortalUserAuthService)이 직접 사용하며,
|
||||
* DB 미러(PTL_ROLE / PTL_ROLE_AUTHORITY)는 {@link MenuSeeder} 가 적재한다.
|
||||
*/
|
||||
@Data
|
||||
@Component
|
||||
@ConfigurationProperties(prefix = "portal-roles")
|
||||
public class PortalRolesProperties {
|
||||
|
||||
private List<RoleDef> roles = new ArrayList<>();
|
||||
|
||||
/** AUTHORITY 유형 역할 코드 → 한글 라벨 (admin UI 표기용) */
|
||||
private Map<String, String> authorityNames = new LinkedHashMap<>();
|
||||
|
||||
@Data
|
||||
public static class RoleDef {
|
||||
private String code;
|
||||
private String name;
|
||||
private List<String> authorities = new ArrayList<>();
|
||||
}
|
||||
|
||||
/**
|
||||
* 기본 역할의 파생 권한 목록. 미정의 역할이면 빈 목록.
|
||||
*/
|
||||
public List<String> getAuthorities(RoleCode roleCode) {
|
||||
return roles.stream()
|
||||
.filter(role -> role.getCode().equals(roleCode.name()))
|
||||
.findFirst()
|
||||
.map(RoleDef::getAuthorities)
|
||||
.orElse(Collections.emptyList());
|
||||
}
|
||||
}
|
||||
@@ -2,7 +2,7 @@ server:
|
||||
servlet:
|
||||
context-path: /
|
||||
session:
|
||||
# 세션 타임아웃 10분 고정 (DB property 관리 폐지).
|
||||
# 세션 타임아웃 10분 고정
|
||||
# WebLogic 배포 시에는 weblogic.xml <timeout-secs>600 이 동일 값을 적용한다.
|
||||
# CSRF 토큰은 세션에 저장(HttpSessionCsrfTokenRepository)되므로 수명도 이 값과 동일하다.
|
||||
timeout: 10m
|
||||
@@ -23,6 +23,10 @@ server:
|
||||
|
||||
|
||||
spring:
|
||||
config:
|
||||
import:
|
||||
- classpath:menu.yml
|
||||
- classpath:roles.yml
|
||||
data:
|
||||
web:
|
||||
pageable:
|
||||
@@ -218,26 +222,7 @@ portal:
|
||||
view-name: apps/apis/static/tokenApiSpec
|
||||
bean: apiHandler
|
||||
|
||||
portal_security:
|
||||
ROLE_USER:
|
||||
- ROLE_INQUIRY
|
||||
- ROLE_ACCOUNT
|
||||
ROLE_CORP_USER:
|
||||
- ROLE_API_KEY_REQUEST
|
||||
- ROLE_API_KEY_REQUEST_VIEW
|
||||
- ROLE_INQUIRY
|
||||
- ROLE_APP
|
||||
- ROLE_ACCOUNT
|
||||
ROLE_CORP_MANAGER:
|
||||
- ROLE_API_KEY_REQUEST
|
||||
- ROLE_API_KEY_REQUEST_VIEW
|
||||
- ROLE_WEBHOOK
|
||||
- ROLE_INQUIRY
|
||||
- ROLE_APP
|
||||
- ROLE_ACCOUNT
|
||||
- ROLE_CORP_API
|
||||
- ROLE_DASHBOARD
|
||||
- ROLE_USER_MANAGER
|
||||
# portal_security 는 roles.yml (portal-roles) 로 이동
|
||||
page:
|
||||
home:
|
||||
name: "Home"
|
||||
@@ -318,6 +303,13 @@ page:
|
||||
api_testbed:
|
||||
name: "테스트베드"
|
||||
path: "/apis/detail/testbed"
|
||||
apistatus:
|
||||
name: "API Status"
|
||||
path: "/apistatus"
|
||||
children:
|
||||
issues:
|
||||
name: "전체 이슈 이력"
|
||||
path: "/apistatus/issues"
|
||||
community:
|
||||
name: 고객지원
|
||||
path: "#"
|
||||
|
||||
@@ -0,0 +1,55 @@
|
||||
# ------------------------------------------------------------------------------
|
||||
# 포탈 GNB 메뉴 정의 (menu.yml)
|
||||
#
|
||||
# - 부팅 시 PTL_MENU_ITEM 으로 자동 적재(upsert by id). 동일 id 의 내용이 바뀌면
|
||||
# 기본값(DFLT_*)이 갱신되고, 관리자가 수정하지 않은 필드만 새 기본값을 따라간다.
|
||||
# - 배치(위치) 정보는 PTL_MENU_PLACEMENT 가 비어있을 때만 최초 적재된다.
|
||||
# 이후 배치 관리는 eapim-admin "포탈메뉴관리" 화면에서 수행.
|
||||
# - id: kebab-case (^[a-z0-9-]+$). 변경 시 새 항목으로 인식되므로 변경 금지.
|
||||
# - group: true → 상위 그룹(클릭 없음). path 를 주면 그룹도 링크 동작.
|
||||
# - section: GNB(기본) | MYPAGE(마이페이지 드롭다운)
|
||||
# - expose-roles / access-roles: 생략=전체 허용, AUTHENTICATED=로그인 사용자,
|
||||
# 그 외 역할 코드 나열 시 하나라도 보유하면 허용(any-of)
|
||||
# ------------------------------------------------------------------------------
|
||||
portal-menu:
|
||||
items:
|
||||
- id: service
|
||||
name: "서비스 소개"
|
||||
group: true
|
||||
children:
|
||||
- { id: service-intro, name: "API 포탈 소개", path: /service/intro }
|
||||
- { id: service-guide, name: "회원가입 안내", path: /service/guide }
|
||||
- { id: service-oauth2-guide, name: "OAuth2 개발가이드", path: /service/oauth2-guide }
|
||||
- { id: service-webhook-dev-guide, name: "웹훅 개발가이드", path: /service/webhook-dev-guide }
|
||||
|
||||
- { id: open-api, name: "오픈 API", path: /apis }
|
||||
|
||||
- id: support
|
||||
name: "고객지원"
|
||||
group: true
|
||||
children:
|
||||
- { id: support-notice, name: "공지사항", path: /portalnotice }
|
||||
- { id: support-faq, name: "FAQ", path: /faq_list }
|
||||
- { id: support-qna, name: "Q&A", path: /inquiry }
|
||||
- { id: support-partnership, name: "피드백/개선요청", path: /partnership }
|
||||
|
||||
- { id: api-status, name: "API Status", path: /apistatus }
|
||||
|
||||
- id: my-page
|
||||
name: "마이페이지"
|
||||
group: true
|
||||
section: MYPAGE
|
||||
expose-roles: [AUTHENTICATED]
|
||||
children:
|
||||
- { id: my-page-users, name: "개발자 관리", path: /users, icon: fa-users,
|
||||
expose-roles: [ROLE_CORP_MANAGER], access-roles: [ROLE_CORP_MANAGER] }
|
||||
- { id: my-page-clients, name: "API 신청 관리", path: /clients, icon: fa-key,
|
||||
expose-roles: [ROLE_APP], access-roles: [ROLE_APP] }
|
||||
- { id: my-page-webhook, name: "Webhook 관리", path: /webhook, icon: fa-bell,
|
||||
expose-roles: [ROLE_WEBHOOK], access-roles: [ROLE_WEBHOOK] }
|
||||
- { id: my-page-statistics, name: "이용 통계", path: /statistics/api, icon: fa-chart-bar,
|
||||
expose-roles: [ROLE_APP], access-roles: [ROLE_APP] }
|
||||
- { id: my-page-profile, name: "내 정보 관리", path: /mypage, icon: fa-user-circle,
|
||||
expose-roles: [AUTHENTICATED], access-roles: [AUTHENTICATED] }
|
||||
- { id: my-page-password, name: "비밀번호 변경", path: /password/change, icon: fa-lock,
|
||||
expose-roles: [AUTHENTICATED], access-roles: [AUTHENTICATED] }
|
||||
@@ -0,0 +1,47 @@
|
||||
# ------------------------------------------------------------------------------
|
||||
# 포탈 역할 정의 (roles.yml)
|
||||
#
|
||||
# - 기존 application.yml 의 portal.portal_security 를 이동한 파일.
|
||||
# - 로그인 시 권한 확장(PortalUserAuthService)은 이 파일 바인딩을 직접 사용한다.
|
||||
# - 부팅 시 PTL_ROLE / PTL_ROLE_AUTHORITY 로 미러 적재되며,
|
||||
# 해당 테이블은 eapim-admin 메뉴 권한 선택 UI 소스로만 소비된다.
|
||||
# ------------------------------------------------------------------------------
|
||||
portal-roles:
|
||||
roles:
|
||||
- code: ROLE_USER
|
||||
name: "개인사용자"
|
||||
authorities:
|
||||
- ROLE_INQUIRY
|
||||
- ROLE_ACCOUNT
|
||||
- code: ROLE_CORP_USER
|
||||
name: "법인사용자"
|
||||
authorities:
|
||||
- ROLE_API_KEY_REQUEST
|
||||
- ROLE_API_KEY_REQUEST_VIEW
|
||||
- ROLE_INQUIRY
|
||||
- ROLE_APP
|
||||
- ROLE_ACCOUNT
|
||||
- code: ROLE_CORP_MANAGER
|
||||
name: "법인관리자"
|
||||
authorities:
|
||||
- ROLE_API_KEY_REQUEST
|
||||
- ROLE_API_KEY_REQUEST_VIEW
|
||||
- ROLE_WEBHOOK
|
||||
- ROLE_INQUIRY
|
||||
- ROLE_APP
|
||||
- ROLE_ACCOUNT
|
||||
- ROLE_CORP_API
|
||||
- ROLE_DASHBOARD
|
||||
- ROLE_USER_MANAGER
|
||||
|
||||
# PTL_ROLE(AUTHORITY 유형) 한글 라벨 — admin 권한 선택 UI 표기용
|
||||
authority-names:
|
||||
ROLE_INQUIRY: "문의 작성"
|
||||
ROLE_ACCOUNT: "계정 관리"
|
||||
ROLE_API_KEY_REQUEST: "인증키 신청"
|
||||
ROLE_API_KEY_REQUEST_VIEW: "인증키 신청 조회"
|
||||
ROLE_APP: "앱/API 신청 관리"
|
||||
ROLE_WEBHOOK: "웹훅 관리"
|
||||
ROLE_CORP_API: "법인 API 조회"
|
||||
ROLE_DASHBOARD: "대시보드"
|
||||
ROLE_USER_MANAGER: "개발자 관리"
|
||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because one or more lines are too long
@@ -0,0 +1,498 @@
|
||||
(function () {
|
||||
'use strict';
|
||||
|
||||
const page = document.getElementById('issueHistoryPage');
|
||||
if (!page) return;
|
||||
|
||||
const windowDays = parseInt(page.getAttribute('data-window-days'), 10) || 90;
|
||||
const base = page.getAttribute('data-base') || '/apistatus';
|
||||
const apiDetailBase = page.getAttribute('data-api-detail-base') || '/apis/detail';
|
||||
const noticeDetailBase = page.getAttribute('data-notice-detail-base') || '/portalnotice/detail';
|
||||
|
||||
/** 오픈 API 목록에 노출되는 API (링크 가능 대상) */
|
||||
const linkableApiIds = new Set();
|
||||
|
||||
const KIND_LABEL = { INCIDENT: '장애', DELAY: '지연', MAINTENANCE: '점검' };
|
||||
const KIND_CLASS = { INCIDENT: 'is-incident', DELAY: 'is-degraded', MAINTENANCE: 'is-maintenance' };
|
||||
const PAGE_SIZE = 10;
|
||||
const API_LIST_LIMIT = 50; // 라이브서치 결과 표시 상한
|
||||
|
||||
const today = page.getAttribute('data-today') || '';
|
||||
// My APIs 등에서 넘어올 때 표시용 API 명 (필터 자체는 apiId 로 동작)
|
||||
const urlApiName = new URLSearchParams(window.location.search).get('apiName') || '';
|
||||
const minDate = page.getAttribute('data-min-date') || '';
|
||||
|
||||
// 진입 시 날짜 미지정 = 조회 기간 전체
|
||||
const state = {
|
||||
date: page.getAttribute('data-selected-date') || '',
|
||||
apiId: page.getAttribute('data-selected-api') || '',
|
||||
kind: page.getAttribute('data-selected-kind') || '',
|
||||
page: 0
|
||||
};
|
||||
|
||||
const indexBar = document.getElementById('issueIndexBar');
|
||||
const listEl = document.getElementById('issueList');
|
||||
const pagerEl = document.getElementById('issuePager');
|
||||
const totalCountEl = document.getElementById('issueTotalCount');
|
||||
const selectedDateLabel = document.getElementById('selectedDateLabel');
|
||||
const dateField = document.getElementById('dateField');
|
||||
const dateInput = document.getElementById('filterDateInput');
|
||||
const dateClearBtn = document.getElementById('filterDateClear');
|
||||
const kindSelect = document.getElementById('filterKindSelect');
|
||||
const apiCombo = document.getElementById('apiCombo');
|
||||
const apiInput = document.getElementById('filterApiInput');
|
||||
const apiClearBtn = document.getElementById('filterApiClear');
|
||||
const apiListEl = document.getElementById('filterApiList');
|
||||
const unlistedBanner = document.getElementById('unlistedApiBanner');
|
||||
const unlistedName = document.getElementById('unlistedApiName');
|
||||
|
||||
let apiOptions = [];
|
||||
|
||||
function escapeHtml(text) {
|
||||
if (text == null) return '';
|
||||
return String(text)
|
||||
.replace(/&/g, '&')
|
||||
.replace(/</g, '<')
|
||||
.replace(/>/g, '>')
|
||||
.replace(/"/g, '"')
|
||||
.replace(/'/g, ''');
|
||||
}
|
||||
|
||||
function fetchJson(url) {
|
||||
return fetch(url, { credentials: 'same-origin', headers: { Accept: 'application/json' } })
|
||||
.then(function (response) {
|
||||
if (!response.ok) throw new Error('HTTP ' + response.status);
|
||||
return response.json();
|
||||
});
|
||||
}
|
||||
|
||||
function parseDateTime(value) {
|
||||
if (!value) return null;
|
||||
const parsed = new Date(String(value).replace(' ', 'T'));
|
||||
return isNaN(parsed.getTime()) ? null : parsed;
|
||||
}
|
||||
|
||||
function pad(value) {
|
||||
return value < 10 ? '0' + value : String(value);
|
||||
}
|
||||
|
||||
function formatDate(value) {
|
||||
const date = parseDateTime(value);
|
||||
if (!date) return '-';
|
||||
return date.getFullYear() + '-' + pad(date.getMonth() + 1) + '-' + pad(date.getDate());
|
||||
}
|
||||
|
||||
function formatDateTime(value) {
|
||||
const date = parseDateTime(value);
|
||||
if (!date) return '-';
|
||||
return formatDate(value) + ' ' + pad(date.getHours()) + ':' + pad(date.getMinutes());
|
||||
}
|
||||
|
||||
function formatDuration(minutes) {
|
||||
if (minutes == null) return '';
|
||||
if (minutes < 60) return minutes + '분';
|
||||
const hours = Math.floor(minutes / 60);
|
||||
const rest = minutes % 60;
|
||||
return rest === 0 ? hours + '시간' : hours + '시간 ' + rest + '분';
|
||||
}
|
||||
|
||||
function buildQuery(params) {
|
||||
const query = [];
|
||||
Object.keys(params).forEach(function (key) {
|
||||
if (params[key] !== '' && params[key] != null) {
|
||||
query.push(key + '=' + encodeURIComponent(params[key]));
|
||||
}
|
||||
});
|
||||
return query.length ? '?' + query.join('&') : '';
|
||||
}
|
||||
|
||||
function syncBrowserUrl() {
|
||||
if (!window.history || !window.history.replaceState) return;
|
||||
window.history.replaceState(null, '',
|
||||
base + '/issues' + buildQuery({ date: state.date, apiId: state.apiId, kind: state.kind }));
|
||||
}
|
||||
|
||||
/** 필터 변경 후 목록/인덱스 재조회 */
|
||||
function applyFilters(reloadIndex) {
|
||||
state.page = 0;
|
||||
syncBrowserUrl();
|
||||
renderIndexBarSelection();
|
||||
if (reloadIndex) loadIndexBar();
|
||||
loadIssues();
|
||||
}
|
||||
|
||||
// ---------------- 90일 인덱스바 ----------------
|
||||
function renderIndexBar(entries) {
|
||||
if (!entries || !entries.length) {
|
||||
indexBar.innerHTML = '';
|
||||
return;
|
||||
}
|
||||
|
||||
indexBar.innerHTML = entries.map(function (entry) {
|
||||
const hasIncident = entry.incCount > 0;
|
||||
const hasDelay = entry.dlyCount > 0;
|
||||
const hasMaintenance = entry.mntCount > 0;
|
||||
|
||||
// 유형이 2종 이상 섞인 날은 개별 색 대신 복합 색으로 표시한다
|
||||
const kindCount = (hasIncident ? 1 : 0) + (hasDelay ? 1 : 0) + (hasMaintenance ? 1 : 0);
|
||||
let cls = '';
|
||||
if (kindCount > 1) cls = ' has-mixed';
|
||||
else if (hasIncident) cls = ' has-incident';
|
||||
else if (hasDelay) cls = ' has-degraded';
|
||||
else if (hasMaintenance) cls = ' has-maintenance';
|
||||
if (state.date && state.date === entry.date) cls += ' is-selected';
|
||||
|
||||
const parts = [];
|
||||
if (hasIncident) parts.push('장애 ' + entry.incCount + '건');
|
||||
if (hasDelay) parts.push('지연 ' + entry.dlyCount + '건');
|
||||
if (hasMaintenance) parts.push('점검 ' + entry.mntCount + '건');
|
||||
const tooltip = entry.date + (parts.length ? ' · ' + parts.join(' · ') : ' · 이슈 없음');
|
||||
|
||||
return '<button type="button" class="as-index-cell' + cls + '"'
|
||||
+ ' data-date="' + escapeHtml(entry.date) + '"'
|
||||
+ ' title="' + escapeHtml(tooltip) + '"></button>';
|
||||
}).join('');
|
||||
|
||||
indexBar.querySelectorAll('.as-index-cell').forEach(function (cell) {
|
||||
cell.addEventListener('click', function () {
|
||||
const clicked = cell.getAttribute('data-date');
|
||||
state.date = state.date === clicked ? '' : clicked;
|
||||
applyFilters(false);
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function renderIndexBarSelection() {
|
||||
indexBar.querySelectorAll('.as-index-cell').forEach(function (cell) {
|
||||
cell.classList.toggle('is-selected', state.date === cell.getAttribute('data-date'));
|
||||
});
|
||||
selectedDateLabel.textContent = state.date || '전체 기간';
|
||||
if (dateInput.value !== state.date) {
|
||||
dateInput.value = state.date;
|
||||
}
|
||||
dateField.classList.toggle('has-value', !!state.date);
|
||||
}
|
||||
|
||||
// ---------------- 이슈 카드 ----------------
|
||||
/**
|
||||
* 영향 API 태그.
|
||||
*
|
||||
* 서버가 이미 현재 사용자에게 게시된 API 만 내려주므로 여기 오는 항목은 전부 링크 대상이다.
|
||||
* 게시되지 않은 GW 인터페이스는 개별 노출하지 않고 hiddenApiCount 로만 받아 건수로 묶는다.
|
||||
*/
|
||||
function apiPillsHtml(apis, hiddenCount) {
|
||||
const hidden = hiddenCount || 0;
|
||||
if ((!apis || !apis.length) && hidden === 0) return '';
|
||||
|
||||
const pills = (apis || []).map(function (api) {
|
||||
const text = escapeHtml(api.apiName || api.apiId);
|
||||
if (!linkableApiIds.has(api.apiId)) {
|
||||
return '<span class="as-api-pill is-unlinked">' + text + '</span>';
|
||||
}
|
||||
return '<a class="as-api-pill" href="' + apiDetailBase + '?id=' + encodeURIComponent(api.apiId) + '">'
|
||||
+ text + '</a>';
|
||||
}).join('');
|
||||
|
||||
// 개발자포탈에 게시되지 않은 GW 인터페이스는 개별 노출 없이 건수로만 알린다
|
||||
const hiddenPill = hidden > 0
|
||||
? '<span class="as-api-pill is-gw" title="개발자포탈에 게시되지 않은 게이트웨이 인터페이스입니다">'
|
||||
+ 'GW 인터페이스 ' + hidden + '건</span>'
|
||||
: '';
|
||||
|
||||
return '<div class="as-api-pills"><span>영향 API:</span>' + pills + hiddenPill + '</div>';
|
||||
}
|
||||
|
||||
/**
|
||||
* 이슈에 연결된 공지 본문. 서버가 게시 중(USE_YN='Y')인 공지만 내려주므로 여기서는 존재 여부만 본다.
|
||||
* 본문은 관리자가 에디터로 작성한 HTML 이라 공지 상세(th:utext)와 같이 그대로 렌더한다.
|
||||
*/
|
||||
function noticeHtml(issue) {
|
||||
if (!issue.noticeDetail) return '';
|
||||
const link = issue.noticeId
|
||||
? '<a class="as-alert-notice-link" href="' + noticeDetailBase + '?id='
|
||||
+ encodeURIComponent(issue.noticeId) + '">공지 전체 보기 →</a>'
|
||||
: '';
|
||||
return '<div class="as-alert-notice">'
|
||||
+ '<div class="as-alert-notice-head">'
|
||||
+ '<span class="as-alert-notice-label">공지사항</span>'
|
||||
+ (issue.noticeSubject ? '<strong>' + escapeHtml(issue.noticeSubject) + '</strong>' : '')
|
||||
+ '</div>'
|
||||
+ '<div class="as-alert-notice-body editor-content">' + issue.noticeDetail + '</div>'
|
||||
+ link
|
||||
+ '</div>';
|
||||
}
|
||||
|
||||
/**
|
||||
* 타임라인 | 공지 2열 배치. 데스크탑에서만 두 칸으로 갈라지고 좁은 화면에서는 세로로 쌓인다.
|
||||
* 한쪽만 있으면 감싸지 않는다 (혼자 반쪽 폭을 차지하지 않게).
|
||||
*/
|
||||
function splitHtml(left, right) {
|
||||
if (!left) return right;
|
||||
if (!right) return left;
|
||||
return '<div class="as-card-split">' + left + right + '</div>';
|
||||
}
|
||||
|
||||
function issueCardHtml(issue) {
|
||||
const kindClass = KIND_CLASS[issue.kind] || 'is-incident';
|
||||
|
||||
let inner;
|
||||
if (issue.kind === 'MAINTENANCE') {
|
||||
inner = '<p class="as-tl-body">' + escapeHtml(issue.summary || '점검 안내') + '</p>';
|
||||
} else {
|
||||
const items = (issue.timeline || []).map(function (entry) {
|
||||
return '<div class="as-tl-item state-' + escapeHtml(entry.stateAfter || 'NONE') + '">'
|
||||
+ '<span class="as-dot"></span>'
|
||||
+ '<p class="as-tl-label">' + escapeHtml(entry.labelKo || '진행 상황') + '</p>'
|
||||
+ '<p class="as-tl-body">' + escapeHtml(entry.body) + '</p>'
|
||||
+ '<p class="as-tl-ts">' + escapeHtml(formatDateTime(entry.eventAt)) + '</p>'
|
||||
+ '</div>';
|
||||
}).join('');
|
||||
inner = items
|
||||
? '<div class="as-tl-block">' + items + '</div>'
|
||||
: '<p class="as-tl-body">' + escapeHtml(issue.summary || '상세 진행 내역이 등록되지 않았습니다.') + '</p>';
|
||||
}
|
||||
|
||||
const period = formatDateTime(issue.startedAt)
|
||||
+ (issue.endAt ? ' ~ ' + formatDateTime(issue.endAt) : ' ~ 진행 중')
|
||||
+ (issue.durationMinutes != null ? ' (' + formatDuration(issue.durationMinutes) + ')' : '');
|
||||
|
||||
return '<article class="as-issue-card ' + kindClass + '">'
|
||||
+ '<div class="as-issue-meta-row">'
|
||||
+ ' <span class="as-badge ' + kindClass + '">' + escapeHtml(KIND_LABEL[issue.kind] || '') + '</span>'
|
||||
+ ' <span>' + escapeHtml(period) + '</span>'
|
||||
+ (issue.stateLabel ? '<span>' + escapeHtml(issue.stateLabel) + '</span>' : '')
|
||||
+ '</div>'
|
||||
+ '<h3 class="as-issue-title">' + escapeHtml(issue.title) + '</h3>'
|
||||
+ splitHtml(inner, noticeHtml(issue))
|
||||
+ apiPillsHtml(issue.impactedApis, issue.hiddenApiCount)
|
||||
+ '</article>';
|
||||
}
|
||||
|
||||
function renderPager(pageData) {
|
||||
const totalPages = pageData.totalPages || 0;
|
||||
if (totalPages <= 1) {
|
||||
pagerEl.innerHTML = '';
|
||||
return;
|
||||
}
|
||||
let html = '';
|
||||
for (let index = 0; index < totalPages; index++) {
|
||||
const current = index === pageData.number;
|
||||
html += '<button type="button" class="as-btn' + (current ? ' is-current' : '') + '"'
|
||||
+ ' data-page="' + index + '"' + (current ? ' disabled' : '') + '>' + (index + 1) + '</button>';
|
||||
}
|
||||
pagerEl.innerHTML = html;
|
||||
pagerEl.querySelectorAll('button[data-page]').forEach(function (button) {
|
||||
button.addEventListener('click', function () {
|
||||
state.page = parseInt(button.getAttribute('data-page'), 10) || 0;
|
||||
loadIssues();
|
||||
window.scrollTo({ top: listEl.offsetTop - 80, behavior: 'smooth' });
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
function loadIssues() {
|
||||
const query = buildQuery({
|
||||
date: state.date,
|
||||
apiId: state.apiId,
|
||||
kind: state.kind,
|
||||
page: state.page,
|
||||
size: PAGE_SIZE
|
||||
});
|
||||
|
||||
fetchJson(base + '/issues/list.json' + query)
|
||||
.then(function (pageData) {
|
||||
const content = pageData.content || [];
|
||||
totalCountEl.textContent = pageData.totalElements != null ? pageData.totalElements : content.length;
|
||||
|
||||
listEl.innerHTML = content.length
|
||||
? content.map(issueCardHtml).join('')
|
||||
: '<div class="as-empty">조건에 해당하는 이슈가 없습니다.</div>';
|
||||
renderPager(pageData);
|
||||
})
|
||||
.catch(function () {
|
||||
listEl.innerHTML = '<div class="as-empty">이슈 목록을 불러올 수 없습니다.</div>';
|
||||
pagerEl.innerHTML = '';
|
||||
});
|
||||
}
|
||||
|
||||
// ---------------- API 필터 (라이브서치 콤보박스) ----------------
|
||||
|
||||
/** 옵션 = 오픈 API 목록과 동일 기준(그룹 편성 + 사용자 공개). 표시는 API 명만. */
|
||||
function loadApiOptions() {
|
||||
return fetchJson(base + '/apis.json')
|
||||
.then(function (apis) {
|
||||
apiOptions = (apis || []).filter(function (api) { return api.apiId; });
|
||||
apiOptions.forEach(function (api) { linkableApiIds.add(api.apiId); });
|
||||
// URL 로 들어온 apiId 는 옵션(오픈 API 목록)에 없어도 필터를 유지한다.
|
||||
// My APIs(기관 계약 API)처럼 오픈 API 목록 밖의 API 로도 진입하기 때문.
|
||||
renderApiInput();
|
||||
})
|
||||
.catch(function () { /* 옵션 조회 실패 시 전체 API 기준으로 동작 */ });
|
||||
}
|
||||
|
||||
function findApiOption(apiId) {
|
||||
if (!apiId) return null;
|
||||
for (let index = 0; index < apiOptions.length; index++) {
|
||||
if (apiOptions[index].apiId === apiId) return apiOptions[index];
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/** 표시 형태: "[그룹명] API명" (그룹 없으면 API명만) */
|
||||
function optionLabel(api) {
|
||||
if (!api) return '';
|
||||
return api.groupName ? '[' + api.groupName + '] ' + api.apiName : api.apiName;
|
||||
}
|
||||
|
||||
function renderApiInput() {
|
||||
const selected = findApiOption(state.apiId);
|
||||
// 옵션에 없는 API(오픈 API 목록 밖)는 전달받은 API 명 또는 ID 로 표시해 필터 상태를 보이게 한다
|
||||
apiInput.value = selected ? optionLabel(selected) : (state.apiId ? (urlApiName || state.apiId) : '');
|
||||
apiCombo.classList.toggle('has-value', !!state.apiId);
|
||||
|
||||
// 포탈 미게시 API 필터 안내 배너 (옵션 목록을 받은 뒤에만 판단)
|
||||
const unlisted = !!state.apiId && apiOptions.length > 0 && !selected;
|
||||
if (unlisted) {
|
||||
unlistedName.textContent = urlApiName || state.apiId;
|
||||
}
|
||||
unlistedBanner.style.display = unlisted ? '' : 'none';
|
||||
}
|
||||
|
||||
function closeApiList() {
|
||||
apiListEl.hidden = true;
|
||||
apiInput.setAttribute('aria-expanded', 'false');
|
||||
}
|
||||
|
||||
function openApiList(keyword) {
|
||||
const query = (keyword || '').trim().toLowerCase();
|
||||
const matched = apiOptions.filter(function (api) {
|
||||
if (!query) return true;
|
||||
return optionLabel(api).toLowerCase().indexOf(query) >= 0;
|
||||
});
|
||||
|
||||
if (!matched.length) {
|
||||
apiListEl.innerHTML = '<li class="as-combo-empty">검색 결과가 없습니다</li>';
|
||||
} else {
|
||||
const items = matched.slice(0, API_LIST_LIMIT).map(function (api) {
|
||||
return '<li role="option" class="as-combo-item" data-api-id="' + escapeHtml(api.apiId) + '">'
|
||||
+ escapeHtml(optionLabel(api)) + '</li>';
|
||||
});
|
||||
if (matched.length > API_LIST_LIMIT) {
|
||||
items.push('<li class="as-combo-empty">이하 '
|
||||
+ (matched.length - API_LIST_LIMIT) + '건은 검색어를 입력해 좁혀주세요</li>');
|
||||
}
|
||||
apiListEl.innerHTML = '<li role="option" class="as-combo-item" data-api-id="">전체 API</li>'
|
||||
+ items.join('');
|
||||
}
|
||||
|
||||
apiListEl.hidden = false;
|
||||
apiInput.setAttribute('aria-expanded', 'true');
|
||||
}
|
||||
|
||||
function selectApi(apiId) {
|
||||
state.apiId = apiId || '';
|
||||
renderApiInput();
|
||||
closeApiList();
|
||||
applyFilters(true);
|
||||
}
|
||||
|
||||
function loadIndexBar() {
|
||||
fetchJson(base + '/issues/dates.json'
|
||||
+ buildQuery({ days: windowDays, apiId: state.apiId, kind: state.kind }))
|
||||
.then(function (entries) {
|
||||
renderIndexBar(entries);
|
||||
renderIndexBarSelection();
|
||||
})
|
||||
.catch(function () { indexBar.innerHTML = ''; });
|
||||
}
|
||||
|
||||
// ---------------- 필터 이벤트 ----------------
|
||||
|
||||
dateInput.addEventListener('change', function () {
|
||||
const value = dateInput.value;
|
||||
// 조회 기간(90일) 밖 날짜는 되돌린다
|
||||
if (value && ((minDate && value < minDate) || (today && value > today))) {
|
||||
dateInput.value = state.date;
|
||||
return;
|
||||
}
|
||||
state.date = value;
|
||||
applyFilters(false);
|
||||
});
|
||||
|
||||
dateClearBtn.addEventListener('click', function () {
|
||||
state.date = '';
|
||||
dateInput.value = '';
|
||||
applyFilters(false);
|
||||
});
|
||||
|
||||
kindSelect.addEventListener('change', function () {
|
||||
state.kind = kindSelect.value;
|
||||
applyFilters(true);
|
||||
});
|
||||
|
||||
// readonly 자동완성 차단 트릭: 브라우저 autofill 은 readonly 입력을 후보에서 제외한다.
|
||||
// 사용자가 실제로 만지는 순간에만 readonly 를 풀어 입력을 허용한다 (모바일은 touchstart 가 먼저 온다).
|
||||
function unlockApiInput() {
|
||||
if (apiInput.hasAttribute('readonly')) {
|
||||
apiInput.removeAttribute('readonly');
|
||||
}
|
||||
}
|
||||
apiInput.addEventListener('touchstart', unlockApiInput, { passive: true });
|
||||
apiInput.addEventListener('mousedown', unlockApiInput);
|
||||
|
||||
apiInput.addEventListener('focus', function () {
|
||||
unlockApiInput();
|
||||
openApiList('');
|
||||
});
|
||||
|
||||
apiInput.addEventListener('input', function () { openApiList(apiInput.value); });
|
||||
|
||||
apiInput.addEventListener('keydown', function (event) {
|
||||
if (event.key === 'Escape') {
|
||||
renderApiInput();
|
||||
closeApiList();
|
||||
} else if (event.key === 'Enter') {
|
||||
event.preventDefault();
|
||||
const first = apiListEl.querySelector('.as-combo-item');
|
||||
if (first) selectApi(first.getAttribute('data-api-id'));
|
||||
}
|
||||
});
|
||||
|
||||
apiListEl.addEventListener('mousedown', function (event) {
|
||||
const item = event.target.closest('.as-combo-item');
|
||||
if (!item) return;
|
||||
event.preventDefault();
|
||||
selectApi(item.getAttribute('data-api-id'));
|
||||
});
|
||||
|
||||
apiClearBtn.addEventListener('click', function () {
|
||||
apiInput.value = '';
|
||||
selectApi('');
|
||||
});
|
||||
|
||||
document.addEventListener('click', function (event) {
|
||||
if (!apiCombo.contains(event.target)) {
|
||||
renderApiInput();
|
||||
closeApiList();
|
||||
}
|
||||
});
|
||||
|
||||
document.getElementById('filterResetBtn').addEventListener('click', function () {
|
||||
state.date = '';
|
||||
state.apiId = '';
|
||||
state.kind = '';
|
||||
dateInput.value = '';
|
||||
kindSelect.value = '';
|
||||
renderApiInput();
|
||||
closeApiList();
|
||||
applyFilters(true);
|
||||
});
|
||||
|
||||
// ---------------- 초기 로딩 ----------------
|
||||
dateInput.value = state.date;
|
||||
kindSelect.value = state.kind;
|
||||
renderIndexBarSelection();
|
||||
loadIndexBar();
|
||||
// 영향 API 태그의 링크 여부 판단에 오픈 API 목록이 필요하므로 옵션을 먼저 받는다
|
||||
loadApiOptions().then(loadIssues);
|
||||
})();
|
||||
@@ -0,0 +1,399 @@
|
||||
(function () {
|
||||
'use strict';
|
||||
|
||||
const page = document.getElementById('apiStatusPage');
|
||||
if (!page) return;
|
||||
|
||||
const windowDays = parseInt(page.getAttribute('data-window-days'), 10) || 90;
|
||||
const authenticated = page.classList.contains('is-authenticated');
|
||||
const base = page.getAttribute('data-base') || '/apistatus';
|
||||
const apiDetailBase = page.getAttribute('data-api-detail-base') || '/apis/detail';
|
||||
const noticeDetailBase = page.getAttribute('data-notice-detail-base') || '/portalnotice/detail';
|
||||
|
||||
/** 오픈 API 목록에 노출되는 API (링크 가능 대상) */
|
||||
const linkableApiIds = new Set();
|
||||
|
||||
const KIND_LABEL = { INCIDENT: '장애', DELAY: '지연', MAINTENANCE: '점검' };
|
||||
const KIND_CLASS = { INCIDENT: 'is-incident', DELAY: 'is-degraded', MAINTENANCE: 'is-maintenance' };
|
||||
|
||||
/** 진행 중 장애 카드 노출 상한. 초과분은 전체 이력 링크로 넘긴다. */
|
||||
const ACTIVE_INCIDENT_LIMIT = 1;
|
||||
|
||||
function escapeHtml(text) {
|
||||
if (text == null) return '';
|
||||
return String(text)
|
||||
.replace(/&/g, '&')
|
||||
.replace(/</g, '<')
|
||||
.replace(/>/g, '>')
|
||||
.replace(/"/g, '"')
|
||||
.replace(/'/g, ''');
|
||||
}
|
||||
|
||||
function fetchJson(url) {
|
||||
return fetch(url, { credentials: 'same-origin', headers: { Accept: 'application/json' } })
|
||||
.then(function (response) {
|
||||
if (!response.ok) throw new Error('HTTP ' + response.status);
|
||||
return response.json();
|
||||
});
|
||||
}
|
||||
|
||||
/** "2026-07-30T09:15:00" → Date. 서버는 서버 timezone(KST) 기준 LocalDateTime 을 보낸다. */
|
||||
function parseDateTime(value) {
|
||||
if (!value) return null;
|
||||
const parsed = new Date(String(value).replace(' ', 'T'));
|
||||
return isNaN(parsed.getTime()) ? null : parsed;
|
||||
}
|
||||
|
||||
function pad(value) {
|
||||
return value < 10 ? '0' + value : String(value);
|
||||
}
|
||||
|
||||
function formatDate(value) {
|
||||
const date = parseDateTime(value);
|
||||
if (!date) return '-';
|
||||
return date.getFullYear() + '-' + pad(date.getMonth() + 1) + '-' + pad(date.getDate());
|
||||
}
|
||||
|
||||
function formatDateTime(value) {
|
||||
const date = parseDateTime(value);
|
||||
if (!date) return '-';
|
||||
return formatDate(value) + ' ' + pad(date.getHours()) + ':' + pad(date.getMinutes());
|
||||
}
|
||||
|
||||
function formatTime(value) {
|
||||
const date = parseDateTime(value);
|
||||
if (!date) return '-';
|
||||
return pad(date.getHours()) + ':' + pad(date.getMinutes());
|
||||
}
|
||||
|
||||
function formatDuration(minutes) {
|
||||
if (minutes == null) return '';
|
||||
if (minutes < 60) return minutes + '분';
|
||||
const hours = Math.floor(minutes / 60);
|
||||
const rest = minutes % 60;
|
||||
return rest === 0 ? hours + '시간' : hours + '시간 ' + rest + '분';
|
||||
}
|
||||
|
||||
function formatPercent(ratio) {
|
||||
if (ratio == null) return '-';
|
||||
return (ratio * 100).toFixed(2);
|
||||
}
|
||||
|
||||
function issuesHref(params) {
|
||||
const query = [];
|
||||
if (params.date) query.push('date=' + encodeURIComponent(params.date));
|
||||
if (params.apiId) query.push('apiId=' + encodeURIComponent(params.apiId));
|
||||
if (params.apiName) query.push('apiName=' + encodeURIComponent(params.apiName));
|
||||
return base + '/issues' + (query.length ? '?' + query.join('&') : '');
|
||||
}
|
||||
|
||||
/**
|
||||
* 영향 API 태그.
|
||||
*
|
||||
* 서버가 이미 현재 사용자에게 게시된 API 만 내려주므로 여기 오는 항목은 전부 링크 대상이다.
|
||||
* 게시되지 않은 GW 인터페이스는 개별 노출하지 않고 hiddenApiCount 로만 받아 건수로 묶는다.
|
||||
*/
|
||||
function apiPillsHtml(apis, label, hiddenCount) {
|
||||
const hidden = hiddenCount || 0;
|
||||
if ((!apis || !apis.length) && hidden === 0) return '';
|
||||
|
||||
const pills = (apis || []).map(function (api) {
|
||||
const text = escapeHtml(api.apiName || api.apiId);
|
||||
if (!linkableApiIds.has(api.apiId)) {
|
||||
return '<span class="as-api-pill is-unlinked">' + text + '</span>';
|
||||
}
|
||||
return '<a class="as-api-pill" href="' + apiDetailBase + '?id=' + encodeURIComponent(api.apiId) + '">'
|
||||
+ text + '</a>';
|
||||
}).join('');
|
||||
|
||||
const hiddenPill = hidden > 0
|
||||
? '<span class="as-api-pill is-gw" title="개발자포탈에 게시되지 않은 게이트웨이 인터페이스입니다">'
|
||||
+ 'GW 인터페이스 ' + hidden + '건</span>'
|
||||
: '';
|
||||
|
||||
return '<div class="as-api-pills"><span>' + escapeHtml(label) + '</span>' + pills + hiddenPill + '</div>';
|
||||
}
|
||||
|
||||
/**
|
||||
* 이슈에 연결된 공지 본문. 서버가 게시 중(USE_YN='Y')인 공지만 내려주므로 여기서는 존재 여부만 본다.
|
||||
* 본문은 관리자가 에디터로 작성한 HTML 이라 공지 상세(th:utext)와 같이 그대로 렌더한다.
|
||||
*/
|
||||
function noticeHtml(incident) {
|
||||
if (!incident.noticeDetail) return '';
|
||||
const link = incident.noticeId
|
||||
? '<a class="as-alert-notice-link" href="' + noticeDetailBase + '?id='
|
||||
+ encodeURIComponent(incident.noticeId) + '">공지 전체 보기 →</a>'
|
||||
: '';
|
||||
return '<div class="as-alert-notice">'
|
||||
+ '<div class="as-alert-notice-head">'
|
||||
+ '<span class="as-alert-notice-label">공지사항</span>'
|
||||
+ (incident.noticeSubject ? '<strong>' + escapeHtml(incident.noticeSubject) + '</strong>' : '')
|
||||
+ '</div>'
|
||||
+ '<div class="as-alert-notice-body editor-content">' + incident.noticeDetail + '</div>'
|
||||
+ link
|
||||
+ '</div>';
|
||||
}
|
||||
|
||||
/**
|
||||
* 타임라인 | 공지 2열 배치. 데스크탑에서만 두 칸으로 갈라지고 좁은 화면에서는 세로로 쌓인다.
|
||||
* 한쪽만 있으면 감싸지 않는다 (혼자 반쪽 폭을 차지하지 않게).
|
||||
*/
|
||||
function splitHtml(left, right) {
|
||||
if (!left) return right;
|
||||
if (!right) return left;
|
||||
return '<div class="as-card-split">' + left + right + '</div>';
|
||||
}
|
||||
|
||||
// ---------------- ❶ 진행 중 장애 ----------------
|
||||
function renderActiveIncidents(incidents) {
|
||||
const container = document.getElementById('activeIncidents');
|
||||
if (!incidents || !incidents.length) {
|
||||
container.innerHTML = '<section class="as-card">'
|
||||
+ '<div class="as-card-head"><div><h2>현재 진행 중인 장애가 없습니다</h2>'
|
||||
+ '<p class="as-desc">모든 API 가 정상 동작 중입니다.</p></div>'
|
||||
+ '<span class="as-badge is-normal">정상</span></div></section>';
|
||||
return;
|
||||
}
|
||||
|
||||
const visible = incidents.slice(0, ACTIVE_INCIDENT_LIMIT);
|
||||
const hidden = incidents.length - visible.length;
|
||||
|
||||
const cards = visible.map(function (incident) {
|
||||
const timeline = (incident.recentTimeline || []).map(function (entry) {
|
||||
const who = entry.authorType === 'SYSTEM' ? 'SYSTEM' : '운영자';
|
||||
const whoClass = entry.authorType === 'SYSTEM' ? ' is-system' : '';
|
||||
return '<div class="as-tl-row">'
|
||||
+ '<span class="as-tl-time">' + escapeHtml(formatTime(entry.eventAt)) + '</span>'
|
||||
+ '<span class="as-tl-who' + whoClass + '">' + escapeHtml(who) + '</span>'
|
||||
+ '<span>' + escapeHtml(entry.body) + '</span>'
|
||||
+ '</div>';
|
||||
}).join('');
|
||||
|
||||
return '<section class="as-card as-alert-card">'
|
||||
+ '<div class="as-alert-head">'
|
||||
+ ' <div><span class="as-badge is-incident">장애</span>'
|
||||
+ (incident.stateLabel ? ' <span class="as-badge is-muted">' + escapeHtml(incident.stateLabel) + '</span>' : '')
|
||||
+ ' </div>'
|
||||
+ ' <div class="as-meta">시작 <strong>' + escapeHtml(formatDateTime(incident.startedAt)) + '</strong>'
|
||||
+ ' · 경과 <strong>' + escapeHtml(formatDuration(incident.elapsedMinutes)) + '</strong></div>'
|
||||
+ '</div>'
|
||||
+ '<h2 class="as-alert-title">' + escapeHtml(incident.title) + '</h2>'
|
||||
+ (incident.summary ? '<p class="as-meta">' + escapeHtml(incident.summary) + '</p>' : '')
|
||||
+ apiPillsHtml(incident.apis, '영향 API:', incident.hiddenApiCount)
|
||||
+ splitHtml(timeline ? '<div class="as-alert-timeline">' + timeline + '</div>' : '',
|
||||
noticeHtml(incident))
|
||||
+ '</section>';
|
||||
}).join('');
|
||||
|
||||
const overflow = hidden > 0
|
||||
? '<div class="as-alert-overflow">'
|
||||
+ '<span>진행 중인 장애가 ' + escapeHtml(String(hidden)) + '건 더 있습니다.</span>'
|
||||
+ '<a href="' + issuesHref({}) + '">전체 이슈 이력에서 보기 →</a>'
|
||||
+ '</div>'
|
||||
: '';
|
||||
|
||||
container.innerHTML = cards + overflow;
|
||||
}
|
||||
|
||||
// ---------------- ❷ 90일 서비스 상태 ----------------
|
||||
function renderUptime(stats) {
|
||||
const chart = document.getElementById('uptimeChart');
|
||||
const fromLabel = document.getElementById('uptimeFromLabel');
|
||||
|
||||
if (!stats || !stats.length) {
|
||||
chart.innerHTML = '';
|
||||
return;
|
||||
}
|
||||
|
||||
const STATUS_LABEL = { OUTAGE: '장애', MAINTENANCE: '점검', DEGRADED: '지연' };
|
||||
|
||||
chart.innerHTML = stats.map(function (stat) {
|
||||
const statusClass = stat.status === 'OUTAGE' ? ' is-outage'
|
||||
: stat.status === 'MAINTENANCE' ? ' is-maintenance'
|
||||
: stat.status === 'DEGRADED' ? ' is-degraded' : '';
|
||||
const titles = (stat.issues || []).map(function (issue) {
|
||||
return (KIND_LABEL[issue.kind] || '') + ' ' + issue.title;
|
||||
});
|
||||
const tooltip = stat.statDate + ' · ' + (STATUS_LABEL[stat.status] || '정상')
|
||||
+ (titles.length ? '\n' + titles.join('\n') : '');
|
||||
return '<button type="button" class="as-bar' + statusClass + '"'
|
||||
+ ' data-date="' + escapeHtml(stat.statDate) + '"'
|
||||
+ ' title="' + escapeHtml(tooltip) + '"></button>';
|
||||
}).join('');
|
||||
|
||||
if (fromLabel) fromLabel.textContent = stats[0].statDate;
|
||||
|
||||
chart.querySelectorAll('.as-bar').forEach(function (bar) {
|
||||
bar.addEventListener('click', function () {
|
||||
window.location.href = issuesHref({ date: bar.getAttribute('data-date') });
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
// ---------------- ❸ My APIs ----------------
|
||||
function renderMyApis(apis) {
|
||||
const card = document.getElementById('myApisCard');
|
||||
if (!card) return;
|
||||
if (!apis || !apis.length) {
|
||||
card.style.display = 'none';
|
||||
return;
|
||||
}
|
||||
|
||||
const badgeClass = {
|
||||
OUTAGE: 'is-outage',
|
||||
DEGRADED: 'is-degraded',
|
||||
MAINTENANCE: 'is-maintenance',
|
||||
NORMAL: 'is-normal'
|
||||
};
|
||||
|
||||
document.getElementById('myApisCount').textContent = apis.length + '건';
|
||||
document.getElementById('myApisBody').innerHTML = apis.map(function (api) {
|
||||
const cls = badgeClass[api.currentStatus] || 'is-muted';
|
||||
return '<tr data-api-id="' + escapeHtml(api.apiId) + '" data-api-name="' + escapeHtml(api.apiName) + '">'
|
||||
+ '<td><span class="as-api-name">' + escapeHtml(api.apiName) + '</span></td>'
|
||||
+ '<td><span class="as-badge ' + cls + '">' + escapeHtml(api.currentStatusLabel) + '</span></td>'
|
||||
+ '<td class="as-num">' + formatPercent(api.uptime90d) + '%</td>'
|
||||
+ '</tr>';
|
||||
}).join('');
|
||||
|
||||
card.style.display = '';
|
||||
card.querySelectorAll('tbody tr').forEach(function (row) {
|
||||
row.addEventListener('click', function () {
|
||||
window.location.href = issuesHref({
|
||||
apiId: row.getAttribute('data-api-id'),
|
||||
apiName: row.getAttribute('data-api-name')
|
||||
});
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
// ---------------- ❹ 점검 사항 ----------------
|
||||
function renderMaintenance(cards) {
|
||||
const list = document.getElementById('maintenanceList');
|
||||
const count = document.getElementById('maintenanceCount');
|
||||
|
||||
if (!cards || !cards.length) {
|
||||
count.textContent = '0건';
|
||||
list.innerHTML = '<div class="as-empty">예정된 점검이 없습니다.</div>';
|
||||
return;
|
||||
}
|
||||
|
||||
const now = new Date();
|
||||
count.textContent = cards.length + '건';
|
||||
list.innerHTML = cards.map(function (card) {
|
||||
const start = parseDateTime(card.startedAt);
|
||||
const ongoing = start && start <= now;
|
||||
const phase = ongoing ? '진행중' : '예정';
|
||||
const range = formatDateTime(card.startedAt)
|
||||
+ (card.endAt ? ' ~ ' + formatDateTime(card.endAt) : '')
|
||||
+ (card.durationMinutes != null ? ' (' + formatDuration(card.durationMinutes) + ')' : '');
|
||||
|
||||
return '<article class="as-maint-card' + (ongoing ? ' is-ongoing' : '') + '">'
|
||||
+ '<div class="as-maint-head">'
|
||||
+ ' <h3 class="as-maint-title">' + escapeHtml(card.title) + '</h3>'
|
||||
+ ' <span class="as-schedule">' + escapeHtml(phase + ' · ' + range) + '</span>'
|
||||
+ '</div>'
|
||||
+ splitHtml(card.summary ? '<div class="as-maint-body">' + escapeHtml(card.summary) + '</div>' : '',
|
||||
noticeHtml(card))
|
||||
+ apiPillsHtml(card.impactedApis, '영향 API:', card.hiddenApiCount)
|
||||
+ '<div class="as-maint-meta">등록 ' + escapeHtml(formatDateTime(card.registeredAt))
|
||||
+ (card.lastModifiedAt ? ' (최종 수정 ' + escapeHtml(formatDateTime(card.lastModifiedAt)) + ')' : '')
|
||||
+ '</div>'
|
||||
+ '</article>';
|
||||
}).join('');
|
||||
}
|
||||
|
||||
// ---------------- ❺ 지난 이슈 사항 ----------------
|
||||
function issueCardHtml(issue) {
|
||||
const kindClass = KIND_CLASS[issue.kind] || 'is-incident';
|
||||
const kindBadge = kindClass;
|
||||
|
||||
let inner;
|
||||
if (issue.kind === 'MAINTENANCE') {
|
||||
inner = '<div class="as-tl-block"><div class="as-tl-item state-RESOLVED">'
|
||||
+ '<span class="as-dot"></span>'
|
||||
+ '<p class="as-tl-label">점검 완료</p>'
|
||||
+ (issue.summary ? '<p class="as-tl-body">' + escapeHtml(issue.summary) + '</p>' : '')
|
||||
+ '<p class="as-tl-ts">' + escapeHtml(formatDateTime(issue.startedAt))
|
||||
+ ' ~ ' + escapeHtml(formatDateTime(issue.endAt)) + '</p>'
|
||||
+ '</div></div>';
|
||||
} else {
|
||||
const items = (issue.timeline || []).map(function (entry) {
|
||||
return '<div class="as-tl-item state-' + escapeHtml(entry.stateAfter || 'NONE') + '">'
|
||||
+ '<span class="as-dot"></span>'
|
||||
+ '<p class="as-tl-label">' + escapeHtml(entry.labelKo || '진행 상황') + '</p>'
|
||||
+ '<p class="as-tl-body">' + escapeHtml(entry.body) + '</p>'
|
||||
+ '<p class="as-tl-ts">' + escapeHtml(formatDateTime(entry.eventAt)) + '</p>'
|
||||
+ '</div>';
|
||||
}).join('');
|
||||
inner = items
|
||||
? '<div class="as-tl-block">' + items + '</div>'
|
||||
: '<p class="as-tl-body">' + escapeHtml(issue.summary || '상세 진행 내역이 등록되지 않았습니다.') + '</p>';
|
||||
}
|
||||
|
||||
const duration = issue.durationMinutes != null ? ' · ' + formatDuration(issue.durationMinutes) : '';
|
||||
|
||||
return '<div class="as-issue-group">'
|
||||
+ '<div class="as-date-head">' + escapeHtml(formatDate(issue.startedAt)) + '</div>'
|
||||
+ '<article class="as-issue-card ' + kindClass + '">'
|
||||
+ ' <div class="as-issue-meta-row">'
|
||||
+ ' <span class="as-badge ' + kindBadge + '">' + escapeHtml(KIND_LABEL[issue.kind] || '') + '</span>'
|
||||
+ ' <span>' + escapeHtml(formatDateTime(issue.startedAt) + duration) + '</span>'
|
||||
+ (issue.stateLabel ? '<span>' + escapeHtml(issue.stateLabel) + '</span>' : '')
|
||||
+ ' </div>'
|
||||
+ ' <h3 class="as-issue-title">' + escapeHtml(issue.title) + '</h3>'
|
||||
+ splitHtml(inner, noticeHtml(issue))
|
||||
+ apiPillsHtml(issue.impactedApis, '영향 API:', issue.hiddenApiCount)
|
||||
+ '</article>'
|
||||
+ '</div>';
|
||||
}
|
||||
|
||||
function renderRecentIssues(issues) {
|
||||
const list = document.getElementById('recentIssueList');
|
||||
if (!issues || !issues.length) {
|
||||
list.innerHTML = '<div class="as-empty">종결된 이슈가 없습니다.</div>';
|
||||
return;
|
||||
}
|
||||
list.innerHTML = issues.map(issueCardHtml).join('');
|
||||
}
|
||||
|
||||
function handleError(target, message) {
|
||||
const element = document.getElementById(target);
|
||||
if (element) element.innerHTML = '<div class="as-empty">' + escapeHtml(message) + '</div>';
|
||||
}
|
||||
|
||||
// ---------------- 초기 로딩 ----------------
|
||||
// 영향 API 태그의 링크 여부를 판단해야 하므로 오픈 API 목록을 먼저 받는다
|
||||
fetchJson(base + '/apis.json')
|
||||
.then(function (apis) {
|
||||
(apis || []).forEach(function (api) {
|
||||
if (api.apiId) linkableApiIds.add(api.apiId);
|
||||
});
|
||||
})
|
||||
.catch(function () { /* 실패 시 전부 링크 없이 표시된다 */ })
|
||||
.then(loadSections);
|
||||
|
||||
function loadSections() {
|
||||
fetchJson(base + '/active.json')
|
||||
.then(renderActiveIncidents)
|
||||
.catch(function () { handleError('activeIncidents', '진행 중 장애 정보를 불러올 수 없습니다.'); });
|
||||
|
||||
fetchJson(base + '/uptime.json?days=' + windowDays)
|
||||
.then(renderUptime)
|
||||
.catch(function () { handleError('uptimeChart', '서비스 상태 정보를 불러올 수 없습니다.'); });
|
||||
|
||||
fetchJson(base + '/maintenance.json')
|
||||
.then(renderMaintenance)
|
||||
.catch(function () { handleError('maintenanceList', '점검 정보를 불러올 수 없습니다.'); });
|
||||
|
||||
fetchJson(base + '/recent-issues.json?size=5')
|
||||
.then(renderRecentIssues)
|
||||
.catch(function () { handleError('recentIssueList', '지난 이슈를 불러올 수 없습니다.'); });
|
||||
|
||||
if (authenticated) {
|
||||
fetchJson(base + '/my-apis.json')
|
||||
.then(renderMyApis)
|
||||
.catch(function () { /* 비인증/권한 없음은 조용히 숨긴다 */ });
|
||||
}
|
||||
}
|
||||
})();
|
||||
@@ -142,7 +142,11 @@ const customPopups = {
|
||||
$('#passwordPopupMessage').html(customPopups._sanitizeHtml(message));
|
||||
|
||||
// 입력 필드 및 에러 초기화 (placeholder 는 호출부 커스텀 허용)
|
||||
$('#passwordPopupInput').val('').removeClass('error').attr('placeholder', placeholder);
|
||||
// type 은 열려 있는 동안만 password 로 전환한다.
|
||||
// 상주 DOM 에 password 입력이 있으면 브라우저가 페이지의 다른 텍스트 입력을
|
||||
// 아이디 칸으로 오인해 계정 자동완성을 띄우기 때문 (닫을 때 text 로 복원).
|
||||
$('#passwordPopupInput').val('').removeClass('error')
|
||||
.attr('type', 'password').attr('placeholder', placeholder);
|
||||
$('#passwordPopupError').removeClass('show').text('');
|
||||
|
||||
// 팝업 표시 (modal 구조 사용)
|
||||
@@ -219,8 +223,8 @@ const customPopups = {
|
||||
// Body 스크롤 복원
|
||||
$('body').css('overflow', '');
|
||||
|
||||
// 입력 필드 초기화
|
||||
$('#passwordPopupInput').val('').removeClass('error');
|
||||
// 입력 필드 초기화 (type 도 text 로 복원 — 상주 password 로 남기지 않는다)
|
||||
$('#passwordPopupInput').val('').removeClass('error').attr('type', 'text');
|
||||
$('#passwordPopupError').removeClass('show').text('');
|
||||
|
||||
// 이벤트 리스너 제거
|
||||
|
||||
@@ -49,6 +49,7 @@
|
||||
padding: 10px 20px;
|
||||
border-radius: 8px;
|
||||
transition: var(--transition-smooth);
|
||||
white-space: nowrap;
|
||||
|
||||
&:hover {
|
||||
background-color: var(--accent-light);
|
||||
@@ -63,6 +64,7 @@
|
||||
background-color: var(--primary-color);
|
||||
padding: 10px 24px;
|
||||
border-radius: 8px;
|
||||
white-space: nowrap;
|
||||
box-shadow: 0 4px 12px rgba(0, 73, 180, 0.15);
|
||||
transition: var(--transition-smooth);
|
||||
|
||||
|
||||
@@ -89,7 +89,7 @@
|
||||
}
|
||||
}
|
||||
|
||||
@media (max-width: 768px) {
|
||||
@media (max-width: 1024px) {
|
||||
height: clamp(44px, 11.73vw, 60px);
|
||||
background: rgba(255, 255, 255, 0.85);
|
||||
backdrop-filter: blur(10px);
|
||||
@@ -128,9 +128,31 @@
|
||||
.header-left {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
// 헤더가 좁아져도 로고 영역은 줄이지 않는다 (줄임은 가운데 메뉴가 감당)
|
||||
flex-shrink: 0;
|
||||
|
||||
.logo {
|
||||
height: 32px;
|
||||
// 로고 워드마크(DJ Bank) 밑선에 "API Portal" 글자 baseline 맞춤
|
||||
align-items: flex-end;
|
||||
flex-wrap: nowrap;
|
||||
|
||||
// width 가 고정(114px)이라 flex 축소가 걸리면 가로만 눌려 비율이 깨진다
|
||||
img { flex-shrink: 0; }
|
||||
|
||||
.mobile-logo-link {
|
||||
align-items: flex-end;
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
.mobile-logo-text {
|
||||
align-items: flex-end;
|
||||
line-height: 1;
|
||||
padding-bottom: 2px;
|
||||
// "API / Portal" 로 접히지 않게
|
||||
white-space: nowrap;
|
||||
flex-shrink: 0;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -251,7 +273,7 @@
|
||||
justify-content: space-between;
|
||||
width: 100%;
|
||||
|
||||
@media (max-width: 768px) {
|
||||
@media (max-width: 1024px) {
|
||||
display: none;
|
||||
}
|
||||
}
|
||||
@@ -262,7 +284,7 @@
|
||||
justify-content: space-between;
|
||||
width: 100%;
|
||||
|
||||
@media (max-width: 768px) {
|
||||
@media (max-width: 1024px) {
|
||||
display: flex;
|
||||
}
|
||||
}
|
||||
@@ -981,6 +1003,8 @@
|
||||
padding: 12px;
|
||||
position: relative;
|
||||
transition: var(--transition-smooth);
|
||||
// 폭이 좁아져도 "서비스 소 / 개" 처럼 메뉴명이 잘리지 않게 한다
|
||||
white-space: nowrap;
|
||||
|
||||
&:hover {
|
||||
color: var(--primary-blue);
|
||||
@@ -1095,7 +1119,7 @@
|
||||
// Mobile Responsive Design
|
||||
// 375px 기준 반응형 - clamp() 사용하여 화면 크기에 비례
|
||||
// ===========================
|
||||
@media (max-width: 768px) {
|
||||
@media (max-width: 1024px) {
|
||||
.global-header {
|
||||
// Figma: 44px 높이, 반투명 배경
|
||||
// 375px 기준 44px → 44/375*100 ≈ 11.73vw, 범위: 44px ~ 60px
|
||||
@@ -1246,7 +1270,7 @@
|
||||
}
|
||||
|
||||
// Mobile responsive
|
||||
@media (max-width: 768px) {
|
||||
@media (max-width: 1024px) {
|
||||
.header-user-info {
|
||||
display: none; // Hide on mobile, use drawer instead
|
||||
}
|
||||
|
||||
@@ -72,6 +72,7 @@
|
||||
@use 'pages/service' as *;
|
||||
@use 'pages/api-statistics' as *;
|
||||
@use 'pages/webhook' as *;
|
||||
@use 'pages/api-status' as *;
|
||||
|
||||
// 6. Themes
|
||||
@use 'themes/dark' as *;
|
||||
|
||||
@@ -467,16 +467,27 @@
|
||||
}
|
||||
}
|
||||
|
||||
&-badge {
|
||||
/* 그룹 배지 + 현재 상태 태그를 한 줄에 둔다.
|
||||
기존 그룹 배지가 갖고 있던 절대 위치(top 39 / left 32)를 이 래퍼가 이어받는다 */
|
||||
&-badges {
|
||||
position: absolute;
|
||||
top: 39px;
|
||||
left: 32px;
|
||||
right: 32px;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
&-badge {
|
||||
background-color: #f2f2f3;
|
||||
border-radius: 10px;
|
||||
padding: 2px 20px;
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
min-width: 0;
|
||||
|
||||
span {
|
||||
font-size: 14px;
|
||||
@@ -484,9 +495,34 @@
|
||||
font-weight: 500;
|
||||
color: #1b4ab7;
|
||||
white-space: nowrap;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
}
|
||||
}
|
||||
|
||||
/* 현재 상태 태그. 색 규격은 API Status 화면(.as-badge)과 동일.
|
||||
상태를 못 받았을 때(빈 값)는 자리만 차지하지 않도록 숨긴다 */
|
||||
&-status {
|
||||
flex-shrink: 0;
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
padding: 3px 12px;
|
||||
border-radius: 10px;
|
||||
font-size: 12px;
|
||||
font-family: 'Spoqa Han Sans Neo', sans-serif;
|
||||
font-weight: 600;
|
||||
white-space: nowrap;
|
||||
background: #eef1f5;
|
||||
color: #4b5563;
|
||||
|
||||
&:empty { display: none; }
|
||||
|
||||
&.is-outage { background: #feeae7; color: #c8362f; }
|
||||
&.is-maintenance { background: #e7f0fb; color: #0a66c2; }
|
||||
&.is-degraded { background: #fef3c7; color: #c77800; }
|
||||
&.is-normal { background: #e7f6ec; color: #1b8c4a; }
|
||||
}
|
||||
|
||||
&-title {
|
||||
position: absolute;
|
||||
top: 86px;
|
||||
@@ -846,7 +882,7 @@
|
||||
}
|
||||
|
||||
// API Overview Card (Flat Style)
|
||||
/* "기본 정보" 헤더: 좌측 제목 + 우측 "API 사용 신청" 버튼 */
|
||||
/* "기본 정보" 헤더: 좌측 제목 + 우측 현재 상태/상태 이력 */
|
||||
.api-basic-info-header {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
@@ -855,6 +891,41 @@
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
/* 현재 상태 배지 + "상태 이력 확인" 버튼.
|
||||
색 규격은 API Status 화면(.as-badge)과 동일하게 맞춘다 */
|
||||
.api-status-inline {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 10px;
|
||||
flex-wrap: wrap;
|
||||
|
||||
.api-status-inline__label {
|
||||
font-size: 13px;
|
||||
font-weight: 500;
|
||||
color: #4b5563;
|
||||
}
|
||||
|
||||
.api-status-inline__badge {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
font-size: 12px;
|
||||
font-weight: 600;
|
||||
padding: 5px 12px;
|
||||
border-radius: 999px;
|
||||
letter-spacing: 0.02em;
|
||||
white-space: nowrap;
|
||||
background: #eef1f5;
|
||||
color: #4b5563;
|
||||
|
||||
&.is-outage { background: #feeae7; color: #c8362f; }
|
||||
&.is-maintenance { background: #e7f0fb; color: #0a66c2; }
|
||||
&.is-degraded { background: #fef3c7; color: #c77800; }
|
||||
&.is-normal { background: #e7f6ec; color: #1b8c4a; }
|
||||
&.is-loading { color: #6b7280; }
|
||||
&.is-muted { background: #eef1f5; color: #6b7280; }
|
||||
}
|
||||
}
|
||||
|
||||
/* 하단 중앙 "API 사용 신청" 버튼 */
|
||||
.api-apply-footer {
|
||||
display: flex;
|
||||
|
||||
@@ -0,0 +1,959 @@
|
||||
// ============================================================
|
||||
// API Status 페이지 (/apistatus, /apistatus/issues)
|
||||
// 설계: architecture/01-api-status/02-screen-design
|
||||
// 타이틀 배너: Figma eapim-portal node 1:16
|
||||
// ============================================================
|
||||
@use '../abstracts/variables' as *;
|
||||
|
||||
// API Status 화면은 제목 포함 전부 본문 폰트(Spoqa Han Sans)를 쓴다.
|
||||
// 전역 타이포가 h1~h6 에 $font-family-heading(OneShinhan 우선)을 지정하므로 페이지 범위에서 되돌린다.
|
||||
.as-title-banner,
|
||||
.as-title-banner h1,
|
||||
.api-status,
|
||||
.api-status h1,
|
||||
.api-status h2,
|
||||
.api-status h3,
|
||||
.api-status h4 {
|
||||
font-family: $font-family-primary;
|
||||
}
|
||||
|
||||
// 타이틀 배너 — 레이아웃의 .container 안에 놓이므로 컨테이너 폭을 따른다
|
||||
.as-title-banner {
|
||||
// 상단 여백은 fixed 헤더(80px) 아래로 배너를 내리기 위한 값이다
|
||||
margin: 44px 0 28px;
|
||||
border-radius: 12px;
|
||||
background: linear-gradient(110deg, #003080 0%, #0049b4 60%, #066ae5 100%);
|
||||
color: #fff;
|
||||
overflow: hidden;
|
||||
|
||||
.as-title-banner-inner {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: 16px;
|
||||
flex-wrap: wrap;
|
||||
padding: 32px;
|
||||
}
|
||||
|
||||
h1 {
|
||||
margin: 0;
|
||||
font-size: 24px;
|
||||
font-weight: 700;
|
||||
letter-spacing: -0.02em;
|
||||
color: #fff;
|
||||
}
|
||||
|
||||
.as-title-meta {
|
||||
text-align: right;
|
||||
|
||||
p { margin: 0; font-weight: 400; }
|
||||
}
|
||||
|
||||
.as-title-meta-main {
|
||||
font-size: 13px;
|
||||
color: #fff;
|
||||
|
||||
strong { font-weight: 500; }
|
||||
}
|
||||
|
||||
.as-title-meta-sub {
|
||||
margin-top: 2px;
|
||||
font-size: 11px;
|
||||
color: #c9d1dc;
|
||||
}
|
||||
|
||||
.as-title-dot {
|
||||
display: inline-block;
|
||||
width: 8px;
|
||||
height: 8px;
|
||||
margin-right: 6px;
|
||||
border-radius: 50%;
|
||||
background: #56e3a6;
|
||||
box-shadow: 0 0 0 4px rgba(86, 227, 166, 0.25);
|
||||
}
|
||||
|
||||
@media (max-width: 720px) {
|
||||
.as-title-banner-inner { padding: 24px 20px; }
|
||||
|
||||
h1 { font-size: 20px; }
|
||||
|
||||
.as-title-meta { text-align: left; }
|
||||
}
|
||||
}
|
||||
|
||||
.api-status {
|
||||
// ---- 토큰 (설계서 색상 규격) ----
|
||||
--as-ok: #1b8c4a;
|
||||
--as-ok-bg: #e7f6ec;
|
||||
--as-warn: #c77800;
|
||||
--as-warn-bg: #fef3c7;
|
||||
--as-err: #c8362f;
|
||||
--as-err-bg: #feeae7;
|
||||
--as-info: #0a66c2;
|
||||
--as-info-bg: #e7f0fb;
|
||||
--as-both: #6b21a8;
|
||||
--as-gray-bg: #eef1f5;
|
||||
// 이슈 없음 = 정상. API Status 메인 가동률 바와 같은 색을 쓴다
|
||||
--as-none-bg: var(--as-ok);
|
||||
--as-border: #e0e6f1;
|
||||
--as-border-strong: #d1d5db;
|
||||
--as-text: #020616;
|
||||
--as-text-2: #252b37;
|
||||
--as-text-3: #4b5563;
|
||||
--as-muted: #6b7280;
|
||||
--as-radius: 12px;
|
||||
--as-pill: 999px;
|
||||
|
||||
display: grid;
|
||||
// minmax(0,1fr): grid 자식의 암묵적 min-width(auto)를 해제한다.
|
||||
// 90일 막대(90개 × 최소폭)가 카드의 최소 폭을 밀어올려 좁은 화면에서 카드가 잘리는 것 방지
|
||||
grid-template-columns: minmax(0, 1fr);
|
||||
gap: 20px;
|
||||
padding: 0 0 70px;
|
||||
|
||||
// 상단 헤더가 fixed 라 브레드크럼 위를 덮는다. 첫 카드가 헤더에 붙지 않도록 띄운다.
|
||||
&.is-standalone { padding-top: 44px; }
|
||||
|
||||
// 제목(h1~h3) 외 본문은 기본 굵기를 쓴다.
|
||||
// 포털 전역 타이포가 본문을 600 으로 잡고 있어 페이지 범위에서 되돌린다.
|
||||
font-weight: 400;
|
||||
|
||||
p,
|
||||
span,
|
||||
li,
|
||||
a,
|
||||
td,
|
||||
th,
|
||||
label,
|
||||
button,
|
||||
input,
|
||||
select { font-weight: 400; }
|
||||
|
||||
b,
|
||||
strong { font-weight: 500; }
|
||||
|
||||
// ---------------- 공통 카드/배지 ----------------
|
||||
.as-card {
|
||||
background: #fff;
|
||||
border: 1px solid var(--as-border);
|
||||
border-radius: var(--as-radius);
|
||||
padding: 24px;
|
||||
box-shadow: 0 1px 2px rgba(15, 23, 42, 0.05);
|
||||
}
|
||||
|
||||
.as-card-head {
|
||||
display: flex;
|
||||
align-items: baseline;
|
||||
justify-content: space-between;
|
||||
gap: 12px;
|
||||
flex-wrap: wrap;
|
||||
margin-bottom: 14px;
|
||||
|
||||
h2 {
|
||||
margin: 0;
|
||||
font-size: 18px;
|
||||
letter-spacing: -0.01em;
|
||||
color: var(--as-text);
|
||||
}
|
||||
|
||||
.as-desc {
|
||||
margin: 4px 0 0;
|
||||
font-size: 13px;
|
||||
color: var(--as-muted);
|
||||
}
|
||||
}
|
||||
|
||||
.as-badge {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 4px;
|
||||
font-size: 11px;
|
||||
font-weight: 500;
|
||||
padding: 4px 10px;
|
||||
border-radius: var(--as-pill);
|
||||
letter-spacing: 0.02em;
|
||||
white-space: nowrap;
|
||||
|
||||
&.is-incident,
|
||||
&.is-outage { background: var(--as-err-bg); color: var(--as-err); }
|
||||
&.is-maintenance { background: var(--as-info-bg); color: var(--as-info); }
|
||||
&.is-degraded { background: var(--as-warn-bg); color: var(--as-warn); }
|
||||
&.is-normal { background: var(--as-ok-bg); color: var(--as-ok); }
|
||||
&.is-muted { background: var(--as-gray-bg); color: var(--as-text-3); }
|
||||
}
|
||||
|
||||
.as-section-title {
|
||||
display: flex;
|
||||
align-items: baseline;
|
||||
gap: 12px;
|
||||
flex-wrap: wrap;
|
||||
margin: 6px 4px 14px;
|
||||
|
||||
h2 {
|
||||
margin: 0;
|
||||
font-size: 20px;
|
||||
letter-spacing: -0.01em;
|
||||
}
|
||||
|
||||
.as-desc { font-size: 13px; color: var(--as-muted); }
|
||||
|
||||
.as-count {
|
||||
font-size: 12px;
|
||||
font-weight: 500;
|
||||
color: var(--as-muted);
|
||||
background: #f6f9fb;
|
||||
padding: 2px 8px;
|
||||
border-radius: var(--as-pill);
|
||||
}
|
||||
}
|
||||
|
||||
.as-empty {
|
||||
color: var(--as-muted);
|
||||
font-size: 14px;
|
||||
padding: 26px;
|
||||
background: #fff;
|
||||
border: 1px dashed var(--as-border);
|
||||
border-radius: var(--as-radius);
|
||||
text-align: center;
|
||||
}
|
||||
|
||||
.as-api-pills {
|
||||
display: flex;
|
||||
gap: 6px;
|
||||
flex-wrap: wrap;
|
||||
align-items: center;
|
||||
margin-top: 12px;
|
||||
font-size: 13px;
|
||||
color: var(--as-text-3);
|
||||
|
||||
.as-api-pill {
|
||||
background: var(--as-gray-bg);
|
||||
color: var(--as-text-2);
|
||||
font-size: 12px;
|
||||
font-weight: 500;
|
||||
padding: 4px 10px;
|
||||
border-radius: var(--as-pill);
|
||||
}
|
||||
|
||||
// 오픈 API 목록에 있는 API — 상세로 이동
|
||||
a.as-api-pill {
|
||||
text-decoration: none;
|
||||
transition: background 0.15s, color 0.15s;
|
||||
|
||||
&:hover,
|
||||
&:focus-visible {
|
||||
background: var(--as-info-bg);
|
||||
color: var(--as-info);
|
||||
}
|
||||
}
|
||||
|
||||
// 목록에 없는 API — 링크 없음, 채도를 낮춰 구분
|
||||
.as-api-pill.is-unlinked {
|
||||
background: #f3f5f8;
|
||||
color: var(--as-muted);
|
||||
cursor: default;
|
||||
}
|
||||
|
||||
// 개발자포탈에 게시되지 않은 GW 인터페이스 묶음 ("GW 인터페이스 3건")
|
||||
.as-api-pill.is-gw {
|
||||
background: #fff;
|
||||
border: 1px dashed var(--as-border-strong);
|
||||
color: var(--as-muted);
|
||||
cursor: default;
|
||||
}
|
||||
}
|
||||
|
||||
// 타임라인 | 공지 2열. 데스크탑(961px~)에서만 갈라지고 그 아래는 세로로 쌓인다.
|
||||
// minmax(0, 1fr) 은 공지 본문의 긴 URL·표가 칸을 밀어내지 못하게 하는 grid 관용구.
|
||||
.as-card-split {
|
||||
margin-top: 16px;
|
||||
display: grid;
|
||||
gap: 16px;
|
||||
align-items: start;
|
||||
|
||||
@media (min-width: 961px) {
|
||||
grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
|
||||
}
|
||||
}
|
||||
|
||||
// 감싼 두 블록의 자체 세로 margin 은 grid gap 으로 대체한다.
|
||||
// 카드 컨텍스트를 함께 써서 원 규칙(.as-alert-card .as-alert-timeline 등)보다 특이도를 높인다.
|
||||
.as-card-split > .as-alert-notice { margin-top: 0; }
|
||||
.as-alert-card .as-card-split > .as-alert-timeline { margin-top: 0; }
|
||||
.as-maint-card .as-card-split > .as-maint-body { margin-top: 0; }
|
||||
|
||||
// 이슈에 연결된 공지 본문 (진행 중 장애 카드 · 점검 카드 공용).
|
||||
// 본문 길이가 제각각이라 높이를 제한하고 안쪽만 스크롤시킨다.
|
||||
.as-alert-notice {
|
||||
margin-top: 16px;
|
||||
border: 1px solid var(--as-border);
|
||||
border-radius: var(--as-radius);
|
||||
background: var(--as-gray-bg);
|
||||
padding: 14px 16px;
|
||||
|
||||
.as-alert-notice-head {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
flex-wrap: wrap;
|
||||
margin-bottom: 10px;
|
||||
|
||||
strong { font-size: 14px; color: var(--as-text); }
|
||||
}
|
||||
|
||||
.as-alert-notice-label {
|
||||
font-size: 11px;
|
||||
font-weight: 500;
|
||||
padding: 2px 8px;
|
||||
border-radius: var(--as-pill);
|
||||
background: var(--as-info-bg);
|
||||
color: var(--as-info);
|
||||
}
|
||||
|
||||
.as-alert-notice-body {
|
||||
max-height: 320px;
|
||||
overflow-y: auto;
|
||||
font-size: 14px;
|
||||
line-height: 1.7;
|
||||
color: var(--as-text-2);
|
||||
word-break: break-word;
|
||||
|
||||
img, table { max-width: 100%; }
|
||||
p:last-child { margin-bottom: 0; }
|
||||
}
|
||||
|
||||
.as-alert-notice-link {
|
||||
display: inline-block;
|
||||
margin-top: 12px;
|
||||
font-size: 13px;
|
||||
font-weight: 500;
|
||||
color: var(--as-info);
|
||||
text-decoration: none;
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------- 진행 중 장애 카드 ----------------
|
||||
.as-alert-card {
|
||||
border-left: 4px solid var(--as-err);
|
||||
|
||||
.as-alert-head {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: 12px;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.as-alert-title {
|
||||
margin: 8px 0 6px;
|
||||
font-size: 20px;
|
||||
color: var(--as-err);
|
||||
}
|
||||
|
||||
.as-meta { font-size: 13px; color: var(--as-text-3); }
|
||||
|
||||
.as-alert-timeline {
|
||||
margin-top: 16px;
|
||||
border-top: 1px dashed var(--as-border);
|
||||
padding-top: 14px;
|
||||
display: grid;
|
||||
gap: 10px;
|
||||
}
|
||||
|
||||
.as-tl-row {
|
||||
display: grid;
|
||||
grid-template-columns: 60px 76px 1fr;
|
||||
gap: 12px;
|
||||
font-size: 13px;
|
||||
|
||||
.as-tl-time {
|
||||
color: var(--as-muted);
|
||||
font-variant-numeric: tabular-nums;
|
||||
}
|
||||
|
||||
.as-tl-who {
|
||||
font-size: 11px;
|
||||
font-weight: 500;
|
||||
text-align: center;
|
||||
height: -webkit-fit-content;
|
||||
height: fit-content;
|
||||
padding: 2px 8px;
|
||||
border-radius: var(--as-pill);
|
||||
background: var(--as-gray-bg);
|
||||
color: var(--as-text-2);
|
||||
|
||||
&.is-system { background: var(--as-info-bg); color: var(--as-info); }
|
||||
}
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
// 진행 중 장애가 노출 상한을 넘을 때 안내
|
||||
.as-alert-overflow {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: 12px;
|
||||
flex-wrap: wrap;
|
||||
padding: 14px 20px;
|
||||
border: 1px dashed var(--as-err);
|
||||
border-radius: var(--as-radius);
|
||||
background: var(--as-err-bg);
|
||||
font-size: 13px;
|
||||
color: var(--as-err);
|
||||
|
||||
a { color: var(--as-err); font-weight: 500; text-decoration: none; }
|
||||
}
|
||||
|
||||
// ---------------- 90일 서비스 상태 ----------------
|
||||
.as-uptime {
|
||||
.as-bar-chart {
|
||||
display: flex;
|
||||
gap: 2px;
|
||||
align-items: flex-end;
|
||||
height: 56px;
|
||||
overflow-x: auto;
|
||||
}
|
||||
|
||||
.as-axis {
|
||||
display: flex;
|
||||
justify-content: space-between;
|
||||
margin-top: 14px;
|
||||
font-size: 11px;
|
||||
color: var(--as-muted);
|
||||
}
|
||||
}
|
||||
|
||||
.as-bar {
|
||||
flex: 1 0 4px;
|
||||
height: 100%;
|
||||
border: 0;
|
||||
padding: 0;
|
||||
border-radius: 2px;
|
||||
background: var(--as-ok);
|
||||
cursor: pointer;
|
||||
transition: opacity 0.15s;
|
||||
|
||||
&.is-outage { background: var(--as-err); }
|
||||
&.is-maintenance { background: var(--as-info); }
|
||||
&.is-degraded { background: var(--as-warn); }
|
||||
&:hover { opacity: 0.75; }
|
||||
}
|
||||
|
||||
.as-legend {
|
||||
display: flex;
|
||||
gap: 14px;
|
||||
flex-wrap: wrap;
|
||||
margin-top: 18px;
|
||||
font-size: 12px;
|
||||
color: var(--as-muted);
|
||||
|
||||
.as-sw {
|
||||
display: inline-block;
|
||||
width: 10px;
|
||||
height: 10px;
|
||||
border-radius: 2px;
|
||||
margin-right: 4px;
|
||||
vertical-align: middle;
|
||||
|
||||
&.is-ok { background: var(--as-ok); }
|
||||
&.is-outage { background: var(--as-err); }
|
||||
&.is-maintenance { background: var(--as-info); }
|
||||
&.is-degraded { background: var(--as-warn); }
|
||||
&.is-none { background: var(--as-none-bg); }
|
||||
// 장애·지연·점검 중 2종 이상이 겹친 날
|
||||
&.is-mixed,
|
||||
&.is-both { background: var(--as-both); }
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------- My APIs ----------------
|
||||
.as-my-apis {
|
||||
table {
|
||||
width: 100%;
|
||||
border-collapse: collapse;
|
||||
font-size: 13px;
|
||||
}
|
||||
|
||||
th,
|
||||
td { text-align: left; padding: 12px 14px; }
|
||||
|
||||
th {
|
||||
background: #f6f9fb;
|
||||
color: var(--as-text-3);
|
||||
font-size: 12px;
|
||||
font-weight: 500;
|
||||
border-bottom: 1px solid var(--as-border);
|
||||
}
|
||||
|
||||
tbody tr {
|
||||
border-bottom: 1px solid var(--as-border);
|
||||
cursor: pointer;
|
||||
|
||||
&:last-child { border-bottom: 0; }
|
||||
&:hover { background: #f6f9fb; }
|
||||
}
|
||||
|
||||
.as-api-name { font-weight: 500; color: var(--as-text); }
|
||||
.as-num { font-variant-numeric: tabular-nums; }
|
||||
}
|
||||
|
||||
// ---------------- 점검 사항 ----------------
|
||||
.as-maint-list { display: grid; gap: 14px; }
|
||||
|
||||
.as-maint-card {
|
||||
background: #fff;
|
||||
border: 1px solid var(--as-border);
|
||||
border-left: 4px solid var(--as-info);
|
||||
border-radius: var(--as-radius);
|
||||
padding: 22px 24px;
|
||||
box-shadow: 0 1px 2px rgba(15, 23, 42, 0.05);
|
||||
|
||||
&.is-ongoing { border-left-color: var(--as-warn); }
|
||||
|
||||
.as-maint-head {
|
||||
display: flex;
|
||||
align-items: baseline;
|
||||
justify-content: space-between;
|
||||
gap: 12px;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.as-maint-title { margin: 0; font-size: 18px; font-weight: 700; color: var(--as-text); }
|
||||
|
||||
.as-schedule {
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
gap: 6px;
|
||||
font-size: 12px;
|
||||
font-weight: 500;
|
||||
color: var(--as-info);
|
||||
background: var(--as-info-bg);
|
||||
padding: 4px 12px;
|
||||
border-radius: var(--as-pill);
|
||||
font-variant-numeric: tabular-nums;
|
||||
}
|
||||
|
||||
&.is-ongoing .as-schedule { color: var(--as-warn); background: var(--as-warn-bg); }
|
||||
|
||||
.as-maint-body { margin: 14px 0 12px; font-size: 14px; line-height: 1.6; color: var(--as-text-3); }
|
||||
|
||||
.as-maint-meta {
|
||||
text-align: right;
|
||||
font-size: 12px;
|
||||
color: var(--as-muted);
|
||||
font-variant-numeric: tabular-nums;
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------- 지난 이슈 / 이슈 이력 카드 ----------------
|
||||
.as-issue-list { display: grid; gap: 24px; }
|
||||
|
||||
.as-issue-group {
|
||||
.as-date-head {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
width: 100%;
|
||||
margin: 0 4px 10px;
|
||||
padding-bottom: 8px;
|
||||
font-size: 14px;
|
||||
font-weight: 500;
|
||||
color: var(--as-text-2);
|
||||
border-bottom: 1px solid var(--as-border);
|
||||
}
|
||||
}
|
||||
|
||||
.as-issue-card {
|
||||
background: #fff;
|
||||
border: 1px solid var(--as-border);
|
||||
border-radius: var(--as-radius);
|
||||
padding: 22px 26px 24px;
|
||||
box-shadow: 0 1px 2px rgba(15, 23, 42, 0.05);
|
||||
|
||||
&.is-incident { border-left: 4px solid var(--as-err); }
|
||||
&.is-degraded { border-left: 4px solid var(--as-warn); }
|
||||
&.is-maintenance { border-left: 4px solid var(--as-info); }
|
||||
|
||||
.as-issue-meta-row {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 12px;
|
||||
flex-wrap: wrap;
|
||||
font-size: 12px;
|
||||
color: var(--as-muted);
|
||||
margin-bottom: 10px;
|
||||
}
|
||||
|
||||
.as-issue-title {
|
||||
margin: 0 0 18px;
|
||||
font-size: 19px;
|
||||
font-weight: 800;
|
||||
line-height: 1.3;
|
||||
letter-spacing: -0.01em;
|
||||
}
|
||||
|
||||
&.is-incident .as-issue-title { color: var(--as-err); }
|
||||
&.is-degraded .as-issue-title { color: var(--as-warn); }
|
||||
&.is-maintenance .as-issue-title { color: var(--as-info); }
|
||||
}
|
||||
|
||||
// 세로 타임라인
|
||||
.as-tl-block {
|
||||
position: relative;
|
||||
padding-left: 24px;
|
||||
|
||||
&::before {
|
||||
content: '';
|
||||
position: absolute;
|
||||
left: 6px;
|
||||
top: 8px;
|
||||
bottom: 8px;
|
||||
width: 1px;
|
||||
background: var(--as-border);
|
||||
}
|
||||
}
|
||||
|
||||
.as-tl-item {
|
||||
position: relative;
|
||||
padding-bottom: 22px;
|
||||
|
||||
&:last-child { padding-bottom: 0; }
|
||||
|
||||
+ .as-tl-item {
|
||||
margin-top: 4px;
|
||||
padding-top: 22px;
|
||||
border-top: 1px dashed var(--as-border);
|
||||
}
|
||||
|
||||
.as-dot {
|
||||
position: absolute;
|
||||
left: -24px;
|
||||
top: 6px;
|
||||
width: 12px;
|
||||
height: 12px;
|
||||
border-radius: 50%;
|
||||
border: 2px solid #fff;
|
||||
background: var(--as-muted);
|
||||
box-shadow: 0 0 0 1px var(--as-border-strong);
|
||||
}
|
||||
|
||||
&.state-RESOLVED .as-dot { background: var(--as-ok); box-shadow: 0 0 0 1px var(--as-ok); }
|
||||
&.state-MONITORING .as-dot { background: var(--as-warn); box-shadow: 0 0 0 1px var(--as-warn); }
|
||||
&.state-IDENTIFIED .as-dot { background: #c95a0f; box-shadow: 0 0 0 1px #c95a0f; }
|
||||
&.state-INVESTIGATING .as-dot { background: var(--as-warn); box-shadow: 0 0 0 1px var(--as-warn); }
|
||||
&.state-CANCELED .as-dot { background: var(--as-muted); box-shadow: 0 0 0 1px var(--as-muted); }
|
||||
|
||||
.as-tl-label { margin: 0 0 8px; font-size: 14px; font-weight: 500; color: var(--as-text); }
|
||||
.as-tl-body { margin: 0 0 8px; font-size: 14px; line-height: 1.6; color: var(--as-text); white-space: pre-line; }
|
||||
|
||||
.as-tl-ts {
|
||||
margin: 0;
|
||||
font-size: 13px;
|
||||
color: var(--as-muted);
|
||||
font-variant-numeric: tabular-nums;
|
||||
}
|
||||
}
|
||||
|
||||
.as-more-link {
|
||||
display: block;
|
||||
margin-top: 14px;
|
||||
text-align: right;
|
||||
font-size: 13px;
|
||||
text-decoration: none;
|
||||
}
|
||||
|
||||
// ---------------- 이슈 이력 페이지 ----------------
|
||||
.as-index-bar {
|
||||
display: flex;
|
||||
gap: 2px;
|
||||
align-items: stretch;
|
||||
height: 44px;
|
||||
overflow-x: auto;
|
||||
}
|
||||
|
||||
.as-index-cell {
|
||||
flex: 1 0 4px;
|
||||
border: 0;
|
||||
padding: 0;
|
||||
border-radius: 2px;
|
||||
background: var(--as-none-bg); // 이슈 없음 = 정상(메인 가동률 바와 동일)
|
||||
cursor: pointer;
|
||||
transition: opacity 0.15s;
|
||||
|
||||
&.has-incident { background: var(--as-err); }
|
||||
&.has-degraded { background: var(--as-warn); }
|
||||
&.has-maintenance { background: var(--as-info); }
|
||||
// 유형이 2종 이상 섞인 날
|
||||
&.has-mixed,
|
||||
&.has-both { background: var(--as-both); }
|
||||
&.is-selected { outline: 2px solid var(--as-text-2); outline-offset: 1px; }
|
||||
&:hover { opacity: 0.75; }
|
||||
}
|
||||
|
||||
.as-filter-bar {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 14px;
|
||||
flex-wrap: wrap;
|
||||
background: #fff;
|
||||
border: 1px solid var(--as-border);
|
||||
border-radius: var(--as-radius);
|
||||
padding: 14px 18px;
|
||||
font-size: 13px;
|
||||
|
||||
.as-filter-field {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
min-width: 0;
|
||||
}
|
||||
|
||||
.as-filter-label {
|
||||
font-weight: 500;
|
||||
color: var(--as-text-2);
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.as-filter-right {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
margin-left: auto;
|
||||
color: var(--as-muted);
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.as-filter-count b { color: var(--as-text); }
|
||||
}
|
||||
|
||||
.as-input {
|
||||
height: 34px;
|
||||
padding: 0 10px;
|
||||
border: 1px solid var(--as-border-strong);
|
||||
border-radius: 6px;
|
||||
font-size: 13px;
|
||||
color: var(--as-text);
|
||||
background: #fff;
|
||||
max-width: 100%;
|
||||
|
||||
&:focus {
|
||||
outline: none;
|
||||
border-color: var(--as-info);
|
||||
box-shadow: 0 0 0 2px rgba(10, 102, 194, 0.15);
|
||||
}
|
||||
}
|
||||
|
||||
// 값 지우기 버튼이 붙는 입력 컨트롤 (날짜 / API)
|
||||
.as-field-control {
|
||||
position: relative;
|
||||
display: inline-flex;
|
||||
align-items: center;
|
||||
|
||||
input { padding-right: 30px; }
|
||||
|
||||
// type=search 의 네이티브 지우기 버튼은 자체 버튼과 중복이라 감춘다
|
||||
input[type='search'] {
|
||||
-webkit-appearance: none;
|
||||
appearance: none;
|
||||
|
||||
&::-webkit-search-cancel-button,
|
||||
&::-webkit-search-decoration { -webkit-appearance: none; appearance: none; display: none; }
|
||||
}
|
||||
}
|
||||
|
||||
.as-field-clear {
|
||||
position: absolute;
|
||||
top: 50%;
|
||||
right: 6px;
|
||||
transform: translateY(-50%);
|
||||
display: none;
|
||||
width: 20px;
|
||||
height: 20px;
|
||||
padding: 0;
|
||||
border: 0;
|
||||
border-radius: 50%;
|
||||
background: var(--as-gray-bg);
|
||||
color: var(--as-text-3);
|
||||
font-size: 14px;
|
||||
line-height: 1;
|
||||
cursor: pointer;
|
||||
|
||||
&:hover { background: var(--as-border-strong); color: var(--as-text); }
|
||||
}
|
||||
|
||||
.as-filter-field.has-value .as-field-clear { display: block; }
|
||||
|
||||
// 날짜 입력은 네이티브 달력 아이콘과 겹치지 않게 여유를 둔다
|
||||
#filterDateInput { padding-right: 52px; }
|
||||
|
||||
// API 라이브서치 콤보박스
|
||||
.as-combo {
|
||||
.as-field-control {
|
||||
min-width: 240px;
|
||||
flex: 1 1 240px;
|
||||
}
|
||||
|
||||
input { width: 100%; }
|
||||
|
||||
.as-combo-list {
|
||||
position: absolute;
|
||||
z-index: 20;
|
||||
top: calc(100% + 4px);
|
||||
left: 0;
|
||||
right: 0;
|
||||
max-height: 280px;
|
||||
margin: 0;
|
||||
padding: 4px;
|
||||
overflow-y: auto;
|
||||
list-style: none;
|
||||
background: #fff;
|
||||
border: 1px solid var(--as-border-strong);
|
||||
border-radius: 8px;
|
||||
box-shadow: 0 8px 24px rgba(15, 23, 42, 0.12);
|
||||
}
|
||||
|
||||
.as-combo-item {
|
||||
padding: 8px 10px;
|
||||
border-radius: 6px;
|
||||
cursor: pointer;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
white-space: nowrap;
|
||||
|
||||
&:hover { background: var(--as-info-bg); }
|
||||
}
|
||||
|
||||
.as-combo-empty {
|
||||
padding: 10px;
|
||||
color: var(--as-muted);
|
||||
font-size: 12px;
|
||||
text-align: center;
|
||||
}
|
||||
}
|
||||
|
||||
// 포탈에 게시되지 않은 API 필터 안내
|
||||
.as-unlisted-banner {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 10px;
|
||||
padding: 12px 18px;
|
||||
border: 1px solid var(--as-border);
|
||||
border-left: 4px solid var(--as-muted);
|
||||
border-radius: var(--as-radius);
|
||||
background: #f6f8fa;
|
||||
font-size: 13px;
|
||||
color: var(--as-text-3);
|
||||
|
||||
b { color: var(--as-text); }
|
||||
|
||||
.as-unlisted-icon {
|
||||
flex: 0 0 auto;
|
||||
color: var(--as-muted);
|
||||
font-size: 15px;
|
||||
}
|
||||
}
|
||||
|
||||
.as-pager {
|
||||
display: flex;
|
||||
justify-content: center;
|
||||
gap: 6px;
|
||||
margin-top: 6px;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
// 필터/페이저 버튼 (전역 버튼 클래스에 의존하지 않는다)
|
||||
.as-btn {
|
||||
min-width: 32px;
|
||||
height: 32px;
|
||||
padding: 0 12px;
|
||||
border: 1px solid var(--as-border-strong);
|
||||
border-radius: 6px;
|
||||
background: #fff;
|
||||
color: var(--as-text-2);
|
||||
font-size: 13px;
|
||||
line-height: 1;
|
||||
cursor: pointer;
|
||||
|
||||
&:hover { background: #f6f9fb; }
|
||||
|
||||
&.is-current {
|
||||
border-color: var(--as-info);
|
||||
background: var(--as-info);
|
||||
color: #fff;
|
||||
cursor: default;
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------- 반응형 ----------------
|
||||
@media (max-width: 960px) {
|
||||
.as-filter-bar {
|
||||
gap: 10px;
|
||||
|
||||
.as-filter-right { margin-left: 0; width: 100%; justify-content: flex-end; }
|
||||
}
|
||||
|
||||
.as-my-apis {
|
||||
table { display: block; overflow-x: auto; white-space: nowrap; }
|
||||
}
|
||||
}
|
||||
|
||||
@media (max-width: 720px) {
|
||||
gap: 16px;
|
||||
padding-bottom: 48px;
|
||||
|
||||
&.is-standalone { padding-top: 32px; }
|
||||
|
||||
.as-card { padding: 18px 16px; }
|
||||
|
||||
.as-card-head { margin-bottom: 12px; }
|
||||
|
||||
.as-alert-card .as-tl-row { grid-template-columns: 52px 1fr; }
|
||||
.as-alert-card .as-tl-who { display: none; }
|
||||
.as-alert-card .as-alert-title { font-size: 18px; }
|
||||
|
||||
// 필터: 라벨 + 입력을 한 줄씩 쌓는다
|
||||
.as-filter-bar {
|
||||
flex-direction: column;
|
||||
align-items: stretch;
|
||||
padding: 14px;
|
||||
|
||||
.as-filter-field { flex-direction: column; align-items: flex-start; gap: 6px; }
|
||||
|
||||
// 세로 스택에서는 flex-basis 가 높이로 해석되므로 반드시 해제한다
|
||||
.as-input,
|
||||
.as-field-control { flex: 0 0 auto; width: 100%; min-width: 0; }
|
||||
|
||||
.as-filter-right { justify-content: space-between; }
|
||||
}
|
||||
|
||||
// 90일 바: 셀을 균등 축소하지 않고 최소 터치 폭을 보장한 뒤 가로 스크롤
|
||||
.as-index-bar {
|
||||
height: 40px;
|
||||
|
||||
.as-index-cell { flex: 0 0 12px; }
|
||||
}
|
||||
|
||||
.as-uptime .as-bar-chart .as-bar { flex: 0 0 12px; }
|
||||
|
||||
.as-issue-card { padding: 18px 16px; }
|
||||
.as-issue-title { font-size: 17px; }
|
||||
|
||||
.as-maint-card { padding: 18px 16px; }
|
||||
|
||||
.as-uptime .as-bar-chart { height: 44px; }
|
||||
|
||||
.as-issue-list { gap: 16px; }
|
||||
|
||||
.as-pager button { min-width: 30px; padding: 0 8px; }
|
||||
}
|
||||
|
||||
@media (max-width: 480px) {
|
||||
.as-section-title h2 { font-size: 18px; }
|
||||
|
||||
.as-legend { gap: 8px; font-size: 11px; }
|
||||
|
||||
.as-tl-block { padding-left: 18px; }
|
||||
.as-tl-item .as-dot { left: -18px; }
|
||||
}
|
||||
}
|
||||
@@ -859,8 +859,9 @@
|
||||
|
||||
.api-cards-container {
|
||||
display: flex;
|
||||
flex-wrap: wrap;
|
||||
gap: 29px;
|
||||
justify-content: center;
|
||||
justify-content: flex-start;
|
||||
|
||||
//@include respond-to('lg') {
|
||||
// gap: 22px;
|
||||
@@ -881,6 +882,10 @@
|
||||
}
|
||||
|
||||
.api-card {
|
||||
// 1행 4열 고정 (gap 29px * 3 = 87px)
|
||||
flex: 0 0 calc((100% - 87px) / 4);
|
||||
max-width: calc((100% - 87px) / 4);
|
||||
box-sizing: border-box;
|
||||
height: 288px;
|
||||
background: #FFFFFF;
|
||||
border: 1px solid var(--border-color);
|
||||
@@ -909,12 +914,16 @@
|
||||
}
|
||||
|
||||
@include respond-to('md') {
|
||||
flex: 0 0 calc(50% - 9px);
|
||||
max-width: calc(50% - 9px);
|
||||
width: calc(50% - 9px);
|
||||
min-width: 250px;
|
||||
}
|
||||
|
||||
@include respond-to('sm') {
|
||||
// Figma 모바일: 144px width, auto height, padding 18px 17px
|
||||
flex: 1 1 auto;
|
||||
max-width: 100%;
|
||||
width: 100%;
|
||||
height: auto;
|
||||
min-width: unset;
|
||||
|
||||
@@ -358,6 +358,14 @@
|
||||
font-weight: 700;
|
||||
flex-shrink: 0;
|
||||
}
|
||||
|
||||
// 개발자포탈에 게시되지 않은 GW 인터페이스 묶음 ("GW 인터페이스 3건")
|
||||
&.is-gw {
|
||||
background-color: #ffffff;
|
||||
border-style: dashed;
|
||||
border-color: #cbd5e1;
|
||||
color: #6b7280;
|
||||
}
|
||||
}
|
||||
|
||||
.btn-affected-toggle {
|
||||
@@ -449,6 +457,96 @@
|
||||
}
|
||||
}
|
||||
|
||||
// 장애 처리 타임라인 — 상단 장애정보 표와 같은 규격의 간결한 표
|
||||
.notice-detail-timeline {
|
||||
padding-bottom: 40px;
|
||||
border-bottom: 1px solid #eee;
|
||||
margin-bottom: $spacing-3xl;
|
||||
|
||||
.notice-timeline-title {
|
||||
margin: 0 0 16px;
|
||||
font-size: 18px;
|
||||
font-weight: 700;
|
||||
color: #000;
|
||||
}
|
||||
|
||||
.timeline-table {
|
||||
width: 100%;
|
||||
border-collapse: collapse;
|
||||
table-layout: fixed;
|
||||
border-bottom: 1px solid #e3e8f0;
|
||||
|
||||
thead th {
|
||||
background: #f9f9f9;
|
||||
height: 43px;
|
||||
font-weight: 500;
|
||||
font-size: 14px;
|
||||
text-align: center;
|
||||
color: #000;
|
||||
border-bottom: 1px solid #e3e8f0;
|
||||
}
|
||||
|
||||
tbody tr {
|
||||
border-bottom: 1px solid #e3e8f0;
|
||||
}
|
||||
|
||||
td {
|
||||
padding: 10px 16px;
|
||||
font-size: 14px;
|
||||
color: #000;
|
||||
vertical-align: top;
|
||||
}
|
||||
|
||||
.timeline-ts {
|
||||
color: #555;
|
||||
white-space: nowrap;
|
||||
font-variant-numeric: tabular-nums;
|
||||
}
|
||||
|
||||
.timeline-body {
|
||||
line-height: 1.6;
|
||||
white-space: pre-line;
|
||||
word-break: break-all;
|
||||
}
|
||||
|
||||
@media (max-width: $breakpoint-md) {
|
||||
table-layout: auto;
|
||||
|
||||
colgroup {
|
||||
display: none;
|
||||
}
|
||||
|
||||
thead th,
|
||||
td {
|
||||
padding: 8px 10px;
|
||||
font-size: 13px;
|
||||
}
|
||||
|
||||
.timeline-ts {
|
||||
white-space: normal;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 상태 배지 — API Status 타임라인 dot 색 규격과 동일
|
||||
.timeline-state {
|
||||
display: inline-block;
|
||||
padding: 2px 10px;
|
||||
border-radius: 999px;
|
||||
font-size: 12px;
|
||||
font-weight: 500;
|
||||
white-space: nowrap;
|
||||
background: #eef1f5;
|
||||
color: #4b5563;
|
||||
|
||||
&.state-RESOLVED { background: #e7f6ec; color: #1b8c4a; }
|
||||
&.state-MONITORING,
|
||||
&.state-INVESTIGATING { background: #fef3c7; color: #c77800; }
|
||||
&.state-IDENTIFIED { background: #fdeee2; color: #c95a0f; }
|
||||
&.state-CANCELED { background: #eef1f5; color: #6b7280; }
|
||||
}
|
||||
}
|
||||
|
||||
// Notice Detail Actions
|
||||
.notice-detail-actions {
|
||||
display: flex;
|
||||
|
||||
@@ -69,9 +69,18 @@
|
||||
<div class="tab-content" th:classappend="${activeTab == 'testbed'} ? '' : 'active'" id="api-info-tab">
|
||||
<!-- API Overview Card (Merged with Additional Information) -->
|
||||
<div class="api-overview-card">
|
||||
<!--/* 현재 상태는 게시된 장애·점검 공지 기준(/apistatus/current.json). 조회 실패해도 화면은 유지 */-->
|
||||
<div class="org-section-header org-section-header--agreement api-basic-info-header">
|
||||
<h3>기본 정보</h3>
|
||||
<button type="button" class="btn-action-primary md api-apply-btn">API 사용 신청</button>
|
||||
<div class="api-status-inline" id="apiStatusInline"
|
||||
th:attr="data-api-id=${apiSpecInfo.apiId},
|
||||
data-status-url=@{/apistatus/current.json}">
|
||||
<span class="api-status-inline__label">현재 상태</span>
|
||||
<span class="api-status-inline__badge is-loading" id="apiStatusBadge">조회 중</span>
|
||||
<!--/* apiName 은 표시용 - 이슈 이력 화면 필터는 apiId 로 동작한다 */-->
|
||||
<a class="btn-action-primary md"
|
||||
th:href="@{/apistatus/issues(apiId=${apiSpecInfo.apiId},apiName=${apiSpecInfo.apiName})}">상태 이력 확인</a>
|
||||
</div>
|
||||
</div>
|
||||
<div class="api-overview-header">
|
||||
<div class="api-method-badge" th:text="${apiSpecInfo.apiMethod}">GET</div>
|
||||
@@ -475,6 +484,51 @@
|
||||
btn.addEventListener('click', requestApiUse);
|
||||
});
|
||||
|
||||
// ===== 기본 정보: 현재 상태 =====
|
||||
// 게시된 장애·점검 공지 기준(/apistatus/current.json). 상태 이력은 /apistatus/issues?apiId= 로 이어진다.
|
||||
(function loadApiCurrentStatus() {
|
||||
const box = document.getElementById('apiStatusInline');
|
||||
const badge = document.getElementById('apiStatusBadge');
|
||||
if (!box || !badge) return;
|
||||
|
||||
const apiId = box.getAttribute('data-api-id');
|
||||
const statusUrl = box.getAttribute('data-status-url');
|
||||
if (!apiId || !statusUrl) return;
|
||||
|
||||
const BADGE_CLASS = {
|
||||
OUTAGE: 'is-outage',
|
||||
DEGRADED: 'is-degraded',
|
||||
MAINTENANCE: 'is-maintenance',
|
||||
NORMAL: 'is-normal'
|
||||
};
|
||||
|
||||
function paint(cls, text, tooltip) {
|
||||
badge.className = 'api-status-inline__badge ' + cls;
|
||||
badge.textContent = text;
|
||||
if (tooltip) badge.setAttribute('title', tooltip);
|
||||
else badge.removeAttribute('title');
|
||||
}
|
||||
|
||||
fetch(statusUrl + '?apiId=' + encodeURIComponent(apiId), { credentials: 'same-origin' })
|
||||
.then(function (r) {
|
||||
if (!r.ok) throw new Error('HTTP ' + r.status);
|
||||
return r.json();
|
||||
})
|
||||
.then(function (status) {
|
||||
const tooltip = [
|
||||
status.activeIncidentTitle,
|
||||
status.statusSince ? '시작 ' + status.statusSince : null,
|
||||
status.expectedEndAt ? '종료 예정 ' + status.expectedEndAt : null
|
||||
].filter(Boolean).join('\n');
|
||||
paint(BADGE_CLASS[status.currentStatus] || 'is-muted',
|
||||
status.currentStatusLabel || '정상', tooltip);
|
||||
})
|
||||
.catch(function (e) {
|
||||
console.error('API 현재 상태 조회 실패', e);
|
||||
paint('is-muted', '상태 확인 불가');
|
||||
});
|
||||
})();
|
||||
|
||||
// ===== DJPGPT0001: 앱 인증 정보 자동 주입 =====
|
||||
const DEFAULT_TOKEN_API_ID = 'default-token-api-spec';
|
||||
const appsSelect = document.getElementById('apps');
|
||||
|
||||
@@ -75,13 +75,20 @@
|
||||
</div>
|
||||
|
||||
<!-- API Cards Grid -->
|
||||
<div class="api-card-grid" th:if="${apis != null and !apis.isEmpty()}">
|
||||
<div class="api-card-grid" th:if="${apis != null and !apis.isEmpty()}"
|
||||
th:attr="data-status-url=@{/apistatus/current-list.json}">
|
||||
<div class="api-card" th:each="api : ${apis}" th:data-href="@{/apis/detail(id=${api.apiId})}" role="button"
|
||||
tabindex="0">
|
||||
|
||||
<!-- Group Badge -->
|
||||
<div class="api-card-badge">
|
||||
<span th:text="${api.apiGroupName}">그룹 이름</span>
|
||||
<!-- Group Badge + 현재 상태 태그 -->
|
||||
<div class="api-card-badges">
|
||||
<div class="api-card-badge">
|
||||
<span th:text="${api.apiGroupName}">그룹 이름</span>
|
||||
</div>
|
||||
<!--/* 상태 태그 노출은 PTL_PROPERTY(djb.apistatus.api-list-status-badge) 로 제어.
|
||||
값은 로드 후 JS가 채우며, 비어 있는 동안은 CSS(:empty)로 숨긴다 */-->
|
||||
<span th:if="${apiStatusBadgeEnabled}" class="api-card-status"
|
||||
th:attr="data-api-id=${api.apiId}"></span>
|
||||
</div>
|
||||
|
||||
<!-- API Name -->
|
||||
@@ -152,6 +159,62 @@
|
||||
});
|
||||
});
|
||||
|
||||
// ===== 카드 현재 상태 태그 =====
|
||||
// 게시된 장애·점검 공지 기준(/apistatus/current-list.json). 태그 자체는 PTL_PROPERTY 로 노출 제어된다.
|
||||
(function loadApiCardStatuses() {
|
||||
const grid = document.querySelector('.api-card-grid');
|
||||
if (!grid) return;
|
||||
|
||||
const statusUrl = grid.getAttribute('data-status-url');
|
||||
const slots = Array.prototype.slice.call(grid.querySelectorAll('.api-card-status[data-api-id]'));
|
||||
if (!statusUrl || !slots.length) return;
|
||||
|
||||
const BADGE_CLASS = {
|
||||
OUTAGE: 'is-outage',
|
||||
DEGRADED: 'is-degraded',
|
||||
MAINTENANCE: 'is-maintenance',
|
||||
NORMAL: 'is-normal'
|
||||
};
|
||||
const CHUNK = 50; // 서버 일괄 조회 상한(100) 이내로 나눠 요청
|
||||
|
||||
// 같은 API 가 여러 카드에 나올 수 있어 apiId → 슬롯 목록으로 묶는다
|
||||
const slotsByApiId = {};
|
||||
slots.forEach(function (el) {
|
||||
const apiId = el.getAttribute('data-api-id');
|
||||
if (!apiId) return;
|
||||
(slotsByApiId[apiId] = slotsByApiId[apiId] || []).push(el);
|
||||
});
|
||||
const apiIds = Object.keys(slotsByApiId);
|
||||
|
||||
function paint(list) {
|
||||
(list || []).forEach(function (status) {
|
||||
const targets = slotsByApiId[status.apiId];
|
||||
const cls = BADGE_CLASS[status.currentStatus];
|
||||
if (!targets || !cls) return;
|
||||
targets.forEach(function (el) {
|
||||
el.className = 'api-card-status ' + cls;
|
||||
el.textContent = status.currentStatusLabel || '';
|
||||
if (status.activeIncidentTitle) el.setAttribute('title', status.activeIncidentTitle);
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
for (let index = 0; index < apiIds.length; index += CHUNK) {
|
||||
const query = apiIds.slice(index, index + CHUNK).map(function (apiId) {
|
||||
return 'apiId=' + encodeURIComponent(apiId);
|
||||
}).join('&');
|
||||
|
||||
fetch(statusUrl + '?' + query, { credentials: 'same-origin' })
|
||||
.then(function (r) {
|
||||
if (!r.ok) throw new Error('HTTP ' + r.status);
|
||||
return r.json();
|
||||
})
|
||||
.then(paint)
|
||||
// 상태 조회 실패는 목록 자체를 막지 않는다 (태그는 비어 있는 채로 숨겨진다)
|
||||
.catch(function (e) { console.error('API 현재 상태 조회 실패', e); });
|
||||
}
|
||||
})();
|
||||
|
||||
// Category/Service Selection
|
||||
const menuTitles = document.querySelectorAll('.js-menu-trigger');
|
||||
menuTitles.forEach(function (title) {
|
||||
|
||||
@@ -69,7 +69,7 @@
|
||||
<td
|
||||
th:text="${portalNotice.startedAt != null ? #temporals.format(portalNotice.startedAt, 'yyyy-MM-dd HH:mm') : '-'}">
|
||||
-</td>
|
||||
<th>끝</th>
|
||||
<th>종료</th>
|
||||
<td
|
||||
th:text="${portalNotice.endAt != null ? #temporals.format(portalNotice.endAt, 'yyyy-MM-dd HH:mm') : '진행중'}">
|
||||
-</td>
|
||||
@@ -78,29 +78,27 @@
|
||||
<th>상태</th>
|
||||
<td colspan="3" th:text="${portalNotice.state != null ? portalNotice.state : '-'}">-</td>
|
||||
</tr>
|
||||
<tr th:if="${portalNotice.affectedApis != null and !portalNotice.affectedApis.isEmpty()}">
|
||||
<tr
|
||||
th:if="${(portalNotice.affectedApis != null and !portalNotice.affectedApis.isEmpty()) or portalNotice.hiddenApiCount > 0}">
|
||||
<th>영향 API</th>
|
||||
<td colspan="3">
|
||||
<div class="affected-apis-wrapper">
|
||||
<!-- First 3 APIs (Always visible) -->
|
||||
<!-- 개발자포탈에 게시된 API 만 개별 노출한다 (인터페이스 ID 는 표시하지 않음) -->
|
||||
<div class="affected-apis-list">
|
||||
<span class="affected-api-badge" th:each="api, iterStat : ${portalNotice.affectedApis}"
|
||||
th:if="${iterStat.index < 3}">
|
||||
<strong th:text="${api.apiId}">API_ID</strong><span
|
||||
th:if="${api.apiName != null and !api.apiName.isEmpty()}"
|
||||
th:text="| - ${api.apiName}|"></span>
|
||||
</span>
|
||||
th:if="${iterStat.index < 3}" th:text="${api.apiName}">API 명</span>
|
||||
|
||||
<!-- Rest of APIs (Hidden by default) -->
|
||||
<th:block th:if="${portalNotice.affectedApis.size() > 3}">
|
||||
<span class="affected-api-badge extra-api"
|
||||
th:each="api, iterStat : ${portalNotice.affectedApis}" th:if="${iterStat.index >= 3}"
|
||||
style="display: none;">
|
||||
<strong th:text="${api.apiId}">API_ID</strong><span
|
||||
th:if="${api.apiName != null and !api.apiName.isEmpty()}"
|
||||
th:text="| - ${api.apiName}|"></span>
|
||||
</span>
|
||||
style="display: none;" th:text="${api.apiName}">API 명</span>
|
||||
</th:block>
|
||||
|
||||
<!-- 게시되지 않은 GW 인터페이스는 건수로만 묶어서 표기 -->
|
||||
<span class="affected-api-badge is-gw" th:if="${portalNotice.hiddenApiCount > 0}"
|
||||
th:text="|GW 인터페이스 ${portalNotice.hiddenApiCount}건|"
|
||||
title="개발자포탈에 게시되지 않은 게이트웨이 인터페이스입니다">GW 인터페이스 0건</span>
|
||||
</div>
|
||||
|
||||
<!-- Toggle Button -->
|
||||
@@ -141,6 +139,38 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 장애 처리 타임라인 (공개 항목이 있을 때만) -->
|
||||
<div class="notice-detail-timeline" th:if="${portalNotice.hasTimeline()}">
|
||||
<h3 class="notice-timeline-title">처리 경과</h3>
|
||||
<table class="detail-table timeline-table">
|
||||
<colgroup>
|
||||
<col style="width: 160px;">
|
||||
<col style="width: 110px;">
|
||||
<col>
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr>
|
||||
<th>일시</th>
|
||||
<th>상태</th>
|
||||
<th>내용</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr th:each="entry : ${portalNotice.timeline}">
|
||||
<td class="timeline-ts"
|
||||
th:text="${entry.eventAt != null ? #temporals.format(entry.eventAt, 'yyyy-MM-dd HH:mm') : '-'}">
|
||||
2026-08-04 11:44</td>
|
||||
<td>
|
||||
<span class="timeline-state"
|
||||
th:classappend="${'state-' + (entry.stateAfter != null ? entry.stateAfter : 'NONE')}"
|
||||
th:text="${entry.labelKo != null ? entry.labelKo : '진행 상황'}">원인 확인</span>
|
||||
</td>
|
||||
<td class="timeline-body" th:text="${entry.body}">진행 내용</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
|
||||
<!-- Action Buttons -->
|
||||
<div class="notice-detail-actions">
|
||||
<button type="button" class="btn-action-primary btn-notice-list"
|
||||
|
||||
@@ -226,8 +226,8 @@
|
||||
</div>
|
||||
|
||||
<div class="api-cards-container">
|
||||
<!-- Services 데이터를 반복하여 API 카드 표시 (최대 4개) -->
|
||||
<div class="api-card" th:each="service, iterStat : ${services}" th:if="${iterStat.index < 4}"
|
||||
<!-- main.service.list 에 등록된 서비스 전체 표시 (1행 4열, 초과분은 다음 행으로) -->
|
||||
<div class="api-card" th:each="service : ${services}"
|
||||
th:onclick="${service.id != null} ? |location.href='@{/apis(groupIds=${service.id})}'| : |location.href='@{/apis}'|">
|
||||
<h3 class="card-title" th:text="${service.groupName}">API 서비스</h3>
|
||||
<p class="card-description">
|
||||
|
||||
@@ -6,34 +6,7 @@
|
||||
|
||||
<th:block layout:fragment="contentFragment">
|
||||
<section class="service-intro">
|
||||
<h1 class="service-intro__title">DJBank 개발자포탈 소개</h1>
|
||||
|
||||
<p class="service-intro__lead">기업의 업무 흐름 속으로, 금융이 흘러 들어갑니다.</p>
|
||||
|
||||
<p class="service-intro__desc">
|
||||
제주은행의 디지털 기업금융 특화 브랜드 'DJ Bank'의 금융 서비스를<br>
|
||||
핀테크 기업·개발자·ERP/SaaS 파트너가 손쉽게 연결해 활용할 수 있도록 지원하는<br>
|
||||
통합 Open API 포털입니다.
|
||||
</p>
|
||||
|
||||
<div class="service-intro__spacer" aria-hidden="true"></div>
|
||||
|
||||
<h2 class="service-intro__section-title">구축 배경</h2>
|
||||
<div class="service-intro__section-body">
|
||||
<p>기존 기업금융은 서류 부담, 시간 지연, 대면중심 절차의 한계가 있었습니다. 또한 폐쇄적인 금융시스템 안에서 핀테크·SaaS 기업이 금융 기능을 자사 서비스에 결합하기 어려웠습니다.</p>
|
||||
<p>DJ Bank는 ERP 데이터와 AI를 결합한 자율형 금융 플랫폼을 지향하며, 이 비전을 실현하기 위해 개방형 API 생태계를 구축했습니다. 기업이 본업의 흐름을 끊지 않고 금융을 이용할 수 있도록, 핵심 금융 자원을 파트너와 개발자에게 개방합니다.</p>
|
||||
</div>
|
||||
|
||||
<div class="service-intro__spacer" aria-hidden="true"></div>
|
||||
|
||||
<h2 class="service-intro__section-title">제공 API 카테고리</h2>
|
||||
<ul class="service-intro__list">
|
||||
<li>계좌 · 수신 - 법인 계좌개설·조회, 법인 파킹통장 연계</li>
|
||||
<li>여신 · 대출 - ERP 연계 매출채권 담보대출, AX 솔루션자금</li>
|
||||
<li>신용 · 평가 - 대안신용평가 전략모형 기반 기업 신용 조회</li>
|
||||
<li>이체 · 결제 - 펌뱅킹, 실시간이체, 결제 API</li>
|
||||
<li>인증 · 보안 - OAuth 2.0, 전자서명, 마이데이터 인증</li>
|
||||
</ul>
|
||||
<h1 class="service-intro__title">DJBank API Portal 소개</h1>
|
||||
</section>
|
||||
</th:block>
|
||||
</body>
|
||||
|
||||
@@ -358,7 +358,7 @@ valid = constantTimeEquals(received, expected)</pre>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>ERROR_START</code></td>
|
||||
<td>장애 시작</td>
|
||||
<td>장애 발생</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td><code>ERROR_END</code></td>
|
||||
|
||||
@@ -0,0 +1,106 @@
|
||||
<!DOCTYPE html>
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"
|
||||
xmlns:sec="http://www.thymeleaf.org/extras/spring-security"
|
||||
xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
|
||||
layout:decorate="~{layout/djbank_title_layout}">
|
||||
|
||||
<body>
|
||||
<th:block layout:fragment="contentFragment">
|
||||
<!-- 타이틀 배너 (Figma node 1:16) -->
|
||||
<div class="as-title-banner">
|
||||
<div class="as-title-banner-inner">
|
||||
<h1>API Status</h1>
|
||||
<div class="as-title-meta" th:if="${lastFireAt != null or lastStatusChangedAt != null}">
|
||||
<p class="as-title-meta-main" th:if="${lastFireAt != null}">
|
||||
<span class="as-title-dot"></span>
|
||||
<span>마지막 점검 </span>
|
||||
<strong th:text="${lastFireRelative}">-</strong>
|
||||
</p>
|
||||
<p class="as-title-meta-sub" th:if="${lastFireAt != null}"
|
||||
th:text="${#temporals.format(lastFireAt, 'yyyy-MM-dd HH:mm')} + ' KST · API 상태 모니터링 실행 시각'">-</p>
|
||||
<p class="as-title-meta-sub" th:if="${lastStatusChangedAt != null}"
|
||||
th:text="'마지막 상태 변경 ' + ${#temporals.format(lastStatusChangedAt, 'yyyy-MM-dd HH:mm')} + ' KST'">-</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="api-status" id="apiStatusPage"
|
||||
th:attr="data-window-days=${windowDays},data-base=@{/apistatus},data-api-detail-base=@{/apis/detail},data-notice-detail-base=@{/portalnotice/detail}"
|
||||
th:classappend="${authenticated} ? 'is-authenticated' : ''">
|
||||
|
||||
<!-- ❶ 진행 중 장애 -->
|
||||
<div id="activeIncidents"></div>
|
||||
|
||||
<!-- ❷ 90일 서비스 상태 -->
|
||||
<section class="as-card as-uptime">
|
||||
<div class="as-card-head">
|
||||
<div>
|
||||
<h2 th:text="|최근 ${windowDays}일 서비스 상태|">최근 90일 서비스 상태</h2>
|
||||
<p class="as-desc">막대 1개 = 하루 · 장애·지연·점검이 있던 날만 색으로 표시됩니다.
|
||||
막대를 클릭하면 그 날짜의 이슈 이력으로 이동합니다.</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="as-bar-chart" id="uptimeChart"></div>
|
||||
<div class="as-axis">
|
||||
<span id="uptimeFromLabel" th:text="|${windowDays}일 전|">90일 전</span>
|
||||
<span>오늘</span>
|
||||
</div>
|
||||
|
||||
<div class="as-legend">
|
||||
<span><span class="as-sw is-ok"></span>정상</span>
|
||||
<span><span class="as-sw is-outage"></span>장애</span>
|
||||
<span><span class="as-sw is-degraded"></span>지연</span>
|
||||
<span><span class="as-sw is-maintenance"></span>점검</span>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- ❸ 점검 사항 -->
|
||||
<section>
|
||||
<div class="as-section-title">
|
||||
<h2>점검 사항</h2>
|
||||
<span class="as-desc">예정 또는 진행 중인 점검</span>
|
||||
<span class="as-count" id="maintenanceCount"></span>
|
||||
</div>
|
||||
<div class="as-maint-list" id="maintenanceList"></div>
|
||||
</section>
|
||||
|
||||
<!-- ❹ My APIs (로그인 사용자) -->
|
||||
<section class="as-card as-my-apis" id="myApisCard" th:if="${authenticated}" style="display:none">
|
||||
<div class="as-card-head">
|
||||
<div>
|
||||
<h2>My APIs</h2>
|
||||
<p class="as-desc">우리 기관이 이용 중인 API 의 현재 상태 · 행을 클릭하면 해당 API 의 이슈 이력을 볼 수 있습니다.</p>
|
||||
</div>
|
||||
<span class="as-count" id="myApisCount"></span>
|
||||
</div>
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th scope="col">API</th>
|
||||
<th scope="col">현재 상태</th>
|
||||
<th scope="col" class="as-num" th:text="|${windowDays}일 가동률|">90일 가동률</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody id="myApisBody"></tbody>
|
||||
</table>
|
||||
</section>
|
||||
|
||||
<!-- ❺ 지난 이슈 사항 -->
|
||||
<section>
|
||||
<div class="as-section-title">
|
||||
<h2>지난 이슈 사항</h2>
|
||||
<span class="as-desc">종결된 장애·점검 내역</span>
|
||||
<span class="as-count">최근 5건</span>
|
||||
</div>
|
||||
<div class="as-issue-list" id="recentIssueList"></div>
|
||||
<a class="as-more-link" th:href="@{/apistatus/issues}">전체 이력 보기 →</a>
|
||||
</section>
|
||||
</div>
|
||||
</th:block>
|
||||
|
||||
<th:block layout:fragment="contentScript">
|
||||
<script th:src="@{/js/djb/api-status.js}"></script>
|
||||
</th:block>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,119 @@
|
||||
<!DOCTYPE html>
|
||||
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"
|
||||
xmlns:layout="http://www.ultraq.net.nz/thymeleaf/layout"
|
||||
layout:decorate="~{layout/djbank_title_layout}">
|
||||
|
||||
<body>
|
||||
<th:block layout:fragment="contentFragment">
|
||||
<!-- 타이틀 배너 (메인과 동일 스타일) -->
|
||||
<div class="as-title-banner">
|
||||
<div class="as-title-banner-inner">
|
||||
<h1>전체 이슈 이력</h1>
|
||||
<div class="as-title-meta">
|
||||
<p class="as-title-meta-main">
|
||||
<strong th:text="|최근 ${windowDays}일|">최근 90일</strong><span> 장애·점검 내역</span>
|
||||
</p>
|
||||
<p class="as-title-meta-sub">날짜·API·유형으로 필터링할 수 있습니다</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="api-status" id="issueHistoryPage"
|
||||
th:attr="data-window-days=${windowDays},
|
||||
data-base=@{/apistatus},
|
||||
data-api-detail-base=@{/apis/detail},
|
||||
data-notice-detail-base=@{/portalnotice/detail},
|
||||
data-today=${today},
|
||||
data-min-date=${minDate},
|
||||
data-selected-date=${selectedDate} ?: '',
|
||||
data-selected-api=${selectedApiId} ?: '',
|
||||
data-selected-kind=${selectedKind} ?: ''">
|
||||
|
||||
<!-- 90일 이슈 인덱스 -->
|
||||
<section class="as-card">
|
||||
<div class="as-card-head">
|
||||
<div>
|
||||
<h2 th:text="|${windowDays}일 이슈 인덱스|">90일 이슈 인덱스</h2>
|
||||
<p class="as-desc">이슈가 있던 날짜만 색으로 표시됩니다. 막대를 클릭하면 그 날짜로 필터링합니다.</p>
|
||||
</div>
|
||||
<div class="as-desc">현재 선택: <b id="selectedDateLabel">전체 기간</b></div>
|
||||
</div>
|
||||
|
||||
<div class="as-index-bar" id="issueIndexBar"></div>
|
||||
<div class="as-axis">
|
||||
<span th:text="|${windowDays}일 전|">90일 전</span>
|
||||
<span>오늘</span>
|
||||
</div>
|
||||
|
||||
<div class="as-legend">
|
||||
<span><span class="as-sw is-none"></span>정상 (이슈 없음)</span>
|
||||
<span><span class="as-sw is-outage"></span>장애만</span>
|
||||
<span><span class="as-sw is-degraded"></span>지연만</span>
|
||||
<span><span class="as-sw is-maintenance"></span>점검만</span>
|
||||
<span><span class="as-sw is-mixed"></span>복합 (2종 이상)</span>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<!-- 필터: 날짜 + API + 유형 -->
|
||||
<div class="as-filter-bar">
|
||||
<div class="as-filter-field" id="dateField">
|
||||
<label class="as-filter-label" for="filterDateInput">날짜</label>
|
||||
<div class="as-field-control">
|
||||
<input type="date" id="filterDateInput" class="as-input"
|
||||
th:attr="min=${minDate},max=${today}">
|
||||
<button type="button" class="as-field-clear" id="filterDateClear"
|
||||
title="날짜 선택 해제" aria-label="날짜 선택 해제">×</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="as-filter-field as-combo" id="apiCombo">
|
||||
<label class="as-filter-label" for="filterApiInput">API</label>
|
||||
<div class="as-field-control">
|
||||
<!-- 레이아웃에 비밀번호 팝업(input[type=password])이 늘 포함돼 있어 브라우저가
|
||||
이 입력을 계정(아이디) 칸으로 오인한다. autocomplete=off 는 Chrome 이 무시하므로
|
||||
new-password + 초기 readonly(focus 시 해제, JS) 조합으로 자동완성을 차단한다 -->
|
||||
<input type="search" id="filterApiInput" class="as-input" readonly
|
||||
autocomplete="new-password" autocorrect="off" autocapitalize="off" spellcheck="false"
|
||||
data-lpignore="true" data-1p-ignore data-form-type="other"
|
||||
placeholder="전체 API (API 명 입력)" aria-expanded="false"
|
||||
role="combobox" aria-controls="filterApiList">
|
||||
<button type="button" class="as-field-clear" id="filterApiClear"
|
||||
title="API 선택 해제" aria-label="API 선택 해제">×</button>
|
||||
<ul class="as-combo-list" id="filterApiList" role="listbox" hidden></ul>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="as-filter-field">
|
||||
<label class="as-filter-label" for="filterKindSelect">유형</label>
|
||||
<select id="filterKindSelect" class="as-input">
|
||||
<option value="">전체 유형</option>
|
||||
<option value="INCIDENT">장애만</option>
|
||||
<option value="DELAY">지연만</option>
|
||||
<option value="MAINTENANCE">점검만</option>
|
||||
</select>
|
||||
</div>
|
||||
|
||||
<div class="as-filter-right">
|
||||
<span class="as-filter-count">총 <b id="issueTotalCount">0</b>건</span>
|
||||
<button type="button" class="as-btn" id="filterResetBtn">초기화</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 필터 중인 API 가 포탈에 게시되지 않은 경우 안내 -->
|
||||
<div class="as-unlisted-banner" id="unlistedApiBanner" style="display:none">
|
||||
<span class="as-unlisted-icon" aria-hidden="true">ⓘ</span>
|
||||
<span><b id="unlistedApiName"></b> 은(는) 포탈에 게시되지 않은 API 입니다.
|
||||
이슈 이력은 조회되지만 API 상세 정보는 제공되지 않습니다.</span>
|
||||
</div>
|
||||
|
||||
<!-- 이슈 목록 -->
|
||||
<div class="as-issue-list" id="issueList"></div>
|
||||
<div class="as-pager" id="issuePager"></div>
|
||||
</div>
|
||||
</th:block>
|
||||
|
||||
<th:block layout:fragment="contentScript">
|
||||
<script th:src="@{/js/djb/api-status-issues.js}"></script>
|
||||
</th:block>
|
||||
</body>
|
||||
</html>
|
||||
@@ -24,18 +24,31 @@
|
||||
<p class="footer-copyright">Copyright © 2026 JEJU Bank. All Rights Reserved.</p>
|
||||
</div>
|
||||
<div class="footer-right">
|
||||
<div class="footer-related-sites">
|
||||
<select class="related-sites-select">
|
||||
<option>DJBank 관련 사이트</option>
|
||||
<option>DJBank 홈페이지</option>
|
||||
<option>DJBank 인터넷뱅킹</option>
|
||||
<option>DJBank 모바일뱅킹</option>
|
||||
<!-- 관련 사이트: PortalProperty(Portal/footer.related-sites[.label])로 제어. 목록이 비면 미노출 -->
|
||||
<div class="footer-related-sites" th:if="${!#lists.isEmpty(relatedSites)}">
|
||||
<select class="related-sites-select" data-related-sites th:aria-label="${relatedSitesLabel}">
|
||||
<option value="" th:text="${relatedSitesLabel}">DJBank 관련 사이트</option>
|
||||
<option th:each="site : ${relatedSites}" th:value="${site.url}" th:text="${site.name}"></option>
|
||||
</select>
|
||||
</div>
|
||||
<p class="footer-contact" th:text="'고객센터 ' + ${customerCenterContact}">고객센터 1588-3388</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<script th:inline="none">
|
||||
// 관련 사이트 셀렉트: 선택 시 새 창으로 이동 후 라벨(첫 항목)로 되돌린다.
|
||||
(function () {
|
||||
document.addEventListener('change', function (e) {
|
||||
var el = e.target;
|
||||
if (!el || !el.hasAttribute || !el.hasAttribute('data-related-sites')) return;
|
||||
var url = el.value;
|
||||
el.selectedIndex = 0;
|
||||
if (!url) return;
|
||||
window.open(url, '_blank', 'noopener,noreferrer');
|
||||
});
|
||||
})();
|
||||
</script>
|
||||
</footer>
|
||||
</body>
|
||||
|
||||
|
||||
@@ -27,28 +27,22 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 상단 GNB: DB 메뉴(menuView) 기반 렌더 — .nav-menu > li / .sub-menu 구조는 하단 JS 의존 -->
|
||||
<nav class="header-center">
|
||||
<ul class="nav-menu">
|
||||
<li>
|
||||
<a href="#" class="nav-link">서비스 소개</a>
|
||||
<ul class="sub-menu">
|
||||
<li><a th:href="@{/service/intro}">API 포탈 소개</a></li>
|
||||
<li><a th:href="@{/service/guide}">회원가입 안내</a></li>
|
||||
<li><a th:href="@{/service/oauth2-guide}">OAuth2 개발가이드</a></li>
|
||||
<li><a th:href="@{/service/webhook-dev-guide}">웹훅 개발가이드</a></li>
|
||||
</ul>
|
||||
<li th:each="menu : ${menuView.gnb}">
|
||||
<th:block th:if="${!menu.children.isEmpty()}">
|
||||
<a th:href="${menu.hasPath()} ? @{${menu.path}} : '#'" class="nav-link" th:text="${menu.name}">메뉴</a>
|
||||
<ul class="sub-menu">
|
||||
<li th:each="child : ${menu.children}">
|
||||
<a th:href="@{${child.path}}" th:target="${child.newWindow} ? '_blank' : null"
|
||||
th:text="${child.name}">하위 메뉴</a>
|
||||
</li>
|
||||
</ul>
|
||||
</th:block>
|
||||
<a th:if="${menu.children.isEmpty()}" th:href="${menu.hasPath()} ? @{${menu.path}} : '#'"
|
||||
th:target="${menu.newWindow} ? '_blank' : null" class="nav-link" th:text="${menu.name}">메뉴</a>
|
||||
</li>
|
||||
<li><a href="/apis" class="nav-link">오픈 API</a></li>
|
||||
<li>
|
||||
<a href="#playground" class="nav-link">고객지원</a>
|
||||
<ul class="sub-menu">
|
||||
<li><a th:href="@{/portalnotice}">공지사항</a></li>
|
||||
<li><a th:href="@{/faq_list}">FAQ</a></li>
|
||||
<li><a th:href="@{/inquiry}">Q&A</a></li>
|
||||
<li><a th:href="@{/partnership}">피드백/개선요청</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a href="#" class="nav-link">API Status</a></li>
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
@@ -76,20 +70,18 @@
|
||||
<span class="divider">•</span>
|
||||
<a th:href="@{/actionLogout.do}" class="header-link">로그아웃</a>
|
||||
<span class="divider">•</span>
|
||||
<div class="mypage-dropdown">
|
||||
<button class="header-link mypage-toggle" type="button">마이페이지</button>
|
||||
<!-- 마이페이지 드롭다운: DB 메뉴(menuView.mypage) 기반, 노출 권한은 서버 필터 적용 -->
|
||||
<div class="mypage-dropdown" th:if="${menuView.mypage != null}">
|
||||
<button class="header-link mypage-toggle" type="button"
|
||||
th:text="${menuView.mypage.name}">마이페이지</button>
|
||||
<div class="mypage-dropdown-menu">
|
||||
<ul class="mypage-menu-list">
|
||||
<li sec:authorize="hasRole('ROLE_CORP_MANAGER')">
|
||||
<a th:href="@{/users}"><i class="fas fa-users"></i>개발자 관리</a>
|
||||
<li th:each="child : ${menuView.mypage.children}">
|
||||
<a th:href="@{${child.path}}" th:target="${child.newWindow} ? '_blank' : null">
|
||||
<i th:if="${child.icon != null}" th:class="'fas ' + ${child.icon}"></i>
|
||||
<th:block th:text="${child.name}">메뉴</th:block>
|
||||
</a>
|
||||
</li>
|
||||
<li sec:authorize="hasRole('ROLE_APP')">
|
||||
<a th:href="@{/clients}"><i class="fas fa-key"></i>API 신청 관리</a>
|
||||
<a th:href="@{/webhook}" sec:authorize="hasRole('ROLE_WEBHOOK')"><i class="fas fa-bell"></i>Webhook 관리</a>
|
||||
<a th:href="@{/statistics/api}"><i class="fas fa-chart-bar"></i>이용 통계</a>
|
||||
</li>
|
||||
<li><a th:href="@{/mypage}"><i class="fas fa-user-circle"></i>내 정보 관리</a></li>
|
||||
<li><a th:href="@{/password/change}"><i class="fas fa-lock"></i>비밀번호 변경</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</div>
|
||||
@@ -184,72 +176,43 @@
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- Navigation Menu (Accordion Style) -->
|
||||
<!-- Navigation Menu (Accordion Style): DB 메뉴(menuView) 기반 렌더 -->
|
||||
<!-- .drawer-menu-item / .drawer-menu-btn / .drawer-submenu 구조는 하단 JS 의존 -->
|
||||
<nav class="drawer-nav">
|
||||
<ul class="drawer-menu-list">
|
||||
<!-- 서비스 소개 -->
|
||||
<li class="drawer-menu-item has-submenu">
|
||||
<button class="drawer-menu-btn" type="button">
|
||||
<span>서비스 소개</span>
|
||||
<svg class="accordion-icon" width="14" height="7" viewBox="0 0 14 7" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<path d="M1 1L7 6L13 1" stroke="#212529" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
</button>
|
||||
<ul class="drawer-submenu">
|
||||
<li><a th:href="@{/service/intro}">API 포탈 소개</a></li>
|
||||
<li><a th:href="@{/service/guide}">회원가입 안내</a></li>
|
||||
<li><a th:href="@{/service/oauth2-guide}">OAuth2 개발가이드</a></li>
|
||||
<li><a th:href="@{/service/webhook-dev-guide}">웹훅 개발가이드</a></li>
|
||||
</ul>
|
||||
<li th:each="menu : ${menuView.gnb}" class="drawer-menu-item"
|
||||
th:classappend="${!menu.children.isEmpty()} ? 'has-submenu' : ''">
|
||||
<th:block th:if="${!menu.children.isEmpty()}">
|
||||
<button class="drawer-menu-btn" type="button">
|
||||
<span th:text="${menu.name}">메뉴</span>
|
||||
<svg class="accordion-icon" width="14" height="7" viewBox="0 0 14 7" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<path d="M1 1L7 6L13 1" stroke="#212529" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
</button>
|
||||
<ul class="drawer-submenu">
|
||||
<li th:each="child : ${menu.children}">
|
||||
<a th:href="@{${child.path}}" th:target="${child.newWindow} ? '_blank' : null"
|
||||
th:text="${child.name}">하위 메뉴</a>
|
||||
</li>
|
||||
</ul>
|
||||
</th:block>
|
||||
<a th:if="${menu.children.isEmpty()}" th:href="${menu.hasPath()} ? @{${menu.path}} : '#'"
|
||||
th:target="${menu.newWindow} ? '_blank' : null" class="drawer-menu-btn" th:text="${menu.name}">메뉴</a>
|
||||
</li>
|
||||
|
||||
<!-- API -->
|
||||
<li class="drawer-menu-item has-submenu">
|
||||
<!-- 마이페이지 (노출 권한 서버 필터 — 미노출 시 null) -->
|
||||
<li class="drawer-menu-item has-submenu" th:if="${menuView.mypage != null}">
|
||||
<button class="drawer-menu-btn" type="button">
|
||||
<span>API</span>
|
||||
<span th:text="${menuView.mypage.name}">마이페이지</span>
|
||||
<svg class="accordion-icon" width="14" height="7" viewBox="0 0 14 7" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<path d="M1 1L7 6L13 1" stroke="#212529" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
</button>
|
||||
<ul class="drawer-submenu">
|
||||
<li><a th:href="@{/apis}">API 마켓</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<!-- 고객지원 -->
|
||||
<li class="drawer-menu-item has-submenu">
|
||||
<button class="drawer-menu-btn" type="button">
|
||||
<span>고객지원</span>
|
||||
<svg class="accordion-icon" width="14" height="7" viewBox="0 0 14 7" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<path d="M1 1L7 6L13 1" stroke="#212529" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
</button>
|
||||
<ul class="drawer-submenu">
|
||||
<li><a th:href="@{/portalnotice}">공지사항</a></li>
|
||||
<li><a th:href="@{/faq_list}">FAQ</a></li>
|
||||
<li><a th:href="@{/inquiry}">Q&A</a></li>
|
||||
<li><a th:href="@{/partnership}">사업 제휴 문의</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<!-- API Status -->
|
||||
<li class="drawer-menu-item">
|
||||
<a href="#" class="drawer-menu-btn">API Status</a>
|
||||
</li>
|
||||
|
||||
<!-- 마이페이지 (Authenticated Only) -->
|
||||
<li class="drawer-menu-item has-submenu" sec:authorize="isAuthenticated()">
|
||||
<button class="drawer-menu-btn" type="button">
|
||||
<span>마이페이지</span>
|
||||
<svg class="accordion-icon" width="14" height="7" viewBox="0 0 14 7" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<path d="M1 1L7 6L13 1" stroke="#212529" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
|
||||
</svg>
|
||||
</button>
|
||||
<ul class="drawer-submenu">
|
||||
<li sec:authorize="hasRole('ROLE_CORP_MANAGER')"><a th:href="@{/users}">개발자 관리</a></li>
|
||||
<li sec:authorize="hasRole('ROLE_APP')"><a th:href="@{/clients}">API 신청 관리</a></li>
|
||||
<li sec:authorize="hasRole('ROLE_WEBHOOK')"><a th:href="@{/webhook}">Webhook 관리</a></li>
|
||||
<li sec:authorize="hasRole('ROLE_APP')"><a th:href="@{/statistics/api}">이용 통계</a></li>
|
||||
<li><a th:href="@{/mypage}">내 정보 관리</a></li>
|
||||
<li><a th:href="@{/password/change}">비밀번호 변경</a></li>
|
||||
<li th:each="child : ${menuView.mypage.children}">
|
||||
<a th:href="@{${child.path}}" th:target="${child.newWindow} ? '_blank' : null"
|
||||
th:text="${child.name}">하위 메뉴</a>
|
||||
</li>
|
||||
</ul>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
@@ -2,41 +2,13 @@
|
||||
<html xmlns:th="http://www.thymeleaf.org">
|
||||
|
||||
<body>
|
||||
<!-- Service Left Sidebar Fragment -->
|
||||
<aside class="service-sidebar" th:fragment="sidebar(activeMenu)">
|
||||
<nav class="service-nav">
|
||||
<!-- 서비스 소개 그룹 (Service) -->
|
||||
<th:block
|
||||
th:if="${activeMenu == 'intro' or activeMenu == 'guide' or activeMenu == 'oauth2' or activeMenu == 'webhookGuide'}">
|
||||
<a th:href="@{/service/intro}" th:classappend="${activeMenu == 'intro'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item">API 포탈 소개</a>
|
||||
<a th:href="@{/service/guide}" th:classappend="${activeMenu == 'guide'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item">회원가입 안내</a>
|
||||
<a th:href="@{/service/oauth2-guide}"
|
||||
th:classappend="${activeMenu == 'oauth2'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item">OAuth2 개발가이드</a>
|
||||
<a th:href="@{/service/webhook-dev-guide}"
|
||||
th:classappend="${activeMenu == 'webhookGuide'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item">웹훅 개발가이드</a>
|
||||
</th:block>
|
||||
|
||||
<!-- 고객지원 그룹 (Customer Support) -->
|
||||
<th:block
|
||||
th:if="${activeMenu == 'notice' or activeMenu == 'faq' or activeMenu == 'qna' or activeMenu == 'feedback'}">
|
||||
<a th:href="@{/portalnotice}" th:classappend="${activeMenu == 'notice'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item">공지사항</a>
|
||||
<a th:href="@{/faq_list}" th:classappend="${activeMenu == 'faq'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item">FAQ</a>
|
||||
<a th:href="@{/inquiry}" th:classappend="${activeMenu == 'qna'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item">Q&A</a>
|
||||
<a th:href="@{/partnership}" th:classappend="${activeMenu == 'feedback'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item">피드백/개선요청</a>
|
||||
</th:block>
|
||||
|
||||
<!-- 마이페이지 그룹 (My Page) -->
|
||||
<th:block
|
||||
th:if="${activeMenu == 'users' or activeMenu == 'apiKey' or activeMenu == 'statistics' or activeMenu == 'webhook' or activeMenu == 'profile' or activeMenu == 'password'}">
|
||||
<!-- Profile Section -->
|
||||
<!-- Service Left Sidebar Fragment: DB 메뉴(menuView) 기반 렌더.
|
||||
activeMenu 파라미터는 기존 호출부 호환용 레거시 키(MenuView.LEGACY_ACTIVE_KEYS 브리지). -->
|
||||
<aside class="service-sidebar" th:fragment="sidebar(activeMenu)"
|
||||
th:with="grp=${menuView.activeGroup(activeMenu)}">
|
||||
<nav class="service-nav" th:if="${grp != null}">
|
||||
<!-- 마이페이지 그룹 프로필 -->
|
||||
<th:block th:if="${grp.section == 'MYPAGE'}">
|
||||
<div class="service-sidebar__profile">
|
||||
<div class="avatar">
|
||||
<svg viewBox="0 0 24 24" fill="currentColor">
|
||||
@@ -48,29 +20,14 @@
|
||||
</div>
|
||||
|
||||
<div class="service-sidebar__divider"></div>
|
||||
|
||||
<a th:href="@{/users}" th:classappend="${activeMenu == 'users'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item" sec:authorize="hasRole('ROLE_CORP_MANAGER')">개발자 관리</a>
|
||||
|
||||
<a th:href="@{/clients}" th:classappend="${activeMenu == 'apiKey'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item" sec:authorize="hasRole('ROLE_APP')">API 신청 관리</a>
|
||||
|
||||
<a th:href="@{/webhook}" th:classappend="${activeMenu == 'webhook'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item" sec:authorize="hasRole('ROLE_WEBHOOK')">Webhook 관리</a>
|
||||
|
||||
<a th:href="@{/statistics/api}"
|
||||
th:classappend="${activeMenu == 'statistics'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item" sec:authorize="hasRole('ROLE_APP')">이용통계</a>
|
||||
|
||||
<a th:href="@{/mypage}" th:classappend="${activeMenu == 'profile'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item">내정보 관리</a>
|
||||
|
||||
<a th:href="@{/password/change}"
|
||||
th:classappend="${activeMenu == 'password'} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item">비밀번호 변경</a>
|
||||
</th:block>
|
||||
|
||||
<a th:each="child : ${grp.children}" th:href="@{${child.path}}"
|
||||
th:target="${child.newWindow} ? '_blank' : null"
|
||||
th:classappend="${menuView.isActive(child, activeMenu)} ? 'service-nav__item--active' : ''"
|
||||
class="service-nav__item" th:text="${child.name}">메뉴</a>
|
||||
</nav>
|
||||
</aside>
|
||||
</body>
|
||||
|
||||
</html>
|
||||
</html>
|
||||
|
||||
@@ -25,10 +25,14 @@
|
||||
</p>
|
||||
|
||||
<!-- Password Input Field -->
|
||||
<!-- 초기 type=text: 이 팝업은 모든 페이지 DOM 에 상주하므로 type=password 로 두면
|
||||
브라우저가 페이지의 다른 텍스트 입력을 아이디 칸으로 오인해 계정 자동완성을 띄운다.
|
||||
팝업을 열 때 JS(custom-popups.js)가 password 로 전환하고 닫을 때 되돌린다. -->
|
||||
<div class="pop_input_group">
|
||||
<input type="password"
|
||||
<input type="text"
|
||||
id="passwordPopupInput"
|
||||
class="pop_input_field"
|
||||
autocomplete="new-password"
|
||||
placeholder="비밀번호를 입력하세요">
|
||||
<div id="passwordPopupError" class="error-message"></div>
|
||||
</div>
|
||||
|
||||
Reference in New Issue
Block a user