Concepts

Database Schema Overview

Download PDF

The IDN platform is built on a deeply normalized relational schema designed for Computer-Aided Facilities Management (CAFM). It models every operational entity a facilities organization touches — from portfolios and buildings down to individual work order line items.

333
Database Tables
12+
Functional Modules
8
Core Entity Types
5
Reporting Horizons

Three layers

The schema is organized in three conceptual layers:

  1. Modules — functional domains such as Portfolio, Work, Equipment, or EHS. A module is a grouping, not a database object; it determines which tables belong together.
  2. Tables — the entities themselves (e.g. building,work_order, asset). 333 tables in total.
  3. Fields — typed columns on each table. 12,000+ across the system, with consistent naming, validation, and relationship conventions.

The 12 modules

Every table belongs to exactly one module. Here is the full list:

Why normalization matters

A normalized model is more verbose than a flat one, but it is what enables the things FM teams actually need in 2026:

  • Reliable analytics — every metric has one source of truth.
  • Predictive maintenance — asset, work-order, and sensor history are linked, not duplicated.
  • AI-native queries — the AI Assistant can reason over a clean graph instead of guessing across spreadsheets.
  • Compliance — EHS, audit, and document trails stay attached to the entities they describe.
Naming conventions
Tables and fields use snake_case. Foreign keys end in _code. Lookup tables are singular (building, not buildings). Date fields use _at for timestamps and _on for date-only values.

Where to go next