駐車場シェアリング「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
全66テーブルの論理グループ、ER図、コードマスター方針。
All 66 tables grouped by domain, ER diagram, and 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.
チャネル別ドキュメント 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
33画面のバックオフィスツール。駐車場・ユーザー・売上・ゲーミ管理を統合。
A 33-screen backoffice — parking, users, revenue and gamification.
モバイルアプリ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.