Admin Template
관리자용 컴포넌트관리자(MASTER)만 쓰는 화면에 쓰입니다.
회원·감사 로그·공통 코드 등 10개 탭을 담은 관리자 화면 템플릿입니다. 프론트 UI만 제공하며 데이터는 목 데이터입니다.
서비스에 바로 가져다 쓸 수 있는 관리자 화면 템플릿입니다. 회원, 감사 로그, 공통 코드, 이메일, 비속어, 게시판, 권한, 약관, 시스템, 접속 통계 10개 탭이 한 틀에 담겨 있습니다. 아래 미리보기에서 탭을 눌러 보고, 화면 전체로 보려면 버튼을 누르세요.
현재 프론트 UI만 작업된 상태입니다. 미리보기의 데이터는 목(mock) 데이터이고, 저장·삭제·CSV 내보내기는 이 화면 안에서만 동작합니다. 서버(API)와는 연결되어 있지 않습니다.
Preview
MeerkitAdmin
회원 관리
회원을 검색하고 계정 상태를 바꿉니다.
| 이름 | 이메일 | 역할 | 가입일 | 상태 | 관리 |
|---|---|---|---|---|---|
| 김미어 | kim@meerkit.dev | MASTER | 2026-03-02 | 활성 | |
| 이킷 | lee@meerkit.dev | OWNER | 2026-05-18 | 활성 | |
| 박작성 | park@meerkit.dev | WRITER | 2026-08-09 | 잠김 | |
| 최보기 | choi@meerkit.dev | VIEWER | 2026-11-01 | 활성 | |
| 정다온 | jung@meerkit.dev | WRITER | 2026-09-14 | 잠김 |
tsx
import { AdminKit } from "@/meerkit";
export default function Page() {
return <AdminKit serviceName="내 서비스" backHref="/" />;
}탭 구성
| 탭 | 하위 화면 | 할 수 있는 일 |
|---|---|---|
| 회원 | 회원 목록 · 잠긴 계정 · 탈퇴 회원 | 이름·이메일 검색, 역할·상태 필터, 계정 잠금과 해제, 탈퇴 회원 복구 |
| 감사 로그 | 전체 로그 · 권한 변경 · 로그인 이력 | 날짜·관리자·행위 필터, 목록을 CSV 파일로 내려받기 |
| 공통 코드 | 코드 묶음 목록 | 묶음별 코드 확인, 코드 추가, 사용 여부 켜고 끄기 |
| 이메일 | 메일 템플릿 목록 | 제목·본문 편집, 쓸 수 있는 변수 안내, 테스트 발송, 저장 |
| 비속어 | 금칙어 사전 · 예외 단어 | 단어 추가·삭제, 처리 방식 선택(마스킹·차단·검토), 등록 현황 카드 |
| 게시판 | 게시판 목록 · 게시물 관리 · 신고 처리 | 게시판 만들기와 사용 여부, 게시물 숨김, 신고 승인·반려 |
| 권한 | 역할별 권한 · 관리자 계정 | 역할×권한 표에서 칸을 눌러 켜고 끄기, 관리자 추가·해제 |
| 약관 | 약관 버전 목록 | 새 버전 작성과 시행일 예약, 시행 상태 확인 |
| 시스템 | 기본 정보 · 보안 · 점검 모드 | 서비스 이름·대표 이메일, 로그인 실패 허용 횟수·잠금 시간, 점검 모드 |
| 접속 통계 | 일별 · 주별 · 월별 | 방문자·DAU·MAU·평균 체류 카드와 방문자 막대 차트 |
Usage
AdminKit을 화면에 놓으면 됩니다. 관리자만 볼 수 있게 하려면 RequireRole로 감싸세요.
app/(service)/admin/page.tsx
import { AdminKit, RequireRole } from "@/meerkit";
export default function Page() {
return (
<RequireRole role="MASTER">
<AdminKit serviceName="내 서비스" backHref="/" />
</RequireRole>
);
}Props
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
serviceName | string | "Meerkit" | 헤더 왼쪽에 보이는 서비스 이름 |
backHref | string | "/" | 오른쪽 위 "서비스로" 링크가 가는 주소 |
backLabel | string | "서비스로" | 그 링크의 글자 |
className | string | - | 바깥 틀에 더할 클래스 |
서버와 연결하려면
- 각 탭의 목 데이터는
admin/kit/mock.ts에 모여 있습니다. 탭 안의useState초기값을 API 결과로 바꾸면 됩니다. - 멤버 목록은 이미 서버와 연결된
MemberDirectory컴포넌트가 따로 있습니다. 실제 회원 관리에는 그것을 쓰세요. - 색은 킷 토큰(
brand,destructive,muted)만 쓰므로 테마를 바꾸면 함께 바뀝니다.
