create-entity-app-server 0.0.3

package/src/app/routes/health/handlers.ts

@@ -0,0 +1,69 @@
+/**
+ * Health 핸들러 구현
+ */
+
+import type { FastifyRequest, FastifyReply } from "fastify";
+import { loadPacketEncryptConfig } from "../../../system/config/packet-encrypt.ts";
+import { deriveAnonymousPacketToken } from "../../../system/security/anonymous-packet-token.ts";
+import { ensureAndSyncAnonymousDevice } from "../../../system/security/anonymous-device.ts";
+
+async function buildPacketHealthPayload(
+    req: FastifyRequest,
+    reply: FastifyReply,
+) {
+    const cfg = loadPacketEncryptConfig();
+    if (!cfg.enabled) {
+        return {
+            ok: true,
+            packet_encryption: false,
+        };
+    }
+
+    const deviceId = await ensureAndSyncAnonymousDevice(req, reply, cfg);
+    return {
+        ok: true,
+        packet_encryption: true,
+        packet_mode: cfg.anonymousEnabled ? "anonymous" : "authenticated",
+        packet_token:
+            cfg.anonymousEnabled && deviceId
+                ? deriveAnonymousPacketToken(deviceId, cfg)
+                : undefined,
+    };
+}
+
+export async function getPacketHealth(
+    req: FastifyRequest,
+    reply: FastifyReply,
+) {
+    return reply.send(await buildPacketHealthPayload(req, reply));
+}
+
+/** 서버 기본 상태를 반환한다 */
+export async function getHealth(req: FastifyRequest, reply: FastifyReply) {
+    const packet = await buildPacketHealthPayload(req, reply);
+    return reply.send({
+        success: true,
+        data: {
+            status: "ok",
+            timestamp: new Date().toISOString(),
+            uptime: process.uptime(),
+            packet_encryption: packet.packet_encryption,
+            packet_mode: packet.packet_mode,
+        },
+    });
+}
+
+/** DB 연결 등 준비 상태를 반환한다 */
+export async function getReady(req: FastifyRequest, reply: FastifyReply) {
+    const dbOk = (req.server as any).db !== null;
+    const status = dbOk ? "ready" : "degraded";
+
+    return reply.code(dbOk ? 200 : 503).send({
+        success: dbOk,
+        data: {
+            status,
+            db: dbOk ? "connected" : "not configured",
+            timestamp: new Date().toISOString(),
+        },
+    });
+}

package/src/app/routes/health/routes.ts

@@ -0,0 +1,14 @@
+/**
+ * Health 라우트 테이블 — 샘플 라우트
+ * 등록 경로: /api/v1/health/*
+ *
+ * 새 라우트 추가 방법: src/app/routes/README.md 참고
+ */
+
+import type { FastifyInstance } from "fastify";
+import * as h from "./handlers.ts";
+
+export default async function healthRoutes(app: FastifyInstance) {
+    app.get("/", h.getHealth);
+    app.get("/ready", h.getReady);
+}

package/src/app/routes/hr/career/config.json

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

package/src/app/routes/hr/career/entities/employee_career.json

@@ -0,0 +1,15 @@
+{
+    "name": "employee_career",
+    "description": "직원 경력 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "employee_seq": {
+            "index": true,
+            "comment": "직원seq",
+            "required": true
+        },
+        "join_date": {
+            "index": true,
+            "comment": "입사일"
+        }
+    }
+}

package/src/app/routes/hr/career/routes.ts

@@ -0,0 +1,25 @@
+/**
+ * 경력 라우트 플러그인
+ *
+ * 자동 로더가 `app/routes/career/routes.ts`를 탐색하여
+ * prefix `/api/v1/career` 으로 등록한다.
+ *
+ * 엔티티:
+ *   - employee_career — 직원 경력
+ */
+
+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 careerRoutes(app: FastifyInstance): Promise<void> {
+    await ensurePluginEntities(__dirname).catch((err) =>
+        logger.warn({ err }, "career: ensureEntities failed"),
+    );
+
+    // TODO: 경력 라우트 핸들러 추가
+    void app;
+}

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

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

package/src/app/routes/hr/education/config.json

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

package/src/app/routes/hr/education/entities/employee_education.json

@@ -0,0 +1,29 @@
+{
+    "name": "employee_education",
+    "description": "직원 교육 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "bgn_time": {
+            "index": true,
+            "comment": "시작일",
+            "type": "date"
+        },
+        "employee_seq": {
+            "index": true,
+            "comment": "직원seq",
+            "required": true
+        },
+        "end_time": {
+            "index": true,
+            "comment": "종료일",
+            "type": "date"
+        },
+        "name": {
+            "index": true,
+            "comment": "교육명"
+        },
+        "next_date": {
+            "index": true,
+            "comment": "차기예정일"
+        }
+    }
+}

package/src/app/routes/hr/education/entities/employee_education_mans.json

@@ -0,0 +1,25 @@
+{
+    "name": "employee_education_mans",
+    "description": "직원 교육 이수자 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "education_seq": {
+            "index": true,
+            "comment": "교육seq",
+            "required": true
+        },
+        "employee_seq": {
+            "index": true,
+            "comment": "직원seq",
+            "required": true
+        }
+    },
+    "unique": [
+        [
+            "employee_seq",
+            "education_seq"
+        ]
+    ],
+    "fk": {
+        "education_seq": "employee_education.seq"
+    }
+}

package/src/app/routes/hr/education/entities/employee_school.json

@@ -0,0 +1,19 @@
+{
+    "name": "employee_school",
+    "description": "직원 학교 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "employee_seq": {
+            "index": true,
+            "comment": "직원seq",
+            "required": true
+        },
+        "entrance_date": {
+            "index": true,
+            "comment": "입학일"
+        },
+        "name": {
+            "index": true,
+            "comment": "학교명"
+        }
+    }
+}

package/src/app/routes/hr/education/routes.ts

@@ -0,0 +1,28 @@
+/**
+ * 학력 라우트 플러그인
+ *
+ * 자동 로더가 `app/routes/education/routes.ts`를 탐색하여
+ * prefix `/api/v1/education` 으로 등록한다.
+ *
+ * 엔티티:
+ *   - employee_education       — 학력
+ *   - employee_education_files — 학력 첨부파일
+ *   - employee_education_mans  — 학력 지도교수 등 관계자
+ *   - employee_school          — 학교 마스터
+ */
+
+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 educationRoutes(app: FastifyInstance): Promise<void> {
+    await ensurePluginEntities(__dirname).catch((err) =>
+        logger.warn({ err }, "education: ensureEntities failed"),
+    );
+
+    // TODO: 학력 라우트 핸들러 추가
+    void app;
+}

package/src/app/routes/hr/employee/config.json

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

package/src/app/routes/hr/employee/entities/employee.json

@@ -0,0 +1,59 @@
+{
+    "name": "employee",
+    "description": "직원 기본 정보. JWT 인증 시 account_seq ↔ account 관계. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "account_seq": {
+            "index": true,
+            "comment": "사용자seq (JWT 인증 시 account.seq 참조. HMAC은 nullable)",
+            "unique": true
+        },
+        "group_seq": {
+            "index": true,
+            "comment": "부서seq"
+        },
+        "join_date": {
+            "index": true,
+            "comment": "입사일"
+        },
+        "labor_form": {
+            "index": true,
+            "comment": "근로형태"
+        },
+        "name": {
+            "index": true,
+            "comment": "이름"
+        },
+        "resign_date": {
+            "index": true,
+            "comment": "퇴사일"
+        },
+        "role_seq": {
+            "index": true,
+            "comment": "직책seq"
+        },
+        "staff_num": {
+            "index": true,
+            "comment": "사번",
+            "unique": true
+        },
+        "work_form": {
+            "index": true,
+            "comment": "근무형태"
+        },
+        "working_status": {
+            "index": true,
+            "comment": "재직상태"
+        }
+    },
+    "reset_defaults": [
+        {
+            "name": "홍길동"
+        },
+        {
+            "name": "김철수"
+        },
+        {
+            "name": "이영희"
+        }
+    ]
+}

package/src/app/routes/hr/employee/entities/employee_cert.json

@@ -0,0 +1,19 @@
+{
+    "name": "employee_cert",
+    "description": "직원 자격증 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "employee_seq": {
+            "index": true,
+            "comment": "직원seq",
+            "required": true
+        },
+        "get_date": {
+            "index": true,
+            "comment": "취득일"
+        },
+        "name": {
+            "index": true,
+            "comment": "자격증명"
+        }
+    }
+}

package/src/app/routes/hr/employee/entities/employee_reward.json

@@ -0,0 +1,21 @@
+{
+    "name": "employee_reward",
+    "description": "직원 상벌 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "date": {
+            "index": true,
+            "comment": "일자"
+        },
+        "employee_seq": {
+            "index": true,
+            "comment": "직원seq",
+            "required": true
+        },
+        "bonus": {
+            "type": "uint"
+        },
+        "penalty": {
+            "type": "uint"
+        }
+    }
+}

package/src/app/routes/hr/employee/routes.ts

@@ -0,0 +1,27 @@
+/**
+ * 직원 라우트 플러그인
+ *
+ * 자동 로더가 `app/routes/employee/routes.ts`를 탐색하여
+ * prefix `/api/v1/employee` 으로 등록한다.
+ *
+ * 엔티티:
+ *   - employee       — 직원 기본 정보
+ *   - employee_cert  — 자격증
+ *   - employee_reward — 포상/징계
+ */
+
+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 employeeRoutes(app: FastifyInstance): Promise<void> {
+    await ensurePluginEntities(__dirname).catch((err) =>
+        logger.warn({ err }, "employee: ensureEntities failed"),
+    );
+
+    // TODO: 직원 라우트 핸들러 추가
+    void app;
+}

package/src/app/routes/hr/entities/hr_group.json

@@ -0,0 +1,47 @@
+{
+    "name": "hr_group",
+    "description": "인사 부서 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "parent_seq": {
+            "index": true,
+            "comment": "상위부서seq"
+        },
+        "name": {
+            "index": true,
+            "comment": "부서명",
+            "unique": true
+        }
+    },
+    "reset_defaults": [
+        {
+            "name": "대표이사"
+        },
+        {
+            "name": "경영지원팀"
+        },
+        {
+            "name": "인사팀"
+        },
+        {
+            "name": "재무회계팀"
+        },
+        {
+            "name": "영업팀"
+        },
+        {
+            "name": "마케팅팀"
+        },
+        {
+            "name": "개발팀"
+        },
+        {
+            "name": "제품팀"
+        },
+        {
+            "name": "고객지원팀"
+        },
+        {
+            "name": "운영팀"
+        }
+    ]
+}

package/src/app/routes/hr/entities/hr_group_pv.json

@@ -0,0 +1,20 @@
+{
+    "name": "hr_group_pv",
+    "description": "인사 부서 권한 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "group_seq": {
+            "index": true,
+            "comment": "부서seq"
+        },
+        "pv_item_seq": {
+            "index": true,
+            "comment": "권한seq"
+        }
+    },
+    "unique": [
+        [
+            "group_seq",
+            "pv_item_seq"
+        ]
+    ]
+}

package/src/app/routes/hr/entities/hr_role.json

@@ -0,0 +1,43 @@
+{
+    "name": "hr_role",
+    "description": "인사 직책 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "name": {
+            "index": true,
+            "comment": "직책명",
+            "unique": true
+        }
+    },
+    "reset_defaults": [
+        {
+            "name": "사원"
+        },
+        {
+            "name": "주임"
+        },
+        {
+            "name": "대리"
+        },
+        {
+            "name": "과장"
+        },
+        {
+            "name": "차장"
+        },
+        {
+            "name": "부장"
+        },
+        {
+            "name": "이사"
+        },
+        {
+            "name": "상무"
+        },
+        {
+            "name": "전무"
+        },
+        {
+            "name": "대표"
+        }
+    ]
+}

package/src/app/routes/hr/entities/hr_role_pv.json

@@ -0,0 +1,20 @@
+{
+    "name": "hr_role_pv",
+    "description": "인사 직책 권한 정보. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "fields": {
+        "role_seq": {
+            "index": true,
+            "comment": "직책seq"
+        },
+        "pv_item_seq": {
+            "index": true,
+            "comment": "권한seq"
+        }
+    },
+    "unique": [
+        [
+            "role_seq",
+            "pv_item_seq"
+        ]
+    ]
+}

package/src/app/routes/hr/routes.ts

@@ -0,0 +1,29 @@
+/**
+ * HR 라우트 플러그인
+ *
+ * 자동 로더가 `app/routes/hr/routes.ts`를 탐색하여
+ * prefix `/api/v1/hr` 으로 등록한다.
+ *
+ * 엔티티:
+ *   - hr_group                — 부서
+ *   - hr_group_pv             — 부서-권한 매핑
+ *   - hr_role                 — 직책
+ *   - hr_role_pv              — 직책-권한 매핑
+ *   - hr_files                — HR 공통 첨부파일
+ */
+
+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 hrRoutes(app: FastifyInstance): Promise<void> {
+    await ensurePluginEntities(__dirname).catch((err) =>
+        logger.warn({ err }, "hr: ensureEntities failed"),
+    );
+
+    // TODO: 인사 라우트 핸들러 추가
+    void app;
+}

package/src/app/routes/messages/chat/config.json

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

package/src/app/routes/messages/chat/entities/user_chat.json

@@ -0,0 +1,47 @@
+{
+    "name": "user_chat",
+    "description": "채팅 메시지. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
+    "fields": {
+        "bytes": {
+            "comment": "메시지 크기",
+            "type": "uint"
+        },
+        "is_deleted": {
+            "index": true,
+            "comment": "삭제 여부",
+            "default": false
+        },
+        "msg_type": {
+            "index": true,
+            "comment": "메시지 유형",
+            "type": [
+                "text",
+                "image",
+                "file",
+                "system"
+            ],
+            "default": "text",
+            "required": true
+        },
+        "parent_seq": {
+            "index": true,
+            "comment": "답글 대상 메시지seq"
+        },
+        "room_seq": {
+            "index": true,
+            "comment": "채팅방seq",
+            "required": true
+        },
+        "sender_seq": {
+            "index": true,
+            "comment": "발신자seq",
+            "required": true
+        }
+    },
+    "fk": {
+        "room_seq": "user_chat_room.seq",
+        "sender_seq": "user.seq",
+        "parent_seq": "user_chat.seq"
+    }
+}

package/src/app/routes/messages/chat/entities/user_chat_room.json

@@ -0,0 +1,38 @@
+{
+    "name": "user_chat_room",
+    "description": "채팅방. 사용자 환경에 맞게 fields를 자유롭게 확장할 수 있습니다.",
+    "license_scope": false,
+    "fields": {
+        "is_active": {
+            "index": true,
+            "comment": "활성 여부",
+            "default": true
+        },
+        "last_message_time": {
+            "index": true,
+            "comment": "마지막 메시지 시각"
+        },
+        "name": {
+            "index": true,
+            "comment": "채팅방 이름",
+            "required": true
+        },
+        "owner_seq": {
+            "index": true,
+            "comment": "방장 user seq"
+        },
+        "room_type": {
+            "index": true,
+            "comment": "채팅방 타입",
+            "type": [
+                "direct",
+                "group"
+            ],
+            "default": "direct",
+            "required": true
+        }
+    },
+    "fk": {
+        "owner_seq": "user.seq"
+    }
+}