Document 06: Foreman Review & Master UI/UX Specification — The Cogneris EPPM Desk Shell & Mobile @native/DeskKit Look & Feel Applied to Lowe-Martin (LMX-NewOps)
Role: Cogneris Foreman (FOREMAN — Intake, Architectural Review & CPT Dispatch)
Source Estate Reference: /Users/pjones/MyProjects/Applications/EPPM (src/features/jit/desk.ts, JitShell.tsx, DeskFurniture.tsx, ConversationDrawer.tsx, mobile-shared/DeskKit.tsx, desk.ts, theme.ts, ui.tsx, AppRoot.tsx, DOCS/HANDOFF_Desk_Shell_2026-08-26.md, DOCS/NAV_STANDARD.md)
Target Suite: The 5 Lowe-Martin Group & LMX Solutions Applications (PACE EstiGate™, PACE PlanFlow™, CORE CRM Account Studio™, CORE Opportunity Radar™, CORE RFx Bid Studio™)
Date: 2026-11-19
1. Foreman Architectural & Design Audit of /Users/pjones/MyProjects/Applications/EPPM
A comprehensive forensic review of the Cogneris EPPM application repository (/Users/pjones/MyProjects/Applications/EPPM) establishes the binding visual and interaction language for Cogneris desktop and mobile applications. Every Lowe-Martin application—across both the Web Desk Shell (/apps/*) and the 5 Native iOS Handset Applications built for iPhone "Mini Me"—must adhere strictly to these non-negotiable rules:
1.1 The Core Thesis: "The Wallpaper IS the Desk"
- Photographic Ground (
desk-bg.jpg/desk-bg-light.jpg):
- The application never renders onto an opaque flat page background. Instead, a full-bleed high-character environmental photograph (
desk-bg.jpgin dark mode,desk-bg-light.jpgin light mode) is mounted once at the root layout (<Desk>on iOS;DESK_WALLPAPERplate on web) usingcoverscaling. - Mounting the wallpaper once above the navigation container prevents re-decoding or black flickering during tab transitions, reinforcing that the photograph is the continuous physical desk surface upon which translucent frosted glass panels rest.
- All navigation containers and screen wrappers (
deskTheme(),DeskScreen,sceneStyle,contentStyle) must be 100% transparent (backgroundColor: 'transparent').
- Flat Glassmorphism Only — Zero Neumorphism, Zero Extruded Drop-Shadow Lift:
- Neumorphism (extruded faces, opposed light/dark shadow pairs, inset pressed wells) is strictly banned.
- Surfaces are separated from the photographic wallpaper exclusively by real backdrop blur, measured luminance tint, a
1px/1pthairline border (EDGE/EDGE_COLOR), and a1px/1ptlit top edge (EDGE_LIT). LIFT = { shadowOpacity: 0, elevation: 0 }on mobile (LIFT_2 = 'shadow-none'on web). Panels lie flat on the desk rather than pretending to float with artificial drop shadows.
- Measured WCAG AA Contrast Across Dual Ladders (
onPanelvs.ON_DESK):
- Contrast is never eyeballed; it is computed against the worst-case pixel of the blurred photographic ground:
- Mobile Dark Frost (
PANEL_FILL = rgba(20, 26, 40, 0.72),CHROME_FILL = rgba(20, 26, 40, 0.84),PANEL_BLUR = 34,CHROME_BLUR = 44): Measured against the brightest wallpaper pixelrgb(67,72,74),#141a28at0.72alpha achieves5.37:1(secondary) and4.53:1(muted), passing WCAG AA across all three text tiers (text: #f2f5fb,text2: #949ab1,text3: #858cab). - Mobile Light Frost (
PANEL_FILL = rgba(247, 244, 238, 0.88),CHROME_FILL = rgba(247, 244, 238, 0.93)): Measured against the darkest wallpaper pixelrgb(68,75,72),#f7f4eeat0.88alpha achieves11.81:1(primary),5.66:1(secondary), and4.90:1(muted). - Web Glass Frost (
bg-[var(--surface)]/65 dark:bg-[#201d2e]/65 backdrop-blur-3xl backdrop-saturate-[1.8]): Paired with compressed text-tier variables ([--text-2:#3e3a34] [--text-3:#3e3932]in light;dark:[--text-2:#c3c8d8] dark:[--text-3:#a4abc0]in dark) to guarantee≥4.52:1contrast at 65% glass opacity. - Bare Wallpaper Text Ladder (
ON_DESK): Text rendered directly over the wallpaper outside a panel (DeskText,DeskLabel,ChipRow) usesON_DESK(primary: #f2f5fb,secondary: #d2d8e8,muted: #bac2d6in dark;#211f1b / #2f2b25 / #3a352doverON_DESK_SCRIM = rgba(247,244,238,0.86)in light).
2. Geometry, Chrome & Layout Standard (Web Desk Shell vs. Mobile Handset)
2.1 Shared Geometry Tokens (desk.ts)
| Token | Value | Purpose |
|---|---|---|
GUTTER | 12px / 12pt | Universal spacing between screen edges, floating chrome, and stacked cards. (Web top bar uses a 24px double gutter beneath it so 65% glass layers do not visually merge.) |
PLATE_RADIUS (Web) | 22px | Outer rounded plate clipping the full-bleed desk wallpaper inset 12px from viewport edges. |
WINDOW_RADIUS | 20px / 20pt | Artifact windows summoned onto the web desk canvas. |
PANEL_RADIUS | 16px / 16pt | All frosted glass panels (<Panel>, <Card>, <DeskHeader>, <ConversationDrawer>). |
CHIP_RADIUS | 999px / 999pt | Full pill radius for <Segments>, <ChipRow>, <AskBar>, and workspace chips. |
DESK_HEADER_HEIGHT | 44px / 44pt | Floating top bar height (inset 12pt from top, left, and right safe-area edges). |
TAB_BAR_HEIGHT (Mobile) | 84pt | Floating frosted bottom navigation bar (position: 'absolute', wallpaper visible underneath). |
CHIP_ROW_HEIGHT | 32pt | Fixed horizontal scroll height for <ChipRow> and <Segments> with right-edge gradient fade. |
3. The Mobile Navigation Standard (DOCS/NAV_STANDARD.md)
The Fundamental Rule:
"The top bar owns WHERE you are. The bottom bar owns WHAT you are doing."
Scope (which plant, which account, which division, settings) belongs in the floating top <DeskHeader>. Mode of engagement (read, act, ask, talk, review) belongs in the floating bottom bar, which has strictly 4 labelled icons and 1 raised unlabelled center microphone (JARVIS / Co-Agent) in the exact same order across every application:
| Slot # | Slot ID | Label | Core Question Answered | Badge Rule |
|---|---|---|---|---|
| 1 | home | Home (or Now) | What is the state of my world right now? | Never badged. Anchor tab to get un-lost. |
| 2 | work | Work | What is waiting for me to do or approve? | Count of items needing user action. Opens on <Segments> (All · Sent to you · [Domain Queues]). Record types are segments, never extra tabs. |
| — | ask | (No Label — Raised 42pt Mic Disc, marginTop: -14) | Just ask, or state a change. | Never badged, never labelled. Brand-filled when active; translucent wash (t.subtle2 + 1pt border t.hair2) when inactive. |
| 3 | chat | Chat | Who is talking to me or blocked on my answer? | Unread messages from people. Segmented into Threads and People (Contacts). Co-agent is never in Chat. |
| 4 | activity | Activity (or Newsfeed) | What has moved against baseline? | Unseen events / signals. Audit trail, PaceConnect webhooks, and external signals with before → after deltas. |
4. Mapping the EPPM Desk & Mobile Standard to the 5 Lowe-Martin Applications
Each of the 5 Lowe-Martin applications is built as both an interactive Web Desk Shell experience (/apps/) and a standalone Native iOS Application (com.cogneris.lmx.) compiled via Xcode (xcodebuild) for Pete's iPhone "Mini Me":
| App # | Application Name | iOS Home Screen Name | iOS Bundle Identifier | Primary Persona & Co-Agent | Accent Color | Work Tab <Segments> | Standing <DeskHeader> Stats |
|---|---|---|---|---|---|---|---|
| App 01 | PACE EstiGate™ | EstiGate | com.cogneris.lmx.estigate | K. Patel (Senior Estimator) · Co-Agent: JARVIS · Otto | #3b82f6 (Cobalt Blue) | All · Spec Gate · Margin Guard · PACE Drafts · Sent to you | Complete 94% · Drafts 6 |
| App 02 | PACE PlanFlow™ | PlanFlow | com.cogneris.lmx.planflow | J. Chen (Master Scheduler) · Co-Agent: JARVIS · Cronos | #14b8a6 (LMX Teal) | All · 72-Hr Watchdog · Rush Sim · Ottawa Press · Mississauga | On-Time 98.4% · Alerts 3 |
| App 03 | CORE CRM Account Studio™ | CORE CRM | com.cogneris.lmx.corecrm | Sebastián Gonzalez (SVP Sales & Mktg) · Co-Agent: JARVIS · Cora | #ee5e44 (Cogneris Coral) | All · 6-Part Briefs · Team Matcher · 6-Div Whitespace · Approvals | Active $14.2M · Briefs 8 |
| App 04 | CORE Opportunity Radar™ | Opp Radar | com.cogneris.lmx.radar | M. Tremblay (Account Executive) · Co-Agent: JARVIS · Scout | #f59e0b (Amber Radar) | All · Public Tenders · PACE Reorders · OmniConnex · Dispatched | Matches 14 · Reorders 9 |
| App 05 | CORE RFx Bid Studio™ | RFx Studio | com.cogneris.lmx.rfxstudio | L. Gagnon (Bid Desk Lead) · Co-Agent: JARVIS · Vera | #8b5cf6 (Royal Violet) | All · RFP Lots · Compliance · PACE Costing · Gate Sign-Off | Win Rate 41% · Live Bids 4 |
5. Five Management Questions & Deterministic Preview-Before-Commit Engine
Following EPPM's src/domain/five-questions.ts and domain/impact.ts, every Lowe-Martin app resolves five canonical management questions from the same underlying dataset (at Enterprise or Single-Account/Job scope) and requires explicit human confirmation (Propose → Preview Before/After → Commit) before writing any state change or invoking any ePS Pace SOAP mutation:
- Where are we? — Current commercial pipeline, plant load across Ottawa (Hunt Club Rd.) & Mississauga, active RFx pursuits, and SLA health.
- How far off? — Schedule variance (hours/days against promised delivery), missing-spec queue depth, and actual-vs-estimated Auto-Count 4D margin drift.
- What moved? — Recent
PaceConnectshop-floor events, CanadaBuys/OECM tender publications, OmniConnex SKU depletions, and paper PO lockouts. - What is it costing? — Quoted vs. actual job cost (
JobCost), substrate waste, freight penalties, and 6-division share-of-wallet whitespace. - What are the options? — Deterministic trade-off cards (e.g., split press/kitting across Ottawa & Mississauga, clone PACE template
#48192, pair bilingual healthcare specialist).