駐車場の登録・編集ガイド Parking Lot Registration & Editing Guide
駐車場の情報はすべてオーナーポータルから登録・変更できます。 新規登録は 8 セクションのウィザード、既存駐車場の編集は 9 タブの詳細画面で行います。
All parking lot information is managed through the owner portal. New lots use an 8-section registration wizard; existing lots are edited on a 9-tab detail screen.
新規登録の流れ (8 セクション) New Registration Wizard (8 sections)
/parking/new から開始します。サイドバー「自分の駐車場 → 駐車場の登録」が入口。
セクションは任意の順で開けますが、必須項目を満たすとステッパーバッジが完了表示になります。
最後に「保存」を押すと POST /v1/owner/parking-lots/mine(バンドル)で本体と子テーブル(hours / pricing groups / rules / tags / images / spots)が atomic に投入され、
初期ステータスは draft です。掲載申請(pending 遷移)は後述の詳細画面 Tab 9「公開設定」から行います。
Start at /parking/new (sidebar: "My parking lots → Register"). Sections can be opened in any order; the stepper marks each as
complete once required fields are valid. Pressing "Save" calls POST /v1/owner/parking-lots/mine (bundle), which inserts the lot
body and all child tables (hours / pricing groups / rules / tags / images / spots) atomically. The initial status is
draft — submission for review (pending) happens later on Tab 9 "Publication" of the detail screen.
flowchart LR S1["1. 基本情報
Basic info"] --> S2["2. 位置・形状
Location"] S2 --> S3["3. 車両制限
Physical"] S3 --> S4["4. 営業時間
Hours"] S4 --> S5["5. 料金
Pricing"] S5 --> S6["6. タグ
Tags"] S6 --> S7["7. 写真
Images"] S7 --> S8["8. 区画
Spots"] S8 --> SAVE{{"保存 / Save
POST .../parking-lots/mine (bundle)"}} SAVE --> DRAFT[("status = draft
→ Tab 9 で申請")]
| セクションSection | SectionKeySectionKey | 入力項目Fields |
|---|---|---|
| 1. 基本情報Basic info | basic |
名称・住所・lot_type(regular / meter / ticket)・収容台数・structure・entry_method・領収書対応・最大連続利用時間などName, address, lot_type (regular / meter / ticket), capacity, structure, entry_method, receipt availability, max continuous duration, etc. |
| 2. 位置・形状Location & shape | location |
shape_type(point / line / area)+ 緯度経度・line / area ジオメトリ(mapbox-gl-draw)shape_type (point / line / area) + lat/lng or line / area GeoJSON via mapbox-gl-draw |
| 3. 車両制限Physical | physical |
lot 共通の上限(高さ・幅・長さ・重量・最低地上高・タイヤ幅)。区画ごとに上書き可(区画セクション)Lot-wide limits (height / width / length / weight / min clearance / tire width). Spot-level override available in the Spots section. |
| 4. 営業時間Hours | hours |
曜日別 open/close(HH:MM)。「24 時間」「終日休業」チェック対応。日付例外は登録後の Tab 4 で追加Day-of-week open/close (HH:MM) with "24h" and "closed all day" checkboxes. Date overrides are added later in detail Tab 4. |
| 5. 料金Pricing | pricing |
料金グループ(デフォルト 1 件は自動)→ ルール(category = unit / cap、day_type = all / weekday / saturday / sunday / holiday / holiday_eve、per_minutes + price_minor、上限)Pricing group (one default is seeded) → rules (category unit/cap, day_type all / weekday / saturday / sunday / holiday / holiday_eve, per_minutes + price_minor, cap rule) |
| 6. タグTags | tags |
支払方法・設備タグを 3 値(true / false / unknown)でセットPayment-method and amenity tags set as a 3-state value (true / false / unknown) |
| 7. 写真Images | images |
R2 へ POST /v1/storage/upload-url で発行した presigned PUT URL に直 PUT。メイン画像指定・並び替えDirect PUT to R2 via presigned URL from POST /v1/storage/upload-url. Set main image, reorder. |
| 8. 区画Spots | spots |
個別区画ドラフト(コード・count 集約・車種上限・EV / アクセシビリティ・寸法・pricing_group_id 上書き)。区画別写真も投入可Per-spot drafts (code, count aggregation, vehicle-class max, EV / accessibility, dimensions, optional pricing_group_id override). Per-spot photos supported. |
draft として登録され、掲載申請は詳細画面 Tab 9「公開設定」の「審査リクエスト」ボタンから行います(draft または revision_requested のときだけ押下可)。
draft; submitting it for review happens later via the "Request review" button on Tab 9 "Publication" (only enabled in draft or revision_requested).
詳細画面のタブ構成 (9 タブ) Detail Screen Tab Layout (9 tabs)
/parking/:id を開くと 9 つのタブが表示されます。
各タブは独立して保存できます。タブを切り替える前に未保存の変更がある場合は警告が表示されます。
Opening /parking/:id shows 9 tabs. Each tab saves independently.
Navigating away with unsaved changes triggers a warning.
| Tab | 名前Name | 編集できることWhat you can edit |
|---|---|---|
| 1 | 基本情報Basic info | 名称・住所・電話番号・駐車場タイプ・収容台数・入庫方法・領収書対応・関連駐車場Name, address, phone, structure type, capacity, entry method, receipt availability, related lots |
| 2 | 位置・形状Location & area | 地図上のピン位置 (緯度/経度) と敷地ポリゴン (Mapbox Draw)Map pin (lat/lng) and site boundary polygon via Mapbox Draw |
| 3 | 物理制限Physical limits | 最大高さ / 幅 / 奥行き / 重量 / 最小地上高 / 最大タイヤ幅。 入力はすべて mm または kg 整数で行います。 Max height / width / length / weight / min clearance / max tire width. All values are entered as mm or kg integers. |
| 4 | 営業時間Opening hours | 曜日ごとの開始/終了時刻 (HH:MM)。「24 時間」「終日休業」チェック対応。 特定日の例外 (花火大会など) も同タブで追加できます。 Open/close time (HH:MM) per day of week. "24h open" and "closed all day" checkboxes available. Date-specific overrides (holidays, events) are also managed here. |
| 5 | 料金Pricing | 料金グループ → ルール → 上限のネスト構造で設定。 グループ単位で複数の料金体系 (一般車/軽/EV 専用など) を管理できます。 Nested structure: pricing group → rate rules → caps. Manage multiple rate schedules per group (standard, compact, EV-only, etc.). |
| 6 | 駐車区画Parking spots | 区画コード・料金グループ・車種上限・EV 充電器・アクセシビリティ対応・寸法 (幅×奥行×高さ mm) を区画ごとに設定。 「編集」を押すと右からドロワーが開きます。 Spot code, pricing group, vehicle class limit, EV charger, accessibility, and dimensions (W×L×H mm) per spot. Click "Edit" to open a slide-in drawer. |
| 7 | 写真Photos | Cloudflare R2 への画像アップロード。メイン画像の設定・並び替え・削除。 メイン画像は掲載ページのサムネイルに使用されます。 Upload images to Cloudflare R2. Set main image, reorder, and delete. The main image is used as the listing thumbnail. |
| 8 | 支払方法・タグPayment & tags | 対応している支払方法 (現金・IC カード・クレジットカードなど) と設備タグを ON/OFF で設定します。 タグはユーザーの検索条件にも反映されます。 Toggle payment methods (cash, IC card, credit card, etc.) and facility tags. Tags are reflected in user search filters. |
| 9 | 公開設定Publication | 現在のステータスを確認し、Parky への掲載申請を送信します。 「審査リクエスト」ボタンは draft または revision_requested のときのみ押下可能です。 View the current status and submit a listing application to Parky. The "Request review" button is only enabled in draft or revision_requested status. |
申請ステータスの流れ Application Status Flow
Tab 9 の「公開設定」で現在のステータスを確認できます。ステータスは以下のように遷移します。
Check the current status in Tab 9 "Publication". Statuses transition as follows.
| ステータスStatus | 意味Meaning | 次のアクションNext action |
|---|---|---|
draft |
編集中 (未申請)Editing (not yet submitted) | Tab 9 の「審査リクエスト」を押すPress "Request review" in Tab 9 |
pending |
新規登録 / 申請直後Just registered / submitted | Parky スタッフによる審査を待ちますAwaiting Parky staff review |
under_review |
審査中Under review | そのままお待ちくださいPlease wait for the review to complete |
active |
掲載中 (審査通過)Active (review passed) | Parky に掲載されています。引き続き情報を更新できます。Listed on Parky. You can continue to update information. |
revision_requested |
修正依頼ありRevision requested | 審査フィードバックに従って情報を修正し、再度申請しますFix the issues from the review feedback and resubmit |
inactive |
非公開Inactive | Parky スタッフにお問い合わせくださいContact Parky staff to re-activate |
「申請中」フィールドの扱い (公開済みの駐車場を編集したとき) "Pending" fields (when editing an already-published lot)
2026-05-04 から、active の駐車場をオーナーが編集した場合の挙動が変わりました。
編集内容は即座に公開には反映されず、運営審査キューに入ります。
従来は PATCH すれば即時に表示が変わっていましたが、Phase 0a (provenance core) 導入後は、
admin による承認まで 旧値が公開されたままになります。
Starting 2026-05-04, editing a published (active) lot behaves differently.
Edits do not appear publicly right away — they enter an admin review queue.
Previously a PATCH was reflected instantly; after Phase 0a (provenance core), the old value remains public
until an admin approves the edit.
| 編集タイミングEdit timing | 挙動Behavior |
|---|---|
draft / pending の自分の駐車場を編集Editing own lot in draft / pending |
即時反映 (作業中扱い)Applied immediately (still being drafted) |
active の自分の駐車場を編集Editing own active lot |
申請中キューに追加。Tab 9「公開設定」に「N 件の修正が運営審査中」と表示。承認されるまで旧値が live。Queued for admin review. Tab 9 "Publication" shows "N edits awaiting admin review". The old value remains live until approved. |
| 敷地ポリゴン (location / area) や status の変更Editing location / area or changing status | 敷地は admin 専管。status は通常通り pending 化リクエストで遷移。Site polygon is admin-only. Status follows the normal "request review" flow. |
申請中のフィールド一覧は Tab 9「公開設定」内の通知バナーで確認できます。 対象になる属性は以下の 17 種類 (Phase 0.5 で 8 → 17 に拡張):
- 基本:
name/address/total_spaces/structure/entry_method/receipt_available/pricing_notes/vehicle_type_max - 連絡先 (Phase 0.5):
contact_phone/contact_email/contact_url - 収容台数の内訳 (Phase 0.5):
capacity_disabled/capacity_kei/capacity_regular/capacity_oversized/capacity_motorcycle/capacity_ev
admin が status を pending → active に切り替えたタイミングで自動承認されるか、
admin が個別に approve することで反映されます。
The list of fields awaiting review is shown as a notice in Tab 9 "Publication". Eligible attributes are the 17 below (expanded from 8 in Phase 0.5):
- Core:
name/address/total_spaces/structure/entry_method/receipt_available/pricing_notes/vehicle_type_max - Contact (Phase 0.5):
contact_phone/contact_email/contact_url - Capacity breakdown (Phase 0.5):
capacity_disabled/capacity_kei/capacity_regular/capacity_oversized/capacity_motorcycle/capacity_ev
Approval happens either automatically when admin transitions status from pending → active,
or manually by admin approval per row.
物理制限の入力単位 Physical Limit Input Units
Tab 3 の物理制限はすべて 整数 で入力します。 単位は項目によって異なります。
All physical limit values in Tab 3 are entered as integers. Units vary by field.
| 項目Field | 単位Unit | 入力例Example |
|---|---|---|
| 最大高さMax height | mm | 2100 (= 2.1 m)(= 2.1 m) |
| 最大幅Max width | mm | 2500 (= 2.5 m)(= 2.5 m) |
| 最大奥行きMax length | mm | 5000 (= 5.0 m)(= 5.0 m) |
| 最大重量Max weight | kg | 2000 (= 2 t)(= 2 t) |
| 最小地上高Min clearance | mm | 150 (= 15 cm)(= 15 cm) |
| 最大タイヤ幅Max tire width | mm | 285 (= 285 mm)(= 285 mm) |
| 区画寸法 (幅×奥行×高さ)Spot dimensions (W×L×H) | mm | 2400 × 5000 × 2100 |