Stall Board and Properties — Barnflow

For: Staff (owner / admin / manager / staff / trainer). Horse owners do not use the stall map; they see horses in the owner portal (/portal or /owner).

Route: /app/stalls (list) and /app/stalls?view=map (Property Map).

> Terminology: always horse owner / owner. Never “guest”.

How to open the board

1. Sign in as staff and open Stalls in the nav (/app/stalls).
2. If you manage more than one barn, pick the property (location) first — Map is one barn at a time.
3. Use List View to filter occupancy, search a stall or horse, then Assign / move / clear.
4. Switch to Map (?view=map) for aisle-side work: drag horses, morning strip, stickers, print.
5. Need a new barn? Properties → Add property, then Add stall. The map stays empty until units exist.

Example

Willow Barn has 24 stalls and a turnout paddock. Monday morning, the barn manager opens Stalls → Map, confirms the property is Willow (not the annex), and drags two unassigned horses onto empty stalls. List view is for a quick “who is empty?” filter; Map is for placing horses the way the aisle actually looks.

What List and Map share

Both views read the same occupancy: horses.unit_id on units under a property. Capacity rules are the same:

• Inactive units cannot take a horse.
• A unit at capacity rejects the drop (single stalls typically capacity = 1).
• Pastures, paddocks, and run-ins can hold more than one horse.

Assigning, moving, and clearing from either view writes the same horse–unit link and is logged in audit_events.

List board

• Filter by property, occupancy status, and search (unit name or horse).
• See which stalls, paddocks, and pastures are free or full.
• Assign, move, or clear horses from a unit.
• Add stall creates a units row; Properties manages locations.

Properties (multi-location)

Barnflow is multi-location: many properties under one organization.

1. Open Stalls → Properties (/app/stalls/properties).
2. Add a property with a clear name (the physical barn / farm).
3. Create units under that property (stalls, paddocks, pastures) with capacity.
4. Use the global Location switcher so Today, stalls, and other lists match the barn you are standing in.

Owners and admins can use All properties in some lists. Property Map always requires a single property — if none is selected, the map asks you to pick one.

Units

• New unit from the stall board (/app/stalls/new) or property context.
• Edit type, name, capacity, notes (/app/stalls/[unitId]/edit).
• Optional saved map coordinates units.map_x / units.map_y (cell grid, not GPS). Until those are set, the map auto-packs tiles by name so you still see every unit.

Property Map (overview of functions)

Toolbar on /app/stalls?view=map:

Control	What it does	Help
Property picker	One barn at a time	this article
Search	Find horse or unit; dim the rest	Daily map work
Edit Layout	Arrange stall tiles	Arrange stalls
Sketch / Templates / Copy layout	Background + bulk positions	Layout tools
Print board	Print the canvas	Print
Intake	Place unassigned horses into empty stalls	Daily map work
Stickers / Heat	Care and occupancy cues	Morning strip & heat
List View	Back to the occupancy table	this article
Zoom + / −	Scale tiles (0.6–1.6)	Arrange stalls
Draw aisle / zone	Overlay lines and polygons	Aisles & zones
Morning strip	Empty / unassigned / care / health	Morning strip & heat

Roles and access

• Any org staff member can view the stall board and place horses (RLS: organization_members).
• Aisles and zones: owner / admin / manager only (canEditMapOverlays). Staff and trainer roles see overlays but cannot draw or delete them.
• Horse owners never see this staff map.

Data model (AI)

• Tenant: organizations. Locations: properties. Stalls: units (property_id, capacity, map_x, map_y, type).
• Occupancy: horses.unit_id. Unassigned horses have unit_id null.
• Overlays: property_map_overlays (kind aisle \| zone, geometry in map-cell space, not lat/lng).
• Mutations: server actions on /app/stalls; audit_events with last-write-wins client_mutation_id when offline.
• Realtime (optional): map refreshes on horses changes scoped by organization_id.

Scope every answer by organization + property. Never mix tenants.

Related

• Daily map work: operate and intake
• Arrange stalls on the map
• Draw aisles and zones
• Templates, sketch, and copy layout
• Morning strip, stickers, and heat
• Print the stall board
• Map questions, answered

AI retrieval keywords: stalls, stall board, property map, list view, occupancy, properties, units, map_x, map_y, capacity, unassigned, Barnflow, /app/stalls