[OpenSpec] operations-sync-status-and-progress #1128

⚠️ OpenSpec-managed issue — this content is automatically synced
from the openspec/ directory. Manual edits will be overwritten on next sync.

Artifacts

• ✅ Metadata
• ✅ Proposal
• ✅ Specs
• ✅ Design
• ✅ Tasks
• 🔲 Plan
• 🔲 Review

Summary

Stackiq synchronises organisations, contact persons and users every five minutes. Only a Nextcloud admin can see that it happens, in admin settings, and even they see the last run time and a spinner, never how far a running sync is. The functional administrator of the catalogue, who answers "why is our new colleague not in the catalogue yet", sees nothing. This change records the progress of a synchronisation where any request can read it, keeps the result of the last run, makes the schedule's on and off switch real, and adds a Synchronisation page under Organisations for the Nextcloud admin and the functional administrator.

Specs

• 📄 sync-status-and-progress

Tasks

• Implement
• Test (PHPUnit tests/Unit/Service/ProgressTrackerTest.php and tests/Unit/Controller/SettingsControllerProgressTest.php)
• Implement
• Test (PHPUnit tests/Unit/Service/OrganizationSyncServiceTest.php)
• Implement
• Test (PHPUnit tests/Unit/BackgroundJob/OrganizationContactSyncJobTest.php)
• Implement
• Test (PHPUnit tests/Unit/Controller/SyncStatusControllerTest.php)
• Implement
• Test (vitest tests/vitest/syncStatusView.spec.js and Playwright tests/e2e/spec-coverage/sync-status.spec.ts)
• Implement
• Test (docs build and a manual read against the running app)

Design

See design.md for technical design details.

Synced from openspec/changes/operations-sync-status-and-progress by OpenSpec workflow
App: stackiq