Set Up Occupancy

The Occupancy module (resource_booking) shows your club at a glance when which resource is free or occupied. Courts, halls, equipment, pools or any other facility are mapped through freely definable resource types — members and groups sign themselves up for free slots, optionally with approval by authorized people.

Automatic Firebase Setup

The Firebase setup (security rules, indexes) happens automatically when you publish your app. You don’t have to worry about Firebase when activating this module.

Overview

Manage resources

Courts, halls, equipment, pools — through freely definable types.

See utilization

Weekly calendar with occupancy blocks in a 30-minute grid.

Self sign-up

Members and groups book themselves into free slots.

Approval workflow

Requests are confirmed or rejected by authorized people.

Group permissions

Book and approve by membership, team and role.

Sports integration

Coaches pick the resource directly in the training with a live check.

---

What the module does

Feature	Description
Resource types	Admin-defined types (name, icon, optional unit) — multilingual, e.g. “Hall”, “Tennis court”, “Swim lane”
Resources	Concrete bookable units per type (e.g. “Hall 1”) with their own booking window and permissions
Utilization calendar	One resource in focus, weekdays as columns, 30-minute grid; non-bookable times greyed out
Self sign-up	Authorized members/groups tap a free cell and submit a booking
Approval workflow	Optional per resource: requests land in the approval inbox of authorized people
Blocked periods	Maintenance/holidays block resources hard
Fixed occupancies	Recurring occupancies (e.g. a fixed team training) as recurrence rules

Maximally generic

Through admin-defined resource types you can label “anything imaginable” correctly — from the multi-purpose hall and the rowing ergometer to the swim lane.

---

Difference from the Rooms module

Occupancy and Rooms sound similar but solve different tasks:

Aspect	Occupancy (resource_booking)	Rooms (rooms)
Purpose	Internal club utilization	Commercial rental
Prices	None	Base, season and extra prices
Booking	Self sign-up + approval	Guest booking with payment
Permissions	Group-based (membership/team/role)	Public catalog
Extras	—	Channel manager, iCal, reviews, loyalty program

Which module?

If it’s about internal utilization without money (Who trains when in Hall 1?) → Occupancy. If it’s about rental with prices (holiday flat, coworking, hotel room) → Rooms.

---

Activation

1. Open Edit Mode in your app

2. Go to Modules & Features

3. Tap Occupancy and then Activate

4. The module is ready to use immediately

One-tap activation

The core of the Occupancy module runs locally in ISAR and needs no Firebase setup to activate. The module settings have sensible defaults, so a single tap is enough — the setup assistant shows no mandatory steps. The Firebase collections (for resources and bookings) are set up automatically when you publish.

Dependencies

Module	Type	Description
Firebase	Required (at publish)	Stores resources and bookings
Membership	Optional	Booking/approval permissions by membership type
Sports	Optional	Team-based permissions + coach picks resource in training
Notifications	Optional	Push for new requests, decisions and reminders

Group permissions

Booking and approval permissions are tied to existing sources: membership types, sports teams and admin roles. If you enable permissions for one of these sources, the respective module is added as a dependency when you publish.

---

Access rights

Role	Rights
All users	View the utilization calendar and resource overview
Authorized groups	Sign up for free slots (by membership/team)
Approvers	Confirm or reject requests
Admins	Manage all resources, bookings, blocked periods and recurrence rules

Login for write actions

Viewing is possible without login. Submitting a booking is a write action and requires sign-in — the login is requested on demand, not forced at app start.

---

Conflict logic

First-come, no overlap

A booking with status requested OR confirmed blocks the period hard — as does a blocked period or a fixed (recurring) occupancy. An overlapping new request is rejected. If a booking is cancelled or rejected, it frees the period again immediately.

---

Sports integration

If the Sports module is also active, a coach picks a resource directly when creating a training:

1. Pick resource — Type → concrete resource in the training editor

2. Live availability check — After date and time, the editor instantly shows “free” or “occupied by X”

3. Save — A fixed occupancy is created; if approval is required, first as a request

4. Display — Members see the resolved resource name instead of a free-text location

Without the Occupancy module

If the Occupancy module is not active, Sports behaves unchanged: the training location stays a free-text field. There is no constraint and no crash.

---

Next steps

Features & Settings Display name, approval default, booking window, coloring, push

Occupancy Editor All settings and admin areas in detail

---

Tips

Start with one type

First create one resource type (e.g. “Hall”) and one resource. Then expand step by step with more types and units.

Set booking windows cleanly

Define the bookable days and times per resource. That way the calendar only shows sensible slots and greys out off-hours automatically.

Use approval selectively

Enable the approval requirement only for resources that really need to be coordinated. Freely accessible equipment works without a workflow.