create-entity-app-server 0.0.3 → 0.1.13

package/src/app/plugins/kobc_freight/entities/kobc_kcci_entry.json

@@ -1,67 +0,0 @@
-{
-    "name": "kobc_kcci_entry",
-    "description": "KOBC 컨테이너선운임지수 (KCCI) — 한국해양진흥공사 일별 스냅샷",
-    "fields": {
-        "index_date": {
-            "type": "varchar(10)",
-            "index": true,
-            "comment": "지수 날짜 (YYYY-MM-DD)"
-        },
-        "kcci": {
-            "type": "integer",
-            "comment": "KCCI Comprehensive Index (pt)"
-        },
-        "kuwi": {
-            "type": "integer",
-            "comment": "KUWI — USWC ($/FEU)"
-        },
-        "kuei": {
-            "type": "integer",
-            "comment": "KUEI — USEC ($/FEU)"
-        },
-        "knei": {
-            "type": "integer",
-            "comment": "KNEI — Europe ($/FEU)"
-        },
-        "kmdi": {
-            "type": "integer",
-            "comment": "KMDI — Mediterranean ($/FEU)"
-        },
-        "kmei": {
-            "type": "integer",
-            "comment": "KMEI — Middle East ($/FEU)"
-        },
-        "kaui": {
-            "type": "integer",
-            "comment": "KAUI — Australia ($/FEU)"
-        },
-        "klei": {
-            "type": "integer",
-            "comment": "KLEI — Latin America East Coast ($/FEU)"
-        },
-        "klwi": {
-            "type": "integer",
-            "comment": "KLWI — Latin America West Coast ($/FEU)"
-        },
-        "ksai": {
-            "type": "integer",
-            "comment": "KSAI — South Africa ($/FEU)"
-        },
-        "kwai": {
-            "type": "integer",
-            "comment": "KWAI — West Africa ($/FEU)"
-        },
-        "kci": {
-            "type": "integer",
-            "comment": "KCI — China (pt)"
-        },
-        "kji": {
-            "type": "integer",
-            "comment": "KJI — Japan (pt)"
-        },
-        "ksei": {
-            "type": "integer",
-            "comment": "KSEI — South East Asia (pt)"
-        }
-    }
-}

package/src/app/plugins/kobc_freight/entities/kobc_kpli_entry.json

@@ -1,27 +0,0 @@
-{
-    "name": "kobc_kpli_entry",
-    "description": "KOBC 항만물류지표 (KPLI) — 한국해양진흥공사 주간 항만·물류 지표 (단위: day)",
-    "fields": {
-        "index_date": {
-            "type": "varchar(10)",
-            "index": true,
-            "comment": "기준 주 시작일 (YYYY-MM-DD)"
-        },
-        "port_efficiency": {
-            "type": "decimal(10,2)",
-            "comment": "항만효율성 — 출발항 (day)"
-        },
-        "total_voyage_time": {
-            "type": "decimal(10,2)",
-            "comment": "총항해시간 (day)"
-        },
-        "waiting_time": {
-            "type": "decimal(10,2)",
-            "comment": "대기시간 — 도착항 (day)"
-        },
-        "schedule_reliability": {
-            "type": "decimal(10,2)",
-            "comment": "항만정시성 (day)"
-        }
-    }
-}

package/src/app/plugins/kobc_freight/entities/kobc_ncfi_entry.json

@@ -1,99 +0,0 @@
-{
-    "name": "kobc_ncfi_entry",
-    "description": "KOBC 닝보 컨테이너선운임지수 (NCFI) — 한국해양진흥공사 일별 스냅샷",
-    "fields": {
-        "index_date": {
-            "type": "varchar(10)",
-            "index": true,
-            "comment": "지수 날짜 (YYYY-MM-DD)"
-        },
-        "composite": {
-            "type": "decimal(10,2)",
-            "comment": "Composite Index (pt)"
-        },
-        "europe": {
-            "type": "decimal(10,2)",
-            "comment": "Europe (pt)"
-        },
-        "west_med": {
-            "type": "decimal(10,2)",
-            "comment": "West Mediterranean (pt)"
-        },
-        "east_med": {
-            "type": "decimal(10,2)",
-            "comment": "East Mediterranean (pt)"
-        },
-        "west_america": {
-            "type": "decimal(10,2)",
-            "comment": "West America (pt)"
-        },
-        "east_america": {
-            "type": "decimal(10,2)",
-            "comment": "East America (pt)"
-        },
-        "mideast": {
-            "type": "decimal(10,2)",
-            "comment": "Mideast (pt)"
-        },
-        "west_south_america": {
-            "type": "decimal(10,2)",
-            "comment": "West South America (pt)"
-        },
-        "east_south_america": {
-            "type": "decimal(10,2)",
-            "comment": "East South America (pt)"
-        },
-        "india_pakistan": {
-            "type": "decimal(10,2)",
-            "comment": "India & Pakistan (pt)"
-        },
-        "red_sea": {
-            "type": "decimal(10,2)",
-            "comment": "Red Sea (pt)"
-        },
-        "australia_nz": {
-            "type": "decimal(10,2)",
-            "comment": "Australia & New Zealand (pt)"
-        },
-        "east_japan": {
-            "type": "decimal(10,2)",
-            "comment": "East Japan (pt)"
-        },
-        "west_japan": {
-            "type": "decimal(10,2)",
-            "comment": "West Japan (pt)"
-        },
-        "thailand_vietnam": {
-            "type": "decimal(10,2)",
-            "comment": "Thailand & Vietnam (pt)"
-        },
-        "singapore_malaysia": {
-            "type": "decimal(10,2)",
-            "comment": "Singapore & Malaysia (pt)"
-        },
-        "philippines": {
-            "type": "decimal(10,2)",
-            "comment": "Philippines (pt)"
-        },
-        "black_sea": {
-            "type": "decimal(10,2)",
-            "comment": "Black Sea (pt)"
-        },
-        "west_africa": {
-            "type": "decimal(10,2)",
-            "comment": "West Africa (pt)"
-        },
-        "south_africa": {
-            "type": "decimal(10,2)",
-            "comment": "South Africa (pt)"
-        },
-        "east_africa": {
-            "type": "decimal(10,2)",
-            "comment": "East Africa (pt)"
-        },
-        "north_africa": {
-            "type": "decimal(10,2)",
-            "comment": "North Africa (pt)"
-        }
-    }
-}

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

@@ -1,283 +0,0 @@
-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

@@ -1,21 +0,0 @@
-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

@@ -1,39 +0,0 @@
-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,
-        ),
-    );
-}