ワインのAOP(原産地呼称)を地図で学ぶWebアプリ。TanStack Start + MapLibre GL JS + Cloudflare Workers/D1。

公開URL: https://wine.nibo.sh (カスタムドメイン)。Workers のデフォルトドメイン https://wine.niboshi.workers.dev でも動作する。

• ディレクトリ構成・アーキテクチャ・ドメインモデリングのルール: docs/architecture.md
• デプロイ・環境構成: docs/deployment.md

AOP境界データの生成

public/data/aop/*.geojson は INAO / EU PDO のオープンデータから生成する(生成物はコミット済み。データ更新時のみ再実行)。手順・データソース・再生成時の注意は docs/geodata.md を参照。

AOPのメタデータ(土壌・品種・生産者)は src/lib/wine/aops.json にあり、src/lib/wine/aop-schema.ts のスキーマで読み込み時に検証される。

Getting Started

To run this application:

bun install
bun --bun run dev

Building For Production

To build this application for production:

bun --bun run build

Testing

This project uses Vitest for testing. You can run the tests with:

bun --bun run test

Setting up Cloudflare D1

This app uses Cloudflare D1 (the DB binding in wrangler.jsonc) to persist Better Auth data (users / sessions / OAuth clients) and the app's own domain data (learning progress, cellar records, credit ledger, etc.).

Create the D1 database:

bunx --bun wrangler d1 create wine-db

Copy the generated database_id into wrangler.jsonc, replacing 00000000-0000-0000-0000-000000000000, then regenerate Worker binding types:

bun run cf-typegen

Migrations

Migrations are hand-written sequential SQL files under drizzle/ (0000_*.sql, 0001_*.sql, …). Drizzle ORM (src/db/schema.ts / src/db/auth-schema.ts) is the runtime query layer only — schema changes are authored by hand as the next numbered SQL file and applied with wrangler d1 migrations apply. drizzle-kit (db:generate / db:push / db:pull) is intentionally not used, since its tracking state does not include the Better Auth tables and could propose destructive diffs against the production DB. See CLAUDE.md for the schema-change workflow.

Apply migrations to the local D1 (run once initially and after every schema change, before bun run dev):

bun run db:migrate:local

Migrations are applied to the remote databases automatically on deploy — Cloudflare Workers Builds runs db:migrate:remote / db:migrate:preview after a successful build (see docs/deployment.md). To apply them manually against the production D1:

bun run db:migrate:remote

Linting & Formatting

This project uses Biome for linting and formatting. The following scripts are available:

bun --bun run lint
bun --bun run format
bun --bun run check

Shadcn

Add components using the latest version of Shadcn.

pnpm dlx shadcn@latest add button

Better Auth

Authentication is handled by Better Auth. It requires a BETTER_AUTH_SECRET in every environment — it signs session cookies and OAuth tokens. Generate one with:

bunx --bun @better-auth/cli secret

• Local: put it in .dev.vars as BETTER_AUTH_SECRET=... (see .dev.vars.example).

• Production / Preview (Cloudflare Workers): set it as a secret so it is never committed:

  bunx --bun wrangler secret put BETTER_AUTH_SECRET
  bunx --bun wrangler secret put BETTER_AUTH_SECRET --env preview
  

wrangler secret put values are not emitted by wrangler types, so the binding is declared for TypeScript in src/env-secrets.d.ts. If BETTER_AUTH_SECRET is missing, Better Auth falls back to a built-in default and, with NODE_ENV=production, fails fast at startup.

For local OAuth/MCP verification, also set BETTER_AUTH_URL=http://localhost:3000 in .dev.vars (see .dev.vars.example).

ライセンス

このリポジトリの成果物は PolyForm Noncommercial License 1.0.0 の下で提供されます（SPDX: PolyForm-Noncommercial-1.0.0、原文: https://polyformproject.org/licenses/noncommercial/1.0.0）。

• 非商用の利用（個人の学習・研究・趣味、非営利団体・教育機関・公的機関による利用等）に限り、無償で利用・複製・改変・配布できます。
• 商用利用はこのライセンスの範囲外です。商用利用を希望する場合は、リポジトリの Issue から maintainers へお問い合わせください。
• 依存パッケージ（package.json / bun.lock に記載のもの）は各々のライセンスに従います。本リポジトリのライセンス設定とは無関係です。