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

package/dist/routes/labels/[id]/index.js

@@ -1,96 +1,506 @@
-/**
- * CMS Label Detail Routes
- *
- * - GET /cms/labels/:id - 라벨 단건 조회
- * - PATCH /cms/labels/:id - 라벨 메타데이터 수정
- * - DELETE /cms/labels/:id - 라벨 삭제
- */
-import { createApp } from '@spfn/core/route';
-import { Transactional } from '@spfn/core/db';
-import { cmsLabelsRepository } from '../../../repositories/index.js';
-import { getLabelContract, updateLabelContract, deleteLabelContract, } from './contract.js';
-const app = createApp();
-/**
- * GET /cms/labels/:id
- * 라벨 단건 조회
- */
+// src/routes/labels/[id]/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/[id]/index.ts
+var app = createApp();
 app.bind(getLabelContract, async (c) => {
-    const { id } = c.params;
-    const labelId = parseInt(id, 10);
-    if (isNaN(labelId)) {
-        return c.json({ error: 'Invalid label ID' }, 400);
-    }
-    const label = await cmsLabelsRepository.findById(labelId);
-    if (!label) {
-        return c.json({ error: 'Label not found' }, 404);
-    }
-    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(),
-    });
+  const { id } = c.params;
+  const labelId = parseInt(id, 10);
+  if (isNaN(labelId)) {
+    return c.json({ error: "Invalid label ID" }, 400);
+  }
+  const label = await cmsLabelsRepository.findById(labelId);
+  if (!label) {
+    return c.json({ error: "Label not found" }, 404);
+  }
+  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()
+  });
 });
-/**
- * PATCH /cms/labels/:id
- * 라벨 메타데이터 수정
- */
 app.bind(updateLabelContract, [Transactional()], async (c) => {
-    const { id } = c.params;
-    const labelId = parseInt(id, 10);
-    if (isNaN(labelId)) {
-        return c.json({ error: 'Invalid label ID' }, 400);
-    }
-    const body = await c.data();
-    // 라벨 존재 확인
-    const existing = await cmsLabelsRepository.findById(labelId);
-    if (!existing) {
-        return c.json({ error: 'Label not found' }, 404);
-    }
-    // 라벨 수정
-    const updated = await cmsLabelsRepository.updateById(labelId, body);
-    if (!updated) {
-        return c.json({ error: 'Failed to update label' }, 500);
-    }
-    return c.json({
-        id: updated.id,
-        key: updated.key,
-        section: updated.section,
-        type: updated.type,
-        publishedVersion: updated.publishedVersion,
-        createdBy: updated.createdBy,
-        createdAt: updated.createdAt.toISOString(),
-        updatedAt: updated.updatedAt.toISOString(),
-    });
+  const { id } = c.params;
+  const labelId = parseInt(id, 10);
+  if (isNaN(labelId)) {
+    return c.json({ error: "Invalid label ID" }, 400);
+  }
+  const body = await c.data();
+  const existing = await cmsLabelsRepository.findById(labelId);
+  if (!existing) {
+    return c.json({ error: "Label not found" }, 404);
+  }
+  const updated = await cmsLabelsRepository.updateById(labelId, body);
+  if (!updated) {
+    return c.json({ error: "Failed to update label" }, 500);
+  }
+  return c.json({
+    id: updated.id,
+    key: updated.key,
+    section: updated.section,
+    type: updated.type,
+    publishedVersion: updated.publishedVersion,
+    createdBy: updated.createdBy,
+    createdAt: updated.createdAt.toISOString(),
+    updatedAt: updated.updatedAt.toISOString()
+  });
 });
-/**
- * DELETE /cms/labels/:id
- * 라벨 삭제
- */
 app.bind(deleteLabelContract, [Transactional()], async (c) => {
-    const { id } = c.params;
-    const labelId = parseInt(id, 10);
-    if (isNaN(labelId)) {
-        return c.json({ error: 'Invalid label ID' }, 400);
-    }
-    // 라벨 존재 확인
-    const existing = await cmsLabelsRepository.findById(labelId);
-    if (!existing) {
-        return c.json({ error: 'Label not found' }, 404);
-    }
-    // 라벨 삭제 (CASCADE로 values도 함께 삭제됨)
-    const deleted = await cmsLabelsRepository.deleteById(labelId);
-    if (!deleted) {
-        return c.json({ error: 'Failed to delete label' }, 500);
-    }
-    return c.json({
-        success: true,
-        id: deleted.id,
-    });
+  const { id } = c.params;
+  const labelId = parseInt(id, 10);
+  if (isNaN(labelId)) {
+    return c.json({ error: "Invalid label ID" }, 400);
+  }
+  const existing = await cmsLabelsRepository.findById(labelId);
+  if (!existing) {
+    return c.json({ error: "Label not found" }, 404);
+  }
+  const deleted = await cmsLabelsRepository.deleteById(labelId);
+  if (!deleted) {
+    return c.json({ error: "Failed to delete label" }, 500);
+  }
+  return c.json({
+    success: true,
+    id: deleted.id
+  });
 });
-export default app;
+var id_default = app;
+export {
+  id_default as default
+};
 //# sourceMappingURL=index.js.map