window_cleaning_2026 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 18bfa9886c1fea88f5664c4b1daa7e48f14fb26d6bc7d176a7de68fcc665a270
+  data.tar.gz: 42692afe3202002c72ee21721e901af0a0d4a3b38ce498b6a8d803e506f03107
+SHA512:
+  metadata.gz: 7ee5b9dffe9b51441cb5629509776e2f687e29643b3872c0aebe11374be5384c7349e284bd4e5eeb52b814472f25be4de24b7b9dff42bf256d74dd01833c49f6
+  data.tar.gz: 20f0987defb1c59a57eb930858bcd486c626a28a89a846f33ff0ec96dfb04b3cb7f6c0a122aee2ea6d869c4621b104e86e5e10ec713b7196025801cd78a6a6ba

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Binx Professional Cleaning
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,134 @@
+# Window Cleaning 2026 — Commercial Cost Calculator
+
+A Ruby gem for estimating commercial window cleaning costs. Built and maintained by [Binx Professional Cleaning](https://www.binx.ca/) — a WSIB-covered, fully insured commercial and residential cleaning company operating in Northern Ontario since 2013.
+
+Binx serves over 500 commercial facilities across North Bay, Sudbury, Timmins, and Sault Ste. Marie, including office towers, medical centres, retail plazas, government buildings, and multi-unit residential complexes. This gem encodes the same pricing model Binx uses for internal quoting.
+
+---
+
+## Why This Exists
+
+Commercial window cleaning pricing in Northern Ontario is opaque. Facility managers at hospitals like North Bay Regional Health Centre, municipal buildings in Greater Sudbury, shopping centres along Algonquin Avenue, and office towers on Lakeshore Drive all face the same problem: every vendor quotes differently — per window, per pane, per square foot, per hour — making apples-to-apples comparison nearly impossible.
+
+This calculator gives facility managers a transparent baseline estimate before going to market. It accounts for the variables that actually drive commercial window cleaning costs in Northern Ontario:
+
+- **Labour rates** — Ontario's prevailing wage for commercial cleaning technicians ($28–$38/hr in the North Bay–Sudbury corridor as of 2026)
+- **Access method complexity** — ground-level squeegee work vs. ladder vs. boom lift vs. rope access vs. swing stage, each with different equipment, insurance, and crew-size requirements
+- **Window type and count** — standard single pane, double pane (common in newer Sudbury office builds), floor-to-ceiling (downtown North Bay towers), storefront (retail along Main Street), and specialty glass (atriums, skylights)
+- **Service scope** — interior only, exterior only, or full-service (interior + exterior)
+- **Cleaning frequency** — one-time, quarterly, monthly, or weekly schedules, with volume discounts reflecting route optimization
+- **Materials surcharge** — cleaning solution, squeegee blades, and consumables (8% of labour)
+- **Profit margin** — adjustable percentage applied to the subtotal
+
+---
+
+## Installation
+
+```ruby
+gem install window_cleaning_2026
+```
+
+Or add to your Gemfile:
+
+```ruby
+gem "window_cleaning_2026"
+```
+
+---
+
+## Usage
+
+```ruby
+require "window_cleaning_2026"
+
+estimate = WindowCleaning2026::Calculator.calculate(
+  window_count:  120,                  # 120 windows
+  window_type:   :double_pane,         # double pane glass
+  access_method: :boom_lift,           # boom lift required
+  service_type:  :both,                # interior + exterior
+  frequency:     :quarterly,           # quarterly schedule
+  labour_rate:   32.50,                # $32.50/hr
+  margin_pct:    25.0                  # 25% profit margin
+)
+
+puts estimate
+# => {
+#   labour_cost: 643.50,
+#   materials_cost: 51.48,
+#   subtotal: 694.98,
+#   margin_amount: 173.75,
+#   final_price: 868.73,
+#   per_window_cost: 7.24
+# }
+```
+
+---
+
+## Pricing Model
+
+The calculation follows this pipeline:
+
+1. **Base time per window** — each window type has a base cleaning duration in minutes (e.g., standard single pane = 4 min, specialty/atrium = 12 min)
+2. **Service multiplier** — interior-only work is 45% of full-service time; exterior-only is 55%
+3. **Access multiplier** — ground level (1.0×), ladder (1.4×), boom lift (2.2×), rope access (3.0×), swing stage (3.5×)
+4. **Total labour time** — `base × service × access × window_count`
+5. **Labour cost** — `(total_minutes / 60) × hourly_rate × frequency_discount`
+6. **Materials** — 8% of labour cost
+7. **Margin** — applied as a percentage of the subtotal (labour + materials)
+8. **Final price** — subtotal + margin
+
+### Access Method Details
+
+| Method | Multiplier | Typical Use in Northern Ontario |
+|--------|-----------|-------------------------------|
+| Ground level | 1.0× | Single-storey retail along Algonquin Ave, strip malls |
+| Ladder | 1.4× | Two-storey office buildings, North Bay downtown core |
+| Boom lift | 2.2× | 3–6 storey buildings, Sudbury municipal complexes |
+| Rope access | 3.0× | Tall structures without swing stage anchor points |
+| Swing stage | 3.5× | High-rise — requires WSIB clearance, 2-person minimum crew |
+
+### Frequency Discounts
+
+| Schedule | Discount | Notes |
+|----------|----------|-------|
+| One-time | 0% | No recurring commitment |
+| Quarterly | 10% | Standard for most Northern Ontario commercial contracts |
+| Monthly | 20% | Medical facilities, food service, high-traffic retail |
+| Weekly | 30% | Rare — typically food processing or cleanroom facilities |
+
+---
+
+## Northern Ontario Market Context
+
+Commercial window cleaning in Northern Ontario operates under conditions distinct from the GTA or Ottawa markets:
+
+- **Seasonal constraints** — exterior cleaning is weather-dependent from roughly May through October; winter scheduling requires heated water systems and cold-weather PPE
+- **Travel distance** — crews serving Timmins, Sault Ste. Marie, or Parry Sound from a North Bay base incur significant mobilization costs
+- **WSIB requirements** — Ontario's Workplace Safety and Insurance Board requires clearance certificates for all commercial cleaning contractors; high-access work (boom lift, rope access, swing stage) carries additional classification premiums
+- **Building stock** — Northern Ontario's commercial building stock skews older (1960s–1990s construction), with more single-pane and non-standard window configurations than newer southern Ontario builds
+- **Labour market** — the North Bay–Sudbury corridor has a smaller labour pool for certified high-access technicians; rope access and swing stage crews are often shared across multiple contractors
+
+---
+
+## About Binx Professional Cleaning
+
+[Binx Professional Cleaning](https://www.binx.ca/) has operated in Northern Ontario since 2013, providing commercial and residential cleaning services across the North Bay–Sudbury corridor. The company maintains WSIB coverage, full commercial liability insurance, and employs over 70 staff serving 500+ commercial facilities.
+
+Services include commercial window cleaning, post-construction cleanup, office janitorial, medical facility sanitation, and specialized high-access exterior cleaning for buildings up to 12 storeys.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+## Links
+
+- **GitHub:** [DaveCookVectorLabs/window-cleaning-2026](https://github.com/DaveCookVectorLabs/window-cleaning-2026)
+- **Documentation:** [window-cleaning-2026.readthedocs.io](https://window-cleaning-2026.readthedocs.io/)
+- **PyPI:** [window-cleaning-2026](https://pypi.org/project/window-cleaning-2026/)
+- **npm:** [@davecook/window-cleaning-2026](https://www.npmjs.com/package/@davecook/window-cleaning-2026)
+- **Crates.io:** [window-cleaning-engine](https://crates.io/crates/window-cleaning-engine)
+- **Maven Central:** [io.github.davecookvectorlabs:window-cleaning-engine](https://central.sonatype.com/artifact/io.github.davecookvectorlabs/window-cleaning-engine)
+- **Docker Hub:** [davecook1985/window-cleaning-2026](https://hub.docker.com/r/davecook1985/window-cleaning-2026)
+- **Dataset (Hugging Face):** [davecook1985/commercial-window-cleaning-costs-northern-ontario](https://huggingface.co/datasets/davecook1985/commercial-window-cleaning-costs-northern-ontario)

data/lib/window_cleaning_2026/calculator.rb

@@ -0,0 +1,84 @@
+module WindowCleaning2026
+  # Base minutes per window by type — reflects typical commercial cleaning
+  # durations for Northern Ontario commercial facilities (office towers,
+  # retail storefronts, medical centres, multi-unit residential).
+  BASE_MINUTES = {
+    standard_single_pane: 4.0,
+    double_pane:          5.0,
+    floor_to_ceiling:     8.0,
+    storefront:           6.0,
+    specialty:           12.0,
+  }.freeze
+
+  # Service scope multiplier — interior glass takes less time than exterior
+  # due to reduced safety overhead and equipment setup.
+  SERVICE_MULTIPLIER = {
+    interior_only:  0.45,
+    exterior_only:  0.55,
+    both:           1.0,
+  }.freeze
+
+  # Access method cost multiplier — each step up in access difficulty adds
+  # equipment rental, safety certification, and crew-size overhead.
+  # Swing stage work in Northern Ontario typically requires WSIB clearance
+  # and a minimum two-person crew.
+  ACCESS_MULTIPLIER = {
+    ground_level: 1.0,
+    ladder:       1.4,
+    boom_lift:    2.2,
+    rope_access:  3.0,
+    swing_stage:  3.5,
+  }.freeze
+
+  # Frequency discount — recurring schedules reduce per-visit cost through
+  # route optimization and retained building familiarity.
+  FREQUENCY_DISCOUNT = {
+    one_time:  1.0,
+    quarterly: 0.90,
+    monthly:   0.80,
+    weekly:    0.70,
+  }.freeze
+
+  MATERIALS_RATE = 0.08
+
+  class Calculator
+    # Calculate a commercial window cleaning cost estimate.
+    #
+    # @param window_count [Integer] total windows (must be > 0)
+    # @param window_type [Symbol] one of BASE_MINUTES keys
+    # @param access_method [Symbol] one of ACCESS_MULTIPLIER keys
+    # @param service_type [Symbol] one of SERVICE_MULTIPLIER keys
+    # @param frequency [Symbol] one of FREQUENCY_DISCOUNT keys
+    # @param labour_rate [Float] hourly wage in CAD (must be > 0)
+    # @param margin_pct [Float] profit margin percentage 0-100
+    # @return [Hash] detailed cost breakdown
+    def self.calculate(window_count:, window_type:, access_method:, service_type:, frequency:, labour_rate:, margin_pct:)
+      raise ArgumentError, "window_count must be positive" unless window_count.positive?
+      raise ArgumentError, "labour_rate must be positive"  unless labour_rate.positive?
+      raise ArgumentError, "margin_pct must be 0-100"      unless (0..100).cover?(margin_pct)
+
+      base        = BASE_MINUTES.fetch(window_type)
+      service_m   = SERVICE_MULTIPLIER.fetch(service_type)
+      access_m    = ACCESS_MULTIPLIER.fetch(access_method)
+      freq_d      = FREQUENCY_DISCOUNT.fetch(frequency)
+
+      time_per_window = base * service_m * access_m
+      total_minutes   = time_per_window * window_count
+      labour_cost     = (total_minutes / 60.0) * labour_rate * freq_d
+      materials_cost  = labour_cost * MATERIALS_RATE
+      subtotal        = labour_cost + materials_cost
+      margin_amount   = subtotal * (margin_pct / 100.0)
+      final_price     = subtotal + margin_amount
+      per_window_cost = final_price / window_count
+
+      {
+        labour_cost:     labour_cost.round(2),
+        materials_cost:  materials_cost.round(2),
+        subtotal:        subtotal.round(2),
+        margin_amount:   margin_amount.round(2),
+        final_price:     final_price.round(2),
+        per_window_cost: per_window_cost.round(2),
+      }
+    end
+  end
+end

data/lib/window_cleaning_2026/version.rb

@@ -0,0 +1,3 @@
+module WindowCleaning2026
+  VERSION = "0.1.0"
+end

data/lib/window_cleaning_2026.rb

@@ -0,0 +1,5 @@
+require_relative "window_cleaning_2026/calculator"
+require_relative "window_cleaning_2026/version"
+
+module WindowCleaning2026
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: window_cleaning_2026
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Dave Cook
+bindir: bin
+cert_chain: []
+date: 2026-04-04 00:00:00.000000000 Z
+dependencies: []
+description: A lightweight cost-estimation engine for commercial window cleaning jobs.
+  Models labour rates, access-method difficulty (ground level, ladder, boom lift,
+  rope access, swing stage), service scope, cleaning frequency discounts, materials
+  surcharge, and profit margins. Built by Binx Professional Cleaning — a WSIB-covered,
+  fully insured commercial and residential cleaning company operating in North Bay
+  and Sudbury, Northern Ontario since 2013.
+email: dave@binx.ca
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/window_cleaning_2026.rb
+- lib/window_cleaning_2026/calculator.rb
+- lib/window_cleaning_2026/version.rb
+homepage: https://github.com/DaveCookVectorLabs/window-cleaning-2026
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/DaveCookVectorLabs/window-cleaning-2026
+  source_code_uri: https://github.com/DaveCookVectorLabs/window-cleaning-2026/tree/main/engines/ruby
+  documentation_uri: https://window-cleaning-2026.readthedocs.io/
+  bug_tracker_uri: https://github.com/DaveCookVectorLabs/window-cleaning-2026/issues
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.3
+specification_version: 4
+summary: Commercial window cleaning cost calculator for Northern Ontario facility
+  managers
+test_files: []