マーケティングポータル ドキュメント Marketing Portal documentation
Parky のマーケティング運用ポータル仕様書。記事 / 広告 / Instagram-legacy / X / SNS 連携 / キャンペーン / 配信カレンダー / アセット / アナリティクスを担当するマーケチームの作業画面 (web/portal/marketing/)。React 19 + Vite 8 + TypeScript / React Router v7 / TanStack Query v5 / Bootstrap 5 / Sentry React / Mapbox GL JS。BFF は /v1/marketing/* に requireMarketing middleware で集約され、変更系には Idempotency-Key を自動付与します。
Documentation for the Parky marketing operations portal — articles, ads, the legacy Instagram tool, X, social integrations, campaigns, the cross-channel calendar, assets, and analytics (web/portal/marketing/). Stack: React 19 + Vite 8 + TypeScript, React Router v7, TanStack Query v5, Bootstrap 5, Sentry React, Mapbox GL JS. The BFF is mounted under /v1/marketing/* behind the requireMarketing middleware, with automatic Idempotency-Key on every mutation.
features.html / pages.html 内のバッジは live(画面 + BFF + DB 全て動く)/scaffold(BFF endpoint はあるが外部連携 or 集計 cron が未稼働)/PlaceholderPage(route tree のみ確保)の 3 段階で表記しています。「ドキュメントに名前があるが実機に存在しない機能」は意図的に排除済みです。
Badges in features.html / pages.html use three buckets: live (screen + BFF + DB all wired), scaffold (BFF endpoint exists but the external integration or aggregation cron is dormant), and PlaceholderPage (route tree reserved only). Imaginary features have been removed.
主要セクション Sections
画面カタログScreen catalog
ダッシュボード・SNS・ニュースレター・キャンペーン・アセット・アナリティクス等、全画面を一覧。
Every screen — dashboard, SNS, newsletter, campaigns, assets, analytics, and more.
機能一覧Features
コンテンツ管理 / X 運用 / Instagram / ニュースレター / キャンペーン / アナリティクス等を機能別に整理。
Content ops, X automation, Instagram, newsletter, campaigns, analytics — organized by feature.
アーキテクチャArchitecture
スタック・requireMarketing 認可・外部 API (X / Instagram / GA4 / Resend)・Vault 暗号化・Cron 構成。
Stack, requireMarketing authorization, external APIs (X / Instagram / GA4 / Resend), Vault encryption, Cron topology.
API 仕様 (Swagger UI)API spec (Swagger UI)
マーケティング API のみに絞った OpenAPI 仕様をインタラクティブに閲覧・試せます。
Interactive Swagger UI showing marketing-channel endpoints only.
API 仕様 (Redoc)API spec (Redoc)
同じ仕様を Redoc 形式で読みやすく表示。
Same spec rendered as Redoc, optimized for reading.