[hiobjan]

…w of apps from circles to the apps

• Resolves: Show resources embedded in the Teams app #2944
• Depends on feat: added ITeamAppProvider and associated DTOs server#65965

Summary

With this approach the creation and view of the apps, that belong to a team is shifted from the circles app to the integrated app.

Flow

1. Register the App

Each app registers its ITeamAppProvider implementation through:
$context->registerTeamAppProvider(TeamsProvider::class);

TeamAppProviderRegistry discovers enabled providers, checks their identity, and obtains their order, compatibility routes, and optional browser-module URL.

2. Initialize the Teams Page

PageController.php publishes those descriptors as initial state.
The frontend registry creates a host-side adapter for each provider. It also imports and validates the optional mount-only module.

3. Load a Team’s Navigation

After membership loads, TeamPage loads the team’s resources and calls the app store.
For each provider, the host requests:
GET /ocs/v2.php/apps/circles/teams/{teamId}/apps/{providerId}/navigation

The response contains entries, actions, and represented resource keys, not resource content.

4. Build the Sidebar

The app store validates and namespaces entries as providerId:entryId.
TeamNavigation displays them. Resource keys prevent the same resource appearing again in the generic shared-resource list.

5. Open the Resource

Entry has href: navigate to the owning app. Deck and Collectives render and authorize the resource there.
Entry has no href: navigate to /team/{teamId}/app/{providerId}/{entryId}, rendered by TeamAppView.

6. Clean Up

Changing entries destroys the previous view. Leaving the team aborts its context and requests. A late-finishing mount is immediately cleaned up.

Selection Is Separate

/navigation/selection stores the resource IDs chosen for navigation.

Implementations

• Deck

TODO

• Migrate existing resources
• ...

Checklist

• Code is properly formatted
• Sign-off message is added to all commits
• Tests (unit, integration, api and/or acceptance) are included
• Screenshots before/after for front-end changes
• Documentation (manuals or wiki) has been updated or is not required
• Backports requested where applicable (ex: critical bugfixes)
• Labels added where applicable (ex: bug/enhancement, 3. to review, feature component)
• Milestone added for target branch/version (ex: 32.x for stable32)

AI (if applicable)

• The content of this PR was partly or fully generated using AI

[codecov]

Codecov Report

❌ Patch coverage is 83.50515% with 48 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/teams/integrations/store.ts	80.99%	13 Missing and 10 partials ⚠️
src/teams/integrations/prompt.ts	6.25%	15 Missing ⚠️
src/teams/integrations/registry.ts	83.78%	4 Missing and 2 partials ⚠️
src/teams/components/TeamAppResourcePicker.vue	90.90%	1 Missing and 2 partials ⚠️
src/teams/views/TeamAppView.vue	97.50%	0 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!