Floor Plan Management¶
Module: Floor Plan Management | Audience: Admin, Owner
Table of Contents¶
- Overview
- Floor Plan List
- Uploading a Floor Plan
- Viewing a Floor Plan
- Interactive Editor
- Asset Positioning
- Mislocation Detection
- Master Data Used by This Module
Overview¶
Floor plans provide a visual representation of physical spaces where assets are located. The module supports uploading floor plan images, placing assets on the plan, drawing RFID detection zones, and detecting asset mislocations through RFID integration.
Floor Plan List¶
Path: Sidebar → Floor Plan Management → Floor Plans | URL: /floor-plans
Paginated list of all floor plans with name, location, creation date, and preview thumbnail.
Uploading a Floor Plan¶
Path: Floor Plans → + Upload
| Field | Type | Required | Validation | Depends On |
|---|---|---|---|---|
| Name | Text | Yes | Max 255 characters; unique per location | — |
| Description | Text Area | No | — | — |
| Location | Dropdown | No | — | Locations |
| Floor Plan Image | File Upload | Yes | Image file (JPG, PNG, SVG, etc.) | — |
After upload: 1. The system stores the original document. 2. A preview image is generated. 3. Tiles are generated at multiple zoom levels for interactive navigation.
Uniqueness: The (Name, Location) combination must be unique.
Viewing a Floor Plan¶
Path: Floor Plans → Click a floor plan | URL: /floor-plans/:id
The view page shows: - Floor plan image with zoom and pan controls - Metadata (name, location, dimensions) - List of positioned assets - Edit and delete actions
Interactive Editor¶
Path: Sidebar → Floor Plan Management → Interactive Editor | URL: /interactive-editor
The interactive editor provides a full-featured workspace for floor plan management:
| Feature | Description |
|---|---|
| Pan & Zoom | Navigate large floor plans with mouse drag and scroll wheel |
| Tile-Based Rendering | Floor plans render as tiles for performance at any zoom level |
| Asset Placement | Drag and drop assets onto specific positions on the floor plan |
| Detection Zones | Draw polygons to define RFID reader detection areas |
| Real-Time Status | Asset icons show current status with color indicators |
| Filters | Filter visible assets by category, status, or condition |
| Metadata Editing | Edit floor plan properties inline |
Asset Positioning¶
Path: Interactive Editor → Select a floor plan | URL: /interactive-editor/:id
To position an asset on a floor plan:
- Open the floor plan in the interactive editor.
- Search for the asset in the asset panel.
- Drag the asset onto the desired position on the floor plan.
- Save the position.
Positioned assets appear as icons on the floor plan with: - Asset name and tag on hover - Color coding by status or condition - Click to view full asset details
Mislocation Detection¶
The mislocation dashboard (within the interactive editor) shows assets detected outside their expected zone:
| Data Point | Description |
|---|---|
| Asset | The mislocated asset |
| Expected Zone | Where the asset should be (based on positioning) |
| Detected Location | Where the RFID reader detected the asset |
| Detection Time | When the mislocation was detected |
| Rule Violated | Which detection rule was triggered |
Mislocation detection requires: 1. Assets positioned on floor plans 2. RFID readers configured with detection zones 3. Detection rules defined (tolerance, threshold, grace period)
See RFID Management — Detection Rules for rule configuration.
Master Data Used by This Module¶
| Master Entity | Where Used | Purpose |
|---|---|---|
| Locations | Floor plan location field | Link floor plan to a physical location |
| Assets | Asset positioning | Place assets on floor plans |
| RFID Readers | Detection zones | Define reader coverage areas |
Related: RFID Management · Asset Management