heineken-interview-arrange

An interview arrangement system that covers the whole flow in a single console: pick interview targets out of survey respondents, match them against interviewers' calendars, and confirm the schedule.

This documentation is intended for everyone involved in the project — engineers, PO, and designers.

System Overview

The system consists of two independent repositories, coupled only through 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 -->|Query| DBX
  BE --> G

The backend generates /openapi.json automatically from its route definitions, and the frontend generates React Query hooks and types from it with Orval.

Documentation Structure

Section	Contents
📁 Business Domain	Product goals, actors, features, data model
💻 Development	Setup, API specs, DB schema, infrastructure, coding rules
🔗 Links	GitHub, development environments, and other external resources

Where to Start

Role	Suggested reading order
Joining development	Setup → Directory Architecture → API Conventions
Understanding the spec	Product → Features → Data Model
Working on the DB	Database Overview

Maintainers

Name	Role
(TBD)	(TBD)

Last updated: 2026-09-01