create-entity-app-server 0.0.3

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

@@ -0,0 +1,283 @@
+import type { FastifyRequest, FastifyReply } from "fastify";
+import { ok, entityServer, BadRequestError, NotFoundError } from "@gateway/api";
+import type { KobcFreightService } from "./service.ts";
+
+// ─── 목록 조회 ───────────────────────────────────────────────────
+
+interface ListQuery {
+    date_from?: string;
+    date_to?: string;
+    index_date?: string;
+    limit?: string;
+    offset?: string;
+}
+
+export async function listEntries(
+    req: FastifyRequest<{ Querystring: ListQuery }>,
+    reply: FastifyReply,
+) {
+    const {
+        date_from,
+        date_to,
+        index_date,
+        limit = "100",
+        offset = "0",
+    } = req.query;
+
+    const where: Record<string, unknown> = {};
+    if (index_date) {
+        where.index_date = index_date;
+    } else if (date_from && date_to) {
+        where.index_date = { between: [date_from, date_to] };
+    } else if (date_from) {
+        where.index_date = { gte: date_from };
+    } else if (date_to) {
+        where.index_date = { lte: date_to };
+    }
+
+    const result = await entityServer.find("kobc_freight_entry", {
+        where,
+        limit: Math.min(Number(limit), 500),
+        offset: Number(offset),
+        orderBy: [{ field: "index_date", direction: "desc" }],
+    });
+
+    return reply.send(ok(result));
+}
+
+// ─── 단건 조회 ───────────────────────────────────────────────────
+
+export async function getEntry(
+    req: FastifyRequest<{ Params: { seq: string } }>,
+    reply: FastifyReply,
+) {
+    const seq = Number(req.params.seq);
+    if (!Number.isFinite(seq) || seq <= 0)
+        throw new BadRequestError("Invalid seq");
+
+    const result = await entityServer.find("kobc_freight_entry", {
+        where: { seq },
+        limit: 1,
+    });
+    const list = Array.isArray(result) ? result : [];
+    if (list.length === 0) throw new NotFoundError("Entry not found");
+
+    return reply.send(ok(list[0]));
+}
+
+// ─── 수동 동기화 ──────────────────────────────────────────────────
+
+interface SyncBody {
+    /** 시작일 YYYY-MM-DD (없으면 최근 syncDays일) */
+    start_date?: string;
+    /** 종료일 YYYY-MM-DD */
+    end_date?: string;
+}
+
+export async function triggerSync(
+    req: FastifyRequest<{ Body: SyncBody }>,
+    reply: FastifyReply,
+) {
+    const service = req.server.kobcFreightService as KobcFreightService;
+    const { start_date, end_date } = req.body ?? {};
+
+    if (start_date && end_date) {
+        // 날짜 형식 검증
+        if (
+            !/^\d{4}-\d{2}-\d{2}$/.test(start_date) ||
+            !/^\d{4}-\d{2}-\d{2}$/.test(end_date)
+        ) {
+            throw new BadRequestError(
+                "start_date / end_date must be YYYY-MM-DD",
+            );
+        }
+        if (start_date > end_date) {
+            throw new BadRequestError("start_date must be <= end_date");
+        }
+        const result = await service.syncRange(start_date, end_date);
+        return reply.send(ok({ ...result, start_date, end_date }));
+    }
+
+    const result = await service.syncRecent();
+    return reply.send(ok(result));
+}
+
+// ─── KCCI ────────────────────────────────────────────────────────────────────
+
+export async function listKcciEntries(
+    req: FastifyRequest<{ Querystring: ListQuery }>,
+    reply: FastifyReply,
+) {
+    const {
+        date_from,
+        date_to,
+        index_date,
+        limit = "100",
+        offset = "0",
+    } = req.query;
+    const where: Record<string, unknown> = {};
+    if (index_date) where.index_date = index_date;
+    else if (date_from && date_to)
+        where.index_date = { between: [date_from, date_to] };
+    else if (date_from) where.index_date = { gte: date_from };
+    else if (date_to) where.index_date = { lte: date_to };
+
+    const result = await entityServer.find("kobc_kcci_entry", {
+        where,
+        limit: Math.min(Number(limit), 500),
+        offset: Number(offset),
+        orderBy: [{ field: "index_date", direction: "desc" }],
+    });
+    return reply.send(ok(result));
+}
+
+export async function getKcciEntry(
+    req: FastifyRequest<{ Params: { seq: string } }>,
+    reply: FastifyReply,
+) {
+    const seq = Number(req.params.seq);
+    if (!Number.isFinite(seq) || seq <= 0)
+        throw new BadRequestError("Invalid seq");
+    const result = await entityServer.find("kobc_kcci_entry", {
+        where: { seq },
+        limit: 1,
+    });
+    const list = Array.isArray(result) ? result : [];
+    if (list.length === 0) throw new NotFoundError("Entry not found");
+    return reply.send(ok(list[0]));
+}
+
+export async function triggerKcciSync(
+    req: FastifyRequest,
+    reply: FastifyReply,
+) {
+    const service = req.server.kobcFreightService as KobcFreightService;
+    const result = await service.syncKcci();
+    return reply.send(ok(result));
+}
+
+// ─── NCFI ────────────────────────────────────────────────────────────────────
+
+export async function listNcfiEntries(
+    req: FastifyRequest<{ Querystring: ListQuery }>,
+    reply: FastifyReply,
+) {
+    const {
+        date_from,
+        date_to,
+        index_date,
+        limit = "100",
+        offset = "0",
+    } = req.query;
+    const where: Record<string, unknown> = {};
+    if (index_date) where.index_date = index_date;
+    else if (date_from && date_to)
+        where.index_date = { between: [date_from, date_to] };
+    else if (date_from) where.index_date = { gte: date_from };
+    else if (date_to) where.index_date = { lte: date_to };
+
+    const result = await entityServer.find("kobc_ncfi_entry", {
+        where,
+        limit: Math.min(Number(limit), 500),
+        offset: Number(offset),
+        orderBy: [{ field: "index_date", direction: "desc" }],
+    });
+    return reply.send(ok(result));
+}
+
+export async function getNcfiEntry(
+    req: FastifyRequest<{ Params: { seq: string } }>,
+    reply: FastifyReply,
+) {
+    const seq = Number(req.params.seq);
+    if (!Number.isFinite(seq) || seq <= 0)
+        throw new BadRequestError("Invalid seq");
+    const result = await entityServer.find("kobc_ncfi_entry", {
+        where: { seq },
+        limit: 1,
+    });
+    const list = Array.isArray(result) ? result : [];
+    if (list.length === 0) throw new NotFoundError("Entry not found");
+    return reply.send(ok(list[0]));
+}
+
+export async function triggerNcfiSync(
+    req: FastifyRequest,
+    reply: FastifyReply,
+) {
+    const service = req.server.kobcFreightService as KobcFreightService;
+    const result = await service.syncNcfi();
+    return reply.send(ok(result));
+}
+
+// ─── KPLI ────────────────────────────────────────────────────────────────────
+
+export async function listKpliEntries(
+    req: FastifyRequest<{ Querystring: ListQuery }>,
+    reply: FastifyReply,
+) {
+    const {
+        date_from,
+        date_to,
+        index_date,
+        limit = "100",
+        offset = "0",
+    } = req.query;
+    const where: Record<string, unknown> = {};
+    if (index_date) where.index_date = index_date;
+    else if (date_from && date_to)
+        where.index_date = { between: [date_from, date_to] };
+    else if (date_from) where.index_date = { gte: date_from };
+    else if (date_to) where.index_date = { lte: date_to };
+
+    const result = await entityServer.find("kobc_kpli_entry", {
+        where,
+        limit: Math.min(Number(limit), 500),
+        offset: Number(offset),
+        orderBy: [{ field: "index_date", direction: "desc" }],
+    });
+    return reply.send(ok(result));
+}
+
+export async function getKpliEntry(
+    req: FastifyRequest<{ Params: { seq: string } }>,
+    reply: FastifyReply,
+) {
+    const seq = Number(req.params.seq);
+    if (!Number.isFinite(seq) || seq <= 0)
+        throw new BadRequestError("Invalid seq");
+    const result = await entityServer.find("kobc_kpli_entry", {
+        where: { seq },
+        limit: 1,
+    });
+    const list = Array.isArray(result) ? result : [];
+    if (list.length === 0) throw new NotFoundError("Entry not found");
+    return reply.send(ok(list[0]));
+}
+
+export async function triggerKpliSync(
+    req: FastifyRequest<{ Body: SyncBody }>,
+    reply: FastifyReply,
+) {
+    const service = req.server.kobcFreightService as KobcFreightService;
+    const { start_date, end_date } = req.body ?? {};
+
+    if (start_date && end_date) {
+        if (
+            !/^\d{4}-\d{2}-\d{2}$/.test(start_date) ||
+            !/^\d{4}-\d{2}-\d{2}$/.test(end_date)
+        ) {
+            throw new BadRequestError(
+                "start_date / end_date must be YYYY-MM-DD",
+            );
+        }
+        if (start_date > end_date) {
+            throw new BadRequestError("start_date must be <= end_date");
+        }
+        const result = await service.syncKpliRange(start_date, end_date);
+        return reply.send(ok({ ...result, start_date, end_date }));
+    }
+
+    const result = await service.syncKpliRecent();
+    return reply.send(ok(result));
+}

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

@@ -0,0 +1,21 @@
+import fp from "fastify-plugin";
+import type { FastifyInstance } from "fastify";
+import { ensurePluginEntities } from "@gateway/api";
+import { loadKobcFreightConfig } from "./config.ts";
+import { KobcFreightService } from "./service.ts";
+
+export default fp(
+    async (app: FastifyInstance) => {
+        const config = loadKobcFreightConfig();
+        if (!config) return;
+
+        // 엔티티 스키마 등록
+        await ensurePluginEntities(import.meta.url);
+
+        const service = new KobcFreightService(config);
+
+        // 서비스 인스턴스를 Fastify 데코레이터로 노출 (라우트 로더가 routes.ts를 별도 등록)
+        app.decorate("kobcFreightService", service);
+    },
+    { name: "kobc_freight" },
+);

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

@@ -0,0 +1,39 @@
+import type { FastifyInstance } from "fastify";
+import * as h from "./handlers.ts";
+
+export default async function kobcFreightRoutes(app: FastifyInstance) {
+    // ── KDCI (건화물선운임지수) ──────────────────────────────────────────────
+    app.get("/entries", h.listEntries);
+    app.get("/entries/:seq", h.getEntry);
+    app.post("/sync", { preHandler: [app.authRequired] }, (req, reply) =>
+        h.triggerSync(req as Parameters<typeof h.triggerSync>[0], reply),
+    );
+
+    // ── KCCI (컨테이너선운임지수) ─────────────────────────────────────────────
+    app.get("/kcci/entries", h.listKcciEntries);
+    app.get("/kcci/entries/:seq", h.getKcciEntry);
+    app.post(
+        "/kcci/sync",
+        { preHandler: [app.authRequired] },
+        h.triggerKcciSync,
+    );
+
+    // ── NCFI (닝보 컨테이너선운임지수) ──────────────────────────────────────────
+    app.get("/ncfi/entries", h.listNcfiEntries);
+    app.get("/ncfi/entries/:seq", h.getNcfiEntry);
+    app.post(
+        "/ncfi/sync",
+        { preHandler: [app.authRequired] },
+        h.triggerNcfiSync,
+    );
+
+    // ── KPLI (항만물류지표) ──────────────────────────────────────────────────
+    app.get("/kpli/entries", h.listKpliEntries);
+    app.get("/kpli/entries/:seq", h.getKpliEntry);
+    app.post("/kpli/sync", { preHandler: [app.authRequired] }, (req, reply) =>
+        h.triggerKpliSync(
+            req as Parameters<typeof h.triggerKpliSync>[0],
+            reply,
+        ),
+    );
+}