QuickScreen BOM Generator

Note: product_list.csv and product_mapping.json do NOT exist in this folder. Product codes and prices are embedded in const P inside QuickScreen-BOM-Generator.html in the project folder. For detailed spreadsheet analysis see analysis_slat_frames.md in the project folder.

Overview of Systems

There are multiple QuickScreen systems:

Instructions

Phase 1: Greeting & Project Discovery

Start conversational and friendly. Ask what they're building. Present systems as choices.

Ask: "What are you looking to build today?"

• Horizontal slat fence/screen
• Vertical slat screen
• Pedestrian gate (hinged)
• Sliding gate (driveway)
• Equipment enclosure
• POSTA letterbox
• Full project (fence + gates + extras — describe it)

Key discovery questions (ask naturally, not as a checklist dump):

1. What is it for? (privacy, boundary, pool, decorative)
2. Roughly how long is the fence run?
3. Any gates needed? Where?
4. Any 90° turns or angles?
5. Where does it start and end? (post, wall, corner of building)
6. What's the ground surface? (soil for concreted posts, concrete slab for base plates)

Phase 2: Gather Dimensions & Configure

For each selected system, gather dimensions through natural conversation. Use multiple-choice questions and calculators to make it easy.

CRITICAL: Display the BOM as a table after each significant addition. The user must be able to see what's being added in real-time and correct mistakes immediately.

2A. Horizontal/Vertical Slat Screens

Gather these inputs (in order of importance):

1. Colour — ask first, affects all product codes

   • Standard: Black (B), Monument (MN), Woodland Grey (G), Surfmist (SM), Pearl White (W), Basalt (BS), Dune (D), Mill (M)
   • Limited: Primrose (P), Paperbark (PB), Palladium Silver (S)

2. Slat size: 65mm or 90mm

   • 65mm: More slats per height = denser look, more material cost
   • 90mm: Fewer slats = more open feel, slightly cheaper

3. Slat spacing/gap: 5mm, 9mm, or 20mm

   • 5mm: Near-privacy (minimal light through)
   • 9mm: Standard privacy fence
   • 20mm: Open/decorative look

4. Screen height (in mm)

   • Show the user what the ACTUAL achievable height will be (it won't match their target exactly)
   • Use the slat count formula from calculation_rules.md:

     num_slats = lookup from height table
     actual_height = ROUND(num_slats × (slat_width + gap) - gap + 3, 0)
     

5. Total fence run length (mm or metres)

6. Panel layout:

   • Max panel width: 2600mm (2000mm for windy areas)
   • Panels > 2000mm need centre support rails
   • Calculate: num_panels = CEIL(run_length / max_panel_width)
   • Then: panel_width = run_length / num_panels (distribute evenly)

7. Termination at each end: Post, Wall, or Existing structure

   • Post-to-Post → Side Frames both sides
   • Post-to-Wall → Side Frame + F-Section
   • Wall-to-Wall → F-Sections both sides

8. 90° turns: Each turn = 1 corner post + independent panels each side

9. Louvre mode: Slats angled? (adds louvre brackets, changes width deduction)

2B. Post Configuration

Ask: "How will the posts be mounted?"

• Concreted into ground → post length = screen height + 450mm min
• Base-plated to slab → need base plate set + domical cover per post
• Core-drilled into concrete → need dress ring + chemical anchor per post
• Existing posts → just verify size (50mm or 65mm)

Post size selection (recommend automatically):

• Screen ≤ 1800mm: 50×50mm posts
• Screen > 1800mm or windy: 65×65mm HD posts
• Sliding gates: 65mm steel posts (XPSG-2700-ST65)
• Gate posts: 65mm HD recommended

2C. Pedestrian Gates (XP System)

1. Opening width (max 1200mm recommended)
2. Gate height (max 2100mm, should match fence height)
3. Slat size and gap (should match adjacent fence)
4. Gate side frame size: 50mm, 60mm, or 65mm
5. Hinge side: Left or right viewed from outside
6. Hardware choice:
   • Option A: Gate Kit (XP-GKIT-LSET09 or XP-GKIT-LSET20) — includes stops, slat count depends on gap
   • Option B: Magna Latch + TruClose hinge combo
   • Option C: Separate latch + separate hinges + lock box

2D. QSG Pedestrian Gates

Similar to XP gates but uses QSG frame system:

• QSG rails (65mm or 90mm profile)
• QSG gate side frames
• QSG joiner blocks
• QSG screw covers and rail screws

2E. Sliding Gates

1. Opening width (gate panel extends beyond for pocket)
2. Height from ground (includes 31mm ground clearance for steel track)
3. Slat size, spacing, and colour
4. Track type: Steel (standard) or Aluminium
5. Number of identical gates

Auto-add for every sliding gate:

• 2× Wheels (XPSG-WHEEL)
• 2× Wheel Clamping Sets (XPSG-WHEEL-CS — 2-pack, 1 per wheel)
• 1× Top Rollers (XPSG-TOPROLL-2PK)
• 1× Slide Guide (XPSG-GUIDE)
• 1× Gate Stop (XPSG-STOP)
• 1× U-Catch (XPSG-CATCH-U)
• Track: calculate length = gate_width × 2, pick 3000mm or 6000mm lengths
• Track Anchors: 22 per 3000mm track, 42 per 6000mm track
• Steel gate posts (XPSG-2700-ST65): typically 2 per gate

Phase 3: Calculate & Build BOM

Read references/calculation_rules.md for exact formulas.

3A. Interactive Calculator Display

When calculating slat counts, show the user a mini calculator:

╔═══════════════════════════════════════════╗
║  SLAT CALCULATOR                          ║
║  Slat: 90mm  |  Gap: 9mm  |  Colour: B   ║
╠═══════════════════════════════════════════╣
║  Target Height: 1800mm                    ║
║  ─────────────────────────────            ║
║  Calculated Slats: 18                     ║
║  Actual Height: 1782mm ← closest match    ║
║  Next option: 19 slats = 1881mm           ║
╚═══════════════════════════════════════════╝

Let the user pick which slat count they want if the target falls between two options.

3B. Progressive BOM Display

After each calculation step, display the BOM table so far:

| Qty | Code | Description | Unit $ | Line $ |
|-----|------|-------------|--------|--------|
| 18  | QS-6100-S90-B | 90mm Slat Black 6100mm | $50.49 | $908.82 |
| ← just added ↑ |

Keep appending rows as new items are calculated. This lets the user catch errors early.

3C. Auto-Add Companion Items

CRITICAL: These must be added automatically whenever their parent product appears. Never leave a BOM without these.

Load the full auto-add rules from references/calculation_rules.md Section 9.

Key auto-adds:

• Side Frame → always add CFC Cover (1:1) + Side Frame Caps (1 pack per 2 SFs)
• Centre Support Rail → add CSR Caps + Top/Base Plates
• Slats → add Spacers (50-packs) + Screws (50-packs)
• F-Section → add F-section fixing screws
• Posts → add mounting accessories based on method
• Gates → add hardware (hinges, latch, lock box if needed)
• Sliding gates → add wheels, track, guides, stops, catches

3D. Stock Length Optimisation

All extrusions are sold in fixed stock lengths. Calculate how many stock lengths to order:

pieces_per_stock = ROUNDDOWN(stock_length / cut_length, 0)
stocks_to_order = ROUNDUP(total_pieces / pieces_per_stock, 0)

Stock lengths:

• Slats (65mm/90mm): 6100mm
• Side Frame: 5800mm
• CFC Cover: 5800mm
• F-Section: 5800mm
• Centre Support Rail: 5800mm
• Gate Stop: 4200mm
• QSG Rails: 4800mm

Phase 4: Review & Validate

4A. Completeness Check

Before presenting the final BOM, verify:

• Every side frame has a matching CFC cover
• Every side frame has caps (2 per frame, sold in 2-packs)
• Every centre support rail has caps + top/base plates
• Screws and spacers are included (in 50-packs)
• Post mounting accessories match the mounting method
• Gate hardware is included (hinges + latch for every gate)
• Sliding gate components are complete (wheels, track, guides, stops)
• Panels > 2000mm have centre support rails
• Colour is consistent across all components

4B. Gotcha Warnings

Flag these if detected:

4C. Final BOM Presentation

Display the complete BOM grouped by category:

1. Screening Materials | Qty | Code | Description | Unit $ | Line $ |

2. Frames & Fixings | Qty | Code | Description | Unit $ | Line $ |

3. Posts & Mounting | Qty | Code | Description | Unit $ | Line $ |

4. Gate Components (if applicable) | Qty | Code | Description | Unit $ | Line $ |

5. Gate Hardware (if applicable) | Qty | Code | Description | Unit $ | Line $ |

6. Accessories & Consumables | Qty | Code | Description | Unit $ | Line $ |

TOTAL: $X,XXX.XX

Phase 5: Adjust & Export

1. Let the user adjust any quantities manually
2. Recalculate totals after adjustments
3. Ask about pricing tier (1 = standard, 2 = mid volume, 3 = trade)
4. Export as structured data (CSV or formatted table)

Pricing Tiers

The price list has 3 tiers:

• Tier 1 (price_1): Standard / small qty — default
• Tier 2 (price_2): Mid volume
• Tier 3 (price_3): Large volume / trade

Ask the user which applies. Default to Tier 1 if not specified.

Colour Codes Reference

Product Code Patterns

Slats:              XP-6100-S65-{col}  or  QS-6100-S90-{col}
Side Frame:         QS-5800-SF-{col}
CFC Cover:          QS-5800-CFC-{col}
F-Section:          QS-5800-F-{col}
CSR:                XP-5800-CSR-{col}
50mm Post 2400:     XP-2400-FP-{col}
50mm Post 6000:     XP-6000-FP-{col}
65mm Post 2400:     XP-2400-65HD-{col}
65mm Post 5800:     XP-5800-65HD-{col}
Base Plate 50mm:    XP-BP-SET-{col}
Base Plate 65mm:    XP-65BP-SET-{col}
Domical 50mm:       XP-DC-2P-{col}
Domical 65mm:       XP-65DC-2P-{col}
Dress Ring 50mm:    XP-DR-{col}
Dress Ring 65mm:    XP-65DR-{col}
SF Cap:             QS-SFC-B  ← individual (not a 2-pack), only available in Black, 2 per frame
CSR Cap:            XP-CSRC-{col}  ← has colour suffix (B, G, MN, S, SM, W)
Spacers:            XPL-SB-50PK-05MM / XPL-SB-50PK-09MM / XPL-SB-50PK-20MM
Screws (screening): XP-SCREWS-{col}  ← 100-pack (not 50)
Screws (gate frame):XP-SCREWSGF-10PK  ← 12G×65mm, 10-pack, separate from screening screws
Gate Blade 65mm:    XP-6100-GB65-{col}  ← only gate blade in catalogue (no 90mm gate blade)
Gate Kit (9mm):     XP-GKIT-LSET09-{col}
Gate Kit (20mm):    XP-GKIT-LSET20-{col}
HD Rail (ped gate): XP-6100-HD6545-{col}  ← top + bottom rail for pedestrian gate
SG Top Rail:        XPSG-6100-TR-{col}  ← 65×82mm, for SLIDING gates only
SG Bottom Rail:     XPSG-6100-BR-{col}  ← 120×45mm, for SLIDING gates only
Gate Stop:          XP-4200-GSTOP-{col}
Steel Post:         XPSG-2700-ST65-{col}
Top Rollers:        XPSG-TOPROLL-2PK
Track 3m:           XPSG-3000-TRACK-ST
Track 6m:           XPSG-6000-TRACK-ST
Wheel:              XPSG-WHEEL
Wheel Clamp:        XPSG-WHEEL-CS  ← 2-pack, 1 per wheel
Slide Guide:        XPSG-GUIDE
Gate Stop (SG):     XPSG-STOP
U-Catch:            XPSG-CATCH-U
F-Catch:            XPSG-CATCH-F
Track Anchors:      XPSG-ANCHOR
Latch+Hinge combo:  ML-TL-KF-H-FT  (Magna Latch + Kwik Fit fixed tension)
Latch only:         ML-TL
Hinge only:         TC-H-AT-2L-B  (TruClose adjustable pair)

Common Gotchas (CRITICAL — memorise these)

1. Where fences start/stop: Always ask. Post-to-wall needs F-section, not side frame.
2. 90° turns: Extra corner post + panels each side terminate independently.
3. Gate locations break the run: Each gate = fence stops, gate opening, fence resumes.
4. Post mounting accessories: NEVER forget base plates/covers for base-plated, dress rings for core-drilled.
5. Centre support for wide panels: Anything > 2000mm needs CSR + plates + caps.
6. Gate kits include stops/frames but NOT hinges or blades: Always add blades, HD rail, and a hinge+latch combo separately.
7. Sliding gate posts: Steel posts (XPSG-2700-ST65) required — not aluminium.
8. Sliding gate rails are different products to pedestrian gate rails: XPSG-6100-TR/BR (sliding) vs XP-6100-HD6545 (pedestrian). Do not mix them.
9. Sliding gates also need top rollers: XPSG-TOPROLL-2PK — easy to forget.
10. Track length: Must extend beyond opening on pocket side by at least gate width.
11. 2400mm posts include cap, 6000mm/5800mm do NOT — order caps separately.
12. Spacers match gap size: XPL-SB-50PK-05MM, XPL-SB-50PK-09MM, or XPL-SB-50PK-20MM — must match the slat spacing.
13. Screws combine SF + CSR: Total screw count = SF screws + CSR screws, sold in 100-packs (XP-SCREWS-{col}).
14. Gate frame screws are separate: XP-SCREWSGF-10PK (12G×65mm), different product from screening screws.
15. SF caps are sold individually (not as packs): QS-SFC-B, only black, 2 per side frame.
16. Actual height differs from target: Always show the user what height they'll actually get.
17. No 90mm gate blade exists: All gates use XP-6100-GB65 (65mm) regardless of fence slat size.

Unverified Items

These catalogue items could not be matched to price list SKUs. Flag for manual pricing:

App Changelog — quickscreen_bom_ai_intake.html

This section documents every fix applied to the BOM generator app. Update this immediately after any change.

2026-03-24 — Fence mapper v3: multi-run, per-run config, gate types, Google Maps

fence-mapper.js — complete rewrite

• Multi-run support: S.nodes[] → S.runs[]; single click places node, double-click finishes run; next click starts a new independent run
• Each run has its own colour (palette cycling), label (Run 1, Run 2…), and config overrides (height, slat size, gap, colour, post mount, terminations, max panel)
• Run node labels reset to A, B, C… per run
• Inline segment length editing: click segment label pill → input appears over canvas → type mm → Enter moves all downstream nodes
• Per-run config panel: click ⚙ gear icon on any segment label → floating panel to edit run settings + delete run
• Gate modal: click in Gate mode → modal with gate type (single/double swing/sliding), width (mm), direction (left/right); gate drawn with arc symbol (swing) or arrow (sliding) + distance-to-end annotations
• Post positions: window.fmSetPostPositions(runIdx, positions) draws gold/red squares on plan after BOM generation
• Google Maps satellite underlay: address input + "Load Map" button in toolbar; uses Geocoding API + Static Maps API; stored in S.mapImage; opacity slider; API key stored in localStorage qs_gmaps_key
• window.applyFenceLayout() now writes window.fmRuns array with per-run totals, gates, corners, config overrides
• Exports: fmGetState/fmLoadState now serialise full S.runs array

QuickScreen-BOM-Generator.html — targeted changes

• "Describe the Job" card is now collapsible (▼ toggle, state saved to localStorage)
• Google Maps API key UI added to Describe card (saves to localStorage('qs_gmaps_key'))
• Gates card: Gate Post Size selector added (50mm / 65mm HD default / 75mm / 100mm with confirm warnings)
• addGate() now captures postSize from selector
• generateSwingGateBOM() and generateSlidingGateBOM() read gate.postSize to select correct post code; 75+mm posts flag "confirm with supplier"
• New generateRunBOM(runCfg, sectionPrefix) helper — generates BOM sections for one run with given config
• generateBOM() now checks window.fmRuns; if set, iterates runs using per-run config overrides (falling back to form values for nulls), generates one BOM block per run, and processes mapper gates per run. Manual gate list is only added when mapper gates aren't present.
• BOM config summary shows multi-run info when mapper runs are active

2026-03-20 — Full audit and rewrite of generateBOM()

Colour dropdown

• Removed 3 non-existent colours: night_sky, jasper, manor_red (none exist in catalogue)
• Added all real QuickScreen colours: Black Satin, Monument, Woodland Grey, Surfmist, Pearl White, Basalt, Dune, Mill, Palladium Silver
• Updated AI parse prompt to use matching values

Fence BOM — complete rewrite

• Old code used completely fake SKUs (QS-SLAT-65, QS-TRK-3M, QS-POST-1800, QS-BP-100, QS-CAP-3M, QS-FIX-BAG, QS-END-CAP) — all removed
• Slat count now calculated correctly from height using round(N × (slat_width + gap) - gap + 3) formula (§1.3)
• Stock-length optimisation now applied via ROUNDDOWN/ROUNDUP (§1.6)
• Real slat codes: XP-6100-S65-{col} ($37.29) / QS-6100-S90-{col} ($50.49)
• Side frames QS-5800-SF-{col} ($24.35) now added with correct stock-length calc
• CFC covers QS-5800-CFC-{col} ($16.92) now mandatory 1:1 with side frames
• SF end caps QS-SFC-B ($0.86 ea) now added — 2 per frame, sold individually, black only
• Spacers XPL-SB-50PK-09MM ($3.01/pk) now added — qty: 2×(slats+1) per panel in 50-packs
• Screws XP-SCREWS-{col} ($6.06/100-pk) now added — qty: slats×2×1.01 + CSR_screws in 100-packs
• CSR XP-5800-CSR-{col} ($43.48) now auto-added for panels ≥ 2000mm, with caps (XP-CSRC-B, $1.03) and base/top plates (XP-BTP-{col}, $4.64 × 2)
• Posts: XP-2400-FP-{col} ($38.55) for ≤1800mm; XP-2400-65HD-{col} ($56.71) for >1800mm
• Base plates: XP-BP-SET-{col} ($9.79) + XP-DC-2P-{col} ($5.11) or 65mm equivalents
• Full 3-tier pricing added throughout (all prices from product_list.csv)
• BOM header now shows actual achieved height (e.g. "target 1800mm → actual 1782mm (18 slats)")

Sliding gate — fixes

• Top/bottom rails corrected: now XPSG-6100-TR-{col} + XPSG-6100-BR-{col} ($147.48 each) — old code wrongly used XP-6100-HD6545 (pedestrian gate product)
• Added missing XPSG-TOPROLL-2PK ($37.96)
• Fixed wheel clamp SKU: XPSG-WHEEL-CS ($6.00) — old code used non-existent QSG-S-WHEEL-CS-2PK
• Corrected all prices: wheel $21.53, guide $38.69, stop $18.20, U-catch $13.88, 3m track $26.52, 6m track $50.44, anchors $0.72/ea, steel posts $54.96
• Motor placeholder replaced with XPSG-FILO-400 ($726.55, verify flag)

Pedestrian gate — fixes

• Now uses XP-GKIT-LSET09-{col} ($157.41 / $132.00 mill) as the correct foundation kit
• Gate blades XP-6100-GB65-{col} ($55.36) — all gates use 65mm blade (only type in catalogue)
• HD rail XP-6100-HD6545-{col} ($124.56) — real price, correct for pedestrian gate
• Hardware: ML-TL-KF-H-FT ($61.48) replaces fake XP-HINGE-TC + XP-LATCH-ML codes
• Gate frame screws: XP-SCREWSGF-10PK ($3.02) — correct product (12G×65mm)
• Old XP-4200-GSTOP removed from pedestrian gate — now covered by gate kit

2026-03-24 — Gate BOM support added to app

New Gates card in QuickScreen-BOM-Generator.html

• Manual gate selector: Single Swing / Double Swing / Sliding Gate
• Inputs: opening width, height (match fence or custom), colour, gap, slat size — all with "match fence" toggles
• Multiple gates can be added; each appears as a list item with remove button
• Gate BOM auto-appended as named sections after fence sections on Generate BOM

Single/Double Swing Gate logic (XP pedestrian gate)

• Gate kit: XP-GKIT-LSET{09|20}-{col} (frame, inserts, stops, rubber, caps, stop screws) — 1 per leaf
• Gate blades: XP-6100-GB65-{col} — always 65mm regardless of fence slat size; count = slatCount(height−130, 65, gap)
• HD rails: XP-6100-HD6545-{col} — 2 per leaf (top + bottom), stock-optimised from 6100mm
• Hardware: ML-TL-KF-H-FT (Magna Latch + Kwik Fit hinges) — 1 per leaf
• Lock box: XP-LBOX-LSET-{col} — 1 per gate
• Gate frame screws: XP-SCREWSGF-10PK — 2 packs per leaf
• Posts: XP-2400-65HD-{col} — 2 for single swing, 3 for double swing
• Double swing also adds: SS-0300DB-ZP drop bolt (passive leaf)
• Warnings: no 5mm gate kit exists → uses 9mm kit; >1200mm → flag; >2100mm height → capped

Sliding Gate logic

• Slats: XP-6100-S65-{col} or QS-6100-S90-{col} — regular fence slats, gate panel = opening + 200mm overlap
• Top rail: XPSG-6100-TR-{col} — 1 per gate, cut to panel width
• Bottom rail: XPSG-6100-BR-{col} — 1 per gate
• Fixed hardware per gate: 2× XPSG-WHEEL, 2× XPSG-WHEEL-CS, 1× XPSG-TOPROLL-2PK, 1× XPSG-GUIDE, 1× XPSG-STOP, 1× XPSG-CATCH-U
• Track: calculated from panel × 2; uses XPSG-3000-TRACK-ST / XPSG-6000-TRACK-ST; XPSG-ANCHOR = 22 per 3m, 42 per 6m
• Posts: 2× XPSG-2700-ST65-{col} (galv. steel)
• Note: XPSG-2700-ST65-B not in catalogue — priced same as other colours

AI parse updated for gates

• Extracts gates[] array from description: type, openingWidth, height, gap, colour, qty
• Populates gate list automatically
• Shows "Still needed" hint banner for missing gate dimensions

2026-03-24 — Merged apps + fence mapper v2 (zoom/pan/scale calibration)

Apps merged into single file

• QuickScreen-BOM-Generator.html is now the definitive app — combines:
  • Generator's complete BOM logic, per-colour price DB P{}, F-section/dress ring/CSR cap support, 3-tier pricing, print/CSV/copy/Ask Claude export
  • AI intake's Claude API integration (calls claude-sonnet-4-20250514, falls back to regex parser)
  • Fence mapper (collapsible section, external fence-mapper.js + fence-mapper.css)
• quickscreen_bom_ai_intake.html preserved as-is for reference

fence-mapper.js — full rewrite (v2)

• Viewport transform: w2s(wx,wy) world→screen, s2w(sx,sy) screen→world applied throughout all render and hit-test functions
• Scroll wheel zoom: centered on mouse position — world point under cursor stays fixed during zoom
• Pan: right-click drag, middle-mouse drag, or left-drag on empty space in Move mode
• Pinch-to-zoom: two-finger touch distance ratio applied, centered on finger midpoint
• Scale calibration: double-click any segment → prompt real length in mm → global S.scale updates → all segment labels recalculate; grid adjusts to match
• Reset View button (fm-reset-view): restores zoom=1, pan=0,0
• applyToCalculator(): writes to runLength (mm) and corners — Generator field IDs (not AI intake IDs)
• Grid redraws correctly at any zoom/pan level

QuickScreen-BOM-Generator.html — merged structure

• Blue header → fence mapper section → describe job card (AI + local) → config form → slat calc → BOM output
• API key: collapsible section in describe card, saved to localStorage('qs_anthropic_key')
• parseWithAI(): injects stored key as x-api-key + anthropic-version headers; falls back to parseNL() on error
• BOM output includes site plan PNG from fmGetSitePlanDataURL()
• Config form field IDs unchanged from Generator (runLength, corners, targetHeight, etc.)

2026-03-23 — Interactive fence layout mapper added

New files added

• Desktop/fence-mapper.js — FM module: canvas-based node/segment polyline, gate placement, run summary, apply-to-calculator, site plan export, serialisation
• Desktop/fence-mapper.css — all mapper styles matching app CSS variable scheme

Changes to quickscreen_bom_ai_intake.html

• Added collapsible "Map Your Fence Layout" section in step1, between describe card and examples card
  • HTML5 canvas with 50px grid, ghost preview overlay, responsive (min 700px)
  • Toolbar: Draw / Gate / Move / Undo / Clear All modes
  • Grid snap + scale control (mm per grid square, default 1000)
  • Node labels (A, B, C…), segment length labels, corner angle display
  • Gate placement on segments via click — dashed gap, double-arrow, width prompt
  • Run summary table: segment, length, gates, net fence, corner angle
  • Totals: total fence length, corner count, gate count
  • "Use This Layout" button: sets f_length, f_corners, prepends layout note to jobDesc, adds gates, shows toast; warns before overwriting existing values
  • Site plan PNG embedded in BOM output
  • Touch support; Ctrl+Z undo; Esc cancels draw
• Added f_corners field to step2 Job & system card (90° corners count)
• generateBOM() now reads f_corners — adds 1 extra post per corner: numPosts = numPanels + 1 + numCorners
• AI parse prompt now extracts "corners" field
• applyParsed() now sets f_corners from parsed JSON
• Added resetGates() helper (clears gate list before re-populating from mapper)
• Added <div id="bom-site-plan"> in step3 — populated with mapper PNG on BOM generation
• Added <div id="fm-toast"> for toast notifications

System Formulas Quick Reference (from analysis_slat_frames.md)

XPL Insert Dimensions

XPL Slat Count (blade count method)

XPL uses blade_cc to determine slat count (different from QSHS height formula):

Blade_cc = Wslot + Gs   # 74.5mm (9mm gap) or 86.5mm (20mm gap)
num_blades = INT(available_height / Blade_cc)
available_height = screen_height - 2 × Ht_EndCap = screen_height - 6

XPL is 65mm slat ONLY. No 90mm option exists.

BAYG Slat Count

BAYG uses its own lookup table (BAYG_ScrHts) for height → slat count. Programmatic approximation (same formula as QSHS):

num_slats = largest N where N × (slat_width + gap) - gap + 3 ≤ target_height

BAYG spacers = 2 × (num_slats + 1) per panel, sold in 50-packs.

VS Vertical Slat Count (AUTHORITATIVE formula from CTS - Vertical Screens tab)

num_slats = ROUNDDOWN((panel_width - 8 + slat_spacing) / (slat_spacing + slat_size), 0)

Where 8 = frame channel depth (4mm each side). Overhang = ROUND((panel_width - 8 - num_slats × (slat_spacing + slat_size) + slat_spacing) / 2, 1) Slat cut length = panel HEIGHT (slats run vertically). Top/bottom rails = side frames cut to panel WIDTH.

Pricing Tiers

T2 = T1 × 0.85 (15% discount from T1) T3 ≈ T1 × 0.80 (approx — varies by product)