create-entity-app-server 0.0.3 → 0.0.4

package/src/app/plugins/ais/service.ts

@@ -1,242 +0,0 @@
-import { logger, entityServer } from "@gateway/api";
-import type {
-    AisConfig,
-    AisStreamMessage,
-    AisVesselAccum,
-} from "./types/index.ts";
-
-const WS_URL = "wss://stream.aisstream.io/v0/stream";
-const ENTITY = "ais_vessel";
-
-// ──────────────────────────── WebSocket 수집 ─────────────────────────────────
-
-/**
- * aisstream.io에 WebSocket으로 연결해 collectSeconds 동안 AIS 메시지를 수집합니다.
- * PositionReport / ShipStaticData 메시지를 MMSI 키로 누적(merge)합니다.
- * Node.js 22 내장 WebSocket 사용 — aisstream.io는 GitHub 로그인 후 무료 API key 발급.
- */
-export function collectAisSnapshot(
-    apiKey: string,
-    collectSeconds: number,
-    boundingBoxes?: [number, number][][],
-): Promise<Map<string, AisVesselAccum>> {
-    return new Promise((resolve, reject) => {
-        const vessels = new Map<string, AisVesselAccum>();
-
-        // Node.js 22 내장 WebSocket (WHATWG 표준 API)
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const ws = new (globalThis as any).WebSocket(WS_URL) as WebSocket;
-
-        const finish = () => {
-            try {
-                ws.close();
-            } catch {
-                /* ignore */
-            }
-            resolve(vessels);
-        };
-
-        const timer = setTimeout(finish, collectSeconds * 1000);
-
-        ws.addEventListener("open", () => {
-            const boxes = boundingBoxes ?? [
-                [
-                    [-90, -180],
-                    [90, 180],
-                ],
-            ];
-            ws.send(
-                JSON.stringify({
-                    APIKey: apiKey,
-                    BoundingBoxes: boxes,
-                    FilterMessageTypes: [
-                        "PositionReport",
-                        "StandardClassBPositionReport",
-                        "ExtendedClassBPositionReport",
-                        "ShipStaticData",
-                    ],
-                }),
-            );
-        });
-
-        ws.addEventListener("message", (event: Event) => {
-            let msg: AisStreamMessage;
-            try {
-                msg = JSON.parse(
-                    (event as MessageEvent).data as string,
-                ) as AisStreamMessage;
-            } catch {
-                return;
-            }
-            mergeMessage(vessels, msg);
-        });
-
-        ws.addEventListener("error", (ev: Event) => {
-            clearTimeout(timer);
-            reject(new Error(`ais WebSocket error: ${String(ev)}`));
-        });
-
-        ws.addEventListener("close", () => {
-            clearTimeout(timer);
-            resolve(vessels);
-        });
-    });
-}
-
-/** AIS 메시지를 파싱해 vessels 맵에 누적합니다 */
-function mergeMessage(
-    vessels: Map<string, AisVesselAccum>,
-    msg: AisStreamMessage,
-): void {
-    const mmsi = String(msg.MetaData?.MMSI ?? "");
-    if (!mmsi || mmsi === "0") return;
-
-    const v = vessels.get(mmsi) ?? { mmsi };
-    const { MessageType, MetaData, Message } = msg;
-
-    if (MetaData.ShipName?.trim()) {
-        v.name = MetaData.ShipName.trim();
-    }
-
-    if (
-        MessageType === "PositionReport" ||
-        MessageType === "StandardClassBPositionReport" ||
-        MessageType === "ExtendedClassBPositionReport"
-    ) {
-        const pos =
-            Message.PositionReport ??
-            (Message as Record<string, AisVesselAccum | undefined>)[
-                MessageType
-            ];
-        if (pos) {
-            const p = pos as {
-                Latitude?: number;
-                Longitude?: number;
-                Sog?: number;
-                Cog?: number;
-                TrueHeading?: number;
-                NavigationalStatus?: number;
-            };
-            if (p.Latitude != null) v.lat = p.Latitude;
-            if (p.Longitude != null) v.lon = p.Longitude;
-            if (p.Sog != null) v.sog = p.Sog;
-            if (p.Cog != null) v.cog = p.Cog;
-            if (p.TrueHeading != null) v.heading = p.TrueHeading;
-            if (p.NavigationalStatus != null)
-                v.nav_status = p.NavigationalStatus;
-            v.snapshot_at = MetaData.time_utc ?? new Date().toISOString();
-        }
-    } else if (MessageType === "ShipStaticData") {
-        const stat = Message.ShipStaticData;
-        if (stat) {
-            if (stat.Name?.trim()) v.name = stat.Name.trim();
-            if (stat.CallSign?.trim()) v.callsign = stat.CallSign.trim();
-            if (stat.ImoNumber) v.imo = stat.ImoNumber;
-            if (stat.Type) v.ship_type = stat.Type;
-            if (stat.Destination?.trim())
-                v.destination = stat.Destination.trim();
-        }
-    }
-
-    vessels.set(mmsi, v);
-}
-
-// ─────────────────────────── DB upsert 배치 ──────────────────────────────────
-
-async function upsertVessels(
-    vessels: Map<string, AisVesselAccum>,
-    batchSize: number,
-): Promise<{ saved: number; errors: number }> {
-    const entries = [...vessels.values()];
-    let saved = 0;
-    let errors = 0;
-
-    for (let i = 0; i < entries.length; i += batchSize) {
-        const chunk = entries.slice(i, i + batchSize);
-        const results = await Promise.allSettled(chunk.map(upsertOne));
-        for (const r of results) {
-            if (r.status === "fulfilled") saved++;
-            else errors++;
-        }
-    }
-
-    return { saved, errors };
-}
-
-async function upsertOne(v: AisVesselAccum): Promise<void> {
-    // 좌표가 없으면 저장하지 않음
-    if (v.lat == null || v.lon == null) return;
-
-    // 기존 레코드 제거
-    const existing = await entityServer.find<{ seq: number }[]>(ENTITY, {
-        where: { mmsi: v.mmsi },
-        limit: 1,
-    });
-    const list = Array.isArray(existing) ? existing : [];
-    for (const rec of list) {
-        await entityServer.delete(ENTITY, rec.seq);
-    }
-
-    // 신규 삽입
-    await entityServer.submit(ENTITY, {
-        mmsi: v.mmsi,
-        name: v.name ?? "",
-        callsign: v.callsign ?? "",
-        imo: v.imo ?? 0,
-        ship_type: v.ship_type ?? 0,
-        lat: v.lat,
-        lon: v.lon,
-        sog: v.sog ?? 0,
-        cog: v.cog ?? 360,
-        heading: v.heading ?? 511,
-        nav_status: v.nav_status ?? 15,
-        destination: v.destination ?? "",
-        snapshot_at: v.snapshot_at ?? new Date().toISOString(),
-    });
-}
-
-// ─────────────────────────── Service 클래스 ──────────────────────────────────
-
-export class AisService {
-    constructor(private readonly config: AisConfig) {}
-
-    /**
-     * aisstream.io에서 스냅샷을 수집하고 DB를 upsert합니다.
-     * 스케줄 및 수동 동기화 모두 이 메서드를 호출합니다.
-     */
-    async syncSnapshot(): Promise<{
-        collected: number;
-        saved: number;
-        errors: number;
-    }> {
-        const collectSeconds = this.config.collectSeconds ?? 60;
-        const batchSize = this.config.batchSize ?? 20;
-
-        logger.info({ collectSeconds }, "ais: collecting from aisstream.io");
-
-        const vessels = await collectAisSnapshot(
-            this.config.apiKey,
-            collectSeconds,
-            this.config.boundingBoxes,
-        );
-
-        logger.info(
-            { collected: vessels.size },
-            "ais: collection done, upserting",
-        );
-
-        const { saved, errors } = await upsertVessels(vessels, batchSize);
-        return { collected: vessels.size, saved, errors };
-    }
-
-    /**
-     * 현재 DB에 저장된 선박 수를 반환합니다.
-     */
-    async countVessels(): Promise<number> {
-        const result = await entityServer.find<{ seq: number }[]>(ENTITY, {
-            limit: 1,
-        });
-        const list = Array.isArray(result) ? result : [];
-        return list.length > 0 ? -1 : 0; // 존재 여부 확인용
-    }
-}

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

@@ -1,78 +0,0 @@
-/** AIS 플러그인 설정 */
-export interface AisConfig {
-    /** 플러그인 활성화 여부 */
-    enabled: boolean;
-    /** aisstream.io API key (GitHub 로그인 후 무료 발급) */
-    apiKey: string;
-    /** WebSocket 수집 시간(초) — 기본 60 */
-    collectSeconds?: number;
-    /** 배치 upsert 병렬 크기 — 기본 20 */
-    batchSize?: number;
-    /** 지역 필터 (생략 시 전세계). [[lat1,lon1],[lat2,lon2]] 형식 */
-    boundingBoxes?: [number, number][][];
-}
-
-/** aisstream.io PositionReport 필드 중 사용하는 부분 */
-export interface AisPositionReport {
-    UserID: number; // MMSI
-    Latitude: number;
-    Longitude: number;
-    Sog: number;
-    Cog: number;
-    TrueHeading: number;
-    NavigationalStatus: number;
-}
-
-/** aisstream.io ShipStaticData 필드 중 사용하는 부분 */
-export interface AisShipStaticData {
-    UserID: number;
-    Name?: string;
-    CallSign?: string;
-    ImoNumber?: number;
-    Type?: number;
-    Destination?: string;
-}
-
-/** aisstream.io StaticDataReport.ReportA */
-export interface AisStaticDataReportA {
-    Name?: string;
-    Valid?: boolean;
-}
-
-/** aisstream.io 메시지 전체 봉투 */
-export interface AisStreamMessage {
-    MessageType: string;
-    MetaData: {
-        MMSI: number;
-        ShipName?: string;
-        latitude?: number;
-        longitude?: number;
-        time_utc?: string;
-    };
-    Message: {
-        PositionReport?: AisPositionReport;
-        ShipStaticData?: AisShipStaticData;
-        StandardClassBPositionReport?: AisPositionReport;
-        ExtendedClassBPositionReport?: AisPositionReport;
-    };
-}
-
-/** 수집 중 MMSI별로 누적하는 임시 레코드 */
-export interface AisVesselAccum {
-    mmsi: string;
-    name?: string;
-    callsign?: string;
-    imo?: number;
-    ship_type?: number;
-    lat?: number;
-    lon?: number;
-    sog?: number;
-    cog?: number;
-    heading?: number;
-    nav_status?: number;
-    destination?: string;
-    snapshot_at?: string;
-}
-
-/** Entity Server에 저장되는 레코드 */
-export type AisVesselRecord = Required<AisVesselAccum>;

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

@@ -1,26 +0,0 @@
-{
-  "_comment": "알림톡 설정 — enabled: false로 비활성화 상태",
-  "enabled": false,
-  "default": "aligo",
-  "sender_key": "${ALIMTALK_SENDER_KEY}",
-  "workers": 2,
-  "dispatch_interval_sec": 5,
-  "queue_size": 200,
-  "max_retries": 3,
-  "_template_file": "templates/notification/alimtalk.json",
-  "providers": {
-    "aligo": {
-      "driver": "aligo",
-      "api_key": "${ALIGO_API_KEY}",
-      "api_secret": "",
-      "user_id": "${ALIGO_USER_ID}",
-      "account": "",
-      "sender_key": "${ALIMTALK_SENDER_KEY}",
-      "pf_id": "",
-      "app_key": "",
-      "secret_key": ""
-    }
-  },
-  "deploy": true,
-  "minify": false
-}

package/src/app/plugins/distance-server/config.json

@@ -1,6 +0,0 @@
-{
-    "enabled": true,
-    "minify": false,
-    "url": "http://127.0.0.1:49200",
-    "timeout": 30000
-}

package/src/app/plugins/distance-server/config.ts

@@ -1,50 +0,0 @@
-/**
- * distance-server 플러그인 설정 로더
- */
-
-import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { logger } from "@gateway/api";
-import type { DistanceServerConfig } from "./types/index.ts";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const CONFIG_PATH = join(__dirname, "config.json");
-
-export function loadDistanceServerConfig(): DistanceServerConfig | null {
-    try {
-        let raw = readFileSync(CONFIG_PATH, "utf-8");
-
-        raw = raw.replace(
-            /\$\{([^}]+)\}/g,
-            (_match, name) => process.env[name] ?? "",
-        );
-
-        const cfg: DistanceServerConfig = JSON.parse(raw);
-
-        if (cfg.enabled === false) {
-            logger.info("distance-server plugin disabled in config");
-            return null;
-        }
-
-        cfg.url = cfg.url.replace(/\/$/, "");
-        const userSecret = process.env.DISTANCE_HMAC_USER_SECRET?.trim();
-        if (!userSecret) {
-            throw new Error(
-                "DISTANCE_HMAC_USER_SECRET is required when distance-server plugin is enabled",
-            );
-        }
-
-        cfg.userSecret = userSecret;
-        cfg.timeout ??= 30_000;
-
-        return cfg;
-    } catch (err: unknown) {
-        if ((err as NodeJS.ErrnoException).code === "ENOENT") {
-            logger.info("distance-server config not found, plugin skipped");
-        } else {
-            logger.error({ err }, "Failed to load distance-server config");
-        }
-        return null;
-    }
-}

package/src/app/plugins/distance-server/docs/README.md

@@ -1,114 +0,0 @@
-# Distance Server 플러그인
-
-Rust 기반 [distance-server](../../../../distance-server/README.md)로의 프록시 플러그인입니다. 항로 계산, 항구 조회, 기상 정보, 해적 위협 정보 등 물류 거리 계산 API를 제공합니다.
-
----
-
-## 목차
-
-- [개요](#개요)
-- [설정](#설정)
-- [인증 방식](#인증-방식)
-- [API](#api)
-- [운영 팁](#운영-팁)
-
----
-
-## 개요
-
-| 항목     | 내용                                             |
-| -------- | ------------------------------------------------ |
-| 역할     | distance-server(Rust) → entity-app-server 프록시 |
-| 인증     | HMAC-SHA256 서명 (내부 서버 간)                  |
-| 기본 URL | `http://127.0.0.1:49200`                         |
-
-> 이 플러그인 자체는 데이터를 저장하지 않습니다. 모든 요청을 Rust 서버로 포워딩하고 응답을 그대로 반환합니다.
-
----
-
-## 설정
-
-`config.json`:
-
-```json
-{
-    "enabled": true,
-    "url": "http://127.0.0.1:49200",
-    "timeout_ms": 30000,
-    "minify": false
-}
-```
-
-### 설정 항목
-
-| 항목         | 기본값                   | 설명                                              |
-| ------------ | ------------------------ | ------------------------------------------------- |
-| `enabled`    | `true`                   | 플러그인 활성화                                   |
-| `url`        | `http://127.0.0.1:49200` | distance-server 주소                              |
-| `timeout_ms` | `30000`                  | 요청 타임아웃(ms) — 항로 계산은 오래 걸릴 수 있음 |
-
----
-
-## 인증 방식
-
-클라이언트 → entity-app-server 구간은 기존 JWT 인증을 사용합니다.  
-entity-app-server → distance-server 구간은 HMAC-SHA256 서명 헤더로 인증합니다.
-
----
-
-## API
-
-기본 경로: `/api/v1/distance-server`
-
-### 항로
-
-| 메서드 | 경로              | 인증        | 설명                 |
-| ------ | ----------------- | ----------- | -------------------- |
-| `POST` | `/route`          | 로그인 필요 | 두 지점 간 항로 계산 |
-| `POST` | `/route-reports`  | 로그인 필요 | 항로 보고서 생성     |
-| `GET`  | `/routing-points` |             | 항로 경유지 목록     |
-
-### 항구
-
-| 메서드 | 경로     | 인증 | 설명             |
-| ------ | -------- | ---- | ---------------- |
-| `GET`  | `/ports` |      | 전세계 항구 목록 |
-
-### 기상
-
-| 메서드 | 경로                     | 인증 | 설명           |
-| ------ | ------------------------ | ---- | -------------- |
-| `GET`  | `/weather/pressure`      |      | 기압 정보      |
-| `GET`  | `/weather/typhoon`       |      | 태풍 정보      |
-| `GET`  | `/weather/ocean-current` |      | 해류 정보      |
-| `GET`  | `/weather/wind`          |      | 풍향/풍속 정보 |
-
-### 위험 구역
-
-| 메서드 | 경로           | 인증 | 설명                               |
-| ------ | -------------- | ---- | ---------------------------------- |
-| `GET`  | `/seca/list`   |      | SECA(황산화물 배출 통제 구역) 목록 |
-| `GET`  | `/piracy/list` |      | 해적 위협 지역 목록                |
-| `GET`  | `/piracy/map`  |      | 해적 위협 지도 데이터              |
-
-### POST /route 요청 예시
-
-```json
-{
-    "from": { "lat": 37.4563, "lon": 126.7052 },
-    "to": { "lat": 1.2897, "lon": 103.8501 },
-    "options": {
-        "avoid_seca": false,
-        "avoid_piracy": true
-    }
-}
-```
-
----
-
-## 운영 팁
-
-- distance-server가 실행 중이지 않으면 모든 요청이 `503` 에러를 반환
-- 항로 계산은 최대 수 초 소요 — `timeout_ms`를 넉넉히 설정
-- 기상/해류 데이터는 distance-server 내부 캐시에서 제공
-- distance-server 별도 설정은 `/distance-server/configs/` 참고

package/src/app/plugins/distance-server/handlers.ts

@@ -1,104 +0,0 @@
-import type { FastifyReply, FastifyRequest } from "fastify";
-import { proxyDistanceRequest } from "./service.ts";
-
-export async function handleRoute(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(request, reply, "/api/v1/route", 60_000);
-}
-
-export async function handlePorts(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(request, reply, "/api/v1/ports", 10_000);
-}
-
-export async function handleWeatherPressure(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(
-        request,
-        reply,
-        "/api/v1/weather/pressure",
-        15_000,
-    );
-}
-
-export async function handleWeatherTyphoon(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(
-        request,
-        reply,
-        "/api/v1/weather/typhoon",
-        15_000,
-    );
-}
-
-export async function handleWeatherOceanCurrent(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(
-        request,
-        reply,
-        "/api/v1/weather/ocean-current",
-        15_000,
-    );
-}
-
-export async function handleWeatherWind(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(request, reply, "/api/v1/weather/wind", 15_000);
-}
-
-export async function handleSecaList(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(request, reply, "/api/v1/seca/list", 10_000);
-}
-
-export async function handlePiracyList(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(request, reply, "/api/v1/piracy/list", 10_000);
-}
-
-export async function handlePiracyMap(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(request, reply, "/api/v1/piracy/map", 10_000);
-}
-
-export async function handleRouteReport(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(
-        request,
-        reply,
-        "/api/v1/route-reports",
-        10_000,
-    );
-}
-
-export async function handleRoutingPoints(
-    request: FastifyRequest,
-    reply: FastifyReply,
-): Promise<unknown> {
-    return proxyDistanceRequest(
-        request,
-        reply,
-        "/api/v1/routing-points",
-        10_000,
-    );
-}

package/src/app/plugins/distance-server/index.ts

@@ -1,23 +0,0 @@
-/**
- * distance-server 플러그인
- *
- * 실제 HTTP 경로 등록은 `*-routes.ts`에서 처리한다.
- * 이 파일은 설정 로드와 시작 로그만 담당한다.
- */
-
-import fp from "fastify-plugin";
-import type { FastifyInstance } from "fastify";
-import { loadDistanceServerConfig } from "./config.ts";
-
-export default fp(
-    async (app: FastifyInstance) => {
-        const config = loadDistanceServerConfig();
-
-        if (!config) {
-            return;
-        }
-
-        app.log.info({ upstream: config.url }, "distance-server plugin ready");
-    },
-    { name: "distance-server-plugin" },
-);

package/src/app/plugins/distance-server/routes.ts

@@ -1,36 +0,0 @@
-/**
- * distance-server 라우트 테이블
- * 등록 경로: /api/v1/distance-server/*
- */
-
-import type { FastifyInstance } from "fastify";
-import * as h from "./handlers.ts";
-
-export default async function distanceServerRoutes(app: FastifyInstance) {
-    // POST /api/v1/distance-server/route
-    app.post("/route", h.handleRoute);
-
-    // GET /api/v1/distance-server/ports
-    app.get("/ports", h.handlePorts);
-
-    // GET /api/v1/distance-server/weather/*
-    app.get("/weather/pressure", h.handleWeatherPressure);
-    app.get("/weather/typhoon", h.handleWeatherTyphoon);
-    app.get("/weather/ocean-current", h.handleWeatherOceanCurrent);
-    app.get("/weather/wind", h.handleWeatherWind);
-
-    // GET /api/v1/distance-server/seca/list
-    app.get("/seca/list", h.handleSecaList);
-
-    // GET /api/v1/distance-server/piracy/list
-    app.get("/piracy/list", h.handlePiracyList);
-
-    // GET /api/v1/distance-server/piracy/map
-    app.get("/piracy/map", h.handlePiracyMap);
-
-    // POST /api/v1/distance-server/route-reports
-    app.post("/route-reports", h.handleRouteReport);
-
-    // GET /api/v1/distance-server/routing-points
-    app.get("/routing-points", h.handleRoutingPoints);
-}