# Data dictionary — The Dock Leveler Repair-or-Replace Ledger, v1.1.0

Compiled by Uptime Dock & Door Research. Source verification date: September 19, 2026.  
Page: https://uptimedockanddoor.com/research/dock-leveler-repair-vs-replace/

## What this dataset is

A source-linked classification of 64 dock-leveler findings, each mapped to a decision class, open paths, responsible role, plain-English evidence basis and exact source locator. Companion tables cover published pit dimensions, matched quote scope, service-life and threshold claims, calculator cases and source provenance.

## What it is not

It is not a repair manual, inspection standard, diagnosis, price list, legal opinion, engineering approval or authorization to operate equipment. It provides no hazardous repair procedure.

## Missing-value rule

An empty CSV cell or JSON `null` means **unknown or not applicable**. It never means zero, safe, passed, satisfactory, included or that a source published nothing.

## Evidence labels

- **★ Source-reported** — checked in the cited issuer's own material on the verification date.
- **● Calculated** — computed by Uptime Dock & Door Research from stated verified inputs, with the formula shown.
- **● Uptime synthesis** — a bounded conclusion assembled from the named source set, with the review boundary stated.

None of these labels means independent product testing. A manufacturer statement remains manufacturer-stated.

## Source joins

`source_id` fields join to `dock-leveler-repair-or-replace-sources.csv`. When one record uses more than one source, IDs are separated by the pipe character: `S01|S09`. Pipe-delimited IDs are a relationship field, not free text.

---

## dock-leveler-repair-or-replace-ledger.csv — 64 rows

| Field | Type | Meaning |
|---|---|---|
| `finding_id` | string | Stable ID F01–F64 |
| `subsystem` | string | Equipment, installation or record area involved |
| `finding_as_the_reader_would_describe_it` | string | Facility-language description; not a verbatim manual quote |
| `decision_class` | string | Uptime editorial classification |
| `paths_open` | string | Paths that remain supportable or unresolved after the finding |
| `who_may_perform_the_work` | string | Role indicated by the cited rule or instruction; not a licensing claim |
| `governing_basis_plain_english` | string | Source-grounded paraphrase plus bounded editorial classification where stated |
| `basis_type` | string | Federal rule, manufacturer instruction/product statement, standards listing, industry position, editorial classification, or combination |
| `source_id` | pipe-delimited string | One or more source-register IDs |
| `source_locator` | string | Page, section, clause or page element |
| `verified_date` | ISO date | Date the source was checked |

**Counts by decision class:** Authorized repair 14; Safety / structural — pause use 11; Compliance / safety trigger 9; Pit / civil 9; Application / capacity mismatch 5; Wear part 4; Obsolescence / support 3; Fit for purpose 2; Evidence gap 2; Wear / housekeeping 1; Operating change 1; Context / planning trigger 1; Commercial term 1; Context, not a trigger 1.

The classification is Uptime's editorial work. The rule or manufacturer statement remains attributable to its issuer.

---

## dock-leveler-pit-fit-crosswalk.csv — 17 rows

| Field | Type | Meaning |
|---|---|---|
| `manufacturer` | string | Source manufacturer |
| `family` | string | Named standard product family |
| `activation` | string | Published activation description |
| `nominal_size` | string | Nominal equipment size, not a field-measured pit |
| `published_pit_width_in` | number | Published standard pit width in inches |
| `published_pit_length_in` | number | Published standard pit length in inches |
| `published_pit_depth_front_in` | number | Published front depth in inches |
| `published_pit_depth_rear_in` | number | Published rear depth in inches |
| `source_id` | pipe-delimited string | Source IDs |
| `source_locator` | string | Chart/manual locator |
| `verified_date` | ISO date | Verification date |

**Limits:** two named standard U.S. product families. This is not a market survey, field approval drawing or custom-fit specification.

---

## dock-leveler-quote-scope-comparison.csv — 20 rows

| Field | Type | Meaning |
|---|---|---|
| `line_id` | string | Q01–Q20 |
| `scope_line` | string | Project-scope topic |
| `what_a_repair_quote_should_state` | string | Information needed from the repair path |
| `what_a_modernization_quote_should_state` | string | Information needed from the modernization path |
| `what_a_replacement_quote_should_state` | string | Information needed from the replacement path |
| `source_id` | string | Source/method ID |
| `verified_date` | ISO date | Verification date |

These are comparison questions, not a universal legal checklist and not a claim that every item is separately billable.

---

## dock-leveler-life-claim-audit.csv — 8 rows

| Field | Type | Meaning |
|---|---|---|
| `claim_id` | string | C01–C08 |
| `claim_as_circulated` | string | Claim in the form commonly published |
| `where_it_comes_from` | string | Publisher or source category traced |
| `what_supports_it` | string | Evidence or method disclosed by that publisher |
| `our_publication_decision` | string | How Uptime treats the claim |
| `source_id` | pipe-delimited string | Source IDs |
| `verified_date` | ISO date | Verification date |

A row can document an excluded claim without making it a public finding.

---

## dock-leveler-crossover-worked-examples.csv — 8 rows

| Field group | Type | Meaning |
|---|---|---|
| Quote, downtime, maintenance, follow-on and salvage fields | number or null | User-entered illustrative inputs |
| `comparison_horizon_years` | number or null | Positive horizon required for annual break-even output |
| `safety_or_structural_gate_unresolved` | boolean | Blocks an economic decision when true |
| Cost and premium fields | number or null | Calculated outputs |
| `expected_status` | string | `complete`, `incomplete`, `invalid` or `blocked` |
| `reading` | string | Expected plain-language result |

**Formulas**

```text
repair_path_cost = repair_quote
  + (repair_downtime_hours × downtime_cost_per_hour)
  + expected_follow_on_repairs
  + repair_path_maintenance

replacement_path_cost = replacement_quote
  + (replacement_downtime_hours × downtime_cost_per_hour)
  + replacement_path_maintenance
  − documented_salvage

replacement_premium = replacement_path_cost − repair_path_cost

annual_avoidable_cost_to_break_even =
  max(0, replacement_premium) ÷ comparison_horizon_years
```

Every dollar amount is illustrative. No row is a market price or quote. The prior `break_even_added_years` formula and expected-service-life input were removed because they relied on an unsupported service-life assumption.

---

## dock-leveler-repair-or-replace-sources.csv — 21 rows

Fields: `source_id`, `publisher`, `document`, `edition_or_date`, `url`, `retrieval_basis`, `what_it_supports`, `verified_date`.

The register distinguishes official regulation, official manufacturer material, public standards listing, industry-group position, Uptime method and contractor pages used only to trace circulating claims.

---

## dock-leveler-repair-or-replace-data.json

Contains dataset metadata, missing-value and source-ID rules, evidence labels, formulas, coverage counts, headline findings and arrays matching all six public CSV files. Numeric CSV fields are JSON numbers. Empty CSV cells are JSON `null`.

## Reuse

The files contain factual observations plus Uptime Dock & Door Research's compilation, classification and calculations. No source text, protected table, diagram or artwork is reproduced. No license is asserted for third-party material, and no separate license is assigned to this compilation in version 1.1.0. Source links allow users to check the originals.