駐車場シェアリング「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.
API 仕様 (Swagger UI)API spec (Swagger UI)
Workers BFF /v1/* の OpenAPI 3.1 仕様をインタラクティブに閲覧・試せるビュー。
Interactive Swagger UI for the Workers BFF /v1/* OpenAPI 3.1 spec.
API 仕様 (Redoc)API spec (Redoc)
同 OpenAPI 3.1 仕様の Redoc ドキュメント形式ビュー。
Redoc-rendered documentation view of the same OpenAPI 3.1 spec.
エラーカタログ & ログError catalog & logging
BFF が返すエラーコード ERROR_CATALOG と 1 行 JSON 構造化ログの仕様、分析クエリ例。
The BFF ERROR_CATALOG of error codes, the structured one-line JSON log schema, and sample analysis queries.
アクティビティ & ゲーミフィケーションActivity & gamification
user_activity_logs / EXP / バッジの配線。各 API が投げる activity_type の一覧と award_user_activity の仕様。
How user_activity_logs, EXP, and badges are wired; the per-API activity_type catalog; award_user_activity semantics.
プロダクト別ドキュメント Product-specific docs
管理者ポータル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.