260703_01_FST: First Commit

This commit is contained in:
2026-07-03 14:56:06 +09:00
commit 084b34a6cc
74 changed files with 1936 additions and 0 deletions

5
.gitignore vendored Normal file
View File

@@ -0,0 +1,5 @@
node_modules/
dist/
*.tgz
.idea/
*.iml

2
.npmrc Normal file
View File

@@ -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}

57
README.md Normal file
View File

@@ -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`를 기본 의존성에 포함합니다.

176
package-lock.json generated Normal file
View File

@@ -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"
}
}
}

33
package.json Normal file
View File

@@ -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"
}

130
src/args.ts Normal file
View File

@@ -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 <project-name> [options]
옵션:
--display-name <name> 화면 표시 이름
--description <text> 프로젝트 설명
--port <number> 개발/실행 포트 (기본 4000)
--repo-url <url> Gitea 저장소 URL
--app-root <path> Ubuntu 배포 경로
--service-name <name> systemd 서비스 이름
--branch <name> 배포 브랜치 (기본 master)
--agent-label <label> Jenkins Agent label (기본 ubuntu-build)
--target-dir <path> 생성 경로
--yes, -y 질문 없이 기본값 사용
--skip-install npm 설치, UI 설치, 검증 생략
--skip-ui KRI UI Registry 설치 생략
--skip-build typecheck/build 생략
--no-jenkins Jenkinsfile 생성 안 함
--force 비어 있지 않은 대상 폴더 사용
--help, -h 도움말
`);
}

97
src/cli.ts Normal file
View File

@@ -0,0 +1,97 @@
#!/usr/bin/env node
import path from "node:path";
import process from "node:process";
import { parseArguments, printHelp } from "./args.js";
import { createProject } from "./create-project.js";
import { ask, confirm } from "./prompts.js";
import type { CliOptions } from "./types.js";
const PROJECT_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
function validateProjectName(name: string): string {
const normalized = name.trim();
if (!PROJECT_NAME_PATTERN.test(normalized)) {
throw new Error("프로젝트명은 npm package 이름으로 사용할 수 있는 영문 소문자, 숫자, -, _, . 조합이어야 합니다.");
}
return normalized;
}
async function resolveOptions(): Promise<CliOptions> {
const parsed = parseArguments(process.argv.slice(2));
if (parsed.help) {
printHelp();
process.exit(0);
}
let projectName = parsed.projectName;
if (!projectName && !parsed.yes) projectName = await ask("프로젝트명");
if (!projectName) throw new Error("프로젝트명이 필요합니다.");
projectName = validateProjectName(projectName);
const displayName = parsed.displayName
?? (parsed.yes ? projectName : await ask("프로젝트 표시 이름", projectName));
const description = parsed.description
?? (parsed.yes ? `${displayName} 시스템` : await ask("프로젝트 설명", `${displayName} 시스템`));
const portText = parsed.port
? String(parsed.port)
: parsed.yes
? "4000"
: await ask("개발/실행 포트", "4000");
const port = Number(portText);
if (!Number.isInteger(port) || port < 1 || port > 65535) throw new Error("포트는 1~65535 사이의 정수여야 합니다.");
const repoDefault = `https://gitea.kric.com/Project/${projectName}.git`;
const repoUrl = parsed.repoUrl ?? (parsed.yes ? repoDefault : await ask("Gitea Repository URL", repoDefault));
const appRootDefault = `/opt/project/${projectName}`;
const appRoot = parsed.appRoot ?? (parsed.yes ? appRootDefault : await ask("Ubuntu 배포 경로", appRootDefault));
const serviceDefault = `${projectName}.service`;
const serviceName = parsed.serviceName ?? (parsed.yes ? serviceDefault : await ask("systemd 서비스 이름", serviceDefault));
const branch = parsed.branch ?? "master";
const agentLabel = parsed.agentLabel ?? "ubuntu-build";
const targetDir = parsed.targetDir ?? path.resolve(process.cwd(), projectName);
const jenkins = parsed.yes ? parsed.jenkins : parsed.jenkins && await confirm("Jenkinsfile을 생성할까요?", true);
return {
projectName,
targetDir,
displayName,
description,
port,
repoUrl,
appRoot,
serviceName,
branch,
agentLabel,
yes: parsed.yes,
install: parsed.install,
installUi: parsed.installUi,
build: parsed.build,
jenkins,
force: parsed.force,
};
}
async function main(): Promise<void> {
const major = Number(process.versions.node.split(".")[0]);
if (major < 20) throw new Error(`Node.js 20 이상이 필요합니다. 현재: ${process.version}`);
const options = await resolveOptions();
console.log(`
[KRI] ${options.projectName} 생성 시작`);
console.log(`[KRI] target=${options.targetDir}`);
await createProject(options);
console.log("\n[KRI] 프로젝트 생성 완료");
console.log(` cd ${options.targetDir}`);
if (!options.install) console.log(" npm install");
console.log(` npm run dev`);
}
main().catch((error: unknown) => {
const message = error instanceof Error ? error.message : String(error);
console.error(`
[ERROR] ${message}`);
process.exitCode = 1;
});

13
src/constants.ts Normal file
View File

@@ -0,0 +1,13 @@
export const REGISTRY_BASE_URL = "https://ui-registry.kric.com/r";
export const KRI_REGISTRY_ITEMS = [
"kri-select",
"kri-date-range-picker",
"kri-password",
"kri-auto-complete",
"kri-data-table",
"kri-loading-overlay",
"kri-editor",
"kri-layout",
"kri-dialog",
] as const;

114
src/create-project.ts Normal file
View File

@@ -0,0 +1,114 @@
import { fileURLToPath } from "node:url";
import path from "node:path";
import { writeFile } from "node:fs/promises";
import { KRI_REGISTRY_ITEMS, REGISTRY_BASE_URL } from "./constants.js";
import { copyTemplate, ensureTargetDirectory, removeJenkinsfile, replacePlaceholders } from "./files.js";
import { run } from "./process.js";
import type { CliOptions } from "./types.js";
const currentDir = path.dirname(fileURLToPath(import.meta.url));
const templateDir = path.resolve(currentDir, "../templates/base");
function packageJson(options: CliOptions) {
return {
name: options.projectName,
version: "0.1.0",
private: true,
scripts: {
dev: `next dev -p ${options.port}`,
build: "next build",
start: `next start -p ${options.port}`,
lint: "eslint",
typecheck: "tsc --noEmit",
},
dependencies: {
"@kri/common": "latest",
"@tanstack/react-query": "latest",
"class-variance-authority": "latest",
clsx: "latest",
jotai: "latest",
"lucide-react": "latest",
next: "latest",
react: "latest",
"react-dom": "latest",
"server-only": "latest",
sonner: "latest",
"tailwind-merge": "latest",
},
devDependencies: {
"@tailwindcss/postcss": "latest",
"@types/node": "latest",
"@types/react": "latest",
"@types/react-dom": "latest",
"babel-plugin-react-compiler": "latest",
eslint: "^9",
"eslint-config-next": "latest",
tailwindcss: "latest",
"tw-animate-css": "latest",
typescript: "^5",
},
};
}
export async function createProject(options: CliOptions): Promise<void> {
await ensureTargetDirectory(options.targetDir, options.force);
await copyTemplate(templateDir, options.targetDir);
if (!options.jenkins) await removeJenkinsfile(options.targetDir);
await replacePlaceholders(options.targetDir, {
"__PROJECT_NAME__": options.projectName,
"__DISPLAY_NAME__": options.displayName,
"__DESCRIPTION__": options.description,
"__PORT__": String(options.port),
"__REPO_URL__": options.repoUrl,
"__APP_ROOT__": options.appRoot,
"__SERVICE_NAME__": options.serviceName,
"__BRANCH__": options.branch,
"__AGENT_LABEL__": options.agentLabel,
});
await writeFile(
path.join(options.targetDir, "package.json"),
`${JSON.stringify(packageJson(options), null, 2)}
`,
"utf8",
);
if (!options.install) {
console.log("[SKIP] npm install");
return;
}
console.log("\n[1/4] npm 의존성 설치");
await run("npm", ["install"], options.targetDir);
console.log("\n[2/4] 최신 @kri/common 설치");
await run("npm", ["install", "--save-exact", "@kri/common@latest"], options.targetDir);
if (options.installUi) {
console.log("\n[3/4] shadcn 및 KRI UI Registry 설치");
await run("npx", ["--yes", "shadcn@latest", "add", "card", "--yes", "--overwrite"], options.targetDir);
for (const item of KRI_REGISTRY_ITEMS) {
await run(
"npx",
["--yes", "shadcn@latest", "add", `${REGISTRY_BASE_URL}/${item}.json`, "--yes", "--overwrite"],
options.targetDir,
);
}
} else {
console.log("[SKIP] UI Registry 설치");
}
if (options.build) {
if (!options.installUi) {
console.warn("[WARN] --skip-ui 때문에 typecheck/build를 생략합니다.");
return;
}
console.log("\n[4/4] TypeScript 및 production build 검증");
await run("npm", ["run", "typecheck"], options.targetDir);
await run("npm", ["run", "build"], options.targetDir);
} else {
console.log("[SKIP] typecheck/build");
}
}

64
src/files.ts Normal file
View File

@@ -0,0 +1,64 @@
import { cp, mkdir, readdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
import path from "node:path";
const RENAMES: Record<string, string> = {
"_gitignore": ".gitignore",
"_npmrc": ".npmrc",
"_env": ".env",
"_env.local": ".env.local",
"_env.development": ".env.development",
"_env.production": ".env.production",
"_env.example": ".env.example",
"README.md.template": "README.md",
"Jenkinsfile.template": "Jenkinsfile",
};
export async function ensureTargetDirectory(targetDir: string, force: boolean): Promise<void> {
await mkdir(targetDir, { recursive: true });
const entries = await readdir(targetDir);
if (entries.length > 0 && !force) {
throw new Error(`대상 폴더가 비어 있지 않습니다: ${targetDir}
--force 옵션을 사용하거나 빈 폴더를 선택하세요.`);
}
}
export async function copyTemplate(templateDir: string, targetDir: string): Promise<void> {
await cp(templateDir, targetDir, { recursive: true, force: true });
for (const [sourceName, targetName] of Object.entries(RENAMES)) {
const source = path.join(targetDir, sourceName);
try {
await stat(source);
await rename(source, path.join(targetDir, targetName));
} catch {
// 선택 파일은 없을 수 있습니다.
}
}
}
export async function removeJenkinsfile(targetDir: string): Promise<void> {
await rm(path.join(targetDir, "Jenkinsfile"), { force: true });
}
export async function replacePlaceholders(rootDir: string, replacements: Record<string, string>): Promise<void> {
const visit = async (directory: string): Promise<void> => {
const entries = await readdir(directory, { withFileTypes: true });
for (const entry of entries) {
const fullPath = path.join(directory, entry.name);
if (entry.isDirectory()) {
await visit(fullPath);
continue;
}
if (!entry.isFile() || /\.(png|ico|jpg|jpeg|gif|webp)$/i.test(entry.name)) continue;
let content = await readFile(fullPath, "utf8");
for (const [key, value] of Object.entries(replacements)) {
content = content.split(key).join(value);
}
await writeFile(fullPath, content, "utf8");
}
};
await visit(rootDir);
}

33
src/process.ts Normal file
View File

@@ -0,0 +1,33 @@
import { spawn } from "node:child_process";
export async function run(command: string, args: string[], cwd: string): Promise<void> {
const isWindows = process.platform === "win32";
const executable = isWindows ? (process.env.ComSpec ?? "cmd.exe") : command;
const executableArgs = isWindows
? ["/d", "/s", "/c", `${command}.cmd`, ...args]
: args;
await new Promise<void>((resolve, reject) => {
const child = spawn(executable, executableArgs, {
cwd,
env: process.env,
stdio: "inherit",
shell: false,
windowsHide: true,
});
child.once("error", reject);
child.once("exit", (code, signal) => {
if (code === 0) {
resolve();
return;
}
reject(
new Error(
`${command} ${args.join(" ")} 실패 (code=${code ?? "null"}, signal=${signal ?? "none"})`,
),
);
});
});
}

20
src/prompts.ts Normal file
View File

@@ -0,0 +1,20 @@
import { createInterface } from "node:readline/promises";
import { stdin as input, stdout as output } from "node:process";
export async function ask(question: string, defaultValue?: string): Promise<string> {
const rl = createInterface({ input, output });
try {
const suffix = defaultValue ? ` (${defaultValue})` : "";
const answer = (await rl.question(`${question}${suffix}: `)).trim();
return answer || defaultValue || "";
} finally {
rl.close();
}
}
export async function confirm(question: string, defaultValue = true): Promise<boolean> {
const defaultText = defaultValue ? "Y/n" : "y/N";
const answer = (await ask(`${question} [${defaultText}]`)).toLowerCase();
if (!answer) return defaultValue;
return answer === "y" || answer === "yes" || answer === "예";
}

38
src/types.ts Normal file
View File

@@ -0,0 +1,38 @@
export interface CliOptions {
projectName: string;
targetDir: string;
displayName: string;
description: string;
port: number;
repoUrl: string;
appRoot: string;
serviceName: string;
branch: string;
agentLabel: string;
yes: boolean;
install: boolean;
installUi: boolean;
build: boolean;
jenkins: boolean;
force: boolean;
}
export interface ParsedArguments {
projectName?: string;
targetDir?: string;
displayName?: string;
description?: string;
port?: number;
repoUrl?: string;
appRoot?: string;
serviceName?: string;
branch?: string;
agentLabel?: string;
yes: boolean;
install: boolean;
installUi: boolean;
build: boolean;
jenkins: boolean;
force: boolean;
help: boolean;
}

View File

@@ -0,0 +1,111 @@
pipeline {
agent none
environment {
AGENT_LABEL = '__AGENT_LABEL__'
REPO_URL = '__REPO_URL__'
BRANCH = '__BRANCH__'
SERVICE_NAME = '__SERVICE_NAME__'
APP_ROOT = '__APP_ROOT__'
BUILD_ENV_SOURCE = '.env.production'
BUILD_ENV_TARGET = '.env.production'
}
stages {
stage('Git Pull') {
agent { label "${env.AGENT_LABEL}" }
steps {
deleteDir()
dir('src') {
git branch: env.BRANCH, url: env.REPO_URL
sh '''#!/usr/bin/env bash
set -euo pipefail
echo "[INFO] git=$(git --version)"
echo "[INFO] branch=$(git rev-parse --abbrev-ref HEAD)"
echo "[INFO] commit=$(git rev-parse --short HEAD)"
'''
}
stash name: 'src', includes: 'src/**,src/.*,src/**/.*', excludes: 'src/.git/**'
}
}
stage('Build') {
agent { label "${env.AGENT_LABEL}" }
steps {
deleteDir()
unstash 'src'
dir('src') {
sh '''#!/usr/bin/env bash
set -euo pipefail
: "${BUILD_ENV_SOURCE:?BUILD_ENV_SOURCE is not set}"
: "${BUILD_ENV_TARGET:?BUILD_ENV_TARGET is not set}"
test -f "${BUILD_ENV_SOURCE}"
if [ "${BUILD_ENV_SOURCE}" != "${BUILD_ENV_TARGET}" ]; then
rm -f "${BUILD_ENV_TARGET}" .env.local .env.production.local || true
cp -f "${BUILD_ENV_SOURCE}" "${BUILD_ENV_TARGET}"
else
rm -f .env.local .env.production.local || true
fi
rm -rf .next out artifact.tgz
npm ci
nice -n 10 npm run build
test -f .next/standalone/server.js
test -d .next/static
test -f .next/BUILD_ID
mkdir -p out
cp -a .next/standalone/. out/
mkdir -p out/.next
cp -a .next/static out/.next/static
cp -a .next/BUILD_ID out/.next/BUILD_ID
cp -f "${BUILD_ENV_TARGET}" out/.env.production
if [ -d public ]; then
cp -a public out/public
fi
tar -czf artifact.tgz -C out .
'''
stash name: 'artifact', includes: 'artifact.tgz'
}
}
}
stage('Apply + Deploy (Local)') {
agent { label "${env.AGENT_LABEL}" }
steps {
deleteDir()
unstash 'artifact'
sh '''#!/usr/bin/env bash
set -euo pipefail
mkdir -p "${APP_ROOT}/releases"
TS="$(date +%Y%m%d_%H%M%S)"
RELEASE_DIR="${APP_ROOT}/releases/${TS}"
mkdir -p "${RELEASE_DIR}"
tar -xzf artifact.tgz -C "${RELEASE_DIR}"
ln -sfn "${RELEASE_DIR}" "${APP_ROOT}/current"
test -f "${APP_ROOT}/current/server.js"
test -d "${APP_ROOT}/current/.next/static"
test -f "${APP_ROOT}/current/.next/BUILD_ID"
'''
}
}
stage('Service Restart') {
agent { label "${env.AGENT_LABEL}" }
steps {
sh '''#!/usr/bin/env bash
set -euo pipefail
sudo -n /usr/bin/systemctl restart "$SERVICE_NAME"
sudo -n /usr/bin/systemctl status "$SERVICE_NAME" --no-pager -l | head -n 80
'''
}
}
}
}

View File

@@ -0,0 +1,35 @@
# __DISPLAY_NAME__
__DESCRIPTION__
## 실행
```powershell
npm run dev
```
기본 포트: `__PORT__`
## 환경변수
프로젝트 생성 시 `.env`, `.env.local`, `.env.development`, `.env.production`, `.env.example`이 함께 생성됩니다.
- `.env`: 모든 환경 공통값
- `.env.local`: 개발자 PC 전용값(Git 제외)
- `.env.development`: 개발 빌드값
- `.env.production`: 운영 빌드값
- `.env.example`: 환경변수 작성 예시
`.env.local`은 다른 환경 파일보다 우선 적용되므로 운영 빌드에서는 제거하거나 Jenkins 정책에 맞게 관리합니다.
## 공통 자원
- npm package: `@kri/common`
- UI Registry: `https://ui-registry.kric.com/r`
## 검증
```powershell
npm run typecheck
npm run build
```

3
templates/base/_env Normal file
View File

@@ -0,0 +1,3 @@
NEXT_PUBLIC_API_BASE=/api
NEXT_PUBLIC_STORE_KEY=kri-local-storage-key-32-bytes!!
NEXT_PUBLIC_STORE_IV=kri-local-iv-16!

View File

@@ -0,0 +1,3 @@
NEXT_PUBLIC_ENV=development
ENV=development
API_SERVER=http://localhost:8080

View File

@@ -0,0 +1,9 @@
# 모든 환경 공통
NEXT_PUBLIC_API_BASE=/api
NEXT_PUBLIC_STORE_KEY=change-this-storage-key-32-bytes
NEXT_PUBLIC_STORE_IV=change-this-iv-16
# 환경별 값 (.env.local / .env.development / .env.production)
NEXT_PUBLIC_ENV=local
ENV=local
API_SERVER=http://localhost:8080

View File

@@ -0,0 +1,3 @@
NEXT_PUBLIC_ENV=local
ENV=local
API_SERVER=http://localhost:8080

View File

@@ -0,0 +1,3 @@
NEXT_PUBLIC_ENV=production
ENV=production
API_SERVER=https://api.example.com

21
templates/base/_gitignore Normal file
View File

@@ -0,0 +1,21 @@
/node_modules
/.next
/out
/build
/coverage
/.pnp
.pnp.*
.vercel
.DS_Store
*.pem
*.tsbuildinfo
next-env.d.ts
npm-debug.log*
yarn-debug.log*
yarn-error.log*
.pnpm-debug.log*
.env
.env.local
.env.*.local
.idea/
*.iml

3
templates/base/_npmrc Normal file
View File

@@ -0,0 +1,3 @@
registry=https://registry.npmjs.org/
@kri:registry=https://gitea.kric.com/api/packages/KRi/npm/
//gitea.kric.com/api/packages/KRi/npm/:_authToken=${GITEA_NPM_TOKEN}

View File

@@ -0,0 +1,22 @@
{
"$schema": "https://ui.shadcn.com/schema.json",
"style": "new-york",
"rsc": true,
"tsx": true,
"tailwind": {
"config": "",
"css": "src/app/globals.css",
"baseColor": "neutral",
"cssVariables": true,
"prefix": ""
},
"iconLibrary": "lucide",
"aliases": {
"components": "@/components",
"utils": "@/lib/utils",
"ui": "@/components/ui",
"lib": "@/lib",
"hooks": "@/hooks"
},
"registries": {}
}

View File

@@ -0,0 +1,17 @@
import { defineConfig, globalIgnores } from "eslint/config";
import nextVitals from "eslint-config-next/core-web-vitals";
import nextTs from "eslint-config-next/typescript";
export default defineConfig([
...nextVitals,
...nextTs,
globalIgnores([".next/**", "out/**", "build/**", "next-env.d.ts"]),
{
rules: {
"@typescript-eslint/no-floating-promises": "off",
"@typescript-eslint/no-explicit-any": "warn",
"react-hooks/exhaustive-deps": "off",
"react-hooks/set-state-in-effect": "off"
}
}
]);

View File

@@ -0,0 +1,6 @@
import type { NextConfig } from "next";
import { createKriNextConfig } from "@kri/common/config";
const nextConfig = createKriNextConfig({}) satisfies NextConfig;
export default nextConfig;

View File

@@ -0,0 +1,7 @@
const config = {
plugins: {
"@tailwindcss/postcss": {}
}
};
export default config;

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

View File

@@ -0,0 +1,11 @@
import { cookies } from "next/headers";
import { redirect } from "next/navigation";
import { AppMainLayout } from "@/components/app-shell/AppMainLayout";
import { CookieKeys } from "@/store/cookie/cookie-keys";
export default async function MainLayout({ children }: Readonly<{ children: React.ReactNode }>) {
const cookieStore = await cookies();
const accessToken = cookieStore.get(CookieKeys.AuthToken)?.value;
if (!accessToken) redirect("/logout");
return <AppMainLayout>{children}</AppMainLayout>;
}

View File

@@ -0,0 +1,13 @@
import { AppPageTitle } from "@/components/app-shell/AppPageTitle";
export default function MainPage() {
return (
<div className="space-y-6">
<AppPageTitle title="__DISPLAY_NAME__" description="프로젝트 기본 구성이 완료되었습니다." />
<div className="rounded-lg border bg-card p-6 text-card-foreground shadow-sm">
<p className="font-medium">다음 작업</p>
<p className="mt-2 text-sm text-muted-foreground">메뉴와 API 경로를 프로젝트 업무에 맞게 확장하세요.</p>
</div>
</div>
);
}

View File

@@ -0,0 +1,81 @@
"use client";
import Image from "next/image";
import type React from "react";
import { useEffect, useRef, useState } from "react";
import { useRouter } from "next/navigation";
import { apiError, NONE_HTTP_ERROR } from "@kri/common/http";
import { Button } from "@/components/ui/button";
import { Card, CardContent, CardHeader } from "@/components/ui/card";
import { Input } from "@/components/ui/input";
import { useLoginMutation } from "@/query/auth";
export default function LoginPage() {
const router = useRouter();
const loginMutation = useLoginMutation();
const passwordInputRef = useRef<HTMLInputElement | null>(null);
const [userId, setUserId] = useState("");
const [userPw, setUserPw] = useState("");
const [error, setError] = useState<string | null>(null);
const tryLogin = async () => {
if (!userId.trim()) return window.alert("아이디를 입력해 주세요.");
if (!userPw) return window.alert("비밀번호를 입력해 주세요.");
setError(null);
try {
await loginMutation.mutateAsync({ userId: userId.trim(), userPw });
} catch (cause: unknown) {
const errorInfo = apiError(cause, { fallbackMessage: "로그인에 실패했습니다." });
if (errorInfo.status === 401 || errorInfo.status === 403) setError("아이디 또는 비밀번호를 다시 확인해 주세요.");
else if (errorInfo.code === NONE_HTTP_ERROR) setError("알 수 없는 오류가 발생했습니다. 잠시 후 다시 시도해 주세요.");
else setError(`로그인에 실패했습니다. (${errorInfo.message})`);
}
};
useEffect(() => {
if (loginMutation.isSuccess) router.replace("/");
}, [loginMutation.isSuccess, router]);
const handleIdKeyDown: React.KeyboardEventHandler<HTMLInputElement> = (event) => {
if (event.key === "Enter") {
event.preventDefault();
passwordInputRef.current?.focus();
}
};
const handlePasswordKeyDown: React.KeyboardEventHandler<HTMLInputElement> = (event) => {
if (event.key === "Enter") {
event.preventDefault();
void tryLogin();
}
};
return (
<main className="flex min-h-screen items-center justify-center bg-muted/40 p-4">
<Card className="w-full max-w-md shadow-xl">
<CardHeader className="pb-8">
<div className="flex justify-center">
<Image src="/logo.png" alt="로고" width={240} height={120} className="h-24 w-auto object-contain" priority />
</div>
</CardHeader>
<CardContent>
<div className="space-y-4">
<div className="space-y-2">
<label htmlFor="userId" className="text-sm font-medium">ID</label>
<Input id="userId" autoComplete="username" placeholder="아이디를 입력하세요" value={userId} onChange={(event) => setUserId(event.currentTarget.value)} onKeyDown={handleIdKeyDown} />
</div>
<div className="space-y-2">
<label htmlFor="userPw" className="text-sm font-medium">Password</label>
<Input ref={passwordInputRef} id="userPw" type="password" autoComplete="current-password" placeholder="비밀번호를 입력하세요" value={userPw} onChange={(event) => setUserPw(event.currentTarget.value)} onKeyDown={handlePasswordKeyDown} />
</div>
{error ? <p className="text-sm text-destructive">{error}</p> : null}
<Button className="mt-6 h-11 w-full" disabled={loginMutation.isPending} onClick={() => void tryLogin()}>
{loginMutation.isPending ? "로그인 중..." : "로그인"}
</Button>
</div>
</CardContent>
</Card>
</main>
);
}

View File

@@ -0,0 +1,20 @@
"use client";
import { useEffect, useRef } from "react";
import { useRouter } from "next/navigation";
import { useLogoutMutation } from "@/query/auth";
import { LoadingOverlayAdapter } from "@/components/app-shell/LoadingOverlayAdapter";
export default function LogoutPage() {
const router = useRouter();
const logoutMutation = useLogoutMutation();
const started = useRef(false);
useEffect(() => {
if (started.current) return;
started.current = true;
void logoutMutation.mutateAsync().finally(() => router.replace("/login"));
}, [logoutMutation, router]);
return <LoadingOverlayAdapter force label="로그아웃 중" />;
}

View File

@@ -0,0 +1,73 @@
import { NextRequest, NextResponse } from "next/server";
import { errorToResponse } from "@kri/common/http";
import { createServerApi } from "@/lib/http-server";
import type { RouteContext } from "@/types/common";
const apiPath = (slug: string[]) => `/example${slug.length ? `/${slug.map(encodeURIComponent).join("/")}` : ""}`;
const toResponse = (result: unknown) => result === undefined ? new NextResponse(null, { status: 204 }) : NextResponse.json(result);
export async function GET(request: NextRequest, context: RouteContext) {
try {
const { slug = [] } = await context.params;
const query = Object.fromEntries(request.nextUrl.searchParams.entries());
const serverApi = await createServerApi();
return toResponse(await serverApi.get<unknown>(apiPath(slug), { query }));
} catch (error: unknown) {
return errorToResponse(error);
}
}
export async function POST(request: NextRequest, context: RouteContext) {
try {
const { slug = [] } = await context.params;
const serverApi = await createServerApi();
const contentType = request.headers.get("content-type") ?? "";
if (contentType.includes("multipart/form-data")) {
return toResponse(await serverApi.postForm<unknown>(apiPath(slug), await request.formData()));
}
const body = await request.json().catch(() => undefined);
return toResponse(await serverApi.post<unknown>(apiPath(slug), body));
} catch (error: unknown) {
return errorToResponse(error);
}
}
export async function PUT(request: NextRequest, context: RouteContext) {
try {
const { slug = [] } = await context.params;
const serverApi = await createServerApi();
const contentType = request.headers.get("content-type") ?? "";
if (contentType.includes("multipart/form-data")) {
return toResponse(await serverApi.putForm<unknown>(apiPath(slug), await request.formData()));
}
const body = await request.json().catch(() => undefined);
return toResponse(await serverApi.put<unknown>(apiPath(slug), body));
} catch (error: unknown) {
return errorToResponse(error);
}
}
export async function PATCH(request: NextRequest, context: RouteContext) {
try {
const { slug = [] } = await context.params;
const serverApi = await createServerApi();
const body = await request.json().catch(() => undefined);
return toResponse(await serverApi.patch<unknown>(apiPath(slug), body));
} catch (error: unknown) {
return errorToResponse(error);
}
}
export async function DELETE(request: NextRequest, context: RouteContext) {
try {
const { slug = [] } = await context.params;
const serverApi = await createServerApi();
const body = await request.json().catch(() => undefined);
return toResponse(await serverApi.del<unknown>(apiPath(slug), body === undefined ? undefined : { json: body }));
} catch (error: unknown) {
return errorToResponse(error);
}
}
// createHttpClient의 FormData 전용 메서드는 postForm과 putForm입니다.
// PATCH/DELETE multipart가 필요하면 공용 HTTP Client 정책을 확인한 뒤 별도 구현하세요.

View File

@@ -0,0 +1,32 @@
import { NextRequest, NextResponse } from "next/server";
import type { LoginRequest, LoginUser } from "@kri/common";
import { errorToResponse } from "@kri/common/http";
import { AUTH_COOKIE_MAX_AGE } from "@/const/common.const";
import { serverEnv } from "@/lib/env.server";
import { createServerApi } from "@/lib/http-server";
import { CookieKeys } from "@/store/cookie/cookie-keys";
import type { RouteContext } from "@/types/common";
type LoginResponse = { accessToken: string; user: LoginUser };
export async function POST(request: NextRequest, context: RouteContext) {
try {
const { slug = [] } = await context.params;
const serverApi = await createServerApi();
const body = (await request.json()) as LoginRequest;
const suffix = slug.length ? `/${slug.map(encodeURIComponent).join("/")}` : "";
const result = await serverApi.post<LoginResponse>(`/auth/login${suffix}`, body);
const response = NextResponse.json(result.user, { status: 200 });
response.cookies.set(CookieKeys.AuthToken, result.accessToken, {
httpOnly: true,
secure: serverEnv.ENV === "prod",
sameSite: "lax",
path: "/",
maxAge: AUTH_COOKIE_MAX_AGE,
});
return response;
} catch (error: unknown) {
return errorToResponse(error);
}
}

View File

@@ -0,0 +1,27 @@
import { NextRequest, NextResponse } from "next/server";
import { errorToResponse } from "@kri/common/http";
import { serverEnv } from "@/lib/env.server";
import { createServerApi } from "@/lib/http-server";
import { CookieKeys } from "@/store/cookie/cookie-keys";
import type { RouteContext } from "@/types/common";
export async function POST(_request: NextRequest, context: RouteContext) {
try {
const { slug = [] } = await context.params;
const serverApi = await createServerApi();
const suffix = slug.length ? `/${slug.map(encodeURIComponent).join("/")}` : "";
await serverApi.post<boolean>(`/auth/logout${suffix}`);
const response = NextResponse.json({ ok: true });
response.cookies.set(CookieKeys.AuthToken, "", {
httpOnly: true,
secure: serverEnv.ENV === "prod",
sameSite: "lax",
path: "/",
maxAge: 0,
});
return response;
} catch (error: unknown) {
return errorToResponse(error);
}
}

View File

@@ -0,0 +1,87 @@
@import "tailwindcss";
@import "tw-animate-css";
@custom-variant dark (&:is(.dark *));
@theme inline {
--color-background: var(--background);
--color-foreground: var(--foreground);
--color-card: var(--card);
--color-card-foreground: var(--card-foreground);
--color-popover: var(--popover);
--color-popover-foreground: var(--popover-foreground);
--color-primary: var(--primary);
--color-primary-foreground: var(--primary-foreground);
--color-secondary: var(--secondary);
--color-secondary-foreground: var(--secondary-foreground);
--color-muted: var(--muted);
--color-muted-foreground: var(--muted-foreground);
--color-accent: var(--accent);
--color-accent-foreground: var(--accent-foreground);
--color-destructive: var(--destructive);
--color-border: var(--border);
--color-input: var(--input);
--color-ring: var(--ring);
--radius-sm: calc(var(--radius) - 4px);
--radius-md: calc(var(--radius) - 2px);
--radius-lg: var(--radius);
--radius-xl: calc(var(--radius) + 4px);
}
:root {
--radius: 0.625rem;
--background: oklch(1 0 0);
--foreground: oklch(0.145 0 0);
--card: oklch(1 0 0);
--card-foreground: oklch(0.145 0 0);
--popover: oklch(1 0 0);
--popover-foreground: oklch(0.145 0 0);
--primary: oklch(0.205 0 0);
--primary-foreground: oklch(0.985 0 0);
--secondary: oklch(0.97 0 0);
--secondary-foreground: oklch(0.205 0 0);
--muted: oklch(0.97 0 0);
--muted-foreground: oklch(0.556 0 0);
--accent: oklch(0.97 0 0);
--accent-foreground: oklch(0.205 0 0);
--destructive: oklch(0.577 0.245 27.325);
--border: oklch(0.922 0 0);
--input: oklch(0.922 0 0);
--ring: oklch(0.708 0 0);
}
.dark {
--background: oklch(0.145 0 0);
--foreground: oklch(0.985 0 0);
--card: oklch(0.205 0 0);
--card-foreground: oklch(0.985 0 0);
--popover: oklch(0.205 0 0);
--popover-foreground: oklch(0.985 0 0);
--primary: oklch(0.922 0 0);
--primary-foreground: oklch(0.205 0 0);
--secondary: oklch(0.269 0 0);
--secondary-foreground: oklch(0.985 0 0);
--muted: oklch(0.269 0 0);
--muted-foreground: oklch(0.708 0 0);
--accent: oklch(0.269 0 0);
--accent-foreground: oklch(0.985 0 0);
--destructive: oklch(0.704 0.191 22.216);
--border: oklch(1 0 0 / 10%);
--input: oklch(1 0 0 / 15%);
--ring: oklch(0.556 0 0);
}
@layer base {
* { @apply border-border outline-ring/50; }
body { @apply bg-background text-foreground; }
}
.ProseMirror img { cursor: pointer; }
.ProseMirror .ProseMirror-selectednode img { outline: 5px solid #0ea5e9; outline-offset: -5px; }
.ProseMirror [data-resize-container] { position: relative; display: inline-block; }
.ProseMirror [data-resize-handle] { position: absolute; width: 10px; height: 10px; box-sizing: border-box; background: #fff; border: 1px solid #0ea5e9; z-index: 10; opacity: 0; pointer-events: none; transition: opacity .12s ease-out; }
.ProseMirror [data-resize-container]:hover [data-resize-handle] { opacity: 1; pointer-events: auto; }
.ProseMirror [data-resize-handle="bottom-right"] { right: -5px; bottom: -5px; cursor: se-resize !important; }
.ProseMirror [data-resize-handle="bottom-left"] { left: -5px; bottom: -5px; cursor: sw-resize !important; }
.ProseMirror [data-resize-handle="top-right"] { right: -5px; top: -5px; cursor: ne-resize !important; }
.ProseMirror [data-resize-handle="top-left"] { left: -5px; top: -5px; cursor: nw-resize !important; }

View File

@@ -0,0 +1,21 @@
import type { Metadata } from "next";
import { Toaster } from "sonner";
import { AppProvider } from "@/components/providers/AppProvider";
import "./globals.css";
export const metadata: Metadata = {
title: "__DISPLAY_NAME__",
description: "__DESCRIPTION__",
icons: { icon: "/favicon.ico" }
};
export default function RootLayout({ children }: Readonly<{ children: React.ReactNode }>) {
return (
<html lang="ko">
<body className="min-h-screen antialiased">
<AppProvider>{children}</AppProvider>
<Toaster />
</body>
</html>
);
}

View File

@@ -0,0 +1,11 @@
import Link from "next/link";
export default function NotFound() {
return (
<main className="flex min-h-screen flex-col items-center justify-center gap-4 p-6 text-center">
<p className="text-sm text-muted-foreground">404</p>
<h1 className="text-2xl font-bold">페이지를 찾을 수 없습니다.</h1>
<Link href="/" className="text-sm underline underline-offset-4">홈으로 이동</Link>
</main>
);
}

View File

@@ -0,0 +1,40 @@
"use client";
import Image from "next/image";
import { LogOut } from "lucide-react";
import { Button } from "@/components/ui/button";
import { KriHeader } from "@/components/layout/KriHeader";
import { topMenus } from "@/config/menu.data";
import type { LoginUser } from "@kri/common";
interface AppHeaderProps {
menuOpen: boolean;
showMenuButton: boolean;
activeMenuId?: string;
user?: LoginUser | null;
onToggleMenu: () => void;
onNavigate: (path: string) => void;
}
export function AppHeader({ menuOpen, showMenuButton, activeMenuId, user, onToggleMenu, onNavigate }: AppHeaderProps) {
return (
<KriHeader
logo={<Image src="/logo.png" alt="로고" width={120} height={40} className="h-10 w-auto object-contain" priority />}
menus={topMenus}
activeMenuId={activeMenuId}
menuOpen={menuOpen}
showMenuButton={showMenuButton}
onToggleMenu={onToggleMenu}
onNavigate={onNavigate}
right={
<>
<span className="hidden text-sm text-muted-foreground sm:inline">{user?.userName ?? ""}</span>
<Button variant="ghost" size="sm" className="gap-2" onClick={() => onNavigate("/logout")}>
<LogOut className="size-4" />
<span className="hidden sm:inline">로그아웃</span>
</Button>
</>
}
/>
);
}

View File

@@ -0,0 +1,44 @@
"use client";
import { useMemo, useState } from "react";
import { usePathname, useRouter } from "next/navigation";
import { KriMainLayout } from "@/components/layout/KriMainLayout";
import { AppHeader } from "./AppHeader";
import { AppSidebar } from "./AppSidebar";
import { sideMenus, topMenus } from "@/config/menu.data";
import { useAuth } from "@/hooks/useAuth";
export function AppMainLayout({ children }: { children: React.ReactNode }) {
const pathname = usePathname();
const router = useRouter();
const { auth } = useAuth();
const [menuOpen, setMenuOpen] = useState(true);
const activeMenuId = useMemo(
() => topMenus.find((item) => item.path && (pathname === item.path || pathname.startsWith(`${item.path}/`)))?.id,
[pathname],
);
const navigate = (path: string) => router.push(path);
const hasSidebar = sideMenus.length > 0;
return (
<KriMainLayout
sidebarOpen={hasSidebar && menuOpen}
onSidebarOpenChange={setMenuOpen}
header={
<AppHeader
menuOpen={menuOpen}
showMenuButton={hasSidebar}
activeMenuId={activeMenuId}
user={auth.user}
onToggleMenu={() => setMenuOpen((current) => !current)}
onNavigate={navigate}
/>
}
sidebar={hasSidebar ? <AppSidebar items={sideMenus} isOpen={menuOpen} pathname={pathname} onNavigate={navigate} /> : undefined}
>
{children}
</KriMainLayout>
);
}

View File

@@ -0,0 +1,10 @@
import { KriPageTitle } from "@/components/layout/KriPageTitle";
export interface AppPageTitleProps {
title: string;
description?: string;
}
export function AppPageTitle({ title, description }: AppPageTitleProps) {
return <KriPageTitle title={title} description={description} />;
}

View File

@@ -0,0 +1,15 @@
"use client";
import { KriSidebar } from "@/components/layout/KriSidebar";
import type { SideMenuItem } from "@/config/menu.type";
interface AppSidebarProps {
items: SideMenuItem[];
isOpen: boolean;
pathname: string;
onNavigate: (path: string) => void;
}
export function AppSidebar({ items, isOpen, pathname, onNavigate }: AppSidebarProps) {
return <KriSidebar items={items} isOpen={isOpen} pathname={pathname} onNavigate={onNavigate} />;
}

View File

@@ -0,0 +1,12 @@
"use client";
import { useAtomValue } from "jotai";
import { KriLoadingOverlay, type KriLoadingOverlayProps } from "@/components/common/KriLoadingOverlay";
import { loadingAtom } from "@/store/jotai/loading";
export type LoadingOverlayAdapterProps = Omit<KriLoadingOverlayProps, "open"> & { force?: boolean };
export function LoadingOverlayAdapter({ force = false, ...props }: LoadingOverlayAdapterProps) {
const open = useAtomValue(loadingAtom);
return <KriLoadingOverlay open={force || open} {...props} />;
}

View File

@@ -0,0 +1,5 @@
export { AppHeader } from "./AppHeader";
export { AppMainLayout } from "./AppMainLayout";
export { AppPageTitle } from "./AppPageTitle";
export { AppSidebar } from "./AppSidebar";
export { LoadingOverlayAdapter } from "./LoadingOverlayAdapter";

View File

@@ -0,0 +1,18 @@
"use client";
import { Provider as JotaiProvider } from "jotai";
import { QueryProvider } from "@kri/common/query";
import { LoadingOverlayAdapter } from "@/components/app-shell/LoadingOverlayAdapter";
import { QueryLoadingSync } from "./QueryLoadingSync";
export function AppProvider({ children }: { children: React.ReactNode }) {
return (
<JotaiProvider>
<QueryProvider>
<QueryLoadingSync />
<LoadingOverlayAdapter />
{children}
</QueryProvider>
</JotaiProvider>
);
}

View File

@@ -0,0 +1,10 @@
"use client";
import { QueryLoadingSync as CommonQueryLoadingSync } from "@kri/common/query";
import { useSetAtom } from "jotai";
import { queryLoadingAtom } from "@/store/jotai/loading";
export function QueryLoadingSync() {
const setQueryLoading = useSetAtom(queryLoadingAtom);
return <CommonQueryLoadingSync onLoadingChange={setQueryLoading} />;
}

View File

@@ -0,0 +1,7 @@
export const commonConfig = {
appName: "__DISPLAY_NAME__",
description: "__DESCRIPTION__",
homePath: "/",
loginPath: "/login",
logoutPath: "/logout",
} as const;

View File

@@ -0,0 +1,7 @@
import type { SideMenuItem, TopMenuItem } from "./menu.type";
export const topMenus: TopMenuItem[] = [
{ id: "home", label: "홈", path: "/" },
];
export const sideMenus: SideMenuItem[] = [];

View File

@@ -0,0 +1,4 @@
import type { KriNavigationItem } from "@/components/layout/types";
export type TopMenuItem = KriNavigationItem;
export type SideMenuItem = KriNavigationItem;

View File

@@ -0,0 +1 @@
export const AUTH_COOKIE_MAX_AGE = 24 * 60 * 60;

View File

@@ -0,0 +1,38 @@
"use client";
import { useCallback } from "react";
import type { LoginUser } from "@kri/common";
import { createAuthHook, type AuthState as CommonAuthState } from "@kri/common/hooks";
import { getLocalStorage, removeLocalStorage, setLocalStorage } from "@/store/storage/secure-storage";
import { StorageKeys } from "@/store/storage/storage-keys";
export type AuthState = CommonAuthState<LoginUser>;
const initialAuthState: AuthState = { user: null };
const loadInitialAuthState = (): AuthState => {
const stored = getLocalStorage(StorageKeys.AuthState);
return stored && typeof stored === "object" && "user" in stored
? { ...initialAuthState, ...(stored as Partial<AuthState>) }
: initialAuthState;
};
const { authAtom, useAuth: useCommonAuth } = createAuthHook<LoginUser>({ initialState: loadInitialAuthState() });
export const authStateAtom = authAtom;
export function useAuth() {
const { auth, setAuth: setCommonAuth } = useCommonAuth();
const setAuth = useCallback((next: AuthState | ((previous: AuthState) => AuthState)) => {
setCommonAuth((previous) => {
const resolved = typeof next === "function" ? next(previous) : next;
if (resolved.user === null) removeLocalStorage(StorageKeys.AuthState);
else setLocalStorage(StorageKeys.AuthState, resolved);
return resolved;
});
}, [setCommonAuth]);
const setFromLoginResponse = useCallback((user: LoginUser) => setAuth({ user }), [setAuth]);
const logout = useCallback(() => setAuth(initialAuthState), [setAuth]);
return { auth, setAuth, setFromLoginResponse, logout } as const;
}

View File

@@ -0,0 +1,23 @@
"use client";
import { useCallback } from "react";
import { createDialogHook } from "@kri/common/hooks";
import type { DialogId } from "@/store/jotai/dialog";
const { openDialogIdsAtom, useDialog: useCommonDialog } = createDialogHook<DialogId>();
export { openDialogIdsAtom };
export function useDialog() {
const { openDialogIds, isDialogOpen, openDialog, closeDialog, closeAllDialogs } = useCommonDialog();
const showDialog = useCallback((id: DialogId, onlyThis = true) => {
if (onlyThis) closeAllDialogs();
openDialog(id);
}, [closeAllDialogs, openDialog]);
return {
openDialogIds,
isDialogOpen,
showDialog,
hideDialog: closeDialog,
hideAll: closeAllDialogs,
} as const;
}

View File

@@ -0,0 +1,7 @@
"use client";
import { createLoadingHook } from "@kri/common/hooks";
const { loadingCountAtom, isLoadingAtom, useLoading } = createLoadingHook();
export { loadingCountAtom, isLoadingAtom, useLoading };
export const manualLoadingAtom = isLoadingAtom;

View File

@@ -0,0 +1,17 @@
"use client";
import { createStorageHook } from "@kri/common/hooks";
import type { AuthState } from "@/hooks/useAuth";
import { getLocalStorage, getSessionStorage, removeLocalStorage, removeSessionStorage, setLocalStorage, setSessionStorage } from "@/store/storage/secure-storage";
import { StorageKeys, StorageType } from "@/store/storage/storage-keys";
type AppStorageSchema = { [StorageKeys.AuthState]: AuthState };
type AppStorageKey = Extract<keyof AppStorageSchema, string>;
const useCommonStorage = createStorageHook<AppStorageSchema>({
resolveStorageScope: (key) => StorageType[key],
localStorageAdapter: { get: getLocalStorage, set: setLocalStorage, remove: removeLocalStorage },
sessionStorageAdapter: { get: getSessionStorage, set: setSessionStorage, remove: removeSessionStorage },
});
export const useStorage = <TKey extends AppStorageKey>(key: TKey) => useCommonStorage(key);

View File

@@ -0,0 +1,8 @@
import { createEnv, env } from "@kri/common/config";
export const clientEnv = createEnv({
ENV: env.required("NEXT_PUBLIC_ENV", process.env.NEXT_PUBLIC_ENV),
API_BASE: env.required("NEXT_PUBLIC_API_BASE", process.env.NEXT_PUBLIC_API_BASE),
STORE_KEY: env.required("NEXT_PUBLIC_STORE_KEY", process.env.NEXT_PUBLIC_STORE_KEY),
STORE_IV: env.required("NEXT_PUBLIC_STORE_IV", process.env.NEXT_PUBLIC_STORE_IV),
});

View File

@@ -0,0 +1,7 @@
import "server-only";
import { createEnv, env } from "@kri/common/config";
export const serverEnv = createEnv({
ENV: env.required("ENV", process.env.ENV),
API_SERVER: env.required("API_SERVER", process.env.API_SERVER),
});

View File

@@ -0,0 +1,4 @@
import { createHttpClient } from "@kri/common/http";
import { clientEnv } from "@/lib/env.client";
export const nextApi = createHttpClient(clientEnv.API_BASE);

View File

@@ -0,0 +1,13 @@
import { cookies } from "next/headers";
import { createHttpClient } from "@kri/common/http";
import { serverEnv } from "@/lib/env.server";
import { CookieKeys } from "@/store/cookie/cookie-keys";
export async function createServerApi() {
const cookieStore = await cookies();
const accessToken = cookieStore.get(CookieKeys.AuthToken)?.value ?? null;
return createHttpClient(serverEnv.API_SERVER, {
getToken: () => accessToken,
defaultHeaders: { "content-type": "application/json" },
});
}

View File

@@ -0,0 +1,14 @@
import { createSecurity } from "@kri/common/security";
import { clientEnv } from "@/lib/env.client";
export const Security = createSecurity({
key: clientEnv.STORE_KEY,
iv: clientEnv.STORE_IV,
onInvalidConfig: ({ message }) => {
if (typeof window === "undefined" || clientEnv.ENV !== "local") return;
const target = window as Window & { __kriCryptoConfigAlerted?: boolean };
if (target.__kriCryptoConfigAlerted) return;
target.__kriCryptoConfigAlerted = true;
window.alert(message);
},
});

View File

@@ -0,0 +1 @@
export { cn } from "@kri/common/ui";

View File

@@ -0,0 +1,10 @@
import { NextRequest, NextResponse } from "next/server";
export const config = {
matcher: ["/example/:path*"],
};
export function proxy(_request: NextRequest) {
// 인증, Header 추가, Redirect 같은 공통 처리를 구현할 수 있습니다.
return NextResponse.next();
}

View File

@@ -0,0 +1,41 @@
"use client";
import type { LoginRequest, LoginUser } from "@kri/common";
import { useMutation, useQueryClient } from "@tanstack/react-query";
import { useAuth } from "@/hooks/useAuth";
import { nextApi } from "@/lib/http-client";
export function useLoginMutation() {
const { setFromLoginResponse } = useAuth();
return useMutation({
mutationFn: (request: LoginRequest) => nextApi.post<LoginUser>("/login", request, {
skipUnauthorizedHandler: true,
skipForbiddenHandler: true,
skipResponseErrorHandler: true,
}),
onSuccess: setFromLoginResponse,
});
}
export function useLogoutMutation() {
const queryClient = useQueryClient();
const { auth, logout } = useAuth();
return useMutation({
mutationFn: async () => {
const suffix = auth.user?.userId ? `/${encodeURIComponent(auth.user.userId)}` : "";
try {
await nextApi.post(`/logout${suffix}`, null, {
skipUnauthorizedHandler: true,
skipForbiddenHandler: true,
skipResponseErrorHandler: true,
});
} catch (error) {
console.error(error);
}
},
onSettled: () => {
logout();
queryClient.clear();
},
});
}

View File

@@ -0,0 +1,56 @@
"use client";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { nextApi } from "@/lib/http-client";
import { queryKeys } from "@/query/key/keys";
import type { ExampleItem, ExampleRequest } from "@/types/common";
export const useExampleQuery = (id: string) => useQuery({
queryKey: queryKeys.example.detail(id),
queryFn: () => nextApi.get<ExampleItem>(`/example/${id}`),
enabled: Boolean(id),
});
export function useCreateExampleMutation() {
const client = useQueryClient();
return useMutation({
mutationFn: (body: ExampleRequest) => nextApi.post<ExampleItem>("/example", body),
onSuccess: () => client.invalidateQueries({ queryKey: queryKeys.example.all }),
});
}
export function useUpdateExampleMutation(id: string) {
const client = useQueryClient();
return useMutation({
mutationFn: (body: ExampleRequest) => nextApi.put<ExampleItem>(`/example/${id}`, body),
onSuccess: () => client.invalidateQueries({ queryKey: queryKeys.example.all }),
});
}
export function usePatchExampleMutation(id: string) {
const client = useQueryClient();
return useMutation({
mutationFn: (body: Partial<ExampleRequest>) => nextApi.patch<ExampleItem>(`/example/${id}`, body),
onSuccess: () => client.invalidateQueries({ queryKey: queryKeys.example.all }),
});
}
export function useDeleteExampleMutation() {
const client = useQueryClient();
return useMutation({
mutationFn: (id: string) => nextApi.del<void>(`/example/${id}`),
onSuccess: () => client.invalidateQueries({ queryKey: queryKeys.example.all }),
});
}
export function useUploadExampleMutation(id: string) {
return useMutation({
mutationFn: (formData: FormData) => nextApi.postForm<ExampleItem>(`/example/${id}`, formData),
});
}
export function useReplaceExampleFileMutation(id: string) {
return useMutation({
mutationFn: (formData: FormData) => nextApi.putForm<ExampleItem>(`/example/${id}`, formData),
});
}

View File

@@ -0,0 +1,6 @@
export const queryKeys = {
example: {
all: ["example"] as const,
detail: (id: string) => ["example", id] as const,
},
} as const;

View File

@@ -0,0 +1,9 @@
"use client";
import { createCookieStore, type CookieSetOptions } from "@kri/common/browser";
import type { CookieKey } from "./cookie-keys";
export type { CookieSetOptions };
export const cookieStore = createCookieStore<CookieKey>({
defaults: { days: 365, path: "/", secure: false, sameSite: "Lax" },
});

View File

@@ -0,0 +1,5 @@
export const CookieKeys = {
AuthToken: "kri_authToken",
} as const;
export type CookieKey = (typeof CookieKeys)[keyof typeof CookieKeys];

View File

@@ -0,0 +1,2 @@
"use client";
export { authStateAtom, type AuthState } from "@/hooks/useAuth";

View File

@@ -0,0 +1 @@
export type DialogId = "exampleDialog";

View File

@@ -0,0 +1,8 @@
"use client";
import { atom } from "jotai";
import { isLoadingAtom } from "@/hooks/useLoading";
export const manualLoadingAtom = isLoadingAtom;
export const queryLoadingAtom = atom(false);
export const loadingAtom = atom((get) => get(isLoadingAtom) || get(queryLoadingAtom));

View File

@@ -0,0 +1,27 @@
"use client";
import { createJsonStorage, type JsonStorageTransform } from "@kri/common/browser";
import { clientEnv } from "@/lib/env.client";
import { Security } from "@/lib/security";
const securityTransform: JsonStorageTransform = {
encode: (value) => Security.encryptBase64(value),
decode: (value) => Security.decryptBase64(value),
};
const options = (storage: "local" | "session") => ({
storage,
fallbackToPlainJson: true,
...(clientEnv.ENV === "prod" ? { transform: securityTransform } : {}),
} as const);
const local = createJsonStorage(options("local"));
const session = createJsonStorage(options("session"));
export const setLocalStorage = local.set;
export const getLocalStorage = local.get;
export const removeLocalStorage = local.remove;
export const clearLocalStorage = local.clear;
export const setSessionStorage = session.set;
export const getSessionStorage = session.get;
export const removeSessionStorage = session.remove;
export const clearSessionStorage = session.clear;

View File

@@ -0,0 +1,8 @@
export const StorageKeys = {
AuthState: "kri:authState",
} as const;
export type StorageKey = (typeof StorageKeys)[keyof typeof StorageKeys];
export const StorageType: Record<StorageKey, "local" | "session"> = {
[StorageKeys.AuthState]: "local",
};

View File

@@ -0,0 +1,12 @@
export type RouteContext = {
params: Promise<{ slug?: string[] }>;
};
export interface ExampleItem {
id: string;
name: string;
}
export interface ExampleRequest {
name: string;
}

View File

@@ -0,0 +1,21 @@
{
"compilerOptions": {
"target": "ES2017",
"lib": ["dom", "dom.iterable", "esnext"],
"allowJs": true,
"skipLibCheck": true,
"strict": true,
"noEmit": true,
"esModuleInterop": true,
"module": "esnext",
"moduleResolution": "bundler",
"resolveJsonModule": true,
"isolatedModules": true,
"jsx": "react-jsx",
"incremental": true,
"plugins": [{ "name": "next" }],
"paths": { "@/*": ["./src/*"] }
},
"include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts", ".next/dev/types/**/*.ts", "**/*.mts"],
"exclude": ["node_modules"]
}

24
tsconfig.json Normal file
View File

@@ -0,0 +1,24 @@
{
"compilerOptions": {
"target": "ES2022",
"lib": [
"ES2022"
],
"module": "NodeNext",
"moduleResolution": "NodeNext",
"rootDir": "src",
"outDir": "dist",
"strict": true,
"esModuleInterop": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true,
"declaration": true,
"sourceMap": true,
"types": [
"node"
]
},
"include": [
"src/**/*.ts"
]
}