create-entity-app-server 0.0.4 → 0.1.13

package/dist-create/template/app/routes/example-es/handlers.ts

@@ -0,0 +1,216 @@
+/**
+ * Entity Server Example 핸들러 — entityServer 클라이언트 사용 예제
+ *
+ * 이 파일은 Gateway에서 Entity Server에 접속하여 엔티티 CRUD를 수행하는 방법을 보여줍니다.
+ * entityServer 는 @gateway/api 에서 import 하며 Entity Server의 REST API를 호출합니다.
+ *
+ * ⚠ 주의: .env 에 ENTITY_SERVER_URL, ENTITY_API_KEY 이 설정되어 있어야 합니다.
+ *   사용하는 엔티티(예: "post")는 entities/ 폴더에 JSON 정의가 필요합니다.
+ */
+
+import type { FastifyRequest, FastifyReply } from "fastify";
+import { ok, fail, entityServer, NotFoundError } from "@gateway/api";
+import type {
+    CreatePostBody,
+    UpdatePostBody,
+    SeqParams,
+    SearchPostsQuery,
+    HistoryQuery,
+} from "./types/index.ts";
+
+// 엔티티 이름 — entities/post.json 에 정의된 엔티티
+const ENTITY = "post";
+
+// ─────────────────────────────────────────────────
+// 기본 CRUD 예제
+// ─────────────────────────────────────────────────
+
+/**
+ * GET /example-es/posts?page=1&limit=20
+ * 게시글 목록 조회 (list)
+ */
+export async function listPosts(
+    req: FastifyRequest<{ Querystring: SearchPostsQuery }>,
+    reply: FastifyReply,
+) {
+    const { page = 1, limit = 20, orderBy, orderDir } = req.query;
+
+    const resp = await entityServer.list(ENTITY, {
+        page,
+        limit,
+        orderBy,
+        orderDir,
+    });
+
+    return reply.send(ok(resp.data));
+}
+
+/**
+ * GET /example-es/posts/:seq
+ * 게시글 단건 조회 (get)
+ */
+export async function getPost(
+    req: FastifyRequest<{ Params: SeqParams }>,
+    reply: FastifyReply,
+) {
+    const seq = Number(req.params.seq);
+
+    const resp = await entityServer.get(ENTITY, seq);
+    if (!resp.data) {
+        throw new NotFoundError(`Post ${seq} not found`);
+    }
+
+    return reply.send(ok(resp.data));
+}
+
+/**
+ * POST /example-es/posts
+ * 게시글 생성 (submit — seq 없으면 INSERT)
+ */
+export async function createPost(
+    req: FastifyRequest<{ Body: CreatePostBody }>,
+    reply: FastifyReply,
+) {
+    const { title, content, category = "general" } = req.body;
+
+    const resp = await entityServer.submit(ENTITY, {
+        title,
+        content,
+        category,
+        status: "draft",
+    });
+
+    return reply.code(201).send(ok({ seq: resp.seq }));
+}
+
+/**
+ * PUT /example-es/posts/:seq
+ * 게시글 수정 (submit — seq 있으면 UPDATE)
+ */
+export async function updatePost(
+    req: FastifyRequest<{ Params: SeqParams; Body: UpdatePostBody }>,
+    reply: FastifyReply,
+) {
+    const seq = Number(req.params.seq);
+    const updates = req.body;
+
+    const resp = await entityServer.submit(ENTITY, {
+        seq,
+        ...updates,
+    });
+
+    return reply.send(ok({ seq: resp.seq }));
+}
+
+/**
+ * DELETE /example-es/posts/:seq
+ * 게시글 삭제 (soft delete)
+ */
+export async function deletePost(
+    req: FastifyRequest<{ Params: SeqParams }>,
+    reply: FastifyReply,
+) {
+    const seq = Number(req.params.seq);
+
+    const resp = await entityServer.delete(ENTITY, seq);
+
+    return reply.send(ok({ deleted: resp.deleted }));
+}
+
+// ─────────────────────────────────────────────────
+// 고급 예제
+// ─────────────────────────────────────────────────
+
+/**
+ * GET /example-es/posts/search?q=keyword&category=tech&status=published
+ * 게시글 검색 (query — 조건 기반 검색)
+ */
+export async function searchPosts(
+    req: FastifyRequest<{ Querystring: SearchPostsQuery }>,
+    reply: FastifyReply,
+) {
+    const { q, category, status, page = 1, limit = 20 } = req.query;
+
+    // conditions 동적 구성
+    const conditions: Record<string, unknown> = {};
+    if (category) conditions.category = category;
+    if (status) conditions.status = status;
+    if (q) conditions.title = q; // title 필드에서 검색 (엔티티 인덱스 필드)
+
+    const resp = await entityServer.list(ENTITY, {
+        page,
+        limit,
+        conditions,
+    });
+
+    if (resp.data.items.length === 0) {
+        return reply.send(fail("No posts found"));
+    }
+
+    return reply.send(ok(resp.data));
+}
+
+/**
+ * POST /example-es/posts/:seq/publish
+ * 게시글 발행 — 트랜잭션 예제
+ *
+ * 게시글 상태를 published로 변경하고,
+ * publish_log 엔티티에 발행 기록을 남기는 것을 하나의 트랜잭션으로 처리합니다.
+ */
+export async function publishPost(
+    req: FastifyRequest<{ Params: SeqParams }>,
+    reply: FastifyReply,
+) {
+    const seq = Number(req.params.seq);
+
+    // 트랜잭션 시작
+    const txId = await entityServer.transStart();
+
+    try {
+        // 1) 게시글 상태 변경
+        await entityServer.submit(
+            ENTITY,
+            {
+                seq,
+                status: "published",
+                published_time: new Date().toISOString(),
+            },
+            { transactionId: txId },
+        );
+
+        // 2) 발행 로그 기록 (publish_log 엔티티가 있다고 가정)
+        await entityServer.submit(
+            "publish_log",
+            {
+                post_seq: seq,
+                action: "publish",
+                created_time: new Date().toISOString(),
+            },
+            { transactionId: txId },
+        );
+
+        // 커밋
+        const result = await entityServer.transCommit(txId);
+        return reply.send(ok({ published: true, results: result.results }));
+    } catch (err) {
+        // 롤백
+        await entityServer.transRollback(txId).catch(() => {});
+        throw err;
+    }
+}
+
+/**
+ * GET /example-es/posts/:seq/history?page=1&limit=10
+ * 게시글 변경 이력 조회 (history)
+ */
+export async function getPostHistory(
+    req: FastifyRequest<{ Params: SeqParams; Querystring: HistoryQuery }>,
+    reply: FastifyReply,
+) {
+    const seq = Number(req.params.seq);
+    const { page = 1, limit = 10 } = req.query;
+
+    const resp = await entityServer.history(ENTITY, seq, { page, limit });
+
+    return reply.send(ok(resp.data));
+}

package/dist-create/template/app/routes/example-es/routes.ts

@@ -0,0 +1,24 @@
+/**
+ * Entity Server Example 라우트 테이블
+ * 등록 경로: /api/v1/example-es/*
+ *
+ * entityServer 클라이언트를 사용한 Entity Server CRUD 예제입니다.
+ * 실제 프로젝트에서는 이 폴더를 복사하여 새 라우트를 만들 수 있습니다.
+ */
+
+import type { FastifyInstance } from "fastify";
+import * as h from "./handlers.ts";
+
+export default async function esExampleRoutes(app: FastifyInstance) {
+    // ── 기본 CRUD ──────────────────────────────
+    app.get("/posts", h.listPosts);
+    app.get("/posts/:seq", h.getPost);
+    app.post("/posts", h.createPost);
+    app.put("/posts/:seq", h.updatePost);
+    app.delete("/posts/:seq", h.deletePost);
+
+    // ── 고급: 검색, 트랜잭션, 이력 ─────────────
+    app.get("/posts/search", h.searchPosts);
+    app.post("/posts/:seq/publish", h.publishPost);
+    app.get("/posts/:seq/history", h.getPostHistory);
+}

package/dist-create/template/app/routes/example-es/types/defaults.ts

@@ -0,0 +1,30 @@
+import type { CreatePostBody, UpdatePostBody } from "./post.ts";
+import type { SearchPostsQuery, HistoryQuery } from "./query.ts";
+
+export const defaultCreatePostBody: CreatePostBody = {
+    title: "",
+    content: "",
+    category: "general",
+};
+
+export const defaultUpdatePostBody: UpdatePostBody = {
+    title: undefined,
+    content: undefined,
+    category: undefined,
+    status: undefined,
+};
+
+export const defaultSearchPostsQuery: SearchPostsQuery = {
+    q: undefined,
+    category: undefined,
+    status: undefined,
+    page: 1,
+    limit: 20,
+    orderBy: undefined,
+    orderDir: "DESC",
+};
+
+export const defaultHistoryQuery: HistoryQuery = {
+    page: 1,
+    limit: 10,
+};

package/dist-create/template/app/routes/example-es/types/index.ts

@@ -0,0 +1,4 @@
+export type { CreatePostBody, UpdatePostBody } from "./post.ts";
+export type { SeqParams } from "./params.ts";
+export type { SearchPostsQuery, HistoryQuery } from "./query.ts";
+export * from "./defaults.ts";

package/dist-create/template/app/routes/example-es/types/params.ts

@@ -0,0 +1,3 @@
+export interface SeqParams {
+    seq: string;
+}

package/dist-create/template/app/routes/example-es/types/post.ts

@@ -0,0 +1,12 @@
+export interface CreatePostBody {
+    title: string;
+    content: string;
+    category?: string;
+}
+
+export interface UpdatePostBody {
+    title?: string;
+    content?: string;
+    category?: string;
+    status?: "draft" | "published";
+}

package/dist-create/template/app/routes/example-es/types/query.ts

@@ -0,0 +1,14 @@
+export interface SearchPostsQuery {
+    q?: string;
+    category?: string;
+    status?: string;
+    page?: number;
+    limit?: number;
+    orderBy?: string;
+    orderDir?: "ASC" | "DESC";
+}
+
+export interface HistoryQuery {
+    page?: number;
+    limit?: number;
+}

package/dist-create/template/app/routes/health/config.json

@@ -0,0 +1,3 @@
+{
+    "enabled": true
+}

package/dist-create/template/app/routes/health/handlers.ts

@@ -0,0 +1,69 @@
+/**
+ * Health 핸들러 구현
+ */
+
+import type { FastifyRequest, FastifyReply } from "fastify";
+import { loadPacketEncryptConfig } from "../../../system/config/packet-encrypt.ts";
+import { deriveAnonymousPacketToken } from "../../../system/security/anonymous-packet-token.ts";
+import { ensureAndSyncAnonymousDevice } from "../../../system/security/anonymous-device.ts";
+
+async function buildPacketHealthPayload(
+    req: FastifyRequest,
+    reply: FastifyReply,
+) {
+    const cfg = loadPacketEncryptConfig();
+    if (!cfg.enabled) {
+        return {
+            ok: true,
+            packet_encryption: false,
+        };
+    }
+
+    const deviceId = await ensureAndSyncAnonymousDevice(req, reply, cfg);
+    return {
+        ok: true,
+        packet_encryption: true,
+        packet_mode: cfg.anonymousEnabled ? "anonymous" : "authenticated",
+        packet_token:
+            cfg.anonymousEnabled && deviceId
+                ? deriveAnonymousPacketToken(deviceId, cfg)
+                : undefined,
+    };
+}
+
+export async function getPacketHealth(
+    req: FastifyRequest,
+    reply: FastifyReply,
+) {
+    return reply.send(await buildPacketHealthPayload(req, reply));
+}
+
+/** 서버 기본 상태를 반환한다 */
+export async function getHealth(req: FastifyRequest, reply: FastifyReply) {
+    const packet = await buildPacketHealthPayload(req, reply);
+    return reply.send({
+        success: true,
+        data: {
+            status: "ok",
+            timestamp: new Date().toISOString(),
+            uptime: process.uptime(),
+            packet_encryption: packet.packet_encryption,
+            packet_mode: packet.packet_mode,
+        },
+    });
+}
+
+/** DB 연결 등 준비 상태를 반환한다 */
+export async function getReady(req: FastifyRequest, reply: FastifyReply) {
+    const dbOk = (req.server as any).db !== null;
+    const status = dbOk ? "ready" : "degraded";
+
+    return reply.code(dbOk ? 200 : 503).send({
+        success: dbOk,
+        data: {
+            status,
+            db: dbOk ? "connected" : "not configured",
+            timestamp: new Date().toISOString(),
+        },
+    });
+}

package/dist-create/template/app/routes/health/routes.ts

@@ -0,0 +1,14 @@
+/**
+ * Health 라우트 테이블 — 샘플 라우트
+ * 등록 경로: /api/v1/health/*
+ *
+ * 새 라우트 추가 방법: src/app/routes/README.md 참고
+ */
+
+import type { FastifyInstance } from "fastify";
+import * as h from "./handlers.ts";
+
+export default async function healthRoutes(app: FastifyInstance) {
+    app.get("/", h.getHealth);
+    app.get("/ready", h.getReady);
+}

package/dist-create/template/app/routes/privilege/config.json

@@ -0,0 +1,3 @@
+{
+    "enabled": true
+}

package/dist-create/template/app/routes/user/config.json

@@ -0,0 +1,3 @@
+{
+    "enabled": true
+}

package/{dist → dist-create/template}/app/schedules/data-retention/config.json

@@ -3,7 +3,5 @@
     "enabled": false,
     "retention_days": 1095,
     "action": "anonymize",
-    "cron": "30 2 * * *",
-    "deploy": true,
-    "minify": false
+    "cron": "30 2 * * *"
 }

package/{dist → dist-create/template}/app/schedules/dormancy/config.json

@@ -9,7 +9,5 @@
     "login_url": "",
     "send_completed_email": false,
     "completed_email_subject": "계정이 휴면 처리되었습니다",
-    "completed_email_template": "dormancy_completed",
-    "deploy": true,
-    "minify": false
+    "completed_email_template": "dormancy_completed"
 }

package/{dist → dist-create/template}/docs/scripts-guide.md

@@ -12,9 +12,10 @@
 | [build.sh](#2-buildsh)                   | TypeScript 빌드 + dist/ 패키징        |
 | [push.sh](#3-pushsh)                     | 버전 관리 + Git push                  |
 | [release.sh](#4-releasesh)               | 빌드 + 버전업 + push (원스텝)         |
-| [entity.sh](#5-entitysh)                 | Gateway 전용 엔티티 테이블 생성       |
-| [reset-all.sh](#6-reset-allsh)           | Gateway 전용 엔티티 테이블 초기화     |
-| [gen-table-type.sh](#7-gen-table-typesh) | 엔티티 → Kysely 테이블 타입 자동 생성 |
+| [update-server.sh](#5-update-serversh)   | 최신 gateway 코어 업데이트            |
+| [entity.sh](#6-entitysh)                 | Gateway 전용 엔티티 테이블 생성       |
+| [reset-all.sh](#7-reset-allsh)           | Gateway 전용 엔티티 테이블 초기화     |
+| [gen-table-type.sh](#8-gen-table-typesh) | 엔티티 → Kysely 테이블 타입 자동 생성 |
 
 ---
 
@@ -61,16 +62,24 @@ TypeScript를 컴파일하고 배포용 `dist/`를 패키징합니다.
 ```bash
 ./scripts/build.sh           # 프로덕션 빌드 + dist/ 패키징 + dist.tar.gz 생성
 ./scripts/build.sh --no-tar  # tar.gz 없이 빌드만
+npm run pack:npm             # npm 패키지(.cache/npm-pack/*.tgz) 생성
 ```
 
+`dist.tar.gz`는 서버 배포용 아카이브이고, `npm run pack:npm`으로 만드는 `.tgz`는 `create-entity-app-server` npm 패키지 아카이브입니다.
+
 ### 단계별 동작
 
 | 단계            | 내용                                                                      |
 | --------------- | ------------------------------------------------------------------------- |
-| [1/4] Build     | `npm run build` → TypeScript 컴파일 → `dist/system.js`, `system-api.js`   |
-| [2/4] Package   | `src/app/` 복사, 플러그인 `config.json` ← `config.example.json` 으로 교체 |
-| [3/4] Resources | `configs/`, `entities/`, `templates/`, `scripts/`, `docs/`, `.env` 복사   |
-| [4/4] Archive   | `dist.tar.gz` 생성 (`--no-tar` 시 생략)                                   |
+| [1/5] Build     | `npm run build` → TypeScript 컴파일 → `dist/system.js`, `system-api.js`   |
+| [2/5] Package   | `src/app/` 복사, 플러그인 `config.json` ← `config.example.json` 으로 교체 |
+| [3/5] Resources | `configs/`, `entities/`, `templates/`, `scripts/`, `docs/`, `.env` 복사   |
+| [4/5] Template  | `dist-create/template/` 생성                                              |
+| [5/5] Archive   | `dist.tar.gz` 생성 (`--no-tar` 시 생략)                                   |
+
+- 플러그인 배포용 `config.example.json` 에는 `deploy`, `minify` 를 넣지 않습니다.
+- build 시 플러그인은 `config.example.json` 내용이 그대로 `dist/app/plugins/*/config.json` 으로 복사됩니다.
+- `routes/`, `schedules/` 는 source `config.json` 을 그대로 사용하므로, 배포 산출물에서는 이들만 `deploy`, `minify` 필드를 제거합니다.
 
 ### dist/ 포함 항목
 
@@ -80,8 +89,8 @@ dist/
 ├── system-api.js     — 공개 API 번들 (ok/fail/logger/entityServer 등)
 ├── tsconfig.json     — @gateway/api, @app/* 경로 별칭
 ├── app/              — 사용자 편집 가능한 TypeScript 소스
-│   ├── plugins/      — 플러그인 (config.json = config.example.json 내용)
-│   └── routes/       — 비즈니스 라우트 (config.json 원본 유지)
+│   ├── plugins/      — 플러그인 (config.json = config.example.json 내용, deploy/minify 없음)
+│   └── routes/       — 비즈니스 라우트 (config.json 원본 유지, 배포 시 deploy/minify 제거)
 ├── configs/          — 서버·DB·CORS 설정 파일
 ├── entities/         — 엔티티 스키마 JSON
 ├── templates/        — 확장 템플릿
@@ -94,49 +103,101 @@ dist/
 
 ## 3) push.sh
 
-버전 번호를 올리고 Git push합니다. `package.json`의 `version` 필드를 기준으로 동작합니다.
+버전 번호를 올리고 현재 작업 트리 변경을 함께 commit/push합니다. `package.json`의 `version` 필드를 기준으로 태그를 만듭니다.
 
 ```bash
 ./scripts/push.sh                    # 현재 버전 확인 + 사용법 출력
-./scripts/push.sh version patch      # x.y.Z+1 — 버그 수정
-./scripts/push.sh version minor      # x.Y+1.0 — 기능 추가
-./scripts/push.sh version major      # X+1.0.0 — 호환성 변경
+./scripts/push.sh bump patch         # 로컬 버전만 증가
+./scripts/push.sh version            # 현재 버전 확인
+./scripts/push.sh patch              # x.y.Z+1 — 버그 수정
+./scripts/push.sh minor              # x.Y+1.0 — 기능 추가
+./scripts/push.sh major              # X+1.0.0 — 호환성 변경
+./scripts/push.sh push-current       # 현재 버전 commit + tag + push
 ./scripts/push.sh tag                # 현재 버전으로 git tag만 생성 + push
 ```
 
-### 동작 순서 (version)
+### 동작 순서
 
-1. `package.json` 버전 업
-2. `git add package.json && git commit -m "chore: bump version to vX.Y.Z"`
-3. `git tag gateway-vX.Y.Z`
-4. `git push origin <현재 브랜치>`
-5. `git push origin gateway-vX.Y.Z`
+1. `./scripts/push.sh bump <type>`: `package.json` 버전만 로컬에서 증가
+2. `./scripts/push.sh patch|minor|major`: 버전 증가 + 현재 작업 트리 전체 commit + tag + push + upstream 연결
+3. `./scripts/push.sh push-current`: 현재 버전 기준으로 작업 트리 전체 commit + tag + push
+4. `./scripts/push.sh tag`: 현재 버전으로 태그만 push
 
-> 태그는 `gateway-v` 접두어를 사용합니다 (부모 서버 태그와 구분).
+> 태그는 `v` 접두어를 사용합니다. 예: `v0.1.8`
 
 ---
 
 ## 4) release.sh
 
-빌드 + 버전업 + push를 한 번에 실행합니다.
+GitHub PR 기반으로 `현재 브랜치 -> main -> release` 승격을 진행합니다.
 
 ```bash
-./scripts/release.sh           # patch 릴리즈 (기본값)
-./scripts/release.sh patch     # 버그 수정 릴리즈
-./scripts/release.sh minor     # 기능 추가 릴리즈
-./scripts/release.sh major     # 호환 변경 릴리즈
+./scripts/release.sh           # 사용법 출력
+./scripts/release.sh start     # 현재 브랜치 -> main -> release PR 생성/머지
 ```
 
 ### 동작 순서
 
-1. `build.sh` 실행 (빌드 + 패키징)
-2. `push.sh version <type>` 실행 (버전업 + push)
+1. 현재 브랜치에 커밋 안 된 변경과 push 안 된 커밋이 없는지 검사
+2. 현재 브랜치가 `main` 이 아니면 `현재 브랜치 -> main` PR 생성/머지
+3. `main -> release` PR 생성/머지
+4. `release` 브랜치 push 이벤트에서 GitHub Actions 가 `v<version>` 태그 생성
+5. 태그 push 이벤트에서 GitHub Actions 가 GitHub Release 생성
+6. 같은 태그 이벤트에서 `build.sh` 실행 후 npm publish 수행
+
+> 실제 릴리즈는 `./scripts/release.sh start` 로 실행합니다. `./scripts/release.sh` 는 사용법만 출력합니다.
+
+### 사전 조건
+
+- `./scripts/build.sh` 로 빌드 검증이 끝나 있어야 합니다.
+- `./scripts/push.sh` 로 현재 브랜치 변경 사항이 원격에 push 되어 있어야 합니다. 이 스크립트는 origin/<현재브랜치> upstream 도 함께 연결합니다.
+- `gh auth status` 가 정상이어야 합니다.
+- GitHub 저장소에 `release` 브랜치가 있어야 합니다.
+- GitHub Secrets 에 `NPM_TOKEN` 이 설정되어 있어야 태그 생성 후 npm publish 가 성공합니다.
+
+> GitHub Releases 페이지에 버전이 보이려면 태그만으로는 부족하고, 태그 push 시 GitHub Release 객체도 생성되어야 합니다. 현재 워크플로는 이 단계까지 자동 처리합니다.
+
+> `release.sh` 는 로컬 커밋, Git push, npm publish 를 직접 하지 않습니다. 릴리즈 승격만 담당합니다.
+
+---
+
+## 5) update-server.sh
+
+생성된 Gateway 프로젝트의 코어 파일을 최신 npm 패키지 버전으로 업데이트합니다.
+
+```bash
+./scripts/update-server.sh version      # 현재 코어 버전 + 최신 버전 확인
+./scripts/update-server.sh latest       # 최신 버전으로 업데이트
+./scripts/update-server.sh 0.0.8        # 특정 버전으로 업데이트
+```
+
+### 동작
+
+1. npm registry 에서 `create-entity-app-server` 최신 버전을 조회
+2. 해당 패키지 tarball 을 내려받아 `dist-create/template/` 기준으로 코어 파일 추출
+3. 아래 항목만 업데이트
+
+- `system.js`
+- `system-api.js`
+- `scripts/run.sh`, `scripts/entity.sh`, `scripts/reset-all.sh`, `scripts/update-server.sh`
+- `docs/`
+- `tsconfig.json`
+- `.env.example`
+- `.gateway-version`
+- `package.json`의 `scripts`, `dependencies`, `optionalDependencies`, `devDependencies`, `engines`, `os`, `cpu`
+
+### 보존 대상
+
+- `app/`
+- `configs/`
+- `.env`
+- `package.json`의 `name`, `version`, `private` 등 앱 고유 메타데이터
 
-> 빠른 배포 사이클에서 사용합니다. 빌드와 push를 개별적으로 제어하려면 `build.sh` → `push.sh`를 따로 실행하세요.
+> 업데이트 후에는 `npm install` 이 자동 실행됩니다.
 
 ---
 
-## 5) entity.sh
+## 6) entity.sh
 
 `entities/` 폴더의 JSON 스키마를 entity-server에 등록(테이블 생성)합니다.
 
@@ -175,7 +236,7 @@ dist/
 
 ---
 
-## 6) reset-all.sh
+## 7) reset-all.sh
 
 Gateway 전용 엔티티 테이블을 **드롭 후 재생성**합니다.
 
@@ -205,6 +266,16 @@ Gateway 전용 엔티티 테이블을 **드롭 후 재생성**합니다.
 
 ---
 
+## 8) gen-table-type.sh
+
+엔티티 JSON을 기준으로 Kysely 타입 정의를 생성합니다.
+
+```bash
+./scripts/gen-table-type.sh
+```
+
+---
+
 ## 자주 쓰는 워크플로
 
 ### 첫 설치 후 초기화