feat(gateway): reorganize admin console navigation
This commit is contained in:
@@ -13,6 +13,7 @@ export default defineConfig({
|
||||
{ text: '개발자', link: '/developer/' },
|
||||
{ text: '플레이어', link: '/user/' },
|
||||
{ text: '아키텍처', link: '/architecture/overview' },
|
||||
{ text: '관리자 콘솔', link: '/admin-console' },
|
||||
{ text: '릴리스 운영', link: '/release-operations' },
|
||||
],
|
||||
sidebar: {
|
||||
@@ -23,6 +24,7 @@ export default defineConfig({
|
||||
{ text: '시작하기', link: '/developer/' },
|
||||
{ text: '아키텍처 개요', link: '/architecture/overview' },
|
||||
{ text: '런타임 아키텍처', link: '/architecture/runtime' },
|
||||
{ text: '관리자 콘솔', link: '/admin-console' },
|
||||
{ text: '릴리스 운영 매뉴얼', link: '/release-operations' },
|
||||
{ text: '요청·턴·저장 흐름', link: '/developer/request-turn-persistence' },
|
||||
{ text: '도메인 로직과 핵심 클래스', link: '/developer/domain-and-classes' },
|
||||
|
||||
@@ -0,0 +1,38 @@
|
||||
# 관리자 콘솔
|
||||
|
||||
Gateway 관리자 콘솔은 `/gateway/admin`에서 시작합니다. 공개 로비에서 관리자
|
||||
역할 또는 `admin.*` 범위 권한이 확인된 사용자에게만 진입 링크를 표시하며,
|
||||
실제 조회와 변경 권한은 각 Gateway API가 다시 검사합니다.
|
||||
|
||||
## 화면 구성
|
||||
|
||||
좌측 메뉴는 관리 책임을 다음과 같이 분리합니다.
|
||||
|
||||
| 메뉴 | 경로 | 책임 |
|
||||
| ------------- | ------------------------- | ------------------------------------------------------------------------------ |
|
||||
| 운영 개요 | `/gateway/admin` | 관리 영역 안내와 빠른 진입 |
|
||||
| 사용자 관리 | `/gateway/admin/users` | 계정 조회·생성, 권한, OAuth 유예, 제재, 아이콘 복구, 탈퇴 예약과 사용자별 이력 |
|
||||
| 서버 관리 | `/gateway/admin/servers` | profile 공개 정보, 계정 정책, 실행 상태와 게임 운영 동작 |
|
||||
| 버전 업데이트 | `/gateway/admin/releases` | profile DB 유지·초기화 배포, Gateway 릴리스·rollback과 작업 이력 |
|
||||
| 공지 · 접속 | `/gateway/admin/system` | 로비 공지와 관리자 세션 연결 |
|
||||
| 감사 로그 | `/gateway/admin/audit` | 관리자 조치 결과, 대상과 사유 조회 |
|
||||
|
||||
기존 `/gateway/admin/server-operations` 링크는 query string을 보존한 채
|
||||
`/gateway/admin/releases`로 이동합니다. 즐겨찾기와 이전 운영 보고서의 링크를
|
||||
즉시 깨뜨리지 않기 위한 호환 경로입니다.
|
||||
|
||||
## 운영 경계
|
||||
|
||||
- 사용자 페이지는 사용자 한 명에 대한 계정 변경과 사용자별 감사 이력만
|
||||
표시합니다. 전체 감사 원장은 감사 로그에서 별도로 조회합니다.
|
||||
- 서버 관리는 현재 실행 상태와 게임 운영 정책을 다룹니다. Git source 선택,
|
||||
migration, 시나리오 초기화와 rollback은 버전 업데이트에서 수행합니다.
|
||||
- `DEPLOY`는 현재 game DB를 유지하고 migration/build를 적용합니다. `RESET`은
|
||||
현재 시즌 데이터를 새 시나리오로 교체하며 장기 보존 자료를 유지합니다.
|
||||
- Gateway 릴리스는 profile 작업과 다른 전역 `admin.releases.manage` 권한을
|
||||
사용하며 외부 release-controller가 실행합니다.
|
||||
- 브라우저의 메뉴 노출은 편의 기능입니다. 권한 판단의 기준은 서버가 인증
|
||||
session에서 해석한 capability입니다.
|
||||
|
||||
상세 배포·복구 절차는 [릴리스 운영 매뉴얼](./release-operations.md)을
|
||||
따릅니다.
|
||||
@@ -15,6 +15,9 @@ hero:
|
||||
- theme: alt
|
||||
text: 릴리스 운영
|
||||
link: /release-operations
|
||||
- theme: alt
|
||||
text: 관리자 콘솔
|
||||
link: /admin-console
|
||||
|
||||
features:
|
||||
- title: 시스템 구조
|
||||
@@ -32,6 +35,8 @@ features:
|
||||
[시간과 턴](./user/time-and-turns.md)과
|
||||
[커맨드 목록](./user/command-catalog.generated.md)을 확인해 주세요. Profile과
|
||||
Gateway 배포는 [릴리스 운영 매뉴얼](./release-operations.md)을 따라 주세요.
|
||||
관리자 화면의 메뉴와 권한·운영 경계는
|
||||
[관리자 콘솔](./admin-console.md)에서 확인할 수 있습니다.
|
||||
게임 진행 시각과 운영 벽시계의 경계는
|
||||
[게임 시계](./architecture/game-clock.md)에 설명합니다.
|
||||
[패키지와 파일 경계](./architecture/package-boundaries.md)는 source import와
|
||||
|
||||
@@ -12,7 +12,8 @@ Gateway 전체는 별도 release-controller가 처리합니다.
|
||||
| Gateway API·frontend·orchestrator | Gateway 관리자 화면 | 외부 release-controller | `GatewayReleaseOperation`, `GatewayReleaseState` |
|
||||
| release-controller 자체 | 별도 CLI process | self-upgrade CLI | PM2 `sammo:release-controller` |
|
||||
|
||||
관리자 화면은 `/gateway/admin/server-operations`입니다. Profile 작업에는 해당
|
||||
관리자 화면은 `/gateway/admin/releases`입니다. 이전 경로
|
||||
`/gateway/admin/server-operations`는 호환성을 위해 새 화면으로 이동합니다. Profile 작업에는 해당
|
||||
profile의 `admin.profiles.manage` 권한이 필요합니다. Gateway 전체 릴리스에는
|
||||
profile 범위 권한과 별개인 전역 `admin.releases.manage` 권한이 필요합니다.
|
||||
일반 사용자와 권한이 없는 관리자는 Gateway 릴리스 영역을 사용할 수 없습니다.
|
||||
|
||||
Reference in New Issue
Block a user