ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
6aac45ce2e
TenantAtlas/specs/012-windows-update-rings/spec.md
ahmido 286d3c596b feat/012-windows-update-rings (#18) 
Created a safe session branch, committed everything, fast-forward merged back into feat/012-windows-update-rings, then pushed.
Commit: 074a656 feat(rings): update rings + update profiles
Push is done; upstream tracking is se

Co-authored-by: Ahmed Darrazi <ahmeddarrazi@adsmac.local>
Reviewed-on: #18
2026-01-01 10:44:17 +00:00

4.8 KiB
Raw Blame History

Feature Specification: Windows Update Rings (012)

Feature Branch: feat/012-windows-update-rings
Created: 2025-12-31
Status: Draft
Input: config/graph_contracts.php (windowsUpdateRing scope)

Overview

Add reliable coverage for Windows Update Rings (windowsUpdateRing) in the existing inventory/backup/version/restore flows.

This feature also extends coverage to Windows Feature Update Profiles ("Feature Updates"), which are managed under the deviceManagement/windowsFeatureUpdateProfiles endpoint and have @odata.type #microsoft.graph.windowsFeatureUpdateProfile.

This feature also extends coverage to Windows Quality Update Profiles ("Quality Updates"), which are managed under the deviceManagement/windowsQualityUpdateProfiles endpoint and have @odata.type #microsoft.graph.windowsQualityUpdateProfile.

This policy type is defined in graph_contracts.php and uses the deviceManagement/deviceConfigurations endpoint, identified by the @odata.type #microsoft.graph.windowsUpdateForBusinessConfiguration. This feature will focus on implementing the necessary UI normalization and ensuring the sync, backup, versioning, and restore flows function correctly for this policy type.

In Scope

  • Policy type: windowsUpdateRing

  • Sync: Policies with @odata.type of #microsoft.graph.windowsUpdateForBusinessConfiguration should be correctly identified and synced as windowsUpdateRing policies.

  • Snapshot capture: Full snapshot of all settings within a Windows Update Ring policy.

  • Restore: Restore a Windows Update Ring policy from a snapshot.

  • UI: Display the settings of a Windows Update Ring policy in a readable, normalized format.

  • Policy type: windowsFeatureUpdateProfile

  • Sync: Feature Update Profiles should be listed and synced from deviceManagement/windowsFeatureUpdateProfiles.

  • Snapshot capture: Full snapshot of the Feature Update Profile payload.

  • Restore: Restore a Feature Update Profile from a snapshot.

  • UI: Display the key settings of a Feature Update Profile in a readable, normalized format.

  • Policy type: windowsQualityUpdateProfile

  • Sync: Quality Update Profiles should be listed and synced from deviceManagement/windowsQualityUpdateProfiles.

  • Snapshot capture: Full snapshot of the Quality Update Profile payload.

  • Restore: Restore a Quality Update Profile from a snapshot.

  • UI: Display the key settings of a Quality Update Profile in a readable, normalized format.

Out of Scope (v1)

  • Advanced analytics or reporting on update compliance.
  • Per-setting partial restore.

User Scenarios & Testing (mandatory)

User Story 1 — Inventory + readable view

As an admin, I can see my Windows Update Ring policies in the policy list and view their configured settings in a clear, understandable format.

Acceptance

  1. Windows Update Ring policies are listed in the main policy table with the correct type name.
  2. The policy detail view shows a structured list/table of configured settings (e.g., "Quality update deferral period", "Automatic update behavior").
  3. Policy Versions store the snapshot and render the settings in the “Normalized settings” view.

User Story 2 — Backup/Version capture

As an admin, when I back up or create a new version of a Windows Update Ring policy, the snapshot contains all its settings.

Acceptance

  1. The backup/version payload in the snapshot column contains all the properties of the windowsUpdateForBusinessConfiguration object.

User Story 3 — Restore settings

As an admin, I can restore a Windows Update Ring policy from a backup or a previous version.

Acceptance

  1. The restore operation correctly applies the settings from the snapshot to the target policy in Intune.
  2. The restore process is audited.

User Story 4 — Feature Updates inventory + readable view

As an admin, I can see my Windows Feature Update Profiles in the policy list and view their configured rollout/version settings in a clear, understandable format.

Acceptance

  1. Feature Update Profiles are listed in the main policy table with the correct type name.
  2. The policy detail view shows a structured list/table of configured settings (e.g., feature update version, rollout window).
  3. Policy Versions store the snapshot and render the settings in the “Normalized settings” view.

User Story 5 — Quality Updates inventory + readable view

As an admin, I can see my Windows Quality Update Profiles in the policy list and view their configured release/content settings in a clear, understandable format.

Acceptance

  1. Quality Update Profiles are listed in the main policy table with the correct type name.
  2. The policy detail view shows a structured list/table of configured settings (e.g., release, deployable content).
  3. Policy Versions store the snapshot and render the settings in the “Normalized settings” view.