메뉴
Use when creating pages under src/app/(site)/(authorized)/admin/. Covers list/detail/edit/create page patterns with DataTable/DataView/DataForm, repositories under src/repositories/, request schemas under src/requests/admin/, and AdminPageHeader breadcrumbs.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when modifying Better Auth + Prisma authentication: src/libraries/auth.ts, src/libraries/auth-client.ts, src/proxy.ts, src/services/auth_service.ts, auth-related actions.ts, or prisma/schema.prisma auth models (User/Session/Account/Verification). Covers session helpers, URL/secret env resolution, DB TLS, and PUBLIC_PATHS.
Use when creating or modifying files under src/repositories/, src/models/, or src/requests/. Covers BaseRepository inheritance (Prisma/API/Local/Airtable/Dify), Zod schema placement, and separation between repository and schema files.
Use when changing this template's mail delivery backend, reviewing email env setup, switching between `ses` and `smtp`, or adding a new provider such as Resend, SendGrid, Postmark, or Mailgun. Covers EMAIL_PROVIDER routing, EMAIL_FROM priority, dynamic import for Node-only SDKs, and test coverage for both email.test.ts and Better Auth callback smoke.
Use when adding or changing translations in messages/ja.json or messages/en.json, using getTranslations/useTranslations, or updating next-intl configuration under src/i18n/. Covers message key hierarchy, Server/Client Component APIs, dynamic and rich-text patterns, and JSON duplicate-key pitfalls.
Use when adding or modifying pages under src/app, or components under src/components (atoms/molecules/organisms) in this Next.js App Router project. Covers Server/Client Component boundary, Atomic Design placement, Server Actions in actions.ts, URL-based state management, sidebar active-state, and shadcn-only atoms rule.
Use when changing this template's object storage backend, reviewing storage env setup, switching between `s3`, `s3-compatible`, and `gcs`, or adding a new provider such as R2, MinIO, Spaces, Azure Blob, or GCS. Covers STORAGE_PROVIDER routing, S3Provider reuse for compatible services, forcePathStyle handling, SYSTEM_AWS_* env, and separation from image-display CSP/EXTRA_REMOTE_IMAGE_URLS.
| name | admin-page-scaffolding |
| description | Use when creating pages under src/app/(site)/(authorized)/admin/. Covers list/detail/edit/create page patterns with DataTable/DataView/DataForm, repositories under src/repositories/, request schemas under src/requests/admin/, and AdminPageHeader breadcrumbs. |
/admin/ 配下の管理画面は AdminPageHeader + DataTable / DataView / DataForm の組み合わせで作る。参照実装は src/app/(site)/(authorized)/admin/users。正本は docs/guides/admin-pages.md。
src/app/(site)/(authorized)/admin/[entity]/ 配下にページを追加するWhen NOT to use: 管理画面 以外 のページは creating-pages-components。
admin/layout.tsx の requireAdminSession() で一括。各ページで重複実装しないoffset / limit / order / direction / query の共通クエリ名を使うsrc/repositories/[entity]_repository.ts 直下。src/repositories/admin/ は使わない（現行構成）src/requests/admin/ 配下: [entity]_create_request.ts / [entity]_update_request.tsAdminPageHeader / DataTable / DataView / DataForm の組み合わせで済ますnext-intl から取得"use server"; 付きで、request schema で入力検証してから repository / service を経由| 種別 | URL |
|---|---|
| 一覧 | /admin/[entities] |
| 詳細 | /admin/[entities]/[id] |
| 新規 | /admin/[entities]/create |
| 編集 | /admin/[entities]/[id]/edit |
src/components/molecules/AdminPageHeader — breadcrumbLinks / title / buttonssrc/components/organisms/DataTable — basePath / count / offset / limit / order / direction / query / data / structuresrc/components/organisms/DataView — data / structure（description list 風）src/components/organisms/DataForm — structure / submitAction（Promise<boolean> を返す async）DataForm の type: text / password / select_single / checkbox_multi / datetime
src/app/(site)/(authorized)/admin/users/ — 参照実装src/app/(site)/(authorized)/admin/layout.tsx — 権限チェックsrc/components/molecules/AdminPageHeader/ / src/components/organisms/{DataTable,DataView,DataForm}/src/repositories/user_repository.ts — Repository 実装例src/requests/admin/ — Request schema 配置先messages/ja.json / messages/en.json — Menu.Admin / エンティティ名追加docs/guides/admin-pages.md（一覧・詳細・作成/編集のコード例あり）data-access-repository Skilli18n-messages Skillsrc/app/(site)/(authorized)/admin/[entity]/ に一覧/詳細/create/edit を配置src/repositories/[entity]_repository.ts を追加・更新src/requests/admin/[entity]_create_request.ts / _update_request.ts を追加messages/ja.json / messages/en.json に Menu.Admin とエンティティ翻訳を追加DataTable のクエリ契約 (offset, limit, order, direction, query) に従うDataView を使うDataForm と submitAction を使うadmin/layout.tsx のメニューに導線を追加