season-app — 여행지 제철 재료 가이드 프로토타입

Season (시즌)

A mobile-first prototype of a seasonal food guide for travelers. Pick a month, and optionally a region, to see which Korean ingredients are in season, where they are mainly produced, and how to choose and store them.

The idea, from the product notes in docs/PRD.md: explore food on a trip by season and place of origin rather than by restaurant ratings. The tagline is "지금, 여기서만 먹을 수 있는 것", roughly "what you can only eat here, right now". The site shows the core facts and hands deeper questions (recipes, where to eat or buy) to an AI search engine.

Status: prototype. It is not deployed, it has no tests or CI, and the ingredient data is hand-written sample data (see Limitations).

Features

• Home (/)
• A month selector, which defaults to the current month.
• An optional region filter covering Korea's 17 시/도.
• A "지도보기" button that opens a full-screen overlay with a simplified SVG map of the 17 regions. Tapping a region applies it as the filter.
• The matching ingredients, each with its season months and main producing regions.
• Ingredient detail (/ingredients/[id])
• A description, the season, the main producing regions, how to choose the ingredient, and how to store it.
• generateStaticParams lists all 20 ingredient ids. The page reads ?month= and ?region= from the query string, so Next.js renders it on the server for each request. It is not a static export.
• "AI로 알아보기": six buttons on the detail page (recipe, restaurants, where to buy, YouTube, blog, 고향사랑기부제 rewards). Each button builds a Korean prompt from a template in src/lib/prompts.ts and opens it as a Perplexity search in a new tab. Most prompts include a region: the one passed from the list, or the ingredient's first producing region if none was passed. Only the recipe prompt also uses the month passed from the list, and the YouTube prompt uses neither.
• Crawler-friendly output
• src/app/sitemap.ts lists the home page and every ingredient page.
• public/robots.txt explicitly allows common AI crawlers.
• Detail pages carry JSON-LD Product and BreadcrumbList data. For items flagged hasDonation, the Product also includes a generic Offer (see Limitations).

Tech stack

• Next.js 14.2 (App Router), React 18, TypeScript 5
• Tailwind CSS 3.4
• ESLint (eslint-config-next)
• Geist and Geist Mono fonts, bundled in src/app/fonts/ under the SIL Open Font License 1.1 (see src/app/fonts/OFL.txt)
• No backend or database. All data lives in static TypeScript files under src/data/.

Getting started

Requires Node.js 18.17 or newer (the minimum for Next.js 14).

npm install
npm run dev      # http://localhost:3000
npm run build    # production build
npm run start    # serve the production build
npm run lint

NEXT_PUBLIC_SITE_URL is optional. It sets the absolute base URL used in page metadata, the sitemap and JSON-LD, and defaults to http://localhost:3000. public/robots.txt is a static file that still names the default domain, so edit it by hand if you change the URL.

Project layout

src/
  app/
    page.tsx                  home: month selector, region filter, map overlay, list
    ingredients/[id]/page.tsx ingredient detail + AI search buttons + JSON-LD
    sitemap.ts
    layout.tsx
  components/
    home/                     MonthSelector, RegionFilter, MapOverlay
    search/                   AISearchButtons
    seo/                      JSON-LD helpers
  data/                       ingredients.ts (20 items), regions.ts (17 regions)
  lib/                        prompts.ts, constants.ts, utils.ts, hooks/
  types/                      shared types
docs/
  PRD.md                      product requirements (Korean)
  TDD.md                      technical design (Korean)

Limitations

• Sample data. The ingredient seasons, producing regions, nutrition notes, tips and donation flags were written by hand for the prototype. They have not been checked against official sources. The "🎁 기부" badge only reflects a hasDonation flag in the data, and no donation amounts or specific rewards are listed. For the 19 flagged items, the detail page's JSON-LD still emits a generic Offer saying the item can be received as a 고향사랑기부제 reward, with a link to ilovegohyang.go.kr. That Offer comes from the same unverified flag.
• Filters are not in the URL. The home page keeps the month and region in component state and does not read them from the URL. The detail page's back link passes ?month= and ?region=, but the home page ignores them.
• Unused components. The components under src/components/{ingredient,map,season,ui} are from an earlier iteration and are not rendered.
• Planned features. docs/TDD.md describes some planned features that are not implemented, such as per-region pages and a search page.
• No tests. There are no automated tests.