feat(inventory): Map network port metrics and logical_number for computer assets

[eduardomozart]

Checklist before requesting a review

Please delete options that are not relevant.

• I have read the CONTRIBUTING document.
• I have performed a self-review of my code.
• I have added tests that prove my fix is effective or that my feature works.
• This change requires a documentation update.

Description

Closes #24509

Note

(There is an ongoing discussion about this feature at #24509)

This PR introduces server-side support for mapping network port statistics and interface metrics to computer assets during inventory. Vital interface statistics like the Number of I/O bytes (ifinbytes, ifoutbytes, ifinerrors, ifouterrors) and the Port Number (logical_number / ifnumber) are now correctly extracted from the payload and mapped to the respective NetworkCard and NetworkPort records.

This brings host-level network monitoring parity to computer assets. While metrics are traditionally associated with network equipment (like manageable switches), capturing them at the computer/host level provides direct insight into the actual traffic processed by the server's or workstation's OS, regardless of the upstream network topology. This mapping does not conflict with or affect switch metrics. Computer network ports and switch network ports remain separate entities in the database, meaning each retains its own independent telemetry data.

Key Under-the-Hood Changes:

• Processes network_ports data from the inventory payload and links it to NetworkCard entries by matching MAC addresses and interface names.
• Correctly maps ifnumber to the interface's logical_number.
• Validates network port data and refactors NetworkCard port handling for simplicity and accuracy.
• Fixes typing, method guards, and updates PHPStan baselines accordingly.

Warning

Dependency & Compatibility Notice

1. Agent Requirement: For this feature to work, the GLPI-Agent must be patched to collect and send these statistics. See the companion PR: glpi-project/glpi-agent#1184.

2. Backward Compatibility Warning: Although sending NETWORK_PORTS for computers is technically valid according to the inventory schema, older versions of GLPI do not expect this data for non-NetworkEquipment assets. If an updated agent sends this payload to an older GLPI server, it will trigger a fatal error:

ERROR: 500 Internal Server Error, Call to undefined method Glpi\Inventory\MainAsset\Computer::getManagementPorts()

(A similar error also occurs with isStackedSwitch()).

Because of this, the GLPI-Agent must perform a version check against GLPI to ensure it only transmits the NETWORK_PORTS payload to compatible GLPI instances (such as the version containing this PR).

How to test:

1. Run an inventory using a GLPI-Agent patched with PR #1184.
2. Go to Assets > Computers > [Your Computer] > Network ports.
3. Ensure the "Port number" and I/O metrics columns (such as "Bytes received", "Bytes sent") are visible and accurately populated.
4. Verify that the speed is correctly displayed in "Mbps" or "Gbps" and matches the expected hardware speed.
5. Verify that the telemetry data reflects the agent's natively reported values.

[trasher]

Will wait for Agent PR.

[trasher]

Back to draft since agent change has not been validated