Key Concepts

Property hierarchy

PropStack uses a three-tier hierarchy for organizing rentable spaces:

Properties

A property is a building or housing complex. Each property has:

• Name and address
• Property type: apartment, house, condo, townhouse, studio, duplex, student housing, commercial, or multi-tenant commercial
• Active status: inactive properties are hidden from public-facing pages
• Amenities and rules: free-text lists displayed to applicants

Units

A unit is an individual rentable space within a property. Unit types include:

Type	Description
Studio	Single-room unit, no separate bedroom
One–Four Bedroom	Standard apartment layouts
Suite	Multi-room unit (common in student housing)
Room	Single room in a larger property
Shared Room	Room with multiple beds, each leased individually
Commercial	Office, retail, or warehouse space

Non-shared units have a single rent_amount and can have one active tenancy at a time.

Beds

Beds exist only within shared room units on student housing properties. Each bed has its own:

• Rent amount and security deposit
• Gender preference (male, female, or mixed)
• Bed size (twin, full, queen, king)
• Occupancy status (vacant, occupied, reserved, maintenance)

This allows per-bed leasing where each tenant in a shared room has their own lease and rental rate.

Availability statuses

PropStack tracks two kinds of availability on the public-facing grid:

Available Now

The space is currently vacant and ready to lease. A green badge is shown with an “Apply” button.

Criteria:

• Beds: occupancy status is vacant and the available date (if set) has passed
• Units: no active tenancy and the available date (if set) has passed

Opening

The space is currently occupied but the tenant is expected to move out before the upcoming lease term. A blue badge shows the expected opening date (e.g. “Opens Jul 18”) with a “Request This Space” button.

Criteria:

• Beds: occupancy status is occupied and external_move_out_date is before the configured term start date
• Units: has an active tenancy with a scheduled_move_out_date or lease end_date before the term start date

Caution

Requesting a space that is “opening” does not reserve it. The listing makes this explicit: “Requesting does not reserve this space.”

Lease lifecycle

1. Pending — lease created but not yet active
2. Active — current, rent is being collected
3. Expired / Month-to-Month — original term ended, tenant continues on month-to-month basis
4. Terminated — lease ended early or completed

Tenancy statuses

A tenancy represents a tenant’s occupancy of a unit:

1. Active — tenant currently lives in the unit
2. Move-out scheduled — tenant has a confirmed move-out date
3. Moved out — tenant has vacated
4. Terminated — tenancy ended by management

Application workflow

1. Applicant finds a space on the availability grid
2. Submits a multi-step application with personal information
3. Pays the application fee (if enabled)
4. Application is reviewed (automatically or manually)
5. Approved: applicant is promoted to tenant role and a lease is created
6. Rejected: applicant is notified with the reason