Cruits Housing — Provider Admin Wireframes

housing-admin.cruits.nl / listings

Title	Type	Mode	Price	Min. stay	Units / Total slots	Status
De Hoeve Hostel, Room 12 Kerkstraat 12, 5611 AE Eindhoven	Private room	Concrete	€ 22 / day	3 days	4 units	Active
Workinn Eindhoven North Industrieweg 88, 5627 BS Eindhoven	Bed	Pool	€ 14 / day	1 day	20 total slots	Active
Flexhome Tilburg Center Stationsstraat 4, 5038 EA Tilburg	Private room	Concrete	€ 35 / day	7 days	2 units	Active
Old Annexe Rooms (legacy) Molenstraat 7, 5038 DB Tilburg	Bed	Concrete	€ 10 / day	1 day	0 units	Inactive

Story 1.6 scope CRUD: create, edit, deactivate/activate Concrete mode — specific numbered units (Floor / Room / Bed) Pool mode — total_slots (static inventory set by Provider); available_count in API is calculated: total_slots − active reservations Deactivation hides listing from discovery but does not affect active bookings Payer Agreements (Story 1.9a) — accessible via Payment Terms nav item

housing-admin.cruits.nl / listings / new

Story 1.6 + 1.8 scope Building: dropdown (existing) or inline create with Google Maps autocomplete + drag-pin map Hero image: explicit radio selection; first photo auto-selected; videos never hero Unit mode set at creation — read-only on edit; Building also read-only on edit Price in Euro (€) only — currency indicator on all financial fields Amenities: checkbox group (not free text) Payment terms configuration — see Payment Terms screen (Story 1.9a)

housing-admin.cruits.nl / booking-list

Listing Concrete 4 units

Type	Period	Status	Slot	Note	Created
resident Andrzej Kowalski	Jun 22 – Jul 6, 2026	PENDING_PROVIDER	Floor 1 / Room 101 / Bed B	—	Jun 22, 2026
resident Jan Nowak	Jul 1 – Jul 21, 2026	PENDING_PROVIDER	Floor 2 / Room 204 / Bed A	—	Jul 1, 2026
provider_block	Jun 10 – Jun 14, 2026	PROVIDER_BLOCKED	Floor 1 / Room 101 / Bed A	Renovation work scheduled	Jun 5, 2026
resident	Jun 8 – Jun 22, 2026	RESERVED	Floor 1 / Room 101 / Bed B	—	Jun 8, 2026
provider_block	Jun 15 – Jun 20, 2026	PROVIDER_BLOCKED	Floor 2 / Room 204 / Bed A	—	Jun 7, 2026
resident	May 1 – May 5, 2026	RESERVATION_FAILED	Floor 2 / Room 204 / Bed A	—	May 1, 2026

Story 1.7 scope provider_block = Booking with booking_type = provider_block; occupies capacity immediately; no hold window or worker notifications Unified formula: available_count = total_slots − bookings in non-terminal states (resident + provider_block) Cancel block: always allowed; restores capacity immediately; no conflict check needed Resident bookings shown read-only; cancellation via Story 3.7 only Story 3.3 (W-1a) PENDING_PROVIDER rows (yellow tint): Confirm button opens booking summary modal; Reject button opens reason dialog On Confirm: direct payment → BOOKED; indirect payment → PENDING_PAYER On Reject: booking → RESERVATION_FAILED; unit hold released; Resident notified Auto-confirm setting ON (W-16) bypasses manual action — system confirms automatically

housing-admin.cruits.nl / booking-list / add-block

Add provider block

Fields marked * are required

Listing

Listing *

Mode

Concrete

Determined by the listing — not editable here

Block period

From *

To *

Slot

Block a specific slot

Floor *

Room *

Bed *

Block all slots for this period

Internal note

Note (optional)

Visible to Provider only — not shown to workers

Story 1.7 — Add block Concrete: specific slot (Floor/Room/Bed) OR all slots — creates one booking per blocked slot Pool: N slots blocked — creates N provider_block bookings, each reducing available_count by 1 Warning shown if selected period overlaps with RESERVED bookings; error (block rejected) if overlaps PENDING_PAYER / SIGNING / BOOKED / CHECKED_IN booking_type = provider_block; status = PROVIDER_BLOCKED on creation; no hold_expires_at, no resident_id, no payer_id

housing-admin.cruits.nl / payment-terms

Default Payment Terms

Applied to all direct-payment bookings (worker_direct) where no payer-specific terms apply.

Only payers with a special contract are allowed

When enabled, this provider only accepts bookings from Payers with an active agreement. Direct worker payment is not supported.

Payment schedule

Configurable in IT-4 (Story 1.9)

Billing period

Configurable in IT-4 (Story 1.9)

Invoice generation

Configurable in IT-4 (Story 1.9)

Payer Agreements

Payer	Indirect payment	Payment terms	Actions
Flexkracht Nederland B.V.	Enabled	Configurable in IT-4
Tempo-Team Uitzendbureau	Direct payment only	N/A

Workers with an indirect-payment session from a Payer not listed here will not see this Provider's listings for indirect payment.

Story 1.9a scope Provider adds Payer agreements; sets indirect_payment = Enabled or Direct payment only per Payer Only listed Payers with Enabled status can book this Provider's listings via indirect payment Discovery filter: workers with indirect-payment session see only listings from Providers with an active agreement for their Payer Default Payment Terms section (top): "Only payers with a special contract are allowed" checkbox — active in IT-2. When checked, Provider works exclusively with contracted 3rd-party Payers; direct worker payment not accepted; payment terms fields below become inactive Payment schedule / Billing period / Invoice generation: disabled when contract-only is on; otherwise configurable in Story 1.9, Iteration 4 Payer-specific payment terms (prepay/postpay/custom) — also deferred to Story 1.9, Iteration 4

housing-admin.cruits.nl / payment-terms / add

Payer *

Select the Payer organisation to create an agreement with. Payer accounts are managed by Platform Admin.

Indirect payment *

Enabled

Workers with an indirect-payment session from this Payer can book this Provider's listings under indirect payment.

Direct payment only

Workers from this Payer can still discover and book this Provider's listings, but only via direct payment.

Story 1.9a — Add / Edit Payer Agreement Payer dropdown lists all active Payer accounts created by Platform Admin One agreement per Provider–Payer pair; adding a duplicate Payer is blocked with an error Removing an agreement does not affect active bookings; only affects future discovery and reservations Payment terms fields (prepay/postpay/custom schedule) added in Story 1.9, Iteration 4

housing-admin.cruits.nl / residents

Listing Status

Resident	Listing / Unit	Period	Status	Payment
Andrzej Kowalski	De Hoeve Hostel, Room 12 Floor 1 / Room 101 / Bed B	Jun 22 – Jul 6, 2026	Confirmed	Direct
Maria Gheorghe	Workinn Eindhoven North Pool	Jun 10 – Jun 30, 2026	Checked in	Flexkracht NL
Petro Kovalenko Overstay	Flexhome Tilburg Center Floor 1 / Room 101	May 15 – Jun 14, 2026 Past end date	Overstay	Direct
Jan Nowak	De Hoeve Hostel, Room 12 Floor 2 / Room 204 / Bed A	Jul 1 – Jul 21, 2026	Confirmed	Tempo-Team

Story 5.1 (W-1) Shows BOOKED + CHECKED_IN resident bookings only — provider_block rows stay in Booking List Overstay: CHECKED_IN past period_end — red row tint, Overstay badge, "Flag overstay" action Sorted by check-in date ascending by default; filter by listing and status BOOKED actions: Check in (→ W-17 dialog) + Cancel (→ W-3 dialog) CHECKED_IN actions: Mark checked out (→ W-2 dialog) Bell icon (W-4): SSE events panel — badge shows unread count; persists until dismissed; click 🔔 to open

housing-admin.cruits.nl / settings

Reservations — W-16

Auto-confirm reservations

No — manual confirmation required for each booking

When Yes, all incoming PENDING_PROVIDER bookings are confirmed automatically (actor = system). Provider still sees them in the Booking List.

Cancellations — W-15

Cancellation notice period

days before check-in

Minimum days notice required to cancel a BOOKED booking. Leave blank to allow cancellations at any time before check-in.

Payment & invoicing

Hold window, payment schedule, billing period, and invoice settings — configurable in Story 1.9 (Iteration 4).

Story 3.3 (W-16) + Story 3.9 (W-15) — Provider Settings extension W-16: Auto-confirm toggle — Yes: system confirms PENDING_PROVIDER bookings automatically (actor = system in state log) W-15: Cancellation notice period (days) — blank = no minimum; enforced for Provider and Resident cancellations of BOOKED bookings Both fields extend Provider Settings (Story 1.10) Payment / invoicing settings — deferred to Story 1.9, Iteration 4

housing-admin.cruits.nl / payer / residents

Pending approval 2

Resident	Provider / Listing / Unit	Period	Actions
Andrzej Kowalski	De Hoeve Hostel, Room 12 Floor 1 / Room 101 / Bed B	Jun 22 – Jul 6, 2026
Jan Nowak	Workinn Eindhoven North Pool	Jul 1 – Jul 21, 2026

Status Provider

Resident	Provider / Listing / Unit	Period	Status	Payment
Andrzej Kowalski	De Hoeve Hostel, Room 12 Floor 1 / Room 101 / Bed B	Jun 22 – Jul 6, 2026	PENDING_PAYER	Flexkracht NL pays
Jan Nowak	Workinn Eindhoven North Pool	Jul 1 – Jul 21, 2026	PENDING_PAYER	Flexkracht NL pays
Maria Gheorghe	Workinn Eindhoven North Pool	Jun 10 – Jun 30, 2026	CHECKED_IN	Flexkracht NL pays
Ioan Popa	Flexhome Tilburg Center Floor 2 / Room 204 / Bed A	May 1 – May 5, 2026	CANCELLED	Flexkracht NL pays

Story 6.1 (W-5) Payer Admin — separate role in same housing-admin-fe app; Payer sees only their residents' bookings Pending Approvals section at top: PENDING_PAYER rows with Confirm (→ W-6) and Reject (→ W-7) Full table: all bookings for this Payer (active + historical); sorted by creation date descending Cancel BOOKED booking (→ W-8): same reason + disclaimer flow as Provider W-3 Bell icon (W-9): SSE — new PENDING_PAYER arrivals and booking status changes; click 🔔 to open Settlements + Notifications nav: placeholder — Iteration 6