Product outcome
Expose the same adopted-basis capacity and conservation relationships in every engineering view, then let the reader drill into a tagged piece of equipment without losing facility context.
Product requirements · adopted NVL72 engineering cockpit
AI Data Hall Operations
A traceable contract for the GB300 NVL72 compute, electrical, liquid-cooling, room-layout, network, fire-safety and BMS/DCIM views in datahallAI.html. The cockpit is a tier-gated simulated engineering surface; this PRD and its methodology manual remain public.
01 Purpose & problem
High-density AI infrastructure couples compute, 2N power, warm-water liquid cooling, residual air cooling, safety and network fabrics. A reviewer needs one coherent basis across every view; an operator needs alarm-first navigation without confusing design targets, locked calculations and jittered sensor demonstrations.
Decision supported
Identify the affected subsystem, inspect its current simulated state, reproduce the governing calculation, and distinguish a resolved design value from a placeholder or unresolved modeling risk.
02 Users & personas
| Persona | Goal | Primary read | Success condition |
|---|---|---|---|
| Data-center operator | Triage power, cooling, safety or communications abnormality. | Alarm strip → subsystem tab → equipment HMI/inspector. | Can name severity, affected tag, dependencies and next check in under one minute. |
| Electrical engineer | Verify 2N capacity, transformer/busway loading and SLD state. | Electrical Overview/DH tabs, SLD mimic and results panel. | Can reproduce ~4,697 A per RPP group, 93.9% busway loading and 79.9% UPS loading. |
| Mechanical / liquid-cooling engineer | Check heat split, TCS flow, CDU duty and residual CRAH load. | Cooling P&ID, CDU/chiller/CT/CRAH HMIs and basis drawer. | Can reproduce 106,216 kW liquid heat, 9,612.3 m³/h TCS flow and 107 running CDUs per hall. |
| Commissioning engineer | Review point names, alarm thresholds, focus behavior and equipment drilldowns. | All clickable SVG equipment, alarm strips and modal summaries. | Can derive a deterministic E2E test for every visible control family. |
| Design reviewer | Audit the adopted basis against vendor/standard sources. | Basis of Design drawer, generated design, manual and risk register. | Can identify targets, calculations, jitter and unresolved discrepancies separately. |
| Educator / learner | Understand the architecture of a modern AI factory. | Overview, Rack, Cooling, Electrical, Network and glossary. | Can trace one NVL72 rack from utility to compute and heat rejection. |
03 Scope & non-goals
In scope
- Four halls, 880 NVL72 racks per hall (one rack = one NVLink domain), 3,520 racks facility-wide.
- Adopted-basis power, heat, flow, capacity and PUE derivations.
- Dashboard, building/floor overview, hall/rack, cooling, electrical, network, fire and BMS/DCIM views.
- Equipment HMIs, SLD mimic/results, alarm strips, data quality, inspector, BoD, report and FAQ workflows.
- Explicit simulated sensor jitter around locked design points.
Non-goals
- No field PLC/BMS/EPMS/DCIM, historian, OPC UA, Modbus or SNMP feed.
- No command write-back, safety interlock or remote switching.
- No stamped design, procurement schedule, CFD, protection study or fire-agent compliance proof.
- No promise that illustrative uptime/alarm values are production records.
- No bypass of the existing cockpit access policy; public docs carry no gate.
04 Functional requirements
Requirements cover every visible control and signal family. Generated SVG items are represented by their stable tag/data-attribute family.
| ID | Visible element / requirement | Acceptance |
|---|---|---|
| FR-01 | Preserve the Full access/Educator cockpit access gate while keeping PRD and Manual public. | Unauthorized cockpit view remains gated; both documentation routes load without invoking cockpit authorization code. |
| FR-02 | Provide Portfolio, DC Solutions, PRD and Manual links. | All four links are visible in the header row and keyboard reachable. |
| FR-03 | Provide Basis of Design, Generate Design, FAQ and Theme controls plus WIB clock. | Each button opens/toggles its stated surface; clock updates without changing engineering values. |
| FR-04 | Provide ten primary tabs: DC Dashboard, Data Hall, Room Layout, Rack Architecture, Cooling & Piping, Electrical SLD, Network, Fire & Safety, BMS, and Alarms & Events. | Exactly one .pn is active and its tab has .on. |
| FR-05 | Allow desktop sidebar collapse/reopen and persist preference. | sideTog/sideReopen update state, labels and dhSideCollapsed. |
| FR-06 | Show Compute sidebar points. | Platform, domains, GPUs, CPUs, GPU basis, HBM, FP4/FP8/BF16 and NVLink/domain remain labeled. |
| FR-07 | Show Power sidebar points. | Rack IT, Total IT, Mech+Aux, per-rack, UPS A/B and GenSet state display units and provenance. |
| FR-08 | Show Cooling sidebar points. | DLC/air heat, TCS supply/return/ΔT, CDUs, chillers and CRAHs remain visible. |
| FR-09 | Show Network, Safety and Alarm sidebar points. | NVLink, IB, OOB, Fire/VESDA, EPO, leak, detector counts, disabled, in-alarm and maintenance states render. |
| FR-10 | Show eight dashboard KPIs with basis drawers. | PUE, WUE, CUE, IT, GPUs, NVL72, Uptime and Alarms support click/Enter/Space where data-basis exists. |
| FR-11 | Show dashboard facility image, callouts and status cards. | Electrical, cooling, network, safety and access values remain readable and source class is clear. |
| FR-12 | Render building overview and selectable floors. | Floor selection opens the corresponding drawing; Overview returns via floorBack. |
| FR-13 | Render Data Hall view and four DH selectors. | DH-1…DH-4 selection updates active state and associated drawing/context. |
| FR-14 | Render rack architecture and specification/detail panels. | NVL72/rack components have stable tags and open the correct detail surface when clickable. |
| FR-15 | Render Cooling & Piping P&ID and detail cards. | TCS/FWS paths, CDU/chiller/CT/pump/CRAH/chemistry equipment remain tagged and interactive by family. |
| FR-16 | Provide Electrical sub-tabs Overview and DH-01…DH-04. | Exactly one .ep is active; tab/data panel pairing is deterministic. |
| FR-17 | Render facility and per-hall electrical SLDs. | MV substation, RMU, transformer, MSB, UPS, ESS, busway, rack PSU and cooling-feed families remain traceable. |
| FR-18 | Open SLD mimic from tagged electrical equipment. | Mimic title, drawing, energized badge and results panel reflect selected type/hall. |
| FR-19 | Provide SLD Zoom In, Zoom Out, Fit, Print, Close and Results toggle. | All six controls change only mimic presentation and preserve selected equipment. |
| FR-20 | Render Network Fabric Topology and detail panels. | Fabric health, capacity/congestion, packet loss and redundancy values have tag/source context. |
| FR-21 | Render Fire Detection & Suppression P&ID and detail panels. | Smoke, heat, VESDA, beam, MCP, EPO, FACP, solenoid, nozzle and cylinder families remain distinguishable. |
| FR-22 | Render BMS/DCIM Architecture, protocol tables and service-health strip. | Historian, notification, 16/16 gateways and alarm lifecycle counters remain visible. |
| FR-23 | Provide CDU HMI. | Selected CDU tag, online mode, pressure/flow/temperature/capacity points and close behavior render. |
| FR-24 | Provide Chiller and Cooling-Tower HMIs. | Selected tag, operating mode, process values, equipment diagram and alarm summary render. |
| FR-25 | Provide generic equipment HMI for pumps/TCS/chemistry and infrastructure detail. | Type-specific points and status are used; no unrelated card is shown. |
| FR-26 | Provide In-Rack CDU and CRAH HMIs. | Selected rack/CRAH tag, thermal/hydronic/air-side points and mode render. |
| FR-27 | Provide Corridor Service and Battery ESS HMIs. | FWS/leak/cable tray and ESS system/unit details open from their tagged SVG elements. |
| FR-28 | Provide Component Detail modal. | Rack/infrastructure selection opens a title, type and diagram tied to the selected component. |
| FR-29 | Provide a right-side inspector for every equipment block, line and breaker (v2.2.0: two-tier — a single click opens the inspector, the deep HMI is an explicit second action). | Live, Capacity, Dependencies, Alarms, Trend and Maintenance tabs retain point quality and selected tag; every cell is registry-hooked or declared simulated; the modal opens only from "Open equipment HMI" / double-click, traps focus, closes on ESC and returns focus. |
| FR-30 | Provide alarm-first strips on every engineering panel except the owner-excluded dashboard. | Overall state, critical, warning, maintenance, comms, stale and last-update values share one evaluation. |
| FR-31 | Provide modal alarm summaries and BMS alarm lifecycle counters. | First modal read exposes NORMAL/WARNING/CRITICAL plus counts; BMS health uses the same rules. |
| FR-32 | Expose data mode and point quality. | body[data-rz-data-mode="simulated"] and RZTelemetryQuality never imply a field feed. |
| FR-33 | Bind basis values to DCAI_MODEL/DCAI_CALC. | IT, heat split, TCS flow, CDU count, current, transformer/UPS loading and PUE are stable on reload. |
| FR-34 | Allow bounded sensor-class jitter only. | Temperature/weather/occupancy/selected local instruments may move around documented setpoints; basis KPIs never move. |
| FR-35 | Provide basis drawers for all eight dashboard KPI families. | Formula, inputs, output, scope, denominator, source, mode and last update display. |
| FR-36 | Provide a full Basis-of-Design calculation-audit drawer and PDF export. | Content reads the locked engine at open time and closes via button/Escape/scrim with focus return. |
| FR-37 | Provide Generate Design report and FAQ. | Report numbers come from the engine; FAQ identifies locked, simulated and non-procurement scope. |
| FR-38 | Provide modal focus management. | Open surfaces receive focus, trap Tab, close on Escape where specified and return focus to trigger. |
| FR-39 | Provide scroll-to-top and responsive layout behavior. | Control is named; page does not widen at 360 px; diagrams support fit/scroll/detail. |
| FR-40 | Keep safety and source actions simulated and non-authoritative. | No UI action invokes a network command or claims a real interlock. |
| FR-41 | Provide an operator alarm-query workspace. | Date/time range, point/tag, system, severity, lifecycle, quality, numeric comparator/value, state transition, event/action/text, and saved-view filters combine deterministically; reset restores the unfiltered fixture. |
| FR-42 | Provide first-out analysis, record evidence and CSV export. | First-out returns the earliest event per incident, a selected row exposes its full evidence, and CSV exports the filtered set with metadata rather than an unrelated global list. |
| FR-43 | Drive electrical animation from semantic topology truth. | Normal, source loss, busway trip and rack-feed failure scenarios compute served/2N/degraded/lost rack counts; energized paths animate and de-energized paths remain visibly inactive without color-only meaning. |
| FR-44 | Provide a zoned fire cause-and-effect matrix. | Initiating event, zone, output, command authority, feedback and inhibition are explicit; FACP owns fire commands while BMS/DCIM is monitor-only. |
| FR-45 | Provide a fire workstation whose home is a point list (v2.3.0, Track A §A6). | Every addressable fire, suppression, leak, EPO and FACP point of the selected hall renders with type, zone, detection means, state, isolation and last test; sub-tabs points / zones / mimic / cause & effect are scoped and keyboard-operable. |
| FR-46 | Provide a rule-bound isolation register (training, this browser). | Life-safety points are never isolable; FACP in alarm refuses; owner, reason ≥ 10 characters and expiry are required; a zone below two independent detection means is IMPAIRED with release inhibited and a fire watch; expired isolations stay flagged; every act is an alarm-query record in the Alarms workspace. |
| FR-47 | Overlay fire, leak and impairment state on every tab. | A page-wide banner above the tab bar shows the stage, impaired zones, fire watch and expired isolations; the alarm strips and the sidebar count the same register. |
| FR-48 | Run the cause-and-effect matrix against time and the register. | A staged training run advances elapsed seconds with the sim tick; rows read DUE / PENDING / BLOCKED; an impaired zone blocks the release path; nothing leaves the page. |
| FR-45 | Show the adopted rack-density baseline beside a retired reference on its own geometry. | Adopted baseline is 880 racks/hall at 142 kW/rack (one rack = one NVLink domain); the retired reference sits on its own smaller hall footprint (see Manual §02) and never mutates DCAI_MODEL. |
| FR-46 | Use the shared Design Studio for controlled document generation. | The dialog captures one current engine snapshot, supports only page-approved document types/scopes, labels current versus current-plus-study, traps focus, closes on Escape, and returns focus to Generate Design. |
05 Data model & telemetry points
A row may represent a generated point family when the UI creates many tagged instances. That family plus its identifier range is the exhaustive point contract.
| Signal | Symbol / ID | Unit | Nominal / alarm semantics | Source binding |
|---|---|---|---|---|
| Hall/rack inventory | DHE.halls, compute.racks_per_hall | count | 4 halls / 880 NVL72 racks per hall (one rack = one NVLink domain). | DCAI_MODEL.facility, DCAI_CALC.snapshot. |
| GPU / CPU inventory | gpuPerFacility, cpuPerHall | count | 253,440 GPU facility; 31,680 Grace CPU/hall (126,720 facility). | DCAI_MODEL.facility. |
| IT load | sPit, dkIt, kIT, dcIT | kW / MW | Rack IT 124,960 kW/hall (499.84 MW facility); total IT 134,763.2 kW/hall (539.05 MW facility, the PUE denominator). | DCAI_CALC.snapshot. |
| Rack power | sPerNVL, DHE.kwPerRack | kW | 142 kW/rack — one rack IS one NVLink domain, no split. | DCAI_MODEL.equipment. |
| Non-IT / facility per hall | sMechAux, sTotal | kW | ~22,259 non-IT / ~157,022 facility per hall derived. | design.electrical, facility_kwe. |
| PUE | dkPue, kP, dcPUE | ratio | 1.165 design-day / 1.158 annual / 1.250 worst-bin derived; 1.12–1.25 is target band only. | DCAI_CALC.snapshot.pue. |
| WUE | dkWue, dcWUE | L/kWh IT | 0.00 for the declared dry-only, warm-TCS baseline. | DHE.wue / dcai-model.js thermal basis. |
| CUE | dkCue, dcCUE | kgCO₂/kWh IT | 0.69 grid factor × derived PUE ≈0.80. | updateDashKPI() and cited PLN Java factor. |
| Uptime | dashboard Uptime KPI | % YTD | 99.99 placeholder; not event-log derived. | Static design placeholder. |
| Active alarms | dkAlm, alarm bars | count | 0 nominal; warning/critical from rules. | rules(); dashboard value is fixed zero. |
| Liquid / air heat | sDLC, sAir, liquidHeat, airHeat | kW | 106,216 / 35,509 per hall. | DCAI_CALC.snapshot.heat at 85% capture. |
| TCS temperatures | sTS, sTR, sDT, dkTcs, dkTcr | °C / K | 40/50/10 nominal (warm, dry-only) with bounded sensor jitter. | Model setpoints plus R(). |
| TCS flow | tcsFlowTotal | m³/h | 9,612.3 per hall. | DCAI_CALC.snapshot.design.flows.tcs_m3h. |
| CDU capacity/state | sCDU, dkCdu, cduSt1…6, data-cdu | count / kW / bar / m³/h | 107/108 per hall (CoolIT CHx1000, 1,000 kWth each); local instruments jitter. | Engine count + HMI simulator. |
| CRAH capacity/state | sCRAH, data-crah | count / kW / m³/s | 178 duty / 179 installed per hall; 200 kWth/unit design rating. | DCAI_CALC.snapshot. |
| Chiller | sCH, data-ch | count / COP / kW | 36 running design day / 142 worst bin / 143 installed; COP derived from a Carnot fraction (~5.50 air-path at design), never a nameplate. | Model equipment + HMI simulator. |
| Electrical current | reqCurrentA | A | 213.5 A per rack feed (dual-corded, ~106.7/cord); ~4,697 A per 22-rack RPP group at 400 V, PF 0.96. | DCAI_CALC.snapshot.distribution. |
| Transformer | txKVA, txLoadPct | kVA / % | ~654,257 kVA facility; 262 × 2.5 MVA transformers installed (33/hall/feed). | equipment.facility_kva. |
| UPS | sUA, sUB, upsLoadPct | kW / % | 1,250 kW/frame, 2N; 135 frames/hall/feed (1,080 total); ~79.9% loading. | equipment.ups_loading_pct and 2N display rule. |
| Busway | buswayA | A | 5,000 A busway trunk per RPP group; ~93.9% loaded. | DCAI_MODEL.equipment vs dashboard. |
| Generator | gensetModel, gensetKW, count fields | kW / count | 4 MW class MV diesel generator (generic — no specific model named); 169 duty + 2 standby = 171 installed (N+2). | Model + facility load division. |
| Rack / NVL72 component points | data-rack, data-ircdu, tray/component tag families | kW / °C / state | Selected tag-specific design and simulated health. | Generated rack renderers + engine constants. |
| Building/floor environment | H*r*s*t/h, C*r*s*t/h | °C / %RH | Hot/cold zone jitter within declared ranges. | upd() sensor simulation. |
| Occupancy/access | pplCount, lastEntry, dkPpl, dkEntry | count / time | 0–7 people and browser-time entry presentation. | Sensor-class jitter / browser clock. |
| Fire/safety device state | sbFire, sbSmoke, sbHeat, sbVesda, sbRope, sbDisabled, sbInAlarm, sbMaint | state / count | Normal baseline; some counts jitter as simulated sensors. | upd() and static basis. |
| Network fabric | NVLink/CX8/OOB and generated network tags | Gb/s / TB/s / % / state | 130 TB/s/rack NVLink domain, 800 Gb/s per CX-8 NIC (202.75 Pb/s aggregate facility), online baseline; detail values simulated. | Static vendor basis + network renderer. |
| Electrical line/breaker state | data-rz-line, data-rz-breaker, data-sld-click | state / V / A / kW / fault | Seven breaker states, line state, load-flow annotations. | SLD renderers, rz-breaker-symbols.js, inspector. |
| Battery ESS | data-bat, ESS HMI points | VDC / %SOC / kW / min / °C | 480 VDC system view; selected unit values simulated around design basis. | Battery renderer/HMI. |
| FWS instruments | fwsPI, fwsTI, fwsFM | bar / °C / m³/h | 1.8–2.4 bar, 11.5–12.5°C, 480–519 m³/h jitter. | upd(). |
| Alarm roll-up | .dh-alarmbar | state / count / age | Normal unless rule thresholds breach; maintenance 2, stale 0 nominal. | rules(), fmtState(), browser age. |
| Alarm event record | RZDataHallAlarmQuery | time / state / value / quality | Immutable simulated fixtures support lifecycle, first-out, filtering and export; no historian is implied. | js/datahall-ai/alarm-query.js. |
| Electrical scenario state | RZDatahallAIElectrical | served / 2N / degraded / lost | Scenario evaluation determines every path state and rack availability. | js/datahall-ai/electrical-topology.js. |
| Fire cause/effect state | RZDatahallAIFireCauseEffect | command / feedback / inhibition | Zoned simulated matrix; command authority remains FACP. | js/datahall-ai/fire-cause-effect.js. |
| Rack-density profile | RZDataHallRackDensity | rack count / kW/rack / MW/hall / kW/m² | Adopted GB300 baseline plus a read-only retired reference (see Manual §02). | js/datahall-ai/rack-density.js. |
| BMS services | bmsGwOnline, bmsAlmActive/Ack/Cleared | count / state | 16/16 gateways; alarm lifecycle roll-up. | Static service presentation + shared alarm rules. |
| Point quality / mode | RZTelemetryQuality, body[data-rz-data-mode] | quality / mode | Simulated; GOOD/STALE/ESTIMATED/MISSING contract where instrumented. | js/rz-telemetry-quality.js. |
06 Formulas & derivations
RackIT_hall = 880 racks × 142 kW/rack = 124,960 kWTotalIT_hall = 124,960 + 7,040 fabric + 264 OOB + 2,499.2 storage/mgmt = 134,763.2 kWTotalIT_facility = 4 × 134,763.2 = 539,052.8 kW (539.05 MW)Adopted basis. One rack IS one NVLink domain — no split-domain footprint. Source:
DCAI_CALC.snapshot.power and Manual §02–03.Q_liquid = RackIT × 0.85 = 106,216 kWQ_air = RackIT × 0.15 + fabric + OOB + storage/mgmt + UPS-loss + dist-loss + aux = 35,509 kWPer hall heat split; the air path also carries every electrical load that never enters the liquid loop, so it is not a naive 15% split.
Flow_TCS = Q_liquid × 3600 / (ρ × Cp × ΔT)= 9,612.3 m³/h per hall (38,449.2 m³/h facility)Source:
flowM3h(); water-property assumptions are explicit. TCS runs warm and dry-only (40/50°C).CDU_duty = ceil(106,216 / 1,000) = 107CDU_installed = 107 + 1 standby = 108/hall (432 facility)CRAH_duty = ceil(35,509 / 200) = 178; CRAH_installed = 179/hall (716 facility)Single-unit standby (N+1 per equipment family), not a block spare; redundancy proof must also consider distribution/common-mode constraints.
I_rackfeed = 142,000 / (√3 × 400 × 0.96) = 213.5 A (106.7 A/cord, dual-corded)I_group = 22 × 142,000 / (√3 × 400 × 0.96) = 4,697 A on a 5,000 A trunk (93.9% loaded)Source:
DCAI_CALC.snapshot.distribution.UPS loading = TotalIT_facility / (540 frames/feed × 1,250 kW) × 100 = 539,052.8 / 675,000 = 79.9%2N topology; each feed can independently carry the protected load.
Chiller COP = min(copMax, carnotFraction × Carnot(evapC, condC)) — derived, never a nameplateFacility_kWe = TotalIT + chillers 25,811 + fans 20,551 + pumps 14,824 + UPS-loss 19,551 + dist-loss 6,547 + aux 1,749 = 628,087 kWPUE_design = 628,087 / 539,053 = 1.165Bottom-up result shown honestly across the weather year (1.158 annual, 1.250 worst-bin); 1.12–1.25 remains a target band, not a forced result.
WUE = annual cooling makeup L / annual IT kWh = 0.00 L/kWhCUE_IT = grid factor × PUE = 0.69 × 1.165 ≈ 0.80 kgCO₂/kWh ITWUE is zero because the adopted TCS is warm and dry-only — no evaporative term exists. Grid factor is year/region sensitive and must be refreshed at source.
Gross IT density = 124,960 kW / (62 m × 31 m) = 65.0 kW/m²Hall volume = 62 × 31 × 5.5 = 10,571 m³Adopted geometry per hall. See Manual §02 "Retired basis" for the smaller, retired footprint kept only as a historical reference.
07 UX & interaction specification
| Interaction family | Required behavior | Accessibility / failure behavior |
|---|---|---|
| Primary / electrical tabs | Activate one matching panel; preserve locked model. | Keyboard operable, selected state exposed, no color-only indication. |
| Sidebar collapse | Widen diagram only on desktop; retain preference. | Labels update and reopen control stays reachable. |
| SVG equipment selection | Open the matching HMI/modal/inspector with selected tag and context. | Focusable host, accessible title, Escape close, focus return. |
| SLD mimic | Zoom/fit/print/results operate inside the overlay. | No page-level overflow; result text supplements color/animation. |
| KPI basis drawer | Show formula, inputs, output, scope, denominator, source, mode and timestamp. | Click/Enter/Space open; Escape/scrim/close button close. |
| BoD / report / FAQ | Use the same engine numbers and disclose simulated/non-procurement scope. | Popup failure reports a useful message; generated document escapes script-closing literals. |
| Alarm-first strips | Worst state and counts appear before diagram detail. | Text, count and semantic shape supplement color; motion never carries meaning alone. |
| Point quality | Inspector exposes source/quality/freshness when available. | Missing/stale points cannot remain visually GOOD. |
| Mobile 360 px | Header/tabs scroll or wrap internally; content stays within viewport. | PRD/Manual and close controls retain 44 px targets. |
| Reduced motion | Disable count-up, flow and pulse decoration. | Static state, labels and alarm text remain complete. |
| Alarm query | Compose filters, run/reset query, select a row, isolate first-out and export the filtered records. | Every input has a label; results use a contained scroll region; selected/detail state and errors are announced textually. |
| Electrical scenario | Recompute summary, timeline and path classes from one semantic result. | Health and served/degraded/lost counts supplement animated conductors; reduced-motion retains the state. |
| Fire cause/effect | Select an initiating event and zone, then highlight commanded outputs and expected feedback. | Authority, scope, command, feedback and inhibition remain readable in the table; no simulated click is represented as a field command. |
| Rack-density study | Compare the adopted baseline with the retired reference without changing the operating snapshot. | Baseline/reference labels, units and adoption status are visible; selection is presentation-only. |
| Design Studio | Choose an allowed document type and current/current-plus-study scope from one captured snapshot. | Accessible dialog semantics, focus trap, Escape, scrim, close, error feedback and focus return are mandatory. |
08 Acceptance criteria
| ID | Given / when / then | Evidence |
|---|---|---|
| AC-01 | Given a fresh load, then 880×142=124,960 kW rack IT/hall and four halls equal 499.84 MW; total IT (incl. fabric/OOB/storage) equals 539.05 MW facility. | Engine unit test plus DOM assertions. |
| AC-02 | Given the adopted basis, then liquid heat equals 85% of rack IT and air heat equals 15% of rack IT plus fabric/OOB/storage/UPS-loss/dist-loss/aux, and both sum back to total IT. | DCAI_CALC.snapshot identity. |
| AC-03 | Given 106,216 kW liquid heat per hall, 10 K ΔT and water properties, then TCS flow is 9,612.3 m³/h per hall. | Calculation test and rendered basis. |
| AC-04 | Given 1,000 kWth CDUs, then running count is 107 and the hall label reads 107/108. | Unit/DOM assertion. |
| AC-05 | Given 400 V and PF 0.96, then required current is approximately 4,697 A per 22-rack RPP group and 5,000 A is the busway trunk rating. | Engine test and electrical view. |
| AC-06 | Given 262 × 2.5 MVA transformers, then facility apparent power is ~654,257 kVA; given 1,080 × 1,250 kW 2N UPS frames, loading is ~79.9%. | Engine identities. |
| AC-07 | Given bottom-up losses across the weather year, then facility load is ~628,087 kW and PUE is 1.165 design-day / 1.158 annual / 1.250 worst-bin, not forced into target band. | DCAI_CALC.snapshot.pue test and basis drawer. |
| AC-08 | Given repeated reloads, then all basis KPIs are identical. | Multi-reload comparison. |
| AC-09 | Given sensor-class points, then jitter remains inside documented ranges and never mutates basis values. | Fake-random boundary tests. |
| AC-10 | Given each of nine primary tabs and five electrical sub-tabs, then the matching panel alone becomes active. | Puppeteer loop. |
| AC-11 | Given each equipment tag family, then selection opens the correct titled HMI/modal/inspector. | Representative E2E per family. |
| AC-12 | Given the SLD mimic, then Zoom In/Out/Fit/Print/Results/Close work without page error. | Interaction journey. |
| AC-13 | Given a basis KPI, then click and keyboard activation show matching formula/source and Escape returns focus. | Keyboard E2E. |
| AC-14 | Given every non-dashboard engineering panel, then an alarm strip appears before its diagram and shares counts with modal/BMS summaries. | DOM and rules-state assertions. |
| AC-15 | Given a point marked stale/missing, then quality presentation does not remain GOOD. | Quality-service fixture. |
| AC-16 | Given BoD, Generate Design and FAQ, then each opens, uses current engine values and closes accessibly. | Browser assertions and PDF text extraction. |
| AC-17 | Given 360 px width, then document width does not exceed viewport and critical controls remain reachable. | Responsive render measurement. |
| AC-18 | Given dark and light themes, then all major surfaces and semantic states remain readable. | Computed-style screenshots. |
| AC-19 | Given cockpit links, then exactly two anchor lines are added and no existing cockpit line is deleted. | git diff --unified=0. |
| AC-20 | Given the full representative journey, then no uncaught console or page error occurs. | Captured browser error stream. |
| AC-21 | Given mixed alarm fixtures, when any supported filter combination is applied, then only matching records render and first-out returns the earliest record per incident. | tools/test-datahall-ai-alarm-query.mjs plus browser query journey. |
| AC-22 | Given a filtered alarm result, when CSV is requested, then exported rows and provenance metadata match that result. | CSV content assertion. |
| AC-23 | Given each electrical scenario, then served/2N/degraded/lost totals reconcile to 880 racks per hall and visual path classes match semantic state. | tools/test-datahall-ai-electrical-topology.mjs plus DOM assertions. |
| AC-24 | Given a fire event and zone, then only the matrix outputs in scope are selected, FACP remains command authority, and BMS/DCIM remains monitor-only. | tools/test-datahall-ai-fire-cause-effect.mjs plus matrix interaction. |
| AC-25 | Given the adopted and retired profiles, then the adopted baseline remains 880×142 kW = 124,960 kW/hall = 65.0 kW/m², and the retired reference (its own smaller geometry) cannot alter that baseline. | tools/test-datahall-ai-rack-density.mjs. |
| AC-26 | Given Generate Design, then current scope contains the current snapshot only; current-plus-study adds a clearly labeled non-adopted study without mutating that snapshot. | tools/test-rz-design-studio.mjs plus dialog/PDF text and focus-return E2E. |
09 Non-functional requirements
Performance
- Initial useful dashboard within 3 s on a mid-tier desktop with local assets.
- Four-second telemetry loops and SVG redraws must not leak timers/listeners.
- Large SLDs maintain responsive pan/zoom; hidden panels avoid unnecessary paint.
Accessibility
- WCAG 2.2 AA target, 44 px mobile actions and visible amber focus.
- Modal focus trap/return and keyboard selection for all clickable families.
- Status never relies on hue, pulse or tiny diagram text alone.
Reliability
- Engine absence fails loud and exposes unavailable quality.
- Basis, target, placeholder and sensor classes remain mechanically distinguishable.
- Generated reports use one engine snapshot.
Security / privacy
- Tier policy remains owned by shared auth/feature flags.
- Docs contain no access gate or secret.
- All rendering and simulator state remain local; no control request leaves the browser.
10 Provenance & sources
| Source | Governs | Binding / use |
|---|---|---|
datahallAI.html | Visible controls, tabs, SVG renderers, HMIs, alarm/UI state and reports. | Primary implementation source. |
js/dcai-model.js | Adopted GB300 authored-leaf constants, equipment ratings and target bands. | DCAI_MODEL. |
js/dcai-engine.js | Power, heat, flow, current, capacity and PUE pure functions. | DCAI_CALC. |
js/datahall-ai/*.js | Alarm query, rack-density comparison, semantic electrical topology, fire cause-and-effect and operator rendering. | Immutable operator contracts; never field control. |
js/rz-design-studio.js | Shared current/current-plus-study document selection, snapshot/provenance display and accessible dialog lifecycle. | Generate Design controller shared with Conventional DC. |
| AI Data Hall Manual | Formula definitions, worked examples, source mapping and operational interpretation. | Public methodology companion. |
data/dcai-parameters.json (spec gb300-500mw-2026-09-06) | Adopted basis: 4×880 NVL72 racks, 142 kW/rack, 85% liquid capture, 40/50°C warm dry-only TCS. | Single basis authority. |
| plan cheerful-cuddling-mitten.md (owner decisions, 2026-09-05/06) | Campus IT target, rack platform selection, cooling-basis decision, retirement of the prior split-domain pair (see risk register). | Requirements/risks. |
| NVIDIA Enterprise Reference Architecture components | 72 GPUs, 36 Grace CPUs, 18 NVSwitch and liquid-cooled rack-scale hardware context at 142 kW/rack. | Adopted GB300 baseline provenance. |
| ASHRAE TC 9.9 | Thermal/environment context for data-processing equipment. | Temperature interpretation, not a site-approved alarm setpoint. |
| ISO/IEC 30134-2, 30134-8 and 30134-9 | PUE, CUE and WUE denominator/reporting definitions respectively. | KPI formulas and scope labels. |
| IEC 60364, IEC 60909, IEEE C37.2, IEEE 1584 / NFPA 70E | Electrical design, fault/protection nomenclature and safety context. | SLD reference boundary; not all calculations implemented. |
| NFPA 75/76 and ISO 14520 / NFPA 2001 | IT-equipment fire protection and clean-agent context. | Fire view; compliance proof remains out of scope. |
| ISA-18 alarm-management series and ISA-5.1 | Alarm lifecycle, first-out/operator workflow and instrumentation naming. | Alarm-state/point taxonomy direction; implementation is a simulated fixture. |
| IEC 62682:2022 | Management of alarms for process industries. | Lifecycle/query terminology and acceptance context, not a certification claim. |
11 Open questions & risks
| Risk / open question | Current evidence | Required resolution |
|---|---|---|
| Dashboard must not carry stale static capacity labels. | Any dashboard card showing a busway/generator figure must match the adopted 5,000 A trunk / 4 MW-class generator basis, not a retired figure. | Bind or explicitly label legacy/context values; never let two values claim the same basis. |
| Not every “live” point is engine-bound. | Temperature, RH, occupancy, detector/maintenance counts and HMI instruments use random jitter. | Maintain an explicit sensor-class registry with ranges, quality and timestamps. |
| Uptime is a placeholder. | 99.99% is not derived from event history. | Bind to a dated outage ledger or relabel as design intent. |
| Alarm count/lifecycle is partly synthetic. | Dashboard alarms are fixed zero; engineering-panel rules use quiet jitter; BMS “cleared” maps maintenance count. | Create one event source with active/ack/cleared/shelved timestamps and deterministic fixtures. |
| Target PUE and derived PUE differ at the worst bin. | Derived worst-bin PUE 1.250 exceeds the 1.12–1.25 target band; design-day 1.165 and annual 1.158 sit inside it. | Keep both labels and model the efficiency interventions required; do not back-solve the chiller COP. |
| WUE 0.00 is topology-dependent. | Valid only for the warm, dry-only TCS baseline (40/50°C, no evaporative term). | If adiabatic/evaporative operation appears anywhere, bind makeup flow and recompute WUE. |
| Grid factor is time-sensitive. | 0.69 kgCO₂/kWh is cited as PLN Java 2025. | Store publication/version and refresh cadence; distinguish location/market basis. |
| Equipment/vendor ratings remain mixed with teaching abstractions. | Some HMIs and generated reports show detailed nameplates not all backed by one schedule. | Maintain a source register per tag/model and mark illustrative values. |
| Fire-agent compliance is not calculated. | Protected volume exists, but concentration, agent density, hold time and leakage inputs are incomplete. | Do not present compliance until a sourced calculation and test method exist. |
| Monolithic page height increases regression risk. | datahallAI.html exceeds 13,000 lines with many timers/renderers. | Future modularization must preserve frozen output and be separately test-driven. |
| Gate fallback and public-doc boundary need ongoing verification. | Cockpit reads local session as a load-order fallback; docs must remain ungated. | Test each tier plus direct public doc navigation without changing auth code in this batch. |
| Mobile is an overview, not a full commissioning workstation. | Dense SVGs and HMIs are desktop-oriented. | Define minimum usable tasks on mobile and keep deep engineering interaction on supported larger viewports. |
| Retired basis (GB200) — historical, not current. | This PRD was originally written against a GB200 NVL72 split-domain basis-of-design (BASELINE-DECISION.md, locked 2026-05-17): 27 NVL72 domains per hall, 2 rack-positions per domain at 66 kW each = 132 kW per domain, 54 rack-positions per hall, 14.256 MW IT per facility (Scenario A), CDU sized at 350 kW end-of-row units, and a nameplate chiller COP of 6.8. That basis was retired 2026-09-06 by owner decision (plan cheerful-cuddling-mitten.md) in favour of the adopted GB300 NVL72 basis used throughout this document — one rack IS one NVLink domain at 142 kW/rack. The retired files, js/datahall-model.js and js/datahall-calculations.js, remain on disk byte-frozen and still pass their own 57 worked-example tests (tools/test-datahall-calc.mjs) as the retirement record. This row is the only place in this document where the retired GB200 figures appear. | Historical record only; the rack-density comparison keeps the retired reference on its own geometry and it cannot alter the adopted baseline. |
| Alarm records and cause/effect are simulated. | The workspace uses immutable browser fixtures and no FACP/historian connection. | Do not treat an acknowledgement, command or export as a site record; production integration requires governed interfaces and independent validation. |