create-entity-app-server 0.0.3

package/src/app/routes/board/handlers/reports.ts

@@ -0,0 +1,131 @@
+import type { FastifyRequest, FastifyReply } from "fastify";
+import { ok, fail, entityServer } from "@gateway/api";
+
+// ── 신고 제출 ────────────────────────────────────────────────────────────────
+
+export async function submit(
+    req: FastifyRequest<{
+        Params: { seq: string };
+        Body: { reason: string; detail?: string };
+    }>,
+    reply: FastifyReply,
+) {
+    const targetSeq = Number(req.params.seq);
+    const userSeq = req.user!.account_seq as number;
+    const { reason, detail } = req.body;
+
+    // URL 기반 target_type 판별
+    const targetType: "post" | "comment" = (
+        req.routeOptions.url ?? ""
+    ).includes("/comments/")
+        ? "comment"
+        : "post";
+
+    // 대상 존재 확인
+    const entityName = targetType === "post" ? "board_post" : "board_comment";
+    const target = await entityServer.find(entityName, { seq: targetSeq });
+    if (!target.data)
+        return reply
+            .code(404)
+            .send(
+                fail(
+                    `${targetType === "post" ? "게시글" : "댓글"}을 찾을 수 없습니다.`,
+                ),
+            );
+
+    // 중복 신고 확인
+    const duplicate = await entityServer.find("board_report", {
+        target_type: targetType,
+        target_seq: targetSeq,
+        user_seq: userSeq,
+    });
+    if (duplicate.data)
+        return reply.code(400).send(fail("이미 신고한 항목입니다."));
+
+    await entityServer.submit("board_report", {
+        target_type: targetType,
+        target_seq: targetSeq,
+        user_seq: userSeq,
+        reason,
+        detail: detail ?? null,
+    });
+
+    return reply.code(201).send(ok(null));
+}
+
+// ── 관리자: 신고 목록 ─────────────────────────────────────────────────────────
+
+export async function adminList(
+    req: FastifyRequest<{
+        Querystring: {
+            status?: string;
+            page?: number;
+            per_page?: number;
+        };
+    }>,
+    reply: FastifyReply,
+) {
+    if (!req.user?.is_admin)
+        return reply.code(403).send(fail("관리자 권한이 필요합니다."));
+
+    const { status, page = 1, per_page = 20 } = req.query;
+
+    const conditions: Record<string, unknown> = {};
+    if (status) conditions.status = status;
+
+    const resp = await entityServer.list("board_report", {
+        conditions,
+        page,
+        limit: per_page,
+        orderBy: "created_time",
+        orderDir: "DESC",
+    });
+
+    return reply.send(ok(resp.data));
+}
+
+// ── 관리자: 신고 처리 ─────────────────────────────────────────────────────────
+
+export async function adminUpdate(
+    req: FastifyRequest<{
+        Params: { seq: string };
+        Body: {
+            status: "resolved" | "dismissed";
+            hide_target?: boolean;
+        };
+    }>,
+    reply: FastifyReply,
+) {
+    if (!req.user?.is_admin)
+        return reply.code(403).send(fail("관리자 권한이 필요합니다."));
+
+    const seq = Number(req.params.seq);
+    const { status, hide_target = false } = req.body;
+
+    if (!["resolved", "dismissed"].includes(status))
+        return reply
+            .code(400)
+            .send(fail("status는 resolved 또는 dismissed여야 합니다."));
+
+    const report = await entityServer.find("board_report", { seq });
+    if (!report.data)
+        return reply.code(404).send(fail("신고를 찾을 수 없습니다."));
+
+    await entityServer.submit("board_report", { seq, status });
+
+    // resolved + hide_target → 대상 숨김 처리
+    if (status === "resolved" && hide_target) {
+        const reportData = report.data as {
+            target_type: "post" | "comment";
+            target_seq: number;
+        };
+        const entityName =
+            reportData.target_type === "post" ? "board_post" : "board_comment";
+        await entityServer.submit(entityName, {
+            seq: reportData.target_seq,
+            status: "hidden",
+        });
+    }
+
+    return reply.send(ok(null));
+}

package/src/app/routes/board/handlers/tags.ts

@@ -0,0 +1,81 @@
+import type { FastifyRequest, FastifyReply } from "fastify";
+import { ok, entityServer } from "@gateway/api";
+
+// ── 태그 목록 검색 ────────────────────────────────────────────────────────────
+
+export async function list(
+    req: FastifyRequest<{
+        Querystring: { search?: string; limit?: number };
+    }>,
+    reply: FastifyReply,
+) {
+    const { search, limit = 30 } = req.query;
+
+    const resp = await entityServer.list("board_tag", {
+        ...(search ? { conditions: { name: search } } : {}),
+        limit,
+        orderBy: "use_count",
+        orderDir: "DESC",
+    });
+
+    return reply.send(ok(resp.data));
+}
+
+// ── 게시글 태그 설정 ──────────────────────────────────────────────────────────
+
+export async function setPostTagsHandler(
+    req: FastifyRequest<{
+        Params: { seq: string };
+        Body: { tags: string[] };
+    }>,
+    reply: FastifyReply,
+) {
+    const postSeq = Number(req.params.seq);
+    const { tags } = req.body;
+
+    await setPostTags(postSeq, tags);
+    return reply.send(ok(null));
+}
+
+// ── 내부 공유 헬퍼 ────────────────────────────────────────────────────────────
+
+/**
+ * posts.ts create/update 에서도 공유 사용
+ */
+export async function setPostTags(
+    postSeq: number,
+    tags: string[],
+): Promise<void> {
+    // 기존 post-tag 연결 전체 삭제
+    const existing = await entityServer.list("board_post_tag", {
+        conditions: { post_seq: postSeq },
+        limit: 200,
+    });
+    for (const pt of existing.data.items) {
+        await entityServer.delete(
+            "board_post_tag",
+            (pt as Record<string, unknown>).seq as number,
+        );
+    }
+
+    // 각 태그 이름 → slug 변환 후 find-or-create
+    for (const tagName of tags) {
+        const slug = tagName.toLowerCase().replace(/\s+/g, "-");
+        const tagRes = await entityServer.find("board_tag", { name: slug });
+
+        let tagSeq: number;
+        if (tagRes.data) {
+            tagSeq = (tagRes.data as Record<string, unknown>).seq as number;
+        } else {
+            const created = await entityServer.submit("board_tag", {
+                name: slug,
+            });
+            tagSeq = created.seq;
+        }
+
+        await entityServer.submit("board_post_tag", {
+            post_seq: postSeq,
+            tag_seq: tagSeq,
+        });
+    }
+}

package/src/app/routes/board/routes.ts

@@ -0,0 +1,137 @@
+/**
+ * Board 라우트 플러그인
+ *
+ * 자동 로더가 `app/routes/board/routes.ts`를 탐색하여
+ * prefix `/api/v1/board` 으로 등록한다.
+ *
+ * 엔드포인트 목록:
+ *   GET    /categories                         → 카테고리 목록
+ *   GET    /categories/:seq                    → 카테고리 상세
+ *   POST   /categories                         → 카테고리 생성 (관리자)
+ *   PUT    /categories/:seq                    → 카테고리 수정 (관리자)
+ *   DELETE /categories/:seq                    → 카테고리 삭제 (관리자)
+ *
+ *   GET    /:category/list                     → 게시글 목록
+ *   GET    /posts/:seq                         → 게시글 상세
+ *   POST   /:category/submit                   → 게시글 작성 (회원)
+ *   PUT    /posts/:seq                         → 게시글 수정
+ *   DELETE /posts/:seq                         → 게시글 삭제
+ *
+ *   GET    /posts/:postSeq/comments            → 댓글 목록
+ *   POST   /posts/:postSeq/comments/submit     → 댓글 작성
+ *   PUT    /comments/:seq                      → 댓글 수정
+ *   DELETE /comments/:seq                      → 댓글 삭제
+ *
+ *   GET    /posts/:postSeq/files               → 파일 목록
+ *   POST   /posts/:postSeq/files               → 파일 업로드
+ *   GET    /files/:uuid                        → 파일 뷰/다운로드
+ *   DELETE /files/:uuid                        → 파일 삭제
+ *
+ *   POST   /:category/guest-submit             → 비회원 글작성
+ *   POST   /posts/:seq/guest-auth              → 비회원 본인확인 → 임시 토큰
+ *
+ *   POST   /posts/:seq/like                    → 좋아요 토글
+ *   POST   /posts/:seq/accept                  → 답변 채택
+ *
+ *   POST   /posts/:seq/rating                  → 게시글 별점
+ *   POST   /comments/:seq/rating               → 댓글 별점
+ *
+ *   GET    /tags                               → 태그 목록
+ *   PUT    /posts/:seq/tags                    → 게시글 태그 일괄 설정
+ *
+ *   POST   /posts/:seq/report                  → 게시글 신고
+ *   POST   /comments/:seq/report               → 댓글 신고
+ *   GET    /admin/reports                      → 신고 목록 (관리자)
+ *   PATCH  /admin/reports/:seq                 → 신고 상태 변경 (관리자)
+ *
+ *   POST   /posts/:seq/read                    → 읽음 표시
+ *
+ *   GET    /mentions                           → 내 멘션 목록
+ *   PATCH  /mentions/:seq/read                 → 멘션 읽음 처리
+ */
+
+import type { FastifyInstance, RouteHandlerMethod } from "fastify";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { logger, logFmt, ensurePluginEntities } from "@gateway/api";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const h = (fn: any): RouteHandlerMethod => fn;
+import * as posts from "./handlers/posts.ts";
+import * as comments from "./handlers/comments.ts";
+import * as files from "./handlers/files.ts";
+import * as categories from "./handlers/categories.ts";
+import * as likes from "./handlers/likes.ts";
+import * as ratings from "./handlers/ratings.ts";
+import * as tags from "./handlers/tags.ts";
+import * as reports from "./handlers/reports.ts";
+import * as mentions from "./handlers/mentions.ts";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export const suppressRouteRegisterLog = true;
+
+export default async function boardRoutes(app: FastifyInstance): Promise<void> {
+    await ensurePluginEntities(__dirname).catch((err) =>
+        logger.warn({ err }, "board: ensureEntities failed"),
+    );
+
+    const auth = { preHandler: app.authRequired.bind(app) };
+
+    // ── 카테고리 ──────────────────────────────────────────────────────────
+    app.get("/categories", h(categories.list));
+    app.get("/categories/:seq", h(categories.detail));
+    app.post("/categories", auth, h(categories.create));
+    app.put("/categories/:seq", auth, h(categories.update));
+    app.delete("/categories/:seq", auth, h(categories.remove));
+
+    // ── 게시글 · 답글 (board_post 통합) ──────────────────────────────────
+    app.get("/:category/list", h(posts.list));
+    app.get("/posts/:seq", h(posts.detail));
+    app.post("/:category/submit", auth, h(posts.create));
+    app.put("/posts/:seq", auth, h(posts.update));
+    app.delete("/posts/:seq", auth, h(posts.remove));
+
+    // ── 댓글 ──────────────────────────────────────────────────────────────
+    app.get("/posts/:postSeq/comments", h(comments.list));
+    app.post("/posts/:postSeq/comments/submit", auth, h(comments.create));
+    app.put("/comments/:seq", auth, h(comments.update));
+    app.delete("/comments/:seq", auth, h(comments.remove));
+
+    // ── 파일 ──────────────────────────────────────────────────────────────
+    app.get("/posts/:postSeq/files", h(files.list));
+    app.post("/posts/:postSeq/files", auth, h(files.upload));
+    app.get("/files/:uuid", h(files.view));
+    app.delete("/files/:uuid", auth, h(files.remove));
+
+    // ── 비회원 글작성 ─────────────────────────────────────────────────────
+    app.post("/:category/guest-submit", h(posts.guestCreate));
+    app.post("/posts/:seq/guest-auth", h(posts.guestAuth));
+
+    // ── 좋아요 토글 ───────────────────────────────────────────────────────
+    app.post("/posts/:seq/like", auth, h(likes.toggle));
+
+    // ── 답변 채택 ─────────────────────────────────────────────────────────
+    app.post("/posts/:seq/accept", auth, h(posts.accept));
+
+    // ── 별점 ──────────────────────────────────────────────────────────────
+    app.post("/posts/:seq/rating", auth, h(ratings.upsert));
+    app.post("/comments/:seq/rating", auth, h(ratings.upsert));
+
+    // ── 태그 ──────────────────────────────────────────────────────────────
+    app.get("/tags", h(tags.list));
+    app.put("/posts/:seq/tags", auth, h(tags.setPostTagsHandler));
+
+    // ── 신고 ──────────────────────────────────────────────────────────────
+    app.post("/posts/:seq/report", auth, h(reports.submit));
+    app.post("/comments/:seq/report", auth, h(reports.submit));
+    app.get("/admin/reports", auth, h(reports.adminList));
+    app.patch("/admin/reports/:seq", auth, h(reports.adminUpdate));
+
+    // ── 읽음 표시 ─────────────────────────────────────────────────────────
+    app.post("/posts/:seq/read", auth, h(posts.markRead));
+
+    // ── 멘션 ──────────────────────────────────────────────────────────────
+    app.get("/mentions", auth, h(mentions.list));
+    app.patch("/mentions/:seq/read", auth, h(mentions.markRead));
+}

package/src/app/routes/calendar/config.json

@@ -0,0 +1,5 @@
+{
+    "enabled": false,
+    "deploy": false,
+    "minify": false
+}

package/src/app/routes/calendar/entities/calendar_attendees.json

@@ -0,0 +1,23 @@
+{
+    "name": "calendar_attendees",
+    "description": "일정 참석자 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "event_seq": {
+            "index": true,
+            "comment": "일정seq"
+        },
+        "employee_seq": {
+            "index": true,
+            "comment": "직원seq"
+        }
+    },
+    "unique": [
+        [
+            "event_seq",
+            "employee_seq"
+        ]
+    ],
+    "fk": {
+        "event_seq": "calendar_events.seq"
+    }
+}

package/src/app/routes/calendar/entities/calendar_comments.json

@@ -0,0 +1,17 @@
+{
+    "name": "calendar_comments",
+    "description": "일정 댓글 정보. JWT 인증 시 account_seq ↔ account 관계. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "event_seq": {
+            "index": true,
+            "comment": "일정seq"
+        },
+        "account_seq": {
+            "index": true,
+            "comment": "사용자seq (JWT 인증 시 account.seq 참조. HMAC은 nullable)"
+        }
+    },
+    "fk": {
+        "event_seq": "calendar_events.seq"
+    }
+}

package/src/app/routes/calendar/entities/calendar_events.json

@@ -0,0 +1,48 @@
+{
+    "name": "calendar_events",
+    "description": "달력 이벤트 정보. JWT 인증 시 account_seq ↔ account 관계. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "account_seq": {
+            "index": true,
+            "comment": "사용자seq (JWT 인증 시 account.seq 참조. HMAC은 nullable)"
+        },
+        "bgn_time": {
+            "index": true,
+            "comment": "시작일시"
+        },
+        "category": {
+            "index": true,
+            "comment": "분류"
+        },
+        "end_time": {
+            "index": true,
+            "comment": "종료일시"
+        },
+        "group_seq": {
+            "index": true,
+            "comment": "그룹seq"
+        },
+        "method": {
+            "index": true,
+            "comment": "방식"
+        },
+        "related_seq": {
+            "index": true,
+            "comment": "연관seq"
+        },
+        "repeat": {
+            "comment": "반복여부"
+        },
+        "title": {
+            "index": true,
+            "comment": "제목"
+        },
+        "visible": {
+            "index": true,
+            "comment": "공개여부"
+        }
+    },
+    "fk": {
+        "group_seq": "hr_group.seq"
+    }
+}

package/src/app/routes/calendar/entities/calendar_kind.json

@@ -0,0 +1,11 @@
+{
+    "name": "calendar_kind",
+    "description": "calendar_kind 엔티티. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "name": {
+            "index": true,
+            "comment": "이름",
+            "unique": true
+        }
+    }
+}

package/src/app/routes/calendar/entities/calendar_method.json

@@ -0,0 +1,11 @@
+{
+    "name": "calendar_method",
+    "description": "calendar_method 엔티티. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "name": {
+            "index": true,
+            "comment": "이름",
+            "unique": true
+        }
+    }
+}

package/src/app/routes/calendar/routes.ts

@@ -0,0 +1,32 @@
+/**
+ * Calendar 라우트 플러그인
+ *
+ * 자동 로더가 `app/routes/calendar/routes.ts`를 탐색하여
+ * prefix `/api/v1/calendar` 으로 등록한다.
+ *
+ * 엔티티:
+ *   - calendar_events     — 일정/이벤트
+ *   - calendar_attendees  — 일정 참석자
+ *   - calendar_comments   — 일정 댓글
+ *   - calendar_files      — 일정 첨부파일
+ *   - calendar_kind       — 일정 분류
+ *   - calendar_method     — 일정 방법(비대면/대면 등)
+ */
+
+import type { FastifyInstance } from "fastify";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { logger, ensurePluginEntities } from "@gateway/api";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export default async function calendarRoutes(
+    app: FastifyInstance,
+): Promise<void> {
+    await ensurePluginEntities(__dirname).catch((err) =>
+        logger.warn({ err }, "calendar: ensureEntities failed"),
+    );
+
+    // TODO: 일정 라우트 핸들러 추가
+    void app;
+}

package/src/app/routes/email-verify/config-loader.ts

@@ -0,0 +1,47 @@
+/**
+ * email-verify 설정 로더
+ *
+ * `router.ts`와 외부 모듈(register 등) 모두에서 재사용하기 위해
+ * 별도 파일로 분리.
+ *
+ * Usage:
+ *   import { loadEmailVerifyConfig } from "../../email-verify/config-loader.ts";
+ *   const cfg = loadEmailVerifyConfig();
+ *   if (cfg.enabled) { ... }
+ */
+
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import type { EmailVerifyConfig } from "./types/index.ts";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/** email-verify/config.json 로드 + 기본값 보정 */
+export function loadEmailVerifyConfig(): EmailVerifyConfig {
+    const configPath = resolve(__dirname, "config.json");
+    let raw: Record<string, unknown> = {};
+    if (existsSync(configPath)) {
+        const text = readFileSync(configPath, "utf-8").replace(
+            /\$\{([^}]+)\}/g,
+            (_m, name) => process.env[name] ?? "",
+        );
+        raw = JSON.parse(text) as Record<string, unknown>;
+    }
+
+    const rl = (raw.rate_limit ?? {}) as Record<string, unknown>;
+
+    return {
+        enabled: raw.enabled !== false,
+        required: raw.required === true,
+        code_length: Number(raw.code_length) || 6,
+        code_ttl_sec: Number(raw.code_ttl_sec) || 300,
+        max_attempts: Number(raw.max_attempts) || 5,
+        resend_cooldown_sec: Number(raw.resend_cooldown_sec) || 60,
+        link_base_url: String(raw.link_base_url ?? ""),
+        rate_limit: {
+            per_email_per_hour: Number(rl.per_email_per_hour) || 5,
+        },
+        email_subject: String(raw.email_subject ?? "이메일 인증"),
+    };
+}

package/src/app/routes/email-verify/config.example.json

@@ -0,0 +1,13 @@
+{
+    "enabled": true,
+    "required": false,
+    "code_length": 6,
+    "code_ttl_sec": 300,
+    "max_attempts": 5,
+    "resend_cooldown_sec": 60,
+    "link_base_url": "https://example.com/verify-email",
+    "rate_limit": {
+        "per_email_per_hour": 5
+    },
+    "email_subject": "이메일 인증"
+}

package/src/app/routes/email-verify/config.json

@@ -0,0 +1,16 @@
+{
+    "_comment": "이메일 인증 설정. enabled를 true로 설정하면 이메일 인증 기능이 활성화됩니다. code_length는 인증 코드의 길이를, code_ttl_sec는 인증 코드의 유효 기간(초)을, max_attempts는 최대 시도 횟수를, resend_cooldown_sec는 재전송 쿨다운(초)을 의미합니다. link_base_url은 이메일에 포함된 인증 링크의 기본 URL입니다.",
+    "enabled": true,
+    "required": false,
+    "code_length": 6,
+    "code_ttl_sec": 300,
+    "max_attempts": 5,
+    "resend_cooldown_sec": 60,
+    "link_base_url": "",
+    "rate_limit": {
+        "per_email_per_hour": 5
+    },
+    "email_subject": "이메일 인증",
+    "deploy": false,
+    "minify": false
+}

package/src/app/routes/email-verify/entities/account.json

@@ -0,0 +1,23 @@
+{
+    "name": "account",
+    "description": "이메일 인증(email-verify) 라우트 전용 필드. email_verified 상태에 따른 처리(인증 메일 발송/검증/차단)는 앱서버 email-verify 라우트가 담당합니다.",
+    "fields": {
+        "email_verified": {
+            "type": "bool",
+            "default": false,
+            "comment": "이메일 인증 완료 여부"
+        },
+        "email_verify_code": {
+            "type": "varchar(64)",
+            "comment": "인증 코드 SHA-256 해시"
+        },
+        "email_verify_expires_time": {
+            "comment": "인증 코드 만료 시각 (RFC3339)"
+        },
+        "email_verify_attempts": {
+            "type": "uint",
+            "default": 0,
+            "comment": "이메일 인증 시도 횟수"
+        }
+    }
+}