@spfn/cms 0.1.0-alpha.6 → 0.1.0-alpha.60

package/dist/routes/labels/index.js

@@ -1,73 +1,493 @@
-/**
- * CMS Labels Routes
- *
- * 라벨 메타데이터 관리 API
- * - GET /cms/labels - 라벨 목록 조회
- * - POST /cms/labels - 새 라벨 생성
- */
-import { createApp } from '@spfn/core/route';
-import { Transactional } from '@spfn/core/db';
-import { cmsLabelsRepository } from '../../repositories/index.js';
-import { getLabelsContract, createLabelContract } from './contract.js';
-const app = createApp();
-/**
- * GET /cms/labels
- * 라벨 목록 조회 (페이지네이션, 섹션 필터)
- */
+// src/routes/labels/index.ts
+import { createApp } from "@spfn/core/route";
+import { Transactional } from "@spfn/core/db";
+
+// src/repositories/cms-labels.repository.ts
+import { findOne, findMany as findManyHelper, create as createHelper, updateOne, deleteOne, count as countHelper } from "@spfn/core/db";
+import { desc } from "drizzle-orm";
+
+// src/entities/cms-labels.ts
+import { index, integer, serial, text, timestamp } from "drizzle-orm/pg-core";
+import { createFunctionSchema } from "@spfn/core/db";
+var schema = createFunctionSchema("@spfn/cms");
+var cmsLabels = schema.table("labels", {
+  // Primary Key
+  id: serial("id").primaryKey(),
+  // 라벨 식별자
+  key: text("key").notNull().unique(),
+  // 예: "home.hero.title", "why-futureplay.hero.subtitle"
+  // 구조: {section}.{component}.{property}
+  // 섹션 분류 (페이지 단위)
+  section: text("section").notNull(),
+  // 예: "home", "why-futureplay", "team"
+  // 값 타입
+  type: text("type").notNull(),
+  // "text" | "image" | "video" | "file" | "object"
+  // 기본값
+  defaultValue: text("default_value"),
+  // 라벨의 기본값 (sync 시 설정)
+  // 설명
+  description: text("description"),
+  // 라벨에 대한 설명 (optional)
+  // 현재 발행된 버전 번호
+  publishedVersion: integer("published_version"),
+  // null = 미발행 상태
+  // 1, 2, 3... = 발행된 버전 번호
+  // 생성자 추적
+  createdBy: text("created_by"),
+  // 타임스탬프
+  createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
+  updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (table) => [
+  // 인덱스: 섹션별 조회 최적화
+  index("cms_labels_section_idx").on(table.section),
+  // 인덱스: key로 조회 최적화 (unique 제약으로 자동 생성되지만 명시)
+  index("cms_labels_key_idx").on(table.key)
+]);
+
+// src/entities/cms-label-values.ts
+import { serial as serial2, integer as integer2, text as text2, jsonb, timestamp as timestamp2, index as index2, unique } from "drizzle-orm/pg-core";
+import { createFunctionSchema as createFunctionSchema2 } from "@spfn/core/db";
+var schema2 = createFunctionSchema2("@spfn/cms");
+var cmsLabelValues = schema2.table("label_values", {
+  // Primary Key
+  id: serial2("id").primaryKey(),
+  // Foreign Key: cms_labels
+  labelId: integer2("label_id").notNull().references(() => cmsLabels.id, { onDelete: "cascade" }),
+  // 버전 번호
+  version: integer2("version").notNull().default(1),
+  // 언어 코드
+  locale: text2("locale").notNull().default("ko"),
+  // "ko" | "en" | "ja"
+  // 반응형 브레이크포인트
+  breakpoint: text2("breakpoint"),
+  // null = 기본값 (모든 화면 크기)
+  // "sm" | "md" | "lg" | "xl" | "2xl"
+  // 실제 값 (JSONB)
+  value: jsonb("value").notNull(),
+  // LabelValue 타입:
+  // - TextValue: { type: "text", content: string }
+  // - ImageValue: { type: "image", url: string, alt?: string, width?: number, height?: number }
+  // - VideoValue: { type: "video", url: string, thumbnail?: string, duration?: number }
+  // - FileValue: { type: "file", url: string, filename: string, size?: number }
+  // - ObjectValue: { type: "object", fields: Record<string, LabelValue> }
+  // 생성 시각
+  createdAt: timestamp2("created_at", { withTimezone: true }).notNull().defaultNow()
+}, (table) => [
+  // UNIQUE 제약: 같은 버전에서 locale + breakpoint 조합은 유일
+  unique("cms_label_values_locale_breakpoint_unique").on(table.labelId, table.version, table.locale, table.breakpoint),
+  // 인덱스: labelId + version 복합 조회 최적화
+  index2("cms_label_values_label_version_idx").on(table.labelId, table.version),
+  // 인덱스: locale 필터링 최적화
+  index2("cms_label_values_locale_idx").on(table.locale)
+]);
+
+// src/entities/cms-label-versions.ts
+import { serial as serial3, integer as integer3, text as text3, timestamp as timestamp3, index as index3, unique as unique2 } from "drizzle-orm/pg-core";
+import { createFunctionSchema as createFunctionSchema3 } from "@spfn/core/db";
+var schema3 = createFunctionSchema3("@spfn/cms");
+var cmsLabelVersions = schema3.table("label_versions", {
+  // Primary Key
+  id: serial3("id").primaryKey(),
+  // Foreign Key: cms_labels
+  labelId: integer3("label_id").notNull().references(() => cmsLabels.id, { onDelete: "cascade" }),
+  // 버전 번호
+  version: integer3("version").notNull(),
+  // 버전 상태
+  status: text3("status").notNull(),
+  // "draft" | "published" | "archived"
+  // 발행 정보
+  publishedAt: timestamp3("published_at", { withTimezone: true }),
+  publishedBy: text3("published_by"),
+  // 버전 노트 (변경사항 설명)
+  notes: text3("notes"),
+  // 버전 생성자
+  createdBy: text3("created_by"),
+  // 생성 시각
+  createdAt: timestamp3("created_at", { withTimezone: true }).notNull().defaultNow()
+}, (table) => [
+  // UNIQUE 제약: 각 라벨의 버전 번호는 고유
+  unique2("cms_label_versions_label_version_unique").on(table.labelId, table.version),
+  // 인덱스: labelId로 버전 목록 조회 최적화
+  index3("cms_label_versions_label_id_idx").on(table.labelId),
+  // 인덱스: status 필터링 최적화
+  index3("cms_label_versions_status_idx").on(table.status)
+]);
+
+// src/entities/cms-draft-cache.ts
+import { serial as serial4, text as text4, jsonb as jsonb2, timestamp as timestamp4, index as index4, unique as unique3 } from "drizzle-orm/pg-core";
+import { createFunctionSchema as createFunctionSchema4 } from "@spfn/core/db";
+var schema4 = createFunctionSchema4("@spfn/cms");
+var cmsDraftCache = schema4.table("draft_cache", {
+  // Primary Key
+  id: serial4("id").primaryKey(),
+  // 섹션 (페이지 단위)
+  section: text4("section").notNull(),
+  // "home" | "why-futureplay" | "team" | "our-companies" | "apply"
+  // 언어
+  locale: text4("locale").notNull(),
+  // "ko" | "en" | "ja"
+  // 사용자 ID (핵심 필드!)
+  userId: text4("user_id").notNull(),
+  // 각 관리자의 독립적인 작업 공간
+  // Draft 콘텐츠 (JSONB)
+  content: jsonb2("content").notNull(),
+  // Record<string, LabelValue>
+  // {
+  //   "home.hero.title": { type: "text", content: "수정 중..." },
+  //   "home.hero.subtitle": { type: "text", content: "새로운 문구" },
+  //   ...
+  // }
+  // 최종 수정 시각
+  updatedAt: timestamp4("updated_at", { withTimezone: true }).notNull().defaultNow()
+}, (table) => [
+  // UNIQUE 제약: section + locale + userId 조합은 유일
+  unique3("cms_draft_cache_unique").on(table.section, table.locale, table.userId),
+  // 인덱스: section으로 조회 최적화
+  index4("cms_draft_cache_section_idx").on(table.section),
+  // 인덱스: userId로 사용자의 모든 draft 조회 최적화
+  index4("cms_draft_cache_user_idx").on(table.userId)
+]);
+
+// src/entities/cms-published-cache.ts
+import { serial as serial5, text as text5, jsonb as jsonb3, integer as integer4, timestamp as timestamp5, index as index5, unique as unique4 } from "drizzle-orm/pg-core";
+import { createFunctionSchema as createFunctionSchema5 } from "@spfn/core/db";
+var schema5 = createFunctionSchema5("@spfn/cms");
+var cmsPublishedCache = schema5.table("published_cache", {
+  // Primary Key
+  id: serial5("id").primaryKey(),
+  // 섹션 (페이지 단위)
+  section: text5("section").notNull(),
+  // "home" | "why-futureplay" | "team" | "our-companies" | "apply"
+  // 언어
+  locale: text5("locale").notNull(),
+  // "ko" | "en" | "ja"
+  // 캐시된 콘텐츠 (JSONB)
+  content: jsonb3("content").notNull(),
+  // Record<string, LabelValue>
+  // {
+  //   "home.hero.title": { type: "text", content: "..." },
+  //   "home.hero.image": { type: "image", url: "...", alt: "..." },
+  //   ...
+  // }
+  // 발행 정보
+  publishedAt: timestamp5("published_at", { withTimezone: true }).notNull(),
+  publishedBy: text5("published_by"),
+  // 캐시 버전 (클라이언트 캐싱용)
+  version: integer4("version").notNull().default(1)
+}, (table) => [
+  // UNIQUE 제약: section + locale 조합은 유일
+  unique4("cms_published_cache_unique").on(table.section, table.locale),
+  // 인덱스: section으로 조회 최적화
+  index5("cms_published_cache_section_idx").on(table.section)
+]);
+
+// src/entities/cms-audit-logs.ts
+import { serial as serial6, integer as integer5, text as text6, jsonb as jsonb4, timestamp as timestamp6, index as index6 } from "drizzle-orm/pg-core";
+import { createFunctionSchema as createFunctionSchema6 } from "@spfn/core/db";
+var schema6 = createFunctionSchema6("@spfn/cms");
+var cmsAuditLogs = schema6.table("audit_logs", {
+  // Primary Key
+  id: serial6("id").primaryKey(),
+  // Foreign Key: cms_labels (nullable - 라벨 삭제 시 로그는 유지)
+  labelId: integer5("label_id").references(() => cmsLabels.id, { onDelete: "set null" }),
+  // 작업 유형
+  action: text6("action").notNull(),
+  // "create" | "update" | "publish" | "unpublish" | "archive" | "delete" | "rollback" | "duplicate"
+  // 사용자 정보
+  userId: text6("user_id").notNull(),
+  userName: text6("user_name"),
+  // 변경 내용 (before/after)
+  changes: jsonb4("changes"),
+  // { before: {...}, after: {...} }
+  // 추가 메타데이터
+  metadata: jsonb4("metadata"),
+  // { version: number, ip: string, userAgent: string, ... }
+  // 작업 시각
+  createdAt: timestamp6("created_at", { withTimezone: true }).notNull().defaultNow()
+}, (table) => [
+  // 인덱스: labelId로 이력 조회 최적화
+  index6("cms_audit_logs_label_id_idx").on(table.labelId),
+  // 인덱스: userId로 사용자 활동 조회 최적화
+  index6("cms_audit_logs_user_id_idx").on(table.userId),
+  // 인덱스: action 필터링 최적화
+  index6("cms_audit_logs_action_idx").on(table.action),
+  // 인덱스: 시간순 조회 최적화
+  index6("cms_audit_logs_created_at_idx").on(table.createdAt)
+]);
+
+// src/repositories/cms-labels.repository.ts
+async function findMany(options) {
+  const { section, limit = 20, offset = 0 } = options || {};
+  return findManyHelper(cmsLabels, {
+    where: section ? { section } : void 0,
+    orderBy: desc(cmsLabels.updatedAt),
+    limit,
+    offset
+  });
+}
+async function count(section) {
+  return countHelper(cmsLabels, section ? { section } : void 0);
+}
+async function findById(id) {
+  return findOne(cmsLabels, { id });
+}
+async function findByKey(key) {
+  return findOne(cmsLabels, { key });
+}
+async function findBySection(section) {
+  return findManyHelper(cmsLabels, {
+    where: { section },
+    orderBy: desc(cmsLabels.updatedAt)
+  });
+}
+async function create(data) {
+  return createHelper(cmsLabels, data);
+}
+async function updateById(id, data) {
+  return updateOne(cmsLabels, { id }, { ...data, updatedAt: /* @__PURE__ */ new Date() });
+}
+async function deleteById(id) {
+  return deleteOne(cmsLabels, { id });
+}
+var cmsLabelsRepository = {
+  findMany,
+  count,
+  findById,
+  findByKey,
+  findBySection,
+  create,
+  updateById,
+  deleteById
+};
+
+// src/repositories/cms-label-values.repository.ts
+import { findOne as findOne2, findMany as findMany2, create as create2, updateOne as updateOne2, deleteMany } from "@spfn/core/db";
+import { eq, and, isNull } from "drizzle-orm";
+
+// src/repositories/cms-draft-cache.repository.ts
+import { findOne as findOne3, findMany as findMany3, deleteOne as deleteOne2, deleteMany as deleteMany2, upsert as upsertHelper } from "@spfn/core/db";
+import { eq as eq2, and as and2, lt } from "drizzle-orm";
+
+// src/repositories/cms-published-cache.repository.ts
+import { findOne as findOne4, findMany as findMany4, deleteOne as deleteOne3, deleteMany as deleteMany3, upsert as upsertHelper2 } from "@spfn/core/db";
+import { eq as eq3, and as and3, sql } from "drizzle-orm";
+
+// src/contracts/labels.ts
+import { Type } from "@sinclair/typebox";
+var getLabelsContract = {
+  method: "GET",
+  path: "/cms/labels",
+  query: Type.Object({
+    section: Type.Optional(Type.String({ description: "\uC139\uC158\uC73C\uB85C \uD544\uD130\uB9C1 (\uC608: home, why-futureplay)" })),
+    limit: Type.Optional(Type.Number({ minimum: 1, maximum: 100, default: 20, description: "\uD398\uC774\uC9C0\uB2F9 \uD56D\uBAA9 \uC218" })),
+    offset: Type.Optional(Type.Number({ minimum: 0, default: 0, description: "\uC2DC\uC791 \uC624\uD504\uC14B" }))
+  }),
+  response: Type.Object({
+    labels: Type.Array(Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String()
+    })),
+    total: Type.Number(),
+    limit: Type.Number(),
+    offset: Type.Number()
+  })
+};
+var createLabelContract = {
+  method: "POST",
+  path: "/cms/labels",
+  body: Type.Object({
+    key: Type.String({
+      description: "\uACE0\uC720 \uD0A4 (\uC608: home.hero.title)",
+      pattern: "^[a-z0-9-]+\\.[a-z0-9-]+\\.[a-z0-9-]+$"
+    }),
+    section: Type.String({
+      description: "\uC139\uC158 \uC774\uB984 (\uC608: home, why-futureplay)",
+      pattern: "^[a-z0-9-]+$"
+    }),
+    type: Type.Union([
+      Type.Literal("text"),
+      Type.Literal("image"),
+      Type.Literal("video"),
+      Type.Literal("file"),
+      Type.Literal("object")
+    ], { description: "\uAC12 \uD0C0\uC785" }),
+    createdBy: Type.Optional(Type.String({ description: "\uC0DD\uC131\uC790 ID" }))
+  }),
+  response: Type.Union([
+    Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String()
+    }),
+    Type.Object({
+      error: Type.String(),
+      key: Type.Optional(Type.String())
+    })
+  ])
+};
+var getLabelContract = {
+  method: "GET",
+  path: "/cms/labels/:id",
+  params: Type.Object({
+    id: Type.String({ description: "\uB77C\uBCA8 ID" })
+  }),
+  response: Type.Union([
+    Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String()
+    }),
+    Type.Object({
+      error: Type.String()
+    })
+  ])
+};
+var updateLabelContract = {
+  method: "PATCH",
+  path: "/cms/labels/:id",
+  params: Type.Object({
+    id: Type.String({ description: "\uB77C\uBCA8 ID" })
+  }),
+  body: Type.Object({
+    section: Type.Optional(Type.String({ description: "\uC139\uC158 \uBCC0\uACBD" })),
+    type: Type.Optional(Type.Union([
+      Type.Literal("text"),
+      Type.Literal("image"),
+      Type.Literal("video"),
+      Type.Literal("file"),
+      Type.Literal("object")
+    ]))
+  }),
+  response: Type.Union([
+    Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String()
+    }),
+    Type.Object({
+      error: Type.String()
+    })
+  ])
+};
+var deleteLabelContract = {
+  method: "DELETE",
+  path: "/cms/labels/:id",
+  params: Type.Object({
+    id: Type.String({ description: "\uB77C\uBCA8 ID" })
+  }),
+  response: Type.Union([
+    Type.Object({
+      success: Type.Boolean(),
+      id: Type.Number()
+    }),
+    Type.Object({
+      error: Type.String()
+    })
+  ])
+};
+var getLabelByKeyContract = {
+  method: "GET",
+  path: "/cms/labels/by-key/:key",
+  params: Type.Object({
+    key: Type.String({ description: "\uB77C\uBCA8 Key (\uC608: home.hero.title)" })
+  }),
+  response: Type.Union([
+    Type.Object({
+      id: Type.Number(),
+      key: Type.String(),
+      section: Type.String(),
+      type: Type.String(),
+      publishedVersion: Type.Union([Type.Number(), Type.Null()]),
+      createdBy: Type.Union([Type.String(), Type.Null()]),
+      createdAt: Type.String(),
+      updatedAt: Type.String()
+    }),
+    Type.Object({
+      error: Type.String(),
+      key: Type.Optional(Type.String())
+    })
+  ])
+};
+
+// src/routes/labels/index.ts
+var app = createApp();
 app.bind(getLabelsContract, async (c) => {
-    const { section, limit = 20, offset = 0 } = c.query;
-    // 라벨 목록 조회
-    const labels = await cmsLabelsRepository.findMany({
-        section,
-        limit,
-        offset,
-    });
-    // 전체 개수 조회
-    const total = await cmsLabelsRepository.count(section);
-    return c.json({
-        labels: labels.map((label) => ({
-            id: label.id,
-            key: label.key,
-            section: label.section,
-            type: label.type,
-            publishedVersion: label.publishedVersion,
-            createdBy: label.createdBy,
-            createdAt: label.createdAt.toISOString(),
-            updatedAt: label.updatedAt.toISOString(),
-        })),
-        total,
-        limit,
-        offset,
-    });
+  const { section, limit = 20, offset = 0 } = c.query;
+  const labels = await cmsLabelsRepository.findMany({
+    section,
+    limit,
+    offset
+  });
+  const total = await cmsLabelsRepository.count(section);
+  return c.json({
+    labels: labels.map((label) => ({
+      id: label.id,
+      key: label.key,
+      section: label.section,
+      type: label.type,
+      publishedVersion: label.publishedVersion,
+      createdBy: label.createdBy,
+      createdAt: label.createdAt.toISOString(),
+      updatedAt: label.updatedAt.toISOString()
+    })),
+    total,
+    limit,
+    offset
+  });
 });
-/**
- * POST /cms/labels
- * 새 라벨 생성
- */
 app.bind(createLabelContract, [Transactional()], async (c) => {
-    const body = await c.data();
-    // 중복 key 체크
-    const existing = await cmsLabelsRepository.findByKey(body.key);
-    if (existing) {
-        return c.json({ error: 'Label with this key already exists', key: body.key }, 409);
-    }
-    // 라벨 생성
-    const label = await cmsLabelsRepository.create({
-        key: body.key,
-        section: body.section,
-        type: body.type,
-        createdBy: body.createdBy,
-    });
-    return c.json({
-        id: label.id,
-        key: label.key,
-        section: label.section,
-        type: label.type,
-        publishedVersion: label.publishedVersion,
-        createdBy: label.createdBy,
-        createdAt: label.createdAt.toISOString(),
-        updatedAt: label.updatedAt.toISOString(),
-    }, 201);
+  const body = await c.data();
+  const existing = await cmsLabelsRepository.findByKey(body.key);
+  if (existing) {
+    return c.json(
+      { error: "Label with this key already exists", key: body.key },
+      409
+    );
+  }
+  const label = await cmsLabelsRepository.create({
+    key: body.key,
+    section: body.section,
+    type: body.type,
+    createdBy: body.createdBy
+  });
+  return c.json(
+    {
+      id: label.id,
+      key: label.key,
+      section: label.section,
+      type: label.type,
+      publishedVersion: label.publishedVersion,
+      createdBy: label.createdBy,
+      createdAt: label.createdAt.toISOString(),
+      updatedAt: label.updatedAt.toISOString()
+    },
+    201
+  );
 });
-export default app;
+var labels_default = app;
+export {
+  labels_default as default
+};
 //# sourceMappingURL=index.js.map