heineken-interview-arrange

アンケート回答者の中からインタビュー対象者を選び、面接官のカレンダーと突き合わせて日程を確定させるまでを 1 画面で完結させる、面接調整システム。

このドキュメントは、開発メンバー・PO・デザイナーなど本プロジェクトに関わる全員を対象としています。

システム構成

独立した 2 つのリポジトリからなり、両者は OpenAPI 経由でのみ結合しています。

graph LR
  FE[heineken-interview-arrange-frontend<br/>Next.js App Router]
  BE[heineken-interview-arrange-backend<br/>Bun + Hono]
  DB[(PostgreSQL)]
  DBX[Databricks<br/>Creative Survey / Ask One]
  G[Google APIs<br/>Calendar / Gmail / OAuth]

  FE -->|REST / JWT| BE
  BE -->|Drizzle ORM| DB
  BE -->|クエリ| DBX
  BE --> G

バックエンドがルート定義から /openapi.json を自動生成し、フロントエンドは Orval でそこから React Query フックと型を生成します。

ドキュメント構成

セクション	内容
📁 ビジネスドメイン	プロダクトの目的・登場人物・機能・データモデル
💻 開発	環境構築・API 仕様・DB 定義・インフラ・コーディングルール
🔗 リンク集	GitHub・開発環境などの外部リソース

はじめに読むもの

立場	推奨
開発に参加する	セットアップ → ディレクトリ構成 → API 共通仕様
仕様を把握したい	プロダクト → 機能 → データモデル
DB を触る	データベース概要

メンテナー

名前	役割
（未設定）	（未設定）

最終更新: 2026-09-01