Add Play Zone inspection type with assessment workflow (#497)

* Add play zone unit type (Chunk 5)

Implements the final unit type from the upgrade plan. Play zone has a
conditional has_slide toggle (like bouncy_castle) that controls whether
the slide_assessment tab is included. Shared assessments: structure,
materials, fan, user_height, slide (conditional).

https://claude.ai/code/session_016Af3G5HbcoYzxLaQC4tDKp

* Fix play_zone tests: override factory has_slide default

The inspection factory defaults has_slide to true, so play_zone tests
that check for no slide tab need to explicitly set has_slide: nil.

https://claude.ai/code/session_016Af3G5HbcoYzxLaQC4tDKp

---------

Co-authored-by: Claude <noreply@anthropic.com>

Author: stefan-burke

NEW_UNIT_TYPES.md

@@ -8,11 +8,11 @@ Spencer's C# desktop app defines inspection checks for inflatable equipment type
 
 | Order | Unit Type | Unique Assessment | Shared Assessments | Conditionals | Status |
 |---|---|---|---|---|---|
-| 1 | `inflatable_ball_pool` | `ball_pool_assessment` (9 fields) | structure, materials, fan | none | |
-| 2 | `inflatable_game` | `inflatable_game_assessment` (9 fields) | structure, materials, fan | none | |
-| 3 | `catch_bed` | `catch_bed_assessment` (15 fields) | structure, materials, fan, anchorage | none | |
-| 4 | `bungee_run` | `bungee_assessment` (19 fields) | structure, materials, fan, anchorage | none | |
-| 5 | `play_zone` | `play_zone_assessment` (14 fields) | structure, materials, fan, user_height, slide | `has_slide` toggle | |
+| 1 | `inflatable_ball_pool` | `ball_pool_assessment` (9 fields) | structure, materials, fan | none | Done |
+| 2 | `inflatable_game` | `inflatable_game_assessment` (9 fields) | structure, materials, fan | none | Done |
+| 3 | `catch_bed` | `catch_bed_assessment` (15 fields) | structure, materials, fan, anchorage | none | Done |
+| 4 | `bungee_run` | `bungee_assessment` (19 fields) | structure, materials, fan, anchorage | none | Done |
+| 5 | `play_zone` | `play_zone_assessment` (14 fields) | structure, materials, fan, user_height, slide | `has_slide` toggle | Done |
 
 ## Per-Chunk Recipe
 

app/controllers/play_zone_assessments_controller.rb

@@ -0,0 +1,5 @@
+# typed: false
+
+class PlayZoneAssessmentsController < ApplicationController
+  include AssessmentController
+end

app/models/assessments/play_zone_assessment.rb

@@ -0,0 +1,15 @@
+# typed: true
+# frozen_string_literal: true
+
+class Assessments::PlayZoneAssessment < ApplicationRecord
+  extend T::Sig
+  include AssessmentLogging
+  include AssessmentCompletion
+  include FormConfigurable
+  include ValidationConfigurable
+
+  self.primary_key = "inspection_id"
+  belongs_to :inspection
+
+  after_update :log_assessment_update, if: :saved_changes?
+end

app/models/inspection.rb

@@ -59,7 +59,8 @@ class Inspection < ApplicationRecord
     catch_bed: "CATCH_BED",
     inflatable_ball_pool: "INFLATABLE_BALL_POOL",
     inflatable_game: "INFLATABLE_GAME",
-    pat_testable: "PAT_TESTABLE"
+    pat_testable: "PAT_TESTABLE",
+    play_zone: "PLAY_ZONE"
   }
 
   CASTLE_ASSESSMENT_TYPES = {
@@ -111,14 +112,24 @@ class Inspection < ApplicationRecord
     bungee_assessment: Assessments::BungeeAssessment
   }.freeze
 
+  PLAY_ZONE_ASSESSMENT_TYPES = {
+    structure_assessment: Assessments::StructureAssessment,
+    materials_assessment: Assessments::MaterialsAssessment,
+    fan_assessment: Assessments::FanAssessment,
+    user_height_assessment: Assessments::UserHeightAssessment,
+    slide_assessment: Assessments::SlideAssessment,
+    play_zone_assessment: Assessments::PlayZoneAssessment
+  }.freeze
+
   ALL_ASSESSMENT_TYPES =
     CASTLE_ASSESSMENT_TYPES
       .merge(PILLOW_ASSESSMENT_TYPES)
       .merge(PAT_TESTABLE_ASSESSMENT_TYPES)
       .merge(INFLATABLE_BALL_POOL_ASSESSMENT_TYPES)
       .merge(INFLATABLE_GAME_ASSESSMENT_TYPES)
       .merge(CATCH_BED_ASSESSMENT_TYPES)
-      .merge(BUNGEE_RUN_ASSESSMENT_TYPES).freeze
+      .merge(BUNGEE_RUN_ASSESSMENT_TYPES)
+      .merge(PLAY_ZONE_ASSESSMENT_TYPES).freeze
 
   USER_EDITABLE_PARAMS = %i[
     has_slide
@@ -153,7 +164,8 @@ class Inspection < ApplicationRecord
     bungee_run: %i[inspection_date] + DIMENSION_FIELDS,
     catch_bed: %i[inspection_date] + DIMENSION_FIELDS,
     inflatable_game: %i[inspection_date] + DIMENSION_FIELDS,
-    pat_testable: %i[inspection_date]
+    pat_testable: %i[inspection_date],
+    play_zone: %i[inspection_date has_slide] + DIMENSION_FIELDS
   }.freeze
 
   belongs_to :user
@@ -281,7 +293,8 @@ def complete?
     catch_bed: CATCH_BED_ASSESSMENT_TYPES,
     inflatable_ball_pool: INFLATABLE_BALL_POOL_ASSESSMENT_TYPES,
     inflatable_game: INFLATABLE_GAME_ASSESSMENT_TYPES,
-    pat_testable: PAT_TESTABLE_ASSESSMENT_TYPES
+    pat_testable: PAT_TESTABLE_ASSESSMENT_TYPES,
+    play_zone: PLAY_ZONE_ASSESSMENT_TYPES
   }.freeze
 
   sig { returns(T::Hash[Symbol, T.class_of(ApplicationRecord)]) }
@@ -296,6 +309,7 @@ def assessment_types
   sig { returns(T::Hash[Symbol, T.class_of(ApplicationRecord)]) }
   def applicable_assessments
     return castle_applicable_assessments if bouncy_castle?
+    return play_zone_applicable_assessments if play_zone?
 
     assessment_types
   end
@@ -318,6 +332,16 @@ def castle_applicable_assessments
     end
   end
 
+  sig { returns(T::Hash[Symbol, T.class_of(ApplicationRecord)]) }
+  def play_zone_applicable_assessments
+    PLAY_ZONE_ASSESSMENT_TYPES.select do |assessment_key, _|
+      case assessment_key
+      when :slide_assessment then has_slide?
+      else true
+      end
+    end
+  end
+
   public
 
   # Iterate over only applicable assessments with a block
@@ -344,7 +368,7 @@ def applicable_tabs
     applicable = applicable_assessments.keys.map { |k| k.to_s.chomp("_assessment") }
 
     # Add tabs in the correct UI order
-    ordered_tabs = %w[user_height slide structure anchorage materials fan enclosed pat ball_pool bungee catch_bed inflatable_game]
+    ordered_tabs = %w[user_height slide structure anchorage materials fan enclosed pat ball_pool bungee catch_bed inflatable_game play_zone]
     ordered_tabs.each do |tab|
       tabs << tab if applicable.include?(tab)
     end

app/models/unit.rb

@@ -46,7 +46,8 @@ class Unit < ApplicationRecord
     catch_bed: "CATCH_BED",
     inflatable_ball_pool: "INFLATABLE_BALL_POOL",
     inflatable_game: "INFLATABLE_GAME",
-    pat_testable: "PAT_TESTABLE"
+    pat_testable: "PAT_TESTABLE",
+    play_zone: "PLAY_ZONE"
   }
 
   belongs_to :user

config/forms/play_zone_assessment.yml

@@ -0,0 +1,48 @@
+---
+form_fields:
+  - legend_i18n_key: markings
+    fields:
+      - partial: :pass_fail_comment
+        field: :age_marking
+      - partial: :pass_fail_comment
+        field: :height_marking
+  - legend_i18n_key: safety_checks
+    fields:
+      - partial: :pass_fail_comment
+        field: :sight_line
+      - partial: :pass_fail_comment
+        field: :access
+      - partial: :pass_fail_comment
+        field: :suitable_matting
+      - partial: :pass_fail_comment
+        field: :traffic_flow
+      - partial: :pass_fail_comment
+        field: :air_juggler
+      - partial: :pass_fail_comment
+        field: :balls
+      - partial: :pass_fail_comment
+        field: :ball_pool_gaps
+      - partial: :pass_fail_comment
+        field: :fitted_sheet
+  - legend_i18n_key: measurements
+    fields:
+      - partial: :number_pass_fail_comment
+        field: :ball_pool_depth
+        attributes:
+          step: 1
+          min: 0
+      - partial: :number_pass_fail_comment
+        field: :ball_pool_entry_height
+        attributes:
+          step: 1
+          min: 0
+      - partial: :number_pass_fail_comment
+        field: :slide_gradient
+        attributes:
+          step: 1
+          min: 0
+      - partial: :number_pass_fail_comment
+        field: :slide_platform_height
+        attributes:
+          step: 0.01
+          min: 0

config/locales/forms/play_zone.en.yml

@@ -0,0 +1,33 @@
+---
+en:
+  forms:
+    play_zone:
+      header: Play Zone
+      sections:
+        markings: Markings
+        safety_checks: Safety Checks
+        measurements: Measurements
+      fields:
+        age_marking: Marking to indicate age range
+        height_marking: Marking to indicate max user height
+        sight_line: Sight lines clear to observe playing areas
+        access: Access, egress and connections safe
+        suitable_matting: Suitable matting
+        traffic_flow: Traffic flow design safe
+        air_juggler: Air jugglers compliant
+        balls: Balls compliant
+        ball_pool_gaps: No gaps in ball pool
+        fitted_sheet: Fitted base sheet
+        ball_pool_depth: Ball pool depth (mm) max 450mm
+        ball_pool_entry_height: Ball pool entry height (mm) max 630mm
+        slide_gradient: Platform incline gradient (deg) max 64 deg
+        slide_platform_height: Slide platform height (m) max 1.5m
+      status:
+        checks_passed: Fields completed
+        completion: Assessment Completion
+      submit: Save Assessment
+      submit_continue: Save & Continue
+      errors:
+        header:
+          one: '1 error prevented this assessment from being saved:'
+          other: '%{count} errors prevented this assessment from being saved:'

config/locales/inspections.en.yml

@@ -271,6 +271,7 @@ en:
       inflatable_game_incomplete: Inflatable Game Assessment incomplete
       materials_incomplete: Materials Assessment incomplete
       pat_incomplete: PAT Assessment incomplete
+      play_zone_incomplete: Play Zone Assessment incomplete
       slide_incomplete: Slide Assessment incomplete
       structure_incomplete: Structure Assessment incomplete
       user_height_incomplete: User Height Assessment incomplete

config/locales/units.en.yml

@@ -71,6 +71,7 @@ en:
       inflatable_ball_pool: Inflatable Ball Pool
       inflatable_game: Inflatable Game
       pat_testable: PAT Testable Appliance
+      play_zone: Play Zone
     labels:
       inspection_date: Inspection Date
       dimensions: Dimensions

db/migrate/20260325000003_create_play_zone_assessments.rb

@@ -0,0 +1,57 @@
+# typed: false
+# frozen_string_literal: true
+
+class CreatePlayZoneAssessments < ActiveRecord::Migration[8.0]
+  def change
+    create_table :play_zone_assessments, id: false do |t|
+      t.string :inspection_id, limit: 12, null: false
+      add_pass_fail_fields(t)
+      add_measurement_fields(t)
+      t.timestamps
+    end
+
+    add_index :play_zone_assessments, :inspection_id,
+      unique: true, name: "play_zone_assessments_pkey"
+    add_foreign_key :play_zone_assessments, :inspections
+  end
+
+  private
+
+  def add_pass_fail_fields(t)
+    t.boolean :age_marking_pass
+    t.text :age_marking_comment
+    t.boolean :height_marking_pass
+    t.text :height_marking_comment
+    t.boolean :sight_line_pass
+    t.text :sight_line_comment
+    t.boolean :access_pass
+    t.text :access_comment
+    t.boolean :suitable_matting_pass
+    t.text :suitable_matting_comment
+    t.boolean :traffic_flow_pass
+    t.text :traffic_flow_comment
+    t.boolean :air_juggler_pass
+    t.text :air_juggler_comment
+    t.boolean :balls_pass
+    t.text :balls_comment
+    t.boolean :ball_pool_gaps_pass
+    t.text :ball_pool_gaps_comment
+    t.boolean :fitted_sheet_pass
+    t.text :fitted_sheet_comment
+  end
+
+  def add_measurement_fields(t)
+    t.integer :ball_pool_depth
+    t.boolean :ball_pool_depth_pass
+    t.text :ball_pool_depth_comment
+    t.integer :ball_pool_entry_height
+    t.boolean :ball_pool_entry_height_pass
+    t.text :ball_pool_entry_height_comment
+    t.integer :slide_gradient
+    t.boolean :slide_gradient_pass
+    t.text :slide_gradient_comment
+    t.decimal :slide_platform_height, precision: 8, scale: 2
+    t.boolean :slide_platform_height_pass
+    t.text :slide_platform_height_comment
+  end
+end