駐車場シェアリング「Parky」の全体ドキュメント The full documentation for Parky — a parking-sharing service
本サイトは Parky を構成するすべてのプロダクト （モバイルアプリ / 一般ユーザー向けWeb版 / 管理者ポータル）の 仕様・設計・運用を横断的にまとめた開発者向けドキュメントです。 左のサイドバーまたは上部タブから各プロダクトの詳細資料へ移動できます。
This site collects specifications, design notes, and operations guides for every product under the Parky umbrella — the mobile app, the public web app, and the admin portal. Use the left sidebar or the tabs above to jump into any product-specific section.
ドキュメント構成 Documentation map
トップページ（このページを含む docs/ 直下）にはプロダクト横断の共通仕様を配置し、
個別プロダクトはそれぞれ専用のサブディレクトリに分離しています。
The top-level docs/ holds cross-product shared specs; each product has its own subdirectory.
アーキテクチャArchitecture
Cloudflare Workers BFF + Supabase のシステム全体像、/v1/* 一元化、コンポーネント境界、認証フロー。
System context around the Cloudflare Workers BFF + Supabase, the unified /v1/* API surface, component boundaries, and auth flow.
データモデルData model
全 93 テーブルを 14 ドメインに分類した論理グループ、ER 図、コードマスター方針。
All 93 tables organized into 14 domain groups, the ER diagram, and the code-master strategy.
技術スタックTech stack
Cloudflare Workers + Hono / Supabase / Mapbox GL JS / Astro / Flutter / FCM など、採用技術と役割。
Cloudflare Workers + Hono, Supabase, Mapbox GL JS, Astro, Flutter, FCM — what we use and why.
共通規約Conventions
コードマスター、ソフトデリート、リンクテーブル、命名規則などの共通ルール。
Code master, soft delete, link tables, naming — the rules we share.
リポジトリ構成Repository layout
Parky モノレポのディレクトリ構造とデプロイ経路のマップ。
Directory map of the Parky monorepo and its deployment pipelines.
残作業チェックリストPending tasks
本番化に向けて残っている「開発者がやる作業」と「運用ユーザーがやる作業」の網羅リスト。目的と具体手順つき。
Everything still required before production — split between developer and operator tasks, each with a purpose and concrete steps.
チャネル別ドキュメント Channel-specific docs
各チャネル（BFF / 管理者ポータル / モバイルアプリ / 公開 Web）の専用ドキュメント。上のサイドバーまたは以下のカードから移動できます。
Dedicated docs per channel (BFF / admin portal / mobile app / public web). Navigate via the sidebar or the cards below.
BFF / APIBFF / API
Cloudflare Workers BFF の仕様一式。OpenAPI (Swagger UI / Redoc)、エラーカタログ、アクティビティ & ゲーミフィケーション、E2E テスト運用。
The complete Cloudflare Workers BFF spec set: OpenAPI (Swagger UI / Redoc), error catalog, activity & gamification, E2E testing guide.
管理者ポータルAdmin portal
40 画面超のバックオフィスツール。駐車場・ユーザー・オペレータ・売上・ゲーミフィケーション・監査ログを統合。
A 40+ screen backoffice — parking, users, operators, revenue, gamification, and audit logs.
オーナーポータルOwner portal
13 画面のオーナー向けセルフサービス。申請・招待・駐車場管理・レビュー返信・ブースト・クレジット。
A 13-screen self-service for parking owners — applications, invitations, lots, review replies, boosts, credits.
マーケティングポータルMarketing portal
コンテンツ運用・SNS（X / Instagram）・ニュースレター配信・キャンペーン・アナリティクスを一元化。
Content ops, SNS (X / Instagram), newsletters, campaigns, and analytics in one place.
モバイルアプリMobile app
エンドユーザー向け Flutter アプリ。駐車場の検索・比較・選択・振り返り。
The end-user Flutter app. Search, compare, park, and review.
Web版Web app
一般ユーザー向け Astro 製 Web 版。SEO 重視、地図検索＋監視体制付き。
The public Astro-based web app — SEO-first with a search/map UX.