From 084b34a6cc2de546b0b2e7be2b10a537a6a62ce8 Mon Sep 17 00:00:00 2001 From: kric_jspark Date: Fri, 3 Jul 2026 14:56:06 +0900 Subject: [PATCH] 260703_01_FST: First Commit --- .gitignore | 5 + .npmrc | 2 + README.md | 57 ++++++ package-lock.json | 176 ++++++++++++++++++ package.json | 33 ++++ src/args.ts | 130 +++++++++++++ src/cli.ts | 97 ++++++++++ src/constants.ts | 13 ++ src/create-project.ts | 114 ++++++++++++ src/files.ts | 64 +++++++ src/process.ts | 33 ++++ src/prompts.ts | 20 ++ src/types.ts | 38 ++++ templates/base/Jenkinsfile.template | 111 +++++++++++ templates/base/README.md.template | 35 ++++ templates/base/_env | 3 + templates/base/_env.development | 3 + templates/base/_env.example | 9 + templates/base/_env.local | 3 + templates/base/_env.production | 3 + templates/base/_gitignore | 21 +++ templates/base/_npmrc | 3 + templates/base/components.json | 22 +++ templates/base/eslint.config.mjs | 17 ++ templates/base/next.config.ts | 6 + templates/base/postcss.config.mjs | 7 + templates/base/public/favicon.ico | Bin 0 -> 15406 bytes templates/base/public/logo.png | Bin 0 -> 13544 bytes .../base/src/app/(pages)/(main)/layout.tsx | 11 ++ .../base/src/app/(pages)/(main)/page.tsx | 13 ++ templates/base/src/app/(pages)/login/page.tsx | 81 ++++++++ .../base/src/app/(pages)/logout/page.tsx | 20 ++ .../src/app/api/example/[[...slug]]/route.ts | 73 ++++++++ .../src/app/api/login/[[...slug]]/route.ts | 32 ++++ .../src/app/api/logout/[[...slug]]/route.ts | 27 +++ templates/base/src/app/globals.css | 87 +++++++++ templates/base/src/app/layout.tsx | 21 +++ templates/base/src/app/not-found.tsx | 11 ++ .../src/components/app-shell/AppHeader.tsx | 40 ++++ .../components/app-shell/AppMainLayout.tsx | 44 +++++ .../src/components/app-shell/AppPageTitle.tsx | 10 + .../src/components/app-shell/AppSidebar.tsx | 15 ++ .../app-shell/LoadingOverlayAdapter.tsx | 12 ++ .../base/src/components/app-shell/index.ts | 5 + .../src/components/providers/AppProvider.tsx | 18 ++ .../components/providers/QueryLoadingSync.tsx | 10 + templates/base/src/config/common.config.ts | 7 + templates/base/src/config/menu.data.ts | 7 + templates/base/src/config/menu.type.ts | 4 + templates/base/src/const/common.const.ts | 1 + templates/base/src/hooks/useAuth.ts | 38 ++++ templates/base/src/hooks/useDialog.ts | 23 +++ templates/base/src/hooks/useLoading.ts | 7 + templates/base/src/hooks/useStorage.ts | 17 ++ templates/base/src/lib/env.client.ts | 8 + templates/base/src/lib/env.server.ts | 7 + templates/base/src/lib/http-client.ts | 4 + templates/base/src/lib/http-server.ts | 13 ++ templates/base/src/lib/security.ts | 14 ++ templates/base/src/lib/utils.ts | 1 + templates/base/src/proxy.ts | 10 + templates/base/src/query/auth.ts | 41 ++++ templates/base/src/query/example.ts | 56 ++++++ templates/base/src/query/key/keys.ts | 6 + .../base/src/store/cookie/client-cookie.ts | 9 + .../base/src/store/cookie/cookie-keys.ts | 5 + templates/base/src/store/jotai/auth.ts | 2 + templates/base/src/store/jotai/dialog.ts | 1 + templates/base/src/store/jotai/loading.ts | 8 + .../base/src/store/storage/secure-storage.ts | 27 +++ .../base/src/store/storage/storage-keys.ts | 8 + templates/base/src/types/common.ts | 12 ++ templates/base/tsconfig.json | 21 +++ tsconfig.json | 24 +++ 74 files changed, 1936 insertions(+) create mode 100644 .gitignore create mode 100644 .npmrc create mode 100644 README.md create mode 100644 package-lock.json create mode 100644 package.json create mode 100644 src/args.ts create mode 100644 src/cli.ts create mode 100644 src/constants.ts create mode 100644 src/create-project.ts create mode 100644 src/files.ts create mode 100644 src/process.ts create mode 100644 src/prompts.ts create mode 100644 src/types.ts create mode 100644 templates/base/Jenkinsfile.template create mode 100644 templates/base/README.md.template create mode 100644 templates/base/_env create mode 100644 templates/base/_env.development create mode 100644 templates/base/_env.example create mode 100644 templates/base/_env.local create mode 100644 templates/base/_env.production create mode 100644 templates/base/_gitignore create mode 100644 templates/base/_npmrc create mode 100644 templates/base/components.json create mode 100644 templates/base/eslint.config.mjs create mode 100644 templates/base/next.config.ts create mode 100644 templates/base/postcss.config.mjs create mode 100644 templates/base/public/favicon.ico create mode 100644 templates/base/public/logo.png create mode 100644 templates/base/src/app/(pages)/(main)/layout.tsx create mode 100644 templates/base/src/app/(pages)/(main)/page.tsx create mode 100644 templates/base/src/app/(pages)/login/page.tsx create mode 100644 templates/base/src/app/(pages)/logout/page.tsx create mode 100644 templates/base/src/app/api/example/[[...slug]]/route.ts create mode 100644 templates/base/src/app/api/login/[[...slug]]/route.ts create mode 100644 templates/base/src/app/api/logout/[[...slug]]/route.ts create mode 100644 templates/base/src/app/globals.css create mode 100644 templates/base/src/app/layout.tsx create mode 100644 templates/base/src/app/not-found.tsx create mode 100644 templates/base/src/components/app-shell/AppHeader.tsx create mode 100644 templates/base/src/components/app-shell/AppMainLayout.tsx create mode 100644 templates/base/src/components/app-shell/AppPageTitle.tsx create mode 100644 templates/base/src/components/app-shell/AppSidebar.tsx create mode 100644 templates/base/src/components/app-shell/LoadingOverlayAdapter.tsx create mode 100644 templates/base/src/components/app-shell/index.ts create mode 100644 templates/base/src/components/providers/AppProvider.tsx create mode 100644 templates/base/src/components/providers/QueryLoadingSync.tsx create mode 100644 templates/base/src/config/common.config.ts create mode 100644 templates/base/src/config/menu.data.ts create mode 100644 templates/base/src/config/menu.type.ts create mode 100644 templates/base/src/const/common.const.ts create mode 100644 templates/base/src/hooks/useAuth.ts create mode 100644 templates/base/src/hooks/useDialog.ts create mode 100644 templates/base/src/hooks/useLoading.ts create mode 100644 templates/base/src/hooks/useStorage.ts create mode 100644 templates/base/src/lib/env.client.ts create mode 100644 templates/base/src/lib/env.server.ts create mode 100644 templates/base/src/lib/http-client.ts create mode 100644 templates/base/src/lib/http-server.ts create mode 100644 templates/base/src/lib/security.ts create mode 100644 templates/base/src/lib/utils.ts create mode 100644 templates/base/src/proxy.ts create mode 100644 templates/base/src/query/auth.ts create mode 100644 templates/base/src/query/example.ts create mode 100644 templates/base/src/query/key/keys.ts create mode 100644 templates/base/src/store/cookie/client-cookie.ts create mode 100644 templates/base/src/store/cookie/cookie-keys.ts create mode 100644 templates/base/src/store/jotai/auth.ts create mode 100644 templates/base/src/store/jotai/dialog.ts create mode 100644 templates/base/src/store/jotai/loading.ts create mode 100644 templates/base/src/store/storage/secure-storage.ts create mode 100644 templates/base/src/store/storage/storage-keys.ts create mode 100644 templates/base/src/types/common.ts create mode 100644 templates/base/tsconfig.json create mode 100644 tsconfig.json diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..3818622 --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +node_modules/ +dist/ +*.tgz +.idea/ +*.iml diff --git a/.npmrc b/.npmrc new file mode 100644 index 0000000..6dacdc0 --- /dev/null +++ b/.npmrc @@ -0,0 +1,2 @@ +@kri:registry=https://gitea.kric.com/api/packages/KRi/npm/ +//gitea.kric.com/api/packages/KRi/npm/:_authToken=${GITEA_NPM_TOKEN} diff --git a/README.md b/README.md new file mode 100644 index 0000000..c941d12 --- /dev/null +++ b/README.md @@ -0,0 +1,57 @@ +# @kri/create-next-app + +KRI 표준 Next.js 프로젝트 생성 CLI입니다. + +## 사전 준비 + +사용자 npm 설정에서 `@kri` scope와 Gitea 토큰이 설정되어 있어야 합니다. + +```ini +@kri:registry=https://gitea.kric.com/api/packages/KRi/npm/ +//gitea.kric.com/api/packages/KRi/npm/:_authToken=${GITEA_NPM_TOKEN} +``` + +## 개발 + +```powershell +npm install +npm run typecheck +npm run build +node .\dist\cli.js test-front --yes --skip-install +``` + +## 사용 + +```powershell +npx @kri/create-next-app survey-front +``` + +질문 없이 기본값으로 생성: + +```powershell +npx @kri/create-next-app survey-front --yes +``` + +주요 옵션은 `--help`로 확인합니다. + +## 생성 과정 + +1. 표준 템플릿 복사 +2. Next.js 및 shadcn 호환 npm 의존성 설치 +3. `@kri/common@latest` 설치 후 exact 버전 기록 +4. KRI UI Registry 9개 항목 설치 +5. TypeScript 검사 +6. Next.js production build + +UI Registry: `https://ui-registry.kric.com/r` + +## 생성되는 환경 파일 + +`.env`, `.env.local`, `.env.development`, `.env.production`, `.env.example`을 생성합니다. `.env.local`과 `.env`는 기본적으로 Git에서 제외되며, `.env.development`와 `.env.production`은 Jenkins 빌드에 사용할 수 있도록 추적 가능합니다. + + +## 호환성 정책 + +- `@kri/common`은 프로젝트 생성 시점의 최신 버전을 설치하고 exact 버전으로 기록합니다. +- Next.js 생태계 호환성을 위해 생성 프로젝트의 TypeScript는 최신 5.x, ESLint는 최신 9.x를 사용합니다. +- shadcn 기본 컴포넌트가 사용하는 `class-variance-authority`, `clsx`, `tailwind-merge`, `lucide-react`를 기본 의존성에 포함합니다. diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..fd3856f --- /dev/null +++ b/package-lock.json @@ -0,0 +1,176 @@ +{ + "name": "@kri/create-next-app", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "@kri/create-next-app", + "version": "0.1.0", + "license": "UNLICENSED", + "bin": { + "kri-create-next-app": "dist/cli.js" + }, + "devDependencies": { + "@types/node": "latest", + "rimraf": "latest", + "typescript": "latest" + }, + "engines": { + "node": ">=20" + } + }, + "node_modules/@types/node": { + "version": "26.1.0", + "resolved": "https://registry.npmjs.org/@types/node/-/node-26.1.0.tgz", + "integrity": "sha512-O0A1G3xPGy4w7AgQdAQYUlQ+BKk2Oovw8eRpofyp5KdBZULnbe+WqaOVNrm705SHphCiG4XHsACrSmPu1f+Kgw==", + "dev": true, + "license": "MIT", + "dependencies": { + "undici-types": "~8.3.0" + } + }, + "node_modules/balanced-match": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", + "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", + "dev": true, + "license": "MIT", + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/brace-expansion": { + "version": "5.0.7", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.7.tgz", + "integrity": "sha512-7oFy703dxfY3/NLxC1fh2SUCQ0H9rmAY+5EpDVfXjUTTs+HEwR2nYaqLv+GWcTsumwxPfiz6CzCNkwXwBUwqCA==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^4.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/glob": { + "version": "13.0.6", + "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz", + "integrity": "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "minimatch": "^10.2.2", + "minipass": "^7.1.3", + "path-scurry": "^2.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/lru-cache": { + "version": "11.5.1", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.5.1.tgz", + "integrity": "sha512-RPimw/7aMdv2oqRrxKwvZXcPfwBrn/JZ2xYcY9Hus/6LaS3VOAKVWKWgNLCFSiOm1ESXinjsDlidVU7JlnCN2A==", + "dev": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, + "node_modules/minimatch": { + "version": "10.2.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz", + "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "brace-expansion": "^5.0.5" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/minipass": { + "version": "7.1.3", + "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz", + "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==", + "dev": true, + "license": "BlueOak-1.0.0", + "engines": { + "node": ">=16 || 14 >=14.17" + } + }, + "node_modules/package-json-from-dist": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz", + "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==", + "dev": true, + "license": "BlueOak-1.0.0" + }, + "node_modules/path-scurry": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.2.tgz", + "integrity": "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "lru-cache": "^11.0.0", + "minipass": "^7.1.2" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/rimraf": { + "version": "6.1.3", + "resolved": "https://registry.npmjs.org/rimraf/-/rimraf-6.1.3.tgz", + "integrity": "sha512-LKg+Cr2ZF61fkcaK1UdkH2yEBBKnYjTyWzTJT6KNPcSPaiT7HSdhtMXQuN5wkTX0Xu72KQ1l8S42rlmexS2hSA==", + "dev": true, + "license": "BlueOak-1.0.0", + "dependencies": { + "glob": "^13.0.3", + "package-json-from-dist": "^1.0.1" + }, + "bin": { + "rimraf": "dist/esm/bin.mjs" + }, + "engines": { + "node": "20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/typescript": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.3.tgz", + "integrity": "sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/undici-types": { + "version": "8.3.0", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-8.3.0.tgz", + "integrity": "sha512-j375ScV60dom+YkPFIfTLcOiPxkN/buHz5GobjLhixFuANaNs3C9l4GmrWqejgXWJ7BbJcFYpTEUkS1Ge8bpZQ==", + "dev": true, + "license": "MIT" + } + } +} diff --git a/package.json b/package.json new file mode 100644 index 0000000..2291a25 --- /dev/null +++ b/package.json @@ -0,0 +1,33 @@ +{ + "name": "@kri/create-next-app", + "version": "0.1.0", + "description": "Create a KRI standard Next.js application", + "type": "module", + "bin": { + "kri-create-next-app": "./dist/cli.js" + }, + "files": [ + "dist", + "templates", + "README.md" + ], + "scripts": { + "clean": "rimraf dist", + "build": "npm run clean && tsc -p tsconfig.json", + "typecheck": "tsc -p tsconfig.json --noEmit", + "prepack": "npm run build" + }, + "engines": { + "node": ">=20" + }, + "devDependencies": { + "@types/node": "latest", + "rimraf": "latest", + "typescript": "latest" + }, + "publishConfig": { + "registry": "https://gitea.kric.com/api/packages/KRi/npm/", + "access": "restricted" + }, + "license": "UNLICENSED" +} diff --git a/src/args.ts b/src/args.ts new file mode 100644 index 0000000..93120ea --- /dev/null +++ b/src/args.ts @@ -0,0 +1,130 @@ +import path from "node:path"; +import type { ParsedArguments } from "./types.js"; + +const requireValue = (args: string[], index: number, option: string): string => { + const value = args[index + 1]; + if (!value || value.startsWith("-")) { + throw new Error(`${option} 옵션의 값이 필요합니다.`); + } + return value; +}; + +export function parseArguments(argv: string[]): ParsedArguments { + const parsed: ParsedArguments = { + yes: false, + install: true, + installUi: true, + build: true, + jenkins: true, + force: false, + help: false, + }; + + for (let index = 0; index < argv.length; index += 1) { + const arg = argv[index]; + + if (!arg.startsWith("-")) { + if (parsed.projectName) throw new Error(`알 수 없는 인자입니다: ${arg}`); + parsed.projectName = arg; + continue; + } + + switch (arg) { + case "--help": + case "-h": + parsed.help = true; + break; + case "--yes": + case "-y": + parsed.yes = true; + break; + case "--force": + parsed.force = true; + break; + case "--skip-install": + parsed.install = false; + parsed.installUi = false; + parsed.build = false; + break; + case "--skip-ui": + parsed.installUi = false; + break; + case "--skip-build": + parsed.build = false; + break; + case "--no-jenkins": + parsed.jenkins = false; + break; + case "--target-dir": + parsed.targetDir = path.resolve(requireValue(argv, index, arg)); + index += 1; + break; + case "--display-name": + parsed.displayName = requireValue(argv, index, arg); + index += 1; + break; + case "--description": + parsed.description = requireValue(argv, index, arg); + index += 1; + break; + case "--port": { + const value = Number(requireValue(argv, index, arg)); + if (!Number.isInteger(value) || value < 1 || value > 65535) { + throw new Error("--port는 1~65535 사이의 정수여야 합니다."); + } + parsed.port = value; + index += 1; + break; + } + case "--repo-url": + parsed.repoUrl = requireValue(argv, index, arg); + index += 1; + break; + case "--app-root": + parsed.appRoot = requireValue(argv, index, arg); + index += 1; + break; + case "--service-name": + parsed.serviceName = requireValue(argv, index, arg); + index += 1; + break; + case "--branch": + parsed.branch = requireValue(argv, index, arg); + index += 1; + break; + case "--agent-label": + parsed.agentLabel = requireValue(argv, index, arg); + index += 1; + break; + default: + throw new Error(`알 수 없는 옵션입니다: ${arg}`); + } + } + + return parsed; +} + +export function printHelp(): void { + console.log(` +사용법: + npx @kri/create-next-app [options] + +옵션: + --display-name 화면 표시 이름 + --description 프로젝트 설명 + --port 개발/실행 포트 (기본 4000) + --repo-url Gitea 저장소 URL + --app-root Ubuntu 배포 경로 + --service-name systemd 서비스 이름 + --branch 배포 브랜치 (기본 master) + --agent-label