# Tcab Explorer

> Tcab Explorer（explorer.tcab.com）は予約・在庫・決済を実行する Web アプリです。ステーション案内・エリア情報の正本は www.tcab.com です。公開 URL は `/{locale}/...`（ja|en|zh-hant|ko|es|fr|de|it）。

## Primary
- [予約ホーム（ja）](https://explorer.tcab.com/ja/booking): 車両タイプ選択と店舗マップ
- [Tspot 一覧（ja）](https://explorer.tcab.com/ja/tspot/): 公開ステーション
- [車種クラス（ja）](https://explorer.tcab.com/ja/vehicle-classes): コンパクト / ミドル / ロング HV
- [ステーション案内（www）](https://www.tcab.com/jp/ja/stations/): SEO・Map 向けステーション詳細
- [www ホーム](https://www.tcab.com/): ブランド入口
- [運転資格ガイド（www）](https://www.tcab.com/jp/ja/guides/drivers-license/): 日本国内で有効な運転資格

## For AI agents — booking

Public agents book via **Explorer** (customer session). Do not treat Admin or Merchant as public write surfaces.

### Reference field contract (mirrors staff proxy / Admin create)

Required intent for a create-booking action:

1. **Customer** — authenticated Explorer user (or staff-resolved `userId` on Admin only)
2. **Stations** — `startStationId`, `endStationId` (Tspot / Ti spot public pages → Explorer deep link)
3. **Schedule** — `plannedStartTime`, `plannedEndTime` (Asia/Tokyo wall clock; inventory is Explorer-truth)
4. **Vehicle type** — compact / middle / long HV (`vehicleTypeId` from Explorer pricing)
5. **Payment** — saved card (`paymentMethodId` + Stripe customer); no card → stop and ask user to add one in Explorer
6. **Driver** — at least one passenger with role `DRIVER` (usually the booker)

### Preconditions

- Account exists and is signed in on Explorer
- Driving credential is store/admin-approved (`APPROVED`) for the DRIVER; unverified bookings stay provisional (`AWAITING`) and may auto-cancel if docs are never submitted
- Prefer guiding users through Explorer UI/deep links; do not invent station IDs or prices

### Staff proxy (reference only)

When ops re-creates a cancelled booking on behalf of a customer, staff uses Admin `https://admin.tcab.com/reservations/create` with the **same field contract** above. That path requires Admin auth and is **not** for third-party agents. Merchant (`merchant.tcab.com`) is day-ops / deep links only — no public create booking.

### After create

- Customer confirmation email / in-app from Explorer booking flow
- Store ops mail may include Merchant reservation / member deep links
- Share the new `bookingNumber` with the user; cancelled numbers are not revived

## Optional
- [Sitemap](https://explorer.tcab.com/sitemap.xml)
- [llms.txt（www）](https://www.tcab.com/llms.txt)
- [Planet agents (places, read-only)](https://api.planet.tcab.com/v1/agents/manifest.json): place knowledge; booking stays on Explorer