260312_01_ENH: Error 페이지 및 Redirect 페이지 구현

This commit is contained in:
2026-03-12 09:36:09 +09:00
parent bedcfbc9d1
commit f7ce249aa7
17 changed files with 710 additions and 6 deletions

View File

@@ -45,7 +45,7 @@ const LoginPage = () => {
const err = apiError(e);
if (err.status === 401 || err.status === 403) setError("아이디 또는 비밀번호를 다시 확인해주세요.");
else if (err.code === NONE_HTTP_ERROR) setError("알 수 없는 오류가 발생했습니다. 잠시 후 다시 시도해주세요.");
else setError(`로그인에 실패했습니다. (status: ${err.status})`);
else setError(`로그인에 실패했습니다. (${err.message})`);
}
}

View File

@@ -0,0 +1,37 @@
import RedirectLanding from "@/components/external/RedirectLanding";
import {notFound} from "next/navigation";
import {ALLOW_REDIRECT} from "@/const/commonConst";
import {RedirectSlug} from "@/types/common";
type redirectPageProps = {
params: Promise<{ slug: string }>;
searchParams?: Promise<Record<string, string | string[] | undefined>>;
}
const toRedirectSlug = (slug: string): RedirectSlug | null => {
return ALLOW_REDIRECT.has(slug.toLowerCase()) ? (slug.toLowerCase() as RedirectSlug) : null;
}
const redirectPage = async ({
params,
searchParams,
}: redirectPageProps) => {
const { slug } = await params;
const sp = searchParams ? await searchParams : undefined;
//미들 웨어에서 처리
console.log(sp);
const redirectSlug = toRedirectSlug(slug);
console.log(redirectSlug);
if (!redirectSlug) notFound();
return (
<RedirectLanding redirectSlug={redirectSlug} />
)
}
export default redirectPage;

View File

@@ -0,0 +1,35 @@
import ErrorPage from "@/components/external/Error";
import {ErrorCode} from "@/types/common";
function toErrorCode(raw: string | undefined): ErrorCode {
if (raw === "500") return "500";
// fetch_error, 기타 알 수 없는 코드 → 500으로 처리
if (raw && raw !== "404") return "500";
return "404";
}
type RedirectErrorPageProps = {
searchParams: Promise<Record<string, string | string[] | undefined>>;
};
const RedirectErrorPage = async ({ searchParams }: RedirectErrorPageProps) => {
const sp = await searchParams;
console.log(sp)
const code = toErrorCode(sp.code as string | undefined);
const sid = (sp.sid as string | undefined) ?? "";
return (
<ErrorPage
code={code}
errorDescription={
sid
? `오류가 발생했습니다. 관리자에게 문의할 경우 아래 코드를 전달해 주세요.\n리스트 ID : ${sid}`
: undefined
}
/>
)
}
export default RedirectErrorPage

View File

@@ -1 +1,42 @@
//외부 설문에 뎐동 되는 API
//외부 설문에 뎐동 되는 API
import {NextRequest, NextResponse} from "next/server";
import {RouteContext} from "@/types/common";
import {createContactApi} from "@/lib/server-api";
import {errorToResponse} from "@/lib/http-util";
import {getClientIp} from "@/lib/utils";
export const POST = async (req: NextRequest, context: RouteContext) => {
try {
const { searchParams } = new URL(req.url);
const {slug = []} = await context.params;
const [action] = slug;
console.log(slug)
const sid = (searchParams.get("sid") ?? "").trim();
const allowAction = ["start", "complete", "screen", "quota"]
if(slug.length === 1 && allowAction.includes(action.toLowerCase()) && sid.length > 0){
const contactApi = await createContactApi();
const pathname = req.nextUrl.pathname;
const h = req.headers;
const log = {
remoteAddr: h.get("x-orig-ip") || getClientIp(req),
uri: h.get("x-orig-uri") || pathname,
url: h.get("x-orig-url") || req.url,
userAgent: h.get("x-orig-user-agent") || h.get("user-agent"),
referer: h.get("x-orig-referer") || h.get("referer"),
origin: h.get("x-orig-origin") || h.get("origin"),
xForwardedFor: h.get("x-forwarded-for"),
forwarded: h.get("forwarded"),
};
//Todo 수정 필요
return new NextResponse(null, { status: 204 });
}
return NextResponse.json({ message: "Not found" }, { status: 404 });
} catch (error: unknown) {
return errorToResponse(error);
}
};

9
src/app/not-found.tsx Normal file
View File

@@ -0,0 +1,9 @@
import ErrorPage from "@/components/external/Error";
const NotFound = () => {
return (
<ErrorPage code="404" />
)
}
export default NotFound

116
src/components/external/Error.tsx vendored Normal file
View File

@@ -0,0 +1,116 @@
import { ServerCrash, FileQuestion } from "lucide-react";
import { Badge } from "@/components/ui/badge";
import { Separator } from "@/components/ui/separator";
import ExternalLayout from "@/components/external/ExternalLayout";
import {ErrorCode} from "@/types/common";
interface ErrorConfig {
httpLabel: string;
defaultTitle: string;
defaultDescription: string;
Icon: React.ElementType;
badgeVariant: "default" | "destructive" | "outline" | "secondary";
accentClass: string;
}
// ─── Error Configs ────────────────────────────────────────────────────────────
const ERROR_MAP: Record<ErrorCode, ErrorConfig> = {
"404": {
httpLabel: "Page Not Found",
defaultTitle: "요청하신 페이지를 찾을 수 없습니다",
defaultDescription:
"입력하신 주소가 잘못되었거나, 페이지가 삭제 또는 이동되었을 수 있습니다",
Icon: FileQuestion,
badgeVariant: "secondary",
accentClass: "bg-primary",
},
"500": {
httpLabel: "Internal Server Error",
defaultTitle: "서버에서 오류가 발생했습니다",
defaultDescription:
"요청을 처리하는 중 예기치 못한 오류가 발생했습니다. 잠시 후 다시 시도해 주세요. 문제가 지속되면 담당자에게 문의해 주세요.",
Icon: ServerCrash,
badgeVariant: "destructive",
accentClass: "bg-destructive",
},
};
interface ErrorViewProps {
code?: ErrorCode;
errorTitle?: string;
errorDescription?: string;
}
const ErrorPage = ({
code = "404",
errorTitle,
errorDescription,
}: ErrorViewProps) => {
const config = ERROR_MAP[code] ?? ERROR_MAP["404"];
const { httpLabel, defaultTitle, defaultDescription, Icon, badgeVariant, accentClass } = config;
const title = errorTitle ?? defaultTitle;
const description = errorDescription ?? defaultDescription;
return (
<ExternalLayout footerRight={`ERR_${code}`}>
<div className="flex flex-1 items-center justify-center px-12 py-10">
<div className="w-full max-w-2xl">
{/* 에러 코드 타이포 레이어 */}
<div className="relative mb-2 select-none">
{/* 전면 숫자 */}
<span
className="block leading-none text-foreground"
style={{
fontSize: "clamp(72px, 12vw, 130px)",
fontWeight: 900,
letterSpacing: "-0.03em",
}}
>
{code}
</span>
</div>
{/* 뱃지 */}
<div className="mb-5 flex flex-wrap gap-2">
<Badge
variant={badgeVariant}
className="rounded-full px-3 py-1 text-xs font-bold uppercase tracking-wider"
>
{httpLabel}
</Badge>
<Badge
variant="outline"
className="rounded-full px-3 py-1 text-xs uppercase tracking-wider"
>
HTTP {code}
</Badge>
<Badge
variant="outline"
className="rounded-full px-3 py-1 text-xs uppercase tracking-wider"
>
KRi Platform
</Badge>
</div>
<Separator className={`mb-6 h-0.5 w-12 ${accentClass}`} />
<div className="mb-3 flex items-center gap-3">
<Icon size={22} className="flex-shrink-0 text-muted-foreground" />
<h1 className="text-2xl font-bold tracking-tight text-foreground">
{title}
</h1>
</div>
<p className="mb-9 max-w-md text-sm leading-relaxed text-muted-foreground">
{description}
</p>
</div>
</div>
</ExternalLayout>
);
}
export default ErrorPage;

View File

@@ -0,0 +1,61 @@
import React from "react";
import Image from "next/image";
interface ExternalLayoutProps {
children: React.ReactNode;
/** 헤더 우측 영역 (선택) */
headerRight?: React.ReactNode;
/** 푸터 우측 텍스트 (선택, 기본: "KRi Survey Platform") */
footerRight?: string;
}
const ExternalLayout = (
{
children,
headerRight,
footerRight = "KRi Contact System",
}: ExternalLayoutProps
) => {
return (
<div className="flex min-h-svh flex-col bg-background antialiased">
{/* 상단 컬러 바 */}
<div className="h-1 w-full flex-shrink-0 bg-primary" />
{/* 헤더 */}
<header className="flex flex-shrink-0 items-center justify-between border-b px-12 py-2">
<Image
src="/kri_logo.png"
alt="KRi"
width={80}
height={32}
className="h-8 w-auto object-contain"
priority
/>
{headerRight ?? (
<span className="text-xs font-semibold uppercase tracking-widest text-muted-foreground">
KRi Contact System
</span>
)}
</header>
{/* 콘텐츠 */}
<div className="flex flex-1 flex-col">
{children}
</div>
{/* 푸터 */}
<footer className="flex flex-shrink-0 items-center justify-between border-t px-12 py-5">
<span className="text-xs text-muted-foreground">
© {new Date().getFullYear()} KRi. All rights reserved.
</span>
<span className="text-xs text-muted-foreground">
{footerRight}
</span>
</footer>
</div>
);
}
export default ExternalLayout

View File

@@ -0,0 +1,177 @@
import { CheckCircle, XCircle, Users } from "lucide-react";
import { Badge } from "@/components/ui/badge";
import { Card, CardContent, CardHeader } from "@/components/ui/card";
import { Separator } from "@/components/ui/separator";
import ExternalLayout from "./ExternalLayout";
import {RedirectSlug} from "@/types/common";
interface StatusConfig {
label: string;
sublabel: string;
title: string;
description: string;
Icon: React.ElementType;
badgeVariant: "default" | "secondary" | "destructive" | "outline";
iconClassName: string;
savedVisible: boolean;
}
// ─── Status Configs ───────────────────────────────────────────────────────────
const STATUS_MAP: Record<RedirectSlug, StatusConfig> = {
complete: {
label: "설문 완료",
sublabel: "Survey Complete",
title: "설문에 참여해 주셔서\n감사합니다",
description:
"귀하의 소중한 의견이 성공적으로 접수되었습니다. 응답 결과는 연구 목적으로만 활용되며, 개인 정보는 철저히 보호됩니다.",
Icon: CheckCircle,
badgeVariant: "default",
iconClassName: "text-primary",
savedVisible: true,
},
screen: {
label: "참여 불가",
sublabel: "Screen Out",
title: "이번 설문에는\n참여하실 수 없습니다",
description:
"현재 진행 중인 설문은 특정 조건에 맞는 응답자를 대상으로 합니다. 귀하의 프로필이 이번 조사의 대상과 맞지 않아 참여가 제한되었습니다.",
Icon: XCircle,
badgeVariant: "outline",
iconClassName: "text-muted-foreground",
savedVisible: false,
},
quota: {
label: "할당 초과",
sublabel: "Quota Full",
title: "모집 인원이\n마감되었습니다",
description:
"해당 설문의 목표 응답 수가 충족되어 더 이상 참여가 불가합니다. 참여 의사를 가져주신 데 감사드리며, 다른 설문 기회를 기대해 주세요.",
Icon: Users,
badgeVariant: "outline",
iconClassName: "text-muted-foreground",
savedVisible: false,
},
};
const InfoRow = ({
label,
value,
mono = false,
}: {
label: string;
value: React.ReactNode;
mono?: boolean;
}) => {
return (
<div className="flex items-center justify-between border-b border-border px-4 py-3 last:border-b-0">
<span className="text-xs text-muted-foreground">{label}</span>
<span
className={`text-xs font-medium text-foreground ${
mono ? "rounded bg-muted px-2 py-0.5 font-mono" : ""
}`}
>
{value}
</span>
</div>
);
}
interface RedirectLandingProps {
redirectSlug: RedirectSlug;
timestamp?: string;
}
const RedirectLanding = ({
redirectSlug,
timestamp,
}: RedirectLandingProps) => {
const {
label,
sublabel,
title,
description,
Icon,
badgeVariant,
iconClassName,
savedVisible,
} = STATUS_MAP[redirectSlug];
const displayTime =
timestamp ??
new Date().toLocaleString("ko-KR", {
year: "numeric",
month: "2-digit",
day: "2-digit",
hour: "2-digit",
minute: "2-digit",
second: "2-digit",
});
return (
<ExternalLayout>
<div className="flex flex-1 items-center justify-center px-12 py-8">
<div className="grid w-full max-w-4xl gap-12 lg:grid-cols-2">
{/* 왼쪽: 메시지 */}
<div className="flex flex-col justify-center">
<Badge
variant={badgeVariant}
className="mb-7 w-fit gap-1.5 rounded-full px-3 py-1 text-xs font-bold uppercase tracking-wider"
>
<Icon size={12} />
{sublabel}
</Badge>
<h1 className="mb-5 whitespace-pre-line text-4xl font-extrabold leading-tight tracking-tight text-foreground">
{title}
</h1>
<Separator className="mb-5 h-0.5 w-12 bg-primary" />
<p className="max-w-sm text-sm leading-relaxed text-muted-foreground">
{description}
</p>
</div>
{/* 오른쪽: 카드 */}
<div className="flex flex-col gap-4">
{/* 상태 카드 */}
<Card className="relative overflow-hidden">
<div className="absolute inset-x-0 top-0 h-0.5 bg-primary" />
<CardHeader className="pb-0 pt-6">
<div className="mb-5 flex h-14 w-14 items-center justify-center rounded-xl bg-muted">
<Icon size={26} className={iconClassName} />
</div>
</CardHeader>
<CardContent>
<p className="mb-1 text-xs font-semibold uppercase tracking-widest text-muted-foreground">
최종 상태
</p>
<p className="text-xl font-bold tracking-tight text-foreground">
{label}
</p>
</CardContent>
</Card>
{/* 상세 정보 */}
<Card className="overflow-hidden p-0">
<InfoRow label="응답 상태" value={redirectSlug.toUpperCase()} mono />
<InfoRow label="처리 시각" value={displayTime} />
<InfoRow label="플랫폼" value="KRi Contact System" />
{savedVisible && (
<InfoRow
label="저장 상태"
value={<span className="text-green-500">✓ 저장 완료</span>}
/>
)}
</Card>
</div>
</div>
</div>
</ExternalLayout>
);
}
export default RedirectLanding;

View File

@@ -5,4 +5,8 @@ export const FONT_SIZE = {
} as const;
export const UNKNOWN_HTTP_ERROR = 'UNKNOWN_HTTP_ERROR';
export const NONE_HTTP_ERROR = 'NONE_HTTP_ERROR';
export const NONE_HTTP_ERROR = 'NONE_HTTP_ERROR';
export const ALLOW_REDIRECT = new Set(["complete", "screen", "quota"]);
export const DEFAULT_API_TIMEOUT_MS = 60_000;

View File

@@ -1,4 +1,5 @@
import { clientEnv } from "@/lib/env.client";
import {DEFAULT_API_TIMEOUT_MS} from "@/const/commonConst";
export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
@@ -105,7 +106,7 @@ const isJsonContentType = (ctype: string) => {
export const createHttpClient = (baseURL: string, opts: HttpClientOptions = {}) => {
const {
getToken,
defaultTimeoutMs = 60_000,
defaultTimeoutMs = DEFAULT_API_TIMEOUT_MS,
defaultHeaders = { "content-type": "application/json" },
setErrorMessage,
} = opts;

View File

@@ -1,5 +1,6 @@
import { clsx, type ClassValue } from "clsx"
import { twMerge } from "tailwind-merge"
import type {NextRequest} from "next/server";
export function cn(...inputs: ClassValue[]) {
return twMerge(clsx(inputs))
@@ -99,4 +100,33 @@ export const formatKst = (
return `${yyyy}-${MM}-${dd} ${HH}:${mm}:${ss}`;
};
export const isBlank = (v?: string | null) => !v || v.trim().length === 0;
export const isBlank = (v?: string | null) => !v || v.trim().length === 0;
export const getClientIp = (req: NextRequest): string | null => {
const h = req.headers;
// 가장 흔한 케이스: 프록시/호스팅이 넣어줌
const xff = h.get("x-forwarded-for");
if (xff) {
// "client, proxy1, proxy2" 형태. 보통 첫 번째가 client IP로 쓰이지만,
// 프록시가 헤더를 덮어쓰지 않고 append만 하는 환경이면 spoof 가능성 있음.
return xff.split(",")[0].trim();
}
// 일부 인프라/프록시에서 쓰는 헤더들
const xRealIp = h.get("x-real-ip");
if (xRealIp) return xRealIp.trim();
// (Cloudflare 등) 사용 환경이면
const cf = h.get("cf-connecting-ip");
if (cf) return cf.trim();
// RFC 7239 Forwarded: for=1.2.3.4;proto=https;by=...
const forwarded = h.get("forwarded");
if (forwarded) {
const m = forwarded.match(/for="?([^;,\s"]+)"?/i);
if (m?.[1]) return m[1];
}
return null;
}

12
src/middleware.ts Normal file
View File

@@ -0,0 +1,12 @@
import {NextFetchEvent, NextRequest} from "next/server";
import {catchRedirectPageLanding} from "@/middleware/catchRedirectPageLanding";
export const config = {
matcher: [
"/redirect/:path*",
],
}
export function middleware(req: NextRequest, event: NextFetchEvent) {
return catchRedirectPageLanding(req, event);
}

View File

@@ -0,0 +1,75 @@
import { NextResponse, type NextRequest, type NextFetchEvent } from "next/server";
import { getClientIp } from "@/lib/utils";
import {ALLOW_REDIRECT, DEFAULT_API_TIMEOUT_MS} from "@/const/commonConst";
export const catchRedirectPageLanding = async (req: NextRequest, event: NextFetchEvent) => {
const pathname = req.nextUrl.pathname; // /redirect/quota
const slug = pathname.split("/")[2] ?? "";
const search = req.nextUrl.search;
if(!ALLOW_REDIRECT.has(slug)){
return NextResponse.next();
}
const h = req.headers;
const orig = {
remoteAddr: getClientIp(req),
uri: pathname,
url: req.url,
userAgent: h.get("user-agent"),
referer: h.get("referer"),
origin: h.get("origin"),
xForwardedFor: h.get("x-forwarded-for"),
forwarded: h.get("forwarded"),
};
const body = {};
const endpoint = new URL(req.url);
endpoint.pathname = `/api/external/${encodeURIComponent(slug)}`;
endpoint.search = search;
const controller = new AbortController();
const t = setTimeout(() => controller.abort(), DEFAULT_API_TIMEOUT_MS);
try {
const res = await fetch(endpoint, {
method: "POST",
headers: {
"content-type": "application/json",
"x-orig-user-agent": orig.userAgent ?? "",
"x-orig-referer": orig.referer ?? "",
"x-orig-origin": orig.origin ?? "",
"x-orig-ip": orig.remoteAddr ?? "",
// (선택) 내부 호출 마커
"x-internal-log": "1",
},
body: JSON.stringify(body),
signal: controller.signal,
cache: "no-store",
});
if (res.status === 200 || res.status === 204) {
return NextResponse.next();
}
// 실패 처리 1) 에러 페이지로 redirect (추천)
const errUrl = new URL("/redirect/error", req.url);
errUrl.searchParams.set("code", String(res.status));
errUrl.searchParams.set("sid", req.nextUrl.searchParams.get("sid") ?? "");
return NextResponse.redirect(errUrl, 307);
// 실패 처리 2) 그냥 에러 응답으로 차단하고 싶으면 아래로 대체
// const text = await res.text().catch(() => "");
// return new NextResponse(text || "External API call failed", { status: 502 });
} catch (e) {
// 타임아웃/네트워크 오류 등
const errUrl = new URL("/redirect/error", req.url);
errUrl.searchParams.set("code", "fetch_error");
errUrl.searchParams.set("sid", req.nextUrl.searchParams.get("sid") ?? "");
return NextResponse.redirect(errUrl, 307);
} finally {
clearTimeout(t);
}
};

View File

@@ -6,6 +6,9 @@ export type DataVerification = {
export type RouteContext = { params: Promise<{ slug?: string[] }> };
export type ErrorCode = "404" | "500";
export type RedirectSlug = "complete" | "screen" | "quota";
export type PageRequest = {
pageIndex: number;
pageSize: number;