Meerkit
Meerkit
HomeDocsComponentsAPI
GitHub

Getting Started

5
IntroductionInstallationProject StructureThemingDeployment

CLI

6
CLI Overviewinit & setupstart, stop & openstatus, check, env & logsdbadd, test & update

Core Concepts

5
AuthenticationRoles & PermissionsData ModelLogin LockoutSecurity

Guides

3
Protect a pageAdd a roleCall your own API

Components

24

사용자 화면12

Login FormSignup FormEmail VerificationTerms AgreementGoogle LoginPassword ResetProfile & PasswordNicknameAuth DialogProfile ImageUser AvatarUser Menu

관리자 화면6

Member TableMember DirectoryMember AI UsageMember AI Usage HistoryRole ManagerRole Select

공통5

Address FieldFile DropzoneLoadingDateRoute Guards

Admin Template

1

관리자 화면1

Admin Template

AI Components

4
AI Prompt InputThinking IndicatorAPI Key InputVoice

API

6
OverviewHealthAuthUsers · 내 정보Users · 관리자LLM

Reference

2
Hooks & StateFAQ

Admin Template

관리자용 컴포넌트관리자(MASTER)만 쓰는 화면에 쓰입니다.

회원·감사 로그·공통 코드 등 10개 탭을 담은 관리자 화면 템플릿입니다. 프론트 UI만 제공하며 데이터는 목 데이터입니다.

서비스에 바로 가져다 쓸 수 있는 관리자 화면 템플릿입니다. 회원, 감사 로그, 공통 코드, 이메일, 비속어, 게시판, 권한, 약관, 시스템, 접속 통계 10개 탭이 한 틀에 담겨 있습니다. 아래 미리보기에서 탭을 눌러 보고, 화면 전체로 보려면 버튼을 누르세요.

전체 화면으로 열기
현재 프론트 UI만 작업된 상태입니다. 미리보기의 데이터는 목(mock) 데이터이고, 저장·삭제·CSV 내보내기는 이 화면 안에서만 동작합니다. 서버(API)와는 연결되어 있지 않습니다.

Preview

MeerkitAdmin
문서로MK

회원 관리

회원을 검색하고 계정 상태를 바꿉니다.

이름이메일역할가입일상태관리
김미어kim@meerkit.devMASTER2026-03-02활성
이킷lee@meerkit.devOWNER2026-05-18활성
박작성park@meerkit.devWRITER2026-08-09잠김
최보기choi@meerkit.devVIEWER2026-11-01활성
정다온jung@meerkit.devWRITER2026-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

이름타입기본값설명
serviceNamestring"Meerkit"헤더 왼쪽에 보이는 서비스 이름
backHrefstring"/"오른쪽 위 "서비스로" 링크가 가는 주소
backLabelstring"서비스로"그 링크의 글자
classNamestring-바깥 틀에 더할 클래스

서버와 연결하려면

  • 각 탭의 목 데이터는 admin/kit/mock.ts에 모여 있습니다. 탭 안의 useState 초기값을 API 결과로 바꾸면 됩니다.
  • 멤버 목록은 이미 서버와 연결된 MemberDirectory 컴포넌트가 따로 있습니다. 실제 회원 관리에는 그것을 쓰세요.
  • 색은 킷 토큰(brand, destructive, muted)만 쓰므로 테마를 바꾸면 함께 바뀝니다.
Route GuardsAI Prompt Input
© Meerkit. All rights reserved.GitHub