create-entity-app-server 0.0.3 → 0.0.4

package/src/app/plugins/smtp/handlers.ts

@@ -1,52 +0,0 @@
-/**
- * SMTP API 핸들러
- *
- * 앱 서버가 직접 처리하는 이유:
- *  - 로컬 템플릿(templates/*.html) 렌더링 후 body_html을 완성하여 Go 서버로 전달
- *  - 프록시 패스스루로는 앱 서버 로컬 파일에 접근 불가
- *
- * 라우트에 없는 /api/v1/smtp/* 경로는 proxy/register.ts가 Go 서버로 패스스루한다.
- */
-
-import type { FastifyRequest, FastifyReply } from "fastify";
-import { ok, fail, sendEmail, entityServer } from "@gateway/api";
-import type { SendEmailParams } from "@gateway/api";
-
-// ─── 핸들러 ──────────────────────────────────────────────────────────────────
-
-/**
- * POST /api/v1/smtp/send
- *
- * templateName이 지정되면 로컬 templates/ 에서 렌더링 후 Go 서버에 전달.
- * templateName 없이 body_html/body_text만 지정하면 그대로 전달.
- */
-export async function handleSend(request: FastifyRequest, reply: FastifyReply) {
-    const params = (request.body ?? {}) as SendEmailParams;
-
-    if (!params.to || params.to.length === 0) {
-        return reply.status(400).send(fail("to is required"));
-    }
-
-    const seq = await sendEmail(params);
-    return ok({ seq });
-}
-
-/**
- * GET /api/v1/smtp/status/:seq
- *
- * Go 서버에 발송 상태를 조회한다.
- */
-export async function handleStatus(
-    request: FastifyRequest,
-    reply: FastifyReply,
-) {
-    const { seq } = request.params as { seq: string };
-    const seqNum = Number(seq);
-
-    if (!seqNum || seqNum <= 0) {
-        return reply.status(400).send(fail("Invalid seq"));
-    }
-
-    const result = await entityServer.smtpStatus(seqNum);
-    return ok(result);
-}

package/src/app/plugins/smtp/index.ts

@@ -1,33 +0,0 @@
-/**
- * SMTP 플러그인
- *
- * 앱 서버 내 모든 이메일 발송에 사용할 공유 레이아웃을 등록한다.
- * 알파벳 순 플러그인 로드 중 초기화되며, 이후의 모든 renderTemplate 호출에서
- * plugins/smtp/templates/layout.html 을 공통 래퍼로 사용한다.
- *
- * HTTP 라우트는 routes.ts 에서 등록하며, proxy/register.ts 의 패스스루보다
- * 먼저 처리된다 (system/routes/loader.ts → system/proxy/register.ts 순서).
- *
- *  - POST /api/v1/smtp/send    → 로컬 템플릿 렌더링 후 Go 서버로 발송
- *  - GET  /api/v1/smtp/status/:seq → Go 서버에 발송 상태 조회
- *
- * routes.ts에 없는 /api/v1/smtp/* 경로는 Go 서버로 패스스루된다.
- */
-
-import fp from "fastify-plugin";
-import type { FastifyInstance } from "fastify";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { setSharedLayout } from "@gateway/api";
-import { logger } from "@gateway/api";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-export default fp(
-    async (_app: FastifyInstance) => {
-        const layoutPath = join(__dirname, "templates", "layout.html");
-        setSharedLayout(layoutPath);
-        logger.debug({ layout: layoutPath }, "Email shared layout registered");
-    },
-    { name: "smtp" },
-);

package/src/app/plugins/smtp/routes.ts

@@ -1,19 +0,0 @@
-/**
- * SMTP 라우트 테이블
- * 등록 경로: /api/v1/smtp/*
- *
- * 여기서 처리되지 않는 /api/v1/smtp/* 경로는
- * system/proxy/register.ts 에 의해 Go 서버로 패스스루된다.
- */
-
-import type { FastifyInstance } from "fastify";
-import * as h from "./handlers.ts";
-
-/** SMTP 라우트를 등록한다 */
-export default async function smtpRoutes(app: FastifyInstance) {
-    // POST /api/v1/smtp/send — 로컬 템플릿 렌더링 후 Go 서버로 발송
-    app.post("/send", h.handleSend);
-
-    // GET /api/v1/smtp/status/:seq — 발송 상태 조회
-    app.get("/status/:seq", h.handleStatus);
-}

package/src/app/plugins/smtp/types/config.ts

@@ -1,8 +0,0 @@
-/** plugins/smtp/config.json 스키마 */
-export interface SmtpPluginConfig {
-    enabled: boolean; // 라우트 활성화 여부 (false면 routes.ts 등록 안 됨)
-
-    deploy?: boolean; // 빌드 시 dist에서 제외 여부
-
-    minify?: boolean; // 빌드 시 난독화 여부
-}

package/src/app/plugins/smtp/types/index.ts

@@ -1 +0,0 @@
-export * from "./config.ts";

package/src/app/plugins/taxinvoice/config.json

@@ -1,35 +0,0 @@
-{
-    "_comment": "전자세금계산서 플러그인 — 바로빌 연동, 국세청 자동 전송·상태 동기화·발행 큐 처리 지원",
-    "enabled": false,
-    "default": "barobill",
-    "workers": 2,
-    "queue_size": 100,
-    "dispatch_interval_sec": 10,
-    "max_retries": 3,
-    "providers": {
-        "barobill": {
-            "driver": "barobill",
-            "cert_key": "${TAXINVOICE_CERT_KEY}",
-            "corp_num": "${TAXINVOICE_CORP_NUM}",
-            "user_id": "${TAXINVOICE_USER_ID}",
-            "api_endpoint": "https://barobill.co.kr/TAPI/TaxInvoiceService.asmx",
-            "timeout_sec": 30
-        }
-    },
-    "nts": {
-        "auto_send": false,
-        "taxation_option": 1,
-        "taxation_add_tax_allow": 0,
-        "tax_exemption_option": 1,
-        "tax_exemption_add_tax_allow": 0
-    },
-    "notify": ["log"],
-    "sync": {
-        "enabled": false,
-        "interval_sec": 600,
-        "state_sync_interval_min": 10,
-        "max_list_days": 200
-    },
-    "deploy": true,
-    "minify": false
-}

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

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

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

@@ -1,23 +0,0 @@
-{
-    "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

@@ -1,17 +0,0 @@
-{
-    "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

@@ -1,48 +0,0 @@
-{
-    "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

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

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

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

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

@@ -1,32 +0,0 @@
-/**
- * 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

@@ -1,47 +0,0 @@
-/**
- * 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

@@ -1,13 +0,0 @@
-{
-    "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

@@ -1,16 +0,0 @@
-{
-    "_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

@@ -1,23 +0,0 @@
-{
-    "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": "이메일 인증 시도 횟수"
-        }
-    }
-}

package/src/app/routes/email-verify/handlers/activate.ts

@@ -1,103 +0,0 @@
-/**
- * GET /activate — 링크 클릭 인증
- */
-
-import type { FastifyRequest, FastifyReply } from "fastify";
-import { ok, fail, entityServer, logger } from "@gateway/api";
-import type {
-    EmailVerifyConfig,
-    VerificationActivateQuery,
-} from "../types/index.ts";
-import { verifyCode } from "../verification-utils.ts";
-import { findAccountByEmail } from "./utils.ts";
-import { loadRegisterConfig } from "../../account/register/config-loader.ts";
-import { sendWelcomeEmail } from "../../account/register/handlers.ts";
-
-export function createActivateHandler(cfg: EmailVerifyConfig) {
-    return async function handleActivate(
-        req: FastifyRequest<{ Querystring: VerificationActivateQuery }>,
-        reply: FastifyReply,
-    ): Promise<void> {
-        const email = ((req.query as VerificationActivateQuery).email ?? "")
-            .trim()
-            .toLowerCase();
-        const token = (
-            (req.query as VerificationActivateQuery).token ?? ""
-        ).trim();
-        const redirect = (req.query as VerificationActivateQuery).redirect;
-
-        if (!email || !token) {
-            reply.code(400).send(fail("email과 token은 필수입니다."));
-            return;
-        }
-
-        const account = await findAccountByEmail(email);
-        if (!account || !account.seq || !account.email_verify_code) {
-            reply.code(400).send(fail("유효하지 않은 인증 링크입니다."));
-            return;
-        }
-
-        if (account.email_verified) {
-            if (redirect === "1" && cfg.link_base_url) {
-                reply.redirect(`${cfg.link_base_url}?verified=1`);
-                return;
-            }
-            reply.send(ok({ message: "이미 인증된 이메일입니다." }));
-            return;
-        }
-
-        // 만료 확인
-        if (
-            !account.email_verify_expires_time ||
-            new Date(account.email_verify_expires_time).getTime() <= Date.now()
-        ) {
-            reply.code(401).send(fail("인증 링크가 만료되었습니다."));
-            return;
-        }
-
-        // 시도 횟수 확인 (링크 무차별 대입 방지)
-        const attempts = Number(account.email_verify_attempts ?? 0);
-        if (attempts >= cfg.max_attempts) {
-            reply.code(429).send(fail("최대 시도 횟수를 초과했습니다."));
-            return;
-        }
-
-        // 토큰 검증
-        if (!verifyCode(token, account.email_verify_code)) {
-            await entityServer.submit("account", {
-                seq: account.seq,
-                email_verify_attempts: attempts + 1,
-            } as Record<string, unknown>);
-            reply.code(401).send(fail("유효하지 않은 인증 링크입니다."));
-            return;
-        }
-
-        // 인증 성공
-        await entityServer.submit("account", {
-            seq: account.seq,
-            email_verified: true,
-            email_verify_code: null,
-            email_verify_expires_time: null,
-            email_verify_attempts: null,
-        } as Record<string, unknown>);
-
-        logger.info(
-            { accountSeq: account.seq, email },
-            "Email verified via link",
-        );
-
-        // 인증 완료 → 환영 메일 (register config의 send_welcome_email이 true인 경우)
-        const registerCfg = loadRegisterConfig();
-        if (registerCfg.send_welcome_email) {
-            sendWelcomeEmail(registerCfg, email).catch((err) =>
-                logger.error({ err, email }, "Activate: welcome email failed"),
-            );
-        }
-
-        if (redirect === "1" && cfg.link_base_url) {
-            reply.redirect(`${cfg.link_base_url}?verified=1`);
-            return;
-        }
-        reply.send(ok({ message: "이메일 인증이 완료되었습니다." }));
-    };
-}

package/src/app/routes/email-verify/handlers/change.ts

@@ -1,106 +0,0 @@
-/**
- * POST /change — 이메일 변경 + 재인증 (JWT 필요)
- */
-
-import type { FastifyRequest, FastifyReply } from "fastify";
-import { ok, fail, entityServer, logger } from "@gateway/api";
-import type { EmailVerifyConfig, EmailChangeBody } from "../types/index.ts";
-import { verifyPassword } from "../../password-reset/password-utils.ts";
-import {
-    MAX_EMAIL_LEN,
-    isRateLimited,
-    getAccountSeqFromJwt,
-    getAccountBySeq,
-    findAccountByEmail,
-} from "./utils.ts";
-import { sendVerification } from "./send.ts";
-
-export function createChangeHandler(cfg: EmailVerifyConfig) {
-    return async function handleChange(
-        req: FastifyRequest<{ Body: EmailChangeBody }>,
-        reply: FastifyReply,
-    ): Promise<void> {
-        const accountSeq = getAccountSeqFromJwt(req);
-        if (!accountSeq) {
-            reply.code(401).send(fail("인증이 필요합니다."));
-            return;
-        }
-
-        const newEmail = (req.body?.new_email ?? "").trim().toLowerCase();
-        if (!newEmail) {
-            reply.code(400).send(fail("new_email은 필수입니다."));
-            return;
-        }
-        if (newEmail.length > MAX_EMAIL_LEN) {
-            reply.code(400).send(fail("new_email is too long"));
-            return;
-        }
-
-        const account = await getAccountBySeq(accountSeq);
-        if (!account) {
-            reply.code(404).send(fail("계정을 찾을 수 없습니다."));
-            return;
-        }
-
-        // 비밀번호 확인 (OAuth 전용 계정이 아닌 경우)
-        if (account.passwd) {
-            const currentPwd = req.body?.current_password ?? "";
-            if (!currentPwd) {
-                reply.code(400).send(fail("현재 비밀번호가 필요합니다."));
-                return;
-            }
-            if (!verifyPassword(currentPwd, account.passwd)) {
-                reply.code(401).send(fail("비밀번호가 일치하지 않습니다."));
-                return;
-            }
-        }
-
-        // 동일 이메일 체크
-        if (newEmail === String(account.email ?? "").toLowerCase()) {
-            reply.code(400).send(fail("현재와 동일한 이메일입니다."));
-            return;
-        }
-
-        // 중복 이메일 체크
-        const existing = await findAccountByEmail(newEmail);
-        if (existing) {
-            reply.code(409).send(fail("이미 사용 중인 이메일입니다."));
-            return;
-        }
-
-        // Rate limit
-        if (isRateLimited(newEmail, cfg.rate_limit.per_email_per_hour)) {
-            reply.code(429).send(fail("발송 제한 횟수를 초과했습니다."));
-            return;
-        }
-
-        // 이메일 변경 + 인증 필드 초기화
-        await entityServer.submit("account", {
-            seq: accountSeq,
-            email: newEmail,
-            email_verified: false,
-            email_verify_code: null,
-            email_verify_expires_time: null,
-            email_verify_attempts: 0,
-        } as Record<string, unknown>);
-
-        // 새 이메일로 인증 코드 발송
-        try {
-            await sendVerification(cfg, accountSeq, newEmail, "code");
-        } catch (err) {
-            logger.error(
-                { err, email: newEmail },
-                "Email change: verification send failed",
-            );
-        }
-
-        reply.send(
-            ok({
-                message:
-                    "이메일이 변경되었습니다. 새 이메일로 인증 코드를 발송했습니다.",
-                email: newEmail,
-                email_verified: false,
-            }),
-        );
-    };
-}