Chore/next-sitemap

.husky/commit-msg

@@ -3,7 +3,7 @@
 pnpm commitlint --edit "$1" || {
   echo
   echo "❌ 커밋 메시지 규칙 위반!"
-  echo "   형식: CDP-숫자 type이모지(scope): subject"
+  echo "   형식: CDP-숫자 type이모지 (scope): subject"
   echo "   예시: CDP-31 fix🐛(ci): CI error resolution"
   echo "   허용: feat✨, fix🐛, refactor🔨, style🎨, chore⚙️, docs📝, test🧪"
   exit 1

commitlint.config.cjs

@@ -1,11 +1,10 @@
-/** commitlint.config.cjs */
 module.exports = {
   extends: ["@commitlint/config-conventional"],
   parserPreset: {
     parserOpts: {
-      // CDP-123 chore⚙️(scope): subject
+      // CDP-123 chore⚙️ (scope): subject
       headerPattern:
-        /^(CDP-\d+)\s(feat✨|fix🐛|refactor🔨|style🎨|chore⚙️|docs📝|test🧪)\(([^)]+)\):\s(.+)$/,
+        /^(CDP-\d+)\s(feat✨|fix🐛|refactor🔨|style🎨|chore⚙️|docs📝|test🧪)\s\(([^)]+)\):\s(.+)$/,
       headerCorrespondence: ["ticket", "type", "scope", "subject"],
     },
   },

next-sitemap.config.js

@@ -0,0 +1,48 @@
+const RAW_SITE_URL = process.env.SITE_URL ?? "https://myplanmate.vercel.app";
+const siteUrl = RAW_SITE_URL.replace(/\/+$/, ""); // 끝 슬래시 제거
+
+// "/" 이외 경로의 끝 슬래시 제거
+const strip = (p) => (p !== "/" && p.endsWith("/") ? p.slice(0, -1) : p);
+
+const config = {
+  siteUrl,
+  generateRobotsTxt: true,
+  outDir: "public",
+  sitemapSize: 5000,
+
+  // 기존 exclude 그대로 유지
+  exclude: ["/api/*", "/admin/*", "/debug", "/lab/*"],
+
+  // <loc>이 canonical과 1:1로 동일하도록 정규화
+  transform: async (cfg, path) => {
+    const loc = strip(path);
+
+    // 우선순위 규칙
+    const priority = loc === "/" ? 1.0 : loc.startsWith("/blog") ? 0.8 : (cfg.priority ?? 0.7);
+
+    return {
+      loc, // ✅ canonical과 동일한 문자열
+      changefreq: "daily",
+      priority,
+      lastmod: new Date().toISOString(),
+
+      // 언어별 페이지가 있다면 경로 단위로 alternateRefs 매핑
+      // 예) /todos → /ko/todos, /en/todos
+      alternateRefs: [
+        { href: `${siteUrl}/ko${loc === "/" ? "" : loc}`, hreflang: "ko" },
+        { href: `${siteUrl}/en${loc === "/" ? "" : loc}`, hreflang: "en" },
+      ],
+    };
+  },
+
+  // robots.txt
+  robotsTxtOptions: {
+    policies: [
+      { userAgent: "*", allow: "/" },
+      { userAgent: "*", disallow: ["/api/", "/admin/", "/debug", "/lab/"] },
+    ],
+    additionalSitemaps: [`${siteUrl}/server-sitemap.xml`], // 동적 sitemap
+  },
+};
+
+export default config;

next.config.ts

@@ -1,5 +1,14 @@
+// next.config.ts
 import type { NextConfig } from "next";
 
+/** 대표 도메인 (없으면 Vercel 프리뷰 기본값) */
+const isProd = process.env.NODE_ENV === "production";
+const RAW = process.env.SITE_URL ?? "https://myplanmate.vercel.app";
+const ORIGIN = new URL(RAW);
+const NON_WWW_HOST = ORIGIN.hostname.replace(/^www\./, "");
+const WWW_HOST = ORIGIN.hostname.startsWith("www.") ? ORIGIN.hostname : `www.${NON_WWW_HOST}`;
+const DEST_ORIGIN = `${ORIGIN.protocol}//${NON_WWW_HOST}`;
+
 const nextConfig: NextConfig = {
   reactStrictMode: true,
   poweredByHeader: false, // x-powered-by: Next.js 헤더 제거
@@ -29,14 +38,8 @@ const nextConfig: NextConfig = {
       {
         source: "/:path*",
         headers: [
-          {
-            key: "X-Frame-Options",
-            value: "DENY", // 클릭재킹 방지
-          },
-          {
-            key: "X-Content-Type-Options",
-            value: "nosniff", // MIME 타입 스니핑 방지
-          },
+          { key: "X-Frame-Options", value: "DENY" }, // 클릭재킹 방지
+          { key: "X-Content-Type-Options", value: "nosniff" }, // MIME 타입 스니핑 방지
           {
             key: "Referrer-Policy",
             value: "strict-origin-when-cross-origin", // 안전한 referrer 전송
@@ -49,6 +52,23 @@ const nextConfig: NextConfig = {
       },
     ];
   },
+
+  // ✅ 슬래시 정책: 무슬래시
+  trailingSlash: false,
+
+  async redirects() {
+    // ⚠️ dev 모드(HMR)에서는 비활성화 (루프 방지)
+    if (!isProd) return [];
+
+    return [
+      {
+        source: "/:path*",
+        has: [{ type: "host", value: WWW_HOST }],
+        destination: `${DEST_ORIGIN}/:path*`,
+        permanent: false, // 검증 후 true로 승격
+      },
+    ];
+  },
 };
 
 export default nextConfig;

package.json

@@ -7,6 +7,8 @@
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
+    "postbuild": "next-sitemap",
+    "sitemap": "next-sitemap",
     "lint": "eslint . --ext .js,.jsx,.ts,.tsx --max-warnings=0",
     "lint:fix": "pnpm lint --fix",
     "format": "prettier --write .",
@@ -55,6 +57,7 @@
     "eslint-plugin-prettier": "^5.5.4",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.0",
+    "next-sitemap": "^4.2.3",
     "prettier": "^3.6.2",
     "prettier-plugin-tailwindcss": "^0.6.14",
     "tailwindcss": "^4",

public/robots.txt

@@ -0,0 +1,17 @@
+# *
+User-agent: *
+Allow: /
+
+# *
+User-agent: *
+Disallow: /api/
+Disallow: /admin/
+Disallow: /debug
+Disallow: /lab/
+
+# Host
+Host: https://myplanmate.vercel.app
+
+# Sitemaps
+Sitemap: https://myplanmate.vercel.app/sitemap.xml
+Sitemap: https://myplanmate.vercel.app/server-sitemap.xml

public/sitemap-0.xml

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:news="http://www.google.com/schemas/sitemap-news/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:mobile="http://www.google.com/schemas/sitemap-mobile/1.0" xmlns:image="http://www.google.com/schemas/sitemap-image/1.1" xmlns:video="http://www.google.com/schemas/sitemap-video/1.1">
+<url><loc>https://myplanmate.vercel.app</loc><lastmod>2025-10-21T17:20:15.421Z</lastmod><changefreq>daily</changefreq><priority>1</priority><xhtml:link rel="alternate" hreflang="ko" href="https://myplanmate.vercel.app/ko"/><xhtml:link rel="alternate" hreflang="en" href="https://myplanmate.vercel.app/en"/></url>
+</urlset>

public/sitemap.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+<sitemap><loc>https://myplanmate.vercel.app/sitemap-0.xml</loc></sitemap>
+<sitemap><loc>https://myplanmate.vercel.app/server-sitemap.xml</loc></sitemap>
+</sitemapindex>

src/app/layout.tsx

@@ -9,12 +9,12 @@ import {
   LOCALE,
   OG_DEFAULT_IMAGE,
   SITE_NAME,
-  SITE_URL,
+  SITE_URL, // ✅ constants에서 SITE_URL 사용
   TITLE_TEMPLATE,
 } from "@/seo/constants";
 
 export const metadata: Metadata = {
-  // 절대 URL 기준점 (canonical/OG 절대경로 변환에 사용)
+  // ✅ 절대 URL 기준점 (canonical / OG 절대경로 변환용)
   metadataBase: new URL(SITE_URL),
 
   // 전역 타이틀 규칙
@@ -48,6 +48,15 @@ export const metadata: Metadata = {
   twitter: {
     card: "summary_large_image",
   },
+
+  // canonical 및 언어별 hreflang
+  alternates: {
+    canonical: "/", // => https://myplanmate.vercel.app/
+    languages: {
+      ko: "/ko", // => https://myplanmate.vercel.app/ko
+      en: "/en", // => https://myplanmate.vercel.app/en
+    },
+  },
 };
 
 export default function RootLayout({ children }: { children: React.ReactNode }) {
@@ -60,15 +69,6 @@ export default function RootLayout({ children }: { children: React.ReactNode })
           - 모든 하위 컴포넌트가 동일한 client & cache 공유
           - useQuery, useMutation 훅이 어디서든 정상 동작
         */}
-        {/* 
-          ✅ 추후 확장 예시:
-          <AuthProvider>
-            <ThemeProvider>
-              <Providers>{children}</Providers>
-            </ThemeProvider>
-          </AuthProvider>
-        */}
-
         <Providers>{children}</Providers>
       </body>
     </html>

src/seo/baseUrl.ts

@@ -1,5 +1,5 @@
 export const getBaseUrl = () => {
-  const fromEnv = process.env.NEXT_PUBLIC_SITE_URL?.replace(/\/$/, "");
+  const fromEnv = process.env.SITE_URL?.replace(/\/$/, "");
   return fromEnv ?? "http://localhost:3000";
 };
 

src/seo/constants.ts

@@ -1,7 +1,7 @@
 export const SITE_NAME = "MyPlanMate";
 
 export const SITE_URL =
-  process.env.NEXT_PUBLIC_SITE_URL?.replace(/\/$/, "") ?? "http://localhost:3000";
+  process.env.NEXT_PUBLIC_SITE_URL ?? process.env.SITE_URL ?? "https://myplanmate.vercel.app";
 
 export const DEFAULT_TITLE = `${SITE_NAME} - 나만의 맞춤형 플래너`;
 export const TITLE_TEMPLATE = `%s | ${SITE_NAME}`;