Inquiry Forms Specification
Status: Canonical
Last Updated: 2026-05-11
Source: apps/frontend/app/[locale]/(landing)/inquiry/
Doc Status: Excellent | ✓ All 6 checks passed
Overview
All inquiry forms (Contact, Venue Rental, Workshops, Private Events, Artist Proposal, Host an Event) follow the same architecture: React Hook Form + Zod validation on frontend, Convex mutation stores in formSessions, and admin kanban view for management.Related specs
- Tech Stack — Forms use React Hook Form + Zod
- Data Model — formSessions, inquirySessions tables
- Public Pages — Inquiry pages are part of public pages
- Admin Dashboard — Kanban view in admin for managing inquiries
- Notifications — Admin alerts when new inquiry submitted
- User Stories — US-G04 covers inquiry submission
Form Types
| Form | Route | Purpose | Storage |
|---|---|---|---|
| Contact | /inquiry/contact | General inquiries | formSessions |
| Venue Rental | /inquiry/venue-rental | Private venue booking | formSessions |
| Workshops | /inquiry/workshops | Workshop inquiries | formSessions |
| Private Events | /inquiry/private-events | Private event bookings | formSessions |
| Artist Proposal | /inquiry/artist-proposal | Performer applications | formSessions |
| Host an Event | /inquiry/host-an-event | Corporate/event hosting | formSessions |
Form Architecture
Frontend
Each inquiry page is a self-contained form:- Hero section with page title
- Form fields (React Hook Form + Zod validation)
- Submit button with loading state
- Success/error messages
Backend Storage
All form submissions stored in two tables: formSessions — Raw submission- sessionId: UUID
- formType: enum
- data: JSON stringified fields
- submitted: boolean
- expiresAt: 7 days
- formSessionId: FK
- formType: enum
- status: NEW | READ | REPLIED | ARCHIVED
- adminNotes: optional
- reviewedBy: Clerk user ID
- reviewedAt: timestamp
Form Fields by Type
Contact
- name (required)
- email (required, validated)
- subject (required)
- message (required)
Venue Rental
- name (required)
- email (required)
- phone (required)
- eventType (required)
- date (required)
- guestCount (required)
- message (optional)
Workshops
- name (required)
- email (required)
- phone (required)
- workshopType (required)
- message (optional)
Private Events
- name (required)
- email (required)
- phone (required)
- eventType (required)
- date (required)
- guestCount (required)
- message (optional)
Artist Proposal
- name (required)
- email (required)
- phone (required)
- performanceType (required)
- description (required)
- links (optional)
Host an Event
- name (required)
- email (required)
- phone (required)
- eventType (required)
- date (required)
- guestCount (required)
- message (optional)
Submission Flow
- User fills form — React Hook Form validates
- Submit — useMutation(api.domains.forms.submitInquiry)
- Convex stores in formSessions
- Convex creates inquirySession with status=NEW
- Convex creates notification for admin
- Frontend shows success message
Admin Management
Kanban Board (/dashboard/inquiries)
- Columns: NEW | READ | REPLIED | ARCHIVED
- Drag cards between columns to update status
- Click card to expand details
Card Display
- Form type badge
- Submitter name
- Submitter email
- Date submitted
- Message preview (first 100 chars)
Detail View
- All form fields
- Submission timestamp
- Current status
- Admin notes (add/edit)
- Follow-up history