Firestore Database Setup¶

Initial Setup Required¶

CRITICAL: The Firestore API must be enabled before the app can function.

Step 1: Enable Firestore¶

Visit Firebase Console
Click "Create database"
Select location: europe-west1 (Belgium) for GDPR compliance
Start in: Production mode (security rules already configured in firestore.rules)

Step 2: Initialize Golf Carts¶

Once Firestore is created, initialize the database with golf carts:

Open the app: https://golfbilkontroll-skigk.web.app
Look for the 🛠️ Reset DB button (visible in dev mode)
Click to create 5 golf carts:
Blå 4 (ID: 1)
Blå 5 (ID: 2)
Grønn (ID: 3)
Hvit (ID: 4)
Svart (ID: 5)

Or manually via Firebase Console:

Create collection carts with documents:

Document ID: "1"
{
  id: 1,
  name: "Blå 4",
  status: "available",
  currentRentalId: null
}

Document ID: "2"
{
  id: 2,
  name: "Blå 5",
  status: "available",
  currentRentalId: null
}
...

Step 3: Verify Connection¶

After Firestore is created: - Calendar should load - Availability grid should show time slots - Can select dates and times - Booking flow should work

Error States¶

"Laster tilgjengelighet..." Never Completes¶

Cause: Firestore API not enabled

Solution: Follow Step 1 above

403 Errors in Console¶

Cause: Firestore API disabled or wrong project

Check:

firebase firestore:databases:list

Should show (default) database in europe-west1

Empty Availability Grid¶

Cause: No carts in database

Solution: Follow Step 2 above

Security Rules¶

Production rules in firestore.rules: - Public read access to carts and rentals - Admin-only write access (when auth is implemented) - Member number privacy protection

Collections Structure¶

carts¶

carts/{cartId}
  - id: number
  - name: string
  - status: "available" | "rented" | "maintenance"
  - currentRentalId: string | null

rentals¶

rentals/{rentalId}
  - cartId: number
  - renterName: string
  - startTime: timestamp (ISO string)
  - endTime: timestamp (ISO string)
  - holes: 9 | 18
  - price: number
  - isMember: boolean
  - membershipNumber: string (optional)
  - contactInfo: string
  - notificationMethod: "email" | "sms"
  - createdAt: timestamp

Database must be in europe-west1
Cannot change location after creation
All booking data stays in EU
Member numbers stored but access controlled via security rules