feat: add power details to hardware device types

Added power details so that we can compute expected power consumption to
our hardware device type definitions.

Author: cardoe

docs/design-guide/device-types.md

@@ -45,6 +45,10 @@ Device types may include:
     * `name`: Interface identifier (e.g., "iDRAC", "eth0", "mgmt")
     * `type`: Physical interface type (e.g., "1000base-t", "10gbase-x-sfp+")
     * `mgmt_only`: Boolean flag indicating management-only interfaces
+* **power-ports**: Power inlet specifications for the device. Each power port has:
+    * `name`: Power port identifier (e.g., "psu1", "psu2")
+    * `type`: Power port connector type (e.g., "iec-60320-c14", "iec-60320-c20") - see [Nautobot PowerPortTypeChoices](https://github.com/nautobot/nautobot/blob/develop/nautobot/dcim/choices.py#L507) for valid values
+    * `maximum_draw`: Maximum power draw in watts (optional)
 * **resource_class**: Array of resource class configurations (required for
   `class: server`)
 
@@ -89,6 +93,15 @@ interfaces:
     type: 1000base-t
     mgmt_only: true
 
+# Power inlet specifications
+power-ports:
+  - name: psu1
+    type: iec-60320-c14
+    maximum_draw: 750
+  - name: psu2
+    type: iec-60320-c14
+    maximum_draw: 750
+
 resource_class:
   - name: m1.small
     cpu:

docs/operator-guide/device-types.md

@@ -69,6 +69,36 @@ interfaces:
 **Note**: General-purpose network ports for workload traffic are specified
 using `nic_count` in the resource class definition, not here.
 
+### 3a. Add Power Ports (Optional)
+
+Define power inlet specifications for accurate power capacity planning and
+monitoring:
+
+```yaml
+power-ports:
+  - name: psu1
+    type: iec-60320-c14
+    maximum_draw: 750
+  - name: psu2
+    type: iec-60320-c14
+    maximum_draw: 750
+```
+
+Each power port specification includes:
+
+* `name`: Power supply identifier (e.g., "psu1", "psu2", "PSU-A")
+* `type`: Power connector type - see [Nautobot PowerPortTypeChoices](https://github.com/nautobot/nautobot/blob/develop/nautobot/dcim/choices.py#L507) for valid values (e.g., "iec-60320-c14", "iec-60320-c20")
+* `maximum_draw`: Maximum power draw in watts (optional)
+
+Common power port types:
+
+* `iec-60320-c14`: Standard 15A power inlet (most common for servers)
+* `iec-60320-c20`: High-current 20A power inlet (used for high-power servers)
+* `iec-60309-p-n-e-6h`: Industrial 3-phase power connectors
+
+**Note**: Power port information helps with capacity planning and can be
+synchronized to Nautobot for power feed calculations.
+
 ### 4. Define Resource Classes
 
 For server-class devices, specify one or more resource class configurations.
@@ -402,6 +432,14 @@ interfaces:
   - name: NIC2
     type: 10gbase-x-sfp+
 
+power-ports:
+  - name: psu1
+    type: iec-60320-c14
+    maximum_draw: 800
+  - name: psu2
+    type: iec-60320-c14
+    maximum_draw: 800
+
 resource_class:
   - name: compute-standard
     cpu:
@@ -435,6 +473,14 @@ interfaces:
   - name: Ethernet1/2
     type: 100gbase-x-qsfp28
   # ... additional 34 100G QSFP28 ports
+
+power-ports:
+  - name: ps1
+    type: iec-60320-c14
+    maximum_draw: 450
+  - name: ps2
+    type: iec-60320-c14
+    maximum_draw: 450
 ```
 
 ### Firewall Device Type
@@ -460,4 +506,12 @@ interfaces:
   - name: ethernet1/5
     type: 10gbase-x-sfp+
   # ... additional data plane interfaces
+
+power-ports:
+  - name: psu1
+    type: iec-60320-c20
+    maximum_draw: 1440
+  - name: psu2
+    type: iec-60320-c20
+    maximum_draw: 1440
 ```

schema/device-type.schema.json

@@ -109,6 +109,29 @@
                 },
                 "required": ["name", "type"]
             }
+        },
+        "power-ports": {
+            "description": "Power ports",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "description": "Power port",
+                "properties": {
+                    "name": {
+                        "type": "string",
+                        "description": "Power port name"
+                    },
+                    "type": {
+                        "type": "string",
+                        "description": "Power port type (valid Nautobot power port type, see https://github.com/nautobot/nautobot/blob/develop/nautobot/dcim/choices.py#L507)"
+                    },
+                    "maximum_draw": {
+                        "type": "integer",
+                        "description": "Maximum power draw in watts"
+                    }
+                },
+                "required": ["name", "type"]
+            }
         }
     },
     "required": [ "class", "manufacturer", "model", "u_height", "is_full_depth" ]