Facility Management~

The /geo/facility page is where you perform 3D modeling, engineering calculations, sensor/actuator binding, and commissioning for buildings such as greenhouses, growing houses, and equipment rooms.

Screen Layout~

┌─────────────────────────────────────┐
│  Facility selector dropdown          │
├───────────────┬─────────────────────┤
│  A. 3D View   │  B. Environment     │
│  (Three.js)   │  Indoor: T/RH/CO₂  │
│               │  Outdoor: T/Wind/PAR│
├───────────────┴─────────────────────┤
│  C. AI Advice panel                  │
├─────────────────────────────────────┤
│  D. Settings (envelope/sensors/act.)│
└─────────────────────────────────────┘

Facility Registration Flow~

Draw Facility polygon in /geo/design (Facility mode)
         ↓
    Save facility name
         ↓
Select facility in /geo/facility
         ↓
  Configure envelope → Verify 3D preview
         ↓
  Bind sensors & actuators
         ↓
  Run commissioning

Envelope Configuration~

Set the physical structure of the building. These values are used as inputs for heating/cooling load calculations.

Structure Type~

Covering Materials~

Bay Configuration~

Enter the dimensions of each bay (structural unit) of the greenhouse.

• Bay count: Number of spans (for multi-span)
• Bay width (m): Width of each span
• Length (m): Length of the structure
• Eave height (m): Height from ground to eave
• Ridge height (m): Height from eave to ridge

3D Preview~

Once envelope settings are saved, a Three.js-rendered building model is displayed in the A. 3D View panel.

• Left mouse drag: Rotate
• Right mouse drag: Pan
• Scroll: Zoom

3D Asset Mode~

Instead of automatic parametric generation, you can apply a custom GLTF model.

1. Upload a GLTF file at /geo/model-assets.
2. Switch the facility's Render Mode → Asset.
3. Select the model from the asset library and adjust position, rotation, and scale.

Engineering Calculations~

Calculates first-order reference values for heating/cooling and ventilation capacity based on the building envelope (±5–10% margin; for equipment estimation purposes only).

Click Compute to calculate:

Natural Ventilation Wind Pressure Simulation~

The /api/geo/facility/<uuid>/wind endpoint accepts building geometry plus wind direction/speed and simulates ventilation performance.

Sensor & Actuator Binding~

Connect AoT devices to their roles within the facility.

Sensor Roles~

Actuator Roles~

How to register:

1. In the Sensors tab, click + Add Sensor.
2. Select a role → Select an AoT Input device → Select the measurement channel.
3. Repeat for the Actuators tab.
4. Click Save.

Integration View~

The /api/geo/facility/<uuid>/integration endpoint returns the current state of all sensors and actuators bound to a facility in a unified response. The AoT_facility widget's environment panel uses this API.

Commissioning~

A diagnostic workflow to verify that facility devices are communicating properly.

1. In the Commissioning tab, click Start Check.
2. The system sends communication requests to all registered sensors and actuators.
3. The response status for each device is displayed:
4. OK: Normal communication
5. TIMEOUT: No response (check wiring and power)
6. ERROR: Error response (check device configuration)
7. Use the Verdict button to approve or hold individual results.

AI Advice Panel~

The AI analyzes bound sensor data to suggest anomaly alerts or operational improvements.

• Urgency colors: Red (immediate action) / Orange (caution) / Green (normal)
• Advice accuracy improves as more learning data accumulates.

Related API~

Related Pages~

• Design Tool — Drawing facility polygons
• Facility Widget — Dashboard 3D widget
• API Reference