Settings › Help & knowledge

Help & Knowledge Hub

All factory rules, SKU codes, cutting decisions, brand standards and locked phrases. Internal use only.

25 topics · showing all

Jump to: Cutting rules SKU naming Color codes Roll widths Offcut policy Busbar Pipeline Visit readiness Brand rules Locked phrases

10 Cutting Rules Cutting

The algorithm in /cut-test/ applies these in order.

#	Rule	What it means
1	Panel size includes busbar	No +8mm margin added. Panel.width_mm used as-is.
2	Width-match	Pick the smallest roll that fits — don't waste a 1830mm roll on a 600mm panel.
3	Borderline block	If panel width is within 50mm of nominal roll width AND the roll has no `actual_width_mm` measured → BLOCKED. Office must measure first.
4	Nesting	Same-height + same-busbar-orientation panels whose summed widths ≤ effective roll width → cut side-by-side in ONE pass. E.g. 220 + 1000 = 1220 on 1240mm roll = 2.6m linear instead of 5.2m.
5	Same-lot-per-project	All panels of one project cut from same lot (warranty traceability). Engine tracks `projectLot[project_id]`.
6	FIFO	Oldest roll first when tied on width.
7	Offcut pool first	Check `offcut_pieces` table ≥200mm wide before opening a fresh roll.
8	Reserved-lot exclusion	Engine cannot pick a lot already reserved to another in-flight project.
9	Linear m + m² auto-derived	`linear_m = (h/1000) × qty` · `billable_m² = (w × h × qty) / 1,000,000`. Not pre-planned.
10	Offcut fate	≥200mm wide = shelf (barcoded) · 150–200mm = quarantine · <150mm = garbage.

NEVER do: add 8mm busbar margin · use a wider roll when a narrower fits · ignore offcut pool · mix lots across one project's panels without flagging.

SKU Naming Convention Product

Pattern: FM-{grade}-{tint}-{adhesion}

Segment	Values	Example
Grade	`T91` (standard) · `T85SL` (acoustic)	`FM-T91`
Tint	(blank) clear · `Y` yellow · `G` gray · `OD` outdoor · `DG` decorative-gray	`FM-T91-Y`
Adhesion	`A` self-adhesive · `N` non-adhesive (for lamination)	`FM-T91-Y-A` · `FM-T91-G-N`

Common SKUs: FM-T91-A clear self-adhesive · FM-T91-N clear non-adhesive · FM-T91-Y-A yellow adhesive · FM-T91-G-N gray non-adhesive · FM-T91-OD-N outdoor non-adhesive.

Color & Tint Codes Product

Written	Code	Used for
T91 / clear / blank	`clear`	Standard transparent smart film
Yellow	`yellow`	Decorative yellow tint
Gray / GRY	`gray`	Decorative gray tint
Outdoor / OUT	`outdoor`	Exterior-grade (weatherproof)
Convection Gray	`decorative-gray`	Special decorative variant

Roll Widths Stock

Three nominal widths: 1240 · 1520 · 1830 mm

Actual width comes from back office. No default + tolerance assumption. Office measures + records actual_width_mm. Borderline panels (within 5cm of nominal) BLOCKED until measured.

Roll length: typically 30–60m per sealed roll. Tracked in stock_smartfilm.length_remaining_m.

Offcut Salvage Policy Stock

Width remaining	Action	Why
≥ 200 mm	→ Shelf (barcoded, stored)	Re-cuttable for future small panels
150–200 mm	→ Quarantine	Office decides per-piece
< 150 mm	→ Garbage	Too narrow for any panel

Auto-record: Every cut leaving offcut ≥200mm wide gets offcut_pieces row + 1 barcode + cutter sticks on strip + stores on shelf. AI lot engine checks this pool BEFORE opening a fresh roll.

Busbar Conventions Cutting

Position (captured at survey, locked before cut):

Top · Bottom · Left · Right · Multi-busbar (Jumbo)

Width:

10 mm · Standard (default)
5 mm · Thin
Custom (other) — must be specified

Wrong busbar position = useless film. Office engineer LOCKS position before cutting sheet generates. QR labels carry busbar info to cutter.

The Canonical Pipeline Pipeline

Every PRIVASEESOFT page sits in this flow. Each transition is a rule-enforced gate.

Inquiry → Project → Visit → Survey → Office Review → Confirmation
        → Stock Reserve → Cutting → QC → Delivery → Problem

Stage decided by combining project.status + visits[].completed_at + quote.status.

Visit Readiness Gate · 9 checks Pipeline

Before any worker dispatches to site. Ready / Not Ready / Blocked.

Customer contact confirmed (name + phone) — HARD
Site address / GPS — HARD
Visit purpose selected
Gate pass / NOC (if required) — HARD
Working hours confirmed
Parking / access notes
PPE + tools selected
Site risks selected
Surveyor / team assigned — HARD

Hard rules — never bypass: No dispatch if gate pass required & not received. No install visit if stock not reserved. No cutting without site contact co-signature.

Locked Phrases Brand

Use VERBATIM in customer-facing docs. Never paraphrase.

LP-001 — Smart Glass identification
LP-002 — Smart Glass lamination process (Smart Glass only — NOT Smart Film)
LP-003 — Service life / hermetic seal claim

Warranty: "2-year standard manufacturer warranty · extendable by separate project agreement" — use verbatim across datasheets, quotations, manuals, web.

Banned Vocabulary (External) Brand

NEVER in external/customer-facing docs:

Supplier names: Moben · Fuyin · Momentive (INTERNAL ONLY)
Operating voltage: 48 V / 60 V (INTERNAL ONLY)
Acoustic Rw 52 dB — banned. Allowed range is 34–48 dB Rw.
"Most common" for PJ-D power drive
Marker brand names on whiteboard
PRIVASEE® with registered mark — brand is PRIVASEE.uk, never ®/™

LG-02 = Acoustic (NOT Reverse-Mode) Brand

LG-02 is the acoustic Smart Glass variant (Rw 34–48 dB). It is NOT reverse-mode. Reverse-mode is a separate, currently-out-of-scope product.

TOSSEAL 381 Silicone — Only Approved Factory

Warranty-critical: TOSSEAL 381 is the ONLY approved silicone for Smart Glass edge sealing. Any other silicone voids the warranty.

EVA Interlayer Standards Factory

0.8 mm EVA — Standard Smart Glass (SG-01, LG-01)
0.76 mm EVA — Acoustic Smart Glass (LG-02)
Substrate: Low Iron tempered glass

3-Label Panel Lifecycle Factory

TOP + BOTTOM labels stuck at lamination BEFORE protection removal — with project/room/size.
QC TESTED label on back after clean + trim + test passes.
Delivery scan reconciles to LPO. Wrong panel = hard block + alarm.

Database is the Only Truth Factory

LAW: Money + official docs = every read AND write through DB. NO localStorage for business data. Page loads ALWAYS query DB by ID.

The session identity token v7.2-admin-unlocked is the only thing allowed in localStorage.

6-SKU PDLC Smart Film Matrix Product

Grade	Thickness	Adhesion	SKU
T91	16 micron	Adhesive	`FM-T91-16-A`
T91	16 micron	Non-adhesive	`FM-T91-16-N`
T91	12 micron	Adhesive	`FM-T91-12-A`
T91	12 micron	Non-adhesive	`FM-T91-12-N`
T85SL	12 micron	Adhesive	`FM-T85SL-12-A`
T85SL	12 micron	Non-adhesive	`FM-T85SL-12-N`

Smart Glass Variants Product

SG-01 — Standard Smart Glass (PDLC film laminated between 2 sheets Low Iron + EVA 0.8mm)
LG-01 — Standard Laminated
LG-02 — Acoustic (Rw 34–48 dB) — uses EVA 0.76mm

Panel Size Includes Busbar Cutting

Cutting sheet sizes already include busbar width.

Don't add 8mm on top during optimization. 1050×2600 = cut to exactly 1050mm.

Nesting — Multi-Panel-Per-Cut Cutting

Same-height panels with summed widths ≤ roll effective width = cut side-by-side in ONE pass.

Example: 220 + 1000 = 1220 on 1240mm roll → 2.6m linear instead of 5.2m. Halves film consumed.

Busbar-collision check required (only top/bottom busbar orientation works for vertical nesting).

Lamination Recipes (7 types) Factory

SG-01 Standard
Acoustic (LG-02)
Transparent (clear film)
Coloured (yellow/gray tint)
SOG Solid Opaque Glass
Decorative
OG Other Glass (customer-supplied)

Per-layer customer_supplied flag (when customer provides their own glass).

v7.9.0 Shell — Locked Baseline Brand

Every PRIVASEESOFT app page uses the EXACT v7.9.0 Home shell:

Desktop: Navy sidebar (sb-brand + sb-nav + sb-foot + 6 sb-items)
iPad / Phone: Topbar (tb-left + tb-right) + bottom-nav (4+ bn-items)
Lang pills (EN/AR/RU) + version chip slot

Only the main content changes between pages. Enforced by Guard 1 in CI.

Every Page Shows Main Version Brand

Rule (sealed together): Every page displays the current main version (e.g. v7.13.0). When main bumps, all pages bump together.

/shared/version-chip.js reads /BUILD_INFO.txt and stamps the chip at bottom-right. Single source of truth. Enforced by Guard 7 in CI.

AI Watchdog per Section Factory

AI watches every section · pings Telegram with "explain please" questions on anomalies · learns from founder answers. Trained-junior-employee pattern.

Tables: ai_anomalies + ai_learning_log.

VLT Publication Policy Brand

External docs publish:

VLT 90% ON · 80% OFF (± 2.0%)
Haze 2.5% ON · 99% OFF
Viewing angle >140°

Same values for Smart Film AND Smart Glass (component spec convention). Earlier 75/50 was wrong — SUPERSEDED.