add Google POI suggestion & place-structure implementation plan

[soranjiro]

Motivation

• Provide a concrete, cross-team implementation plan to add Google Places POI autocomplete suggestions to place inputs and to store structured place data for future ML/analytics.
• Ensure backward compatibility with existing free-text steps.location while proposing DB/API/frontend changes to enable richer place metadata (Place ID, geo, address components, source, etc.).
• Document UX, privacy/regulatory considerations, phased rollout, and risks so implementation can proceed without blocking product/security reviews.

Description

• Add a comprehensive plan at docs/developer/google-poi-place-data-plan.md that covers motivation, UX, data model (places / step_places), API endpoints (/api/places/autocomplete, /api/places/details), frontend component (PlaceInput.svelte) and a phased roadmap.
• Update docs/developer/index.md to link the new plan from the developer guide index.
• The plan includes suggested SQL for new tables, TypeScript API/type sketches (PlaceStructuredData, StepPlaceLink), step create/update flows, field-mask recommendations for Google Place Details, and ML/analytics view examples.
• Implementation notes include using a server-side proxy for Google calls, session token handling, attribution, rate limiting, and tests/migration checklist to keep existing behavior compatible.

Testing

• Ran the project test suite with pnpm test (invokes turbo test:run).
• Automated tests completed successfully: web tests passed (39 tests) and api tests passed (125 tests), with the test run finishing without failures.
• No code changes to runtime logic were made in this PR, so tests confirm repository health after adding documentation and index link.

---

Codex Task

[soranjiro]

@codex
実際に実装まで行ってください。
テスト用にGoogleのmockサーバも別で用意して試せるようにしてみて
mockサーバーは独立で、Googleの設定をしたらmockサーバ無しでそのまま使えるようにして
standardのテーマに優先的に実装して

[chatgpt-codex-connector]

Summary

• Google Places 用のサーバーサイドプロキシを追加し、Autocomplete / Details の取得処理と SvelteKit API ルートを実装しました。実 Google 利用時は GOOGLE_PLACES_API_KEY / 既存 GOOGLE_MAPS_API_KEY を使い、mock 利用時は GOOGLE_PLACES_API_BASE_URL で差し替えられます。 apps/web/src/lib/server/googlePlaces.tsL42-L63 apps/web/src/lib/server/googlePlaces.tsL98-L144 apps/web/src/routes/api/places/autocomplete/+server.tsL6-L21 apps/web/src/routes/api/places/details/+server.tsL6-L24
• standard 系テーマ向けに PlaceInput を追加し、場所入力で Google 候補を検索・選択できるようにしました。選択した Place Details は既存の notes JSON に google_place として保存し、手入力の場合はそのまま保存できます。 apps/web/src/lib/components/PlaceInput.svelteL42-L89 apps/web/src/lib/components/PlaceInput.svelteL99-L138 apps/web/src/lib/themes/standard-seasons/shared/components/EventDetailDialog.svelteL102-L114 apps/web/src/lib/themes/standard-seasons/shared/components/EventDetailDialog.svelteL277-L285 apps/web/src/lib/themes/standard-seasons/shared/components/EventDetailDialog.svelteL515-L523
• 詳細表示では保存済みの Google Maps URL がある場合に Google Maps リンクを表示するようにしました。 apps/web/src/lib/themes/standard-seasons/shared/components/EventDetailDialog.svelteL567-L590
• Places 用の共有型とクライアント API ラッパーを追加しました。 packages/types/src/place.tsL1-L26 apps/web/src/lib/api/places.tsL11-L31
• 独立起動できる Google Places mock サーバーを追加し、pnpm dev:google-places-mock で起動できるようにしました。mock なしで本物の Google 設定に切り替える手順も README / wrangler example に追記しています。 tools/google-places-mock/server.jsL1-L49 tools/google-places-mock/server.jsL88-L128 tools/google-places-mock/README.mdL8-L15 package.jsonL8-L18 wrangler.toml.exampleL18-L23
• Google Places 変換処理のユニットテストを追加しました。 apps/web/src/lib/server/googlePlaces.test.tsL4-L75

Testing

• ✅ pnpm --filter web test:run src/lib/server/googlePlaces.test.ts
• ✅ pnpm --filter web build
• ✅ node tools/google-places-mock/server.js > /tmp/google-places-mock.log 2>&1 & pid=$!; sleep 1; curl -fsS 'http://localhost:8789/v1/places/mock-google-place-tokyo-station' | node -e 'let d="";process.stdin.on("data",c=>d+=c).on("end",()=>{const j=JSON.parse(d); if(j.displayName?.text!=="東京駅") process.exit(1); console.log(j.displayName.text)})'; status=$?; kill $pid 2>/dev/null || true; exit $status
• ❌ pnpm --filter web exec svelte-check --tsconfig ./tsconfig.json（既存の unrelated な型エラー・警告で失敗。例: standard-autumn 配下の欠落 import、map-only / mapbox-journey の既存 props 型不一致など。今回追加分は pnpm --filter web build でコンパイル通過しています。）

View task →

[soranjiro]

@codex
実装したものをこのブランチにコミットしてpushまでして
テストが通ることも確認して

[chatgpt-codex-connector]

Summary

• Google Places（New）向けのサーバーサイドプロキシを追加し、実 Google 利用時は GOOGLE_PLACES_API_KEY / GOOGLE_MAPS_API_KEY、mock 利用時は GOOGLE_PLACES_API_BASE_URL で切り替えられるようにしました。Autocomplete / Details の field mask と session token もサーバー側で扱います。
• Places 用の共有型とフロントエンド API ラッパーを追加しました。
• standard テーマの場所入力に PlaceInput を導入し、候補検索・詳細取得・手入力 fallback・Google attribution 表示に対応しました。
• EventDetailDialog で選択済み Google Place を notes JSON の google_place に保存し、手入力時は古い google_place を消すようにしました。保存済み Maps URL がある場合は詳細表示で Google Maps リンクを表示します。
• Place autocomplete UI 用の standard テーマ CSS を追加しました。
• 独立起動できる Google Places mock server と利用手順を追加し、root script / wrangler example に設定例を追記しました。
• Google Places 変換処理・設定優先順位・field mask / session token 付きリクエストのユニットテストを追加しました。
• コミット済みです: 53bbd88 feat: implement Google Places suggestions。
• PR 作成処理も実行しました。
• 参考にした一次情報: Google Places API (New) overview。

Testing

• ✅ pnpm --filter web test:run src/lib/server/googlePlaces.test.ts
• ✅ pnpm --filter web build
• ✅ node tools/google-places-mock/server.js > /tmp/google-places-mock.log 2>&1 & pid=$!; sleep 1; curl -fsS 'http://localhost:8789/v1/places/mock-google-place-tokyo-station' | node -e 'let d="";process.stdin.on("data",c=>d+=c).on("end",()=>{const j=JSON.parse(d); if(j.displayName?.text!=="東京駅") process.exit(1); console.log(j.displayName.text)})'; status=$?; kill $pid 2>/dev/null || true; exit $status
• ✅ pnpm test
• ⚠️ node - <<'EOF' const { chromium } = require('@playwright/test'); (async () => { const browser = await chromium.launch({ headless: true }); const page = await browser.newPage({ viewport: { width: 1280, height: 900 } }); await page.goto('http://localhost:4173/', { waitUntil: 'networkidle' }); await page.screenshot({ path: '/tmp/tabitabi-home.png', fullPage: true }); await browser.close(); })(); EOF（Playwright のブラウザ実行ファイルが未インストールのためスクリーンショット取得不可）
• ⚠️ git push（この環境の work ブランチに push 先 remote / upstream が設定されていないため失敗: fatal: No configured push destination.）

View task →

[soranjiro]

/deploy-preview

[github-actions]

🚀 Preview Environment Ready

Your preview environment has been deployed:

• Web App: https://989a8811.tabitabi.pages.dev
• API: https://tabitabi-api-preview-pr-187.oranda.workers.dev/api/v1

The Web app is configured to access the preview API automatically.
To update this preview, comment /deploy-preview again.

Note: Preview environments share the same database as production.