feat: show recent people on contact icon

[kristian-zendato]

• Resolves: Make People menu more inviting #60304

Summary

Makes the People (contacts) header menu more inviting by showing a stack of up to 3 overlapping avatars of recent contacts on the menu trigger, instead of only the contacts icon.

• Adds GET /contactsmenu/preview-avatars which returns the first 3 entries from the same unfiltered contacts list as the menu (Manager::getEntries with an empty filter), with optional team filtering matching the existing index endpoint.
• Frontend loads those contacts on mount and shows an NcAvatar stack when at least 2 are available; otherwise keeps the existing contacts icon.
• Widens the header trigger (width: fit-content) so the stack does not overlap notifications/profile and remains fully clickable.
• Adds PHP and Vue unit tests for the new endpoint and trigger behavior.

Screenshot

🏚️ Before

🏡 After

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

[kristian-zendato]

@SebastianKrupinski I created another branch for your comment.
Can you check it again please?

[susnux]

otherwise good

[susnux]

Suggested change

	private const PREVIEW_AVATARS_LIMIT = 3;
	private const PREVIEW_AVATARS_CACHE_TTL = 300;
	private const int PREVIEW_AVATARS_LIMIT = 3;
	private const int PREVIEW_AVATARS_CACHE_TTL = 300;

[jancborchardt]

It’s good for all contacts:

But for teams of which members are not in the global "top 3 interacted with", it doesn’t show their avatars:

[jancborchardt]

Also @kristian-zendato @susnux we could consider the Teams support for it a follow-up as well. Not a strict blocker

[jancborchardt]

Blocking this for now after some concern shared by @schiessle and @karlitschek in the Files planning call about this looking too much like what collaborative editors like MS Office (and we) do.

As a result it might seem like other people are in your files, which is of course not the case and an impression we do not want to create under any circumstances.

Any alternative ideas regarding this? Otherwise it would be ok to skip or postpone this item.

[kra-mo]

Just leaving a note that there are ideas for an alternative design, something like this:

But we'll see next cycle.

[github-actions]

Hello there,
Thank you so much for taking the time and effort to create a pull request to our Nextcloud project.

We hope that the review process is going smooth and is helpful for you. We want to ensure your pull request is reviewed to your satisfaction. If you have a moment, our community management team would very much appreciate your feedback on your experience with this PR review process.

Your feedback is valuable to us as we continuously strive to improve our community developer experience. Please take a moment to complete our short survey by clicking on the following link: https://cloud.nextcloud.com/apps/forms/s/i9Ago4EQRZ7TWxjfmeEpPkf6

Thank you for contributing to Nextcloud and we hope to hear from you soon!

(If you believe you should not receive this message, you can add yourself to the blocklist.)