# Activiteitsfeed

De Activiteitsfeed is uw realtime stroom van alles wat er gebeurt in uw gebouwen op het Magma-platform. Het toont relevante gebeurtenissen, meldingen en actiepunten van alle gebouwen waarop u stakeholder bent, in één enkele, chronologische feed — zodat u nooit een belangrijke update mist.

***

## Toegang tot de Activiteitsfeed

De Activiteitsfeed is toegankelijk via het item **Activiteit** in de linkernavigatiebalk. Een **ongelezen badge** op het navigatie-item toont het aantal niet-geziene items.

***

## Feed-opmaak

De Activiteitsfeed is een verticaal gescrolde lijst van gebeurtenisitems. Bovenaan de pagina maakt een **gebouwcarrousel** het mogelijk de feed te filteren op een specifiek gebouw.

### Gebouwcarrousel

Een horizontale rij van gebouwminiaturen bovenaan de feed. Elke miniatuur vertegenwoordigt een gebouw met recente activiteit. Klikken op een miniatuur filtert de feed om alleen gebeurtenissen van dat gebouw te tonen. Klik opnieuw (of klik op "Alle gebouwen") om het filter te verwijderen.

Alleen gebouwen met recente activiteit worden weergegeven in de carrousel — gebouwen zonder recente gebeurtenissen worden niet weergegeven.

***

## Feed-items

Elk item in de Activiteitsfeed vertegenwoordigt een enkele gebeurtenis en bevat de volgende elementen:

| Element                  | Beschrijving                                                                              |
| ------------------------ | ----------------------------------------------------------------------------------------- |
| **Gebouwminiatuur**      | Een afbeelding van 56×56 px van het gebouw (omslagfoto). Klikken opent het gebouw.        |
| **Titel**                | Een beknopte titel die de gebeurtenis beschrijft (bijv. "Document vereist validatie").    |
| **Gebeurtenistypebadge** | Een gekleurde label die de categorie aangeeft: DOCUMENT, REMINDER of ANNOUNCEMENT.        |
| **Beschrijving**         | Een gedetailleerde beschrijving van wat er is gebeurd, inclusief contextuele informatie.  |
| **Relatief tijdstempel** | Hoe lang geleden de gebeurtenis heeft plaatsgevonden (bijv. "2 uur geleden", "Gisteren"). |
| **Actieknop**            | Een contextuele knop voor het nemen van de juiste actie als reactie op de gebeurtenis.    |

### Contextuele details in beschrijvingen

Beschrijvingen bevatten dynamische verwijzingen om gebeurtenissen onmiddellijk begrijpelijk te maken:

* **Naam van stakeholder** — Wie de actie heeft uitgevoerd (bijv. "Marie Dupont heeft een nieuw document geüpload").
* **Documentnaam** — De naam van het betreffende document.
* **Documentversie** — Het versienummer van het betrokken document.
* **Afwijzingsreden** — Als een document of record is afgewezen, wordt de afwijzingsreden inline in de beschrijving weergegeven.

***

## Gebeurtenistypen

Activiteitsfeed-items zijn gecategoriseerd in 3 typen:

| Type             | Badge             | Beschrijving                                                                                                                 |
| ---------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **DOCUMENT**     | Blauw of neutraal | Gebeurtenissen gerelateerd aan documentuploads, validaties, afwijzingen, vervangingen of toegang.                            |
| **REMINDER**     | Geel of oranje    | Geautomatiseerde herinneringen voor aankomende of achterstallige acties (bijv. verlopen documenten, openstaande validaties). |
| **ANNOUNCEMENT** | Groen of paars    | Platform- of gebouwbrede aankondigingen (bijv. nieuwe functie-releases, statuswijzigingen van het gebouw).                   |

***

## Actieknoppen

Elk Activiteitsfeed-item bevat een actieknop die rechtstreeks linkt naar de relevante functie of workflow. Het label van de knop verandert op basis van het gebeurtenistype:

| Actieknop                    | Wanneer getoond                                                                                     | Actie                                                           |
| ---------------------------- | --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| **Document bekijken**        | Een document is geüpload, gevalideerd, afgewezen of bijgewerkt.                                     | Opent het document in de Data Room.                             |
| **Object 3D-model bekijken** | Een BIM-objectgebeurtenis heeft plaatsgevonden (veldwijziging ingediend, goedgekeurd of afgewezen). | Opent de BIM 3D Viewer bij het specifieke object via deep link. |
| **Uitnodiging bekijken**     | Een nieuwe stakeholder is uitgenodigd voor het gebouw.                                              | Opent de details van de stakeholderuitnodiging.                 |
| **Verzoek beoordelen**       | Een stakeholder heeft een toegangsverzoek voor een document ingediend.                              | Opent de workflow voor het goedkeuren van toegangsverzoeken.    |
| **Validator toewijzen**      | Een document is geüpload zonder een toegewezen validator.                                           | Opent het documentuploadformulier om validators toe te wijzen.  |
| **Lotverdeling bekijken**    | Een gebeurtenis heeft plaatsgevonden in de sectie Lot Division.                                     | Opent de sectie Lot Division voor het gebouw.                   |
| **Energiemeter bekijken**    | Een gebeurtenis heeft plaatsgevonden in de sectie Fluid Synoptic.                                   | Opent de sectie Fluid Synoptic voor het gebouw.                 |
| **Taken bekijken**           | Een nieuwe taak is aangemaakt voor de gebruiker.                                                    | Opent het Takenpaneel voor het relevante gebouw.                |
| **Opmerking bekijken**       | Een nieuwe annotatiecommentaar is toegevoegd aan een document.                                      | Opent het document in de viewer op de annotatiepositie.         |

***

## Niet-geziene items

Activiteitsfeed-items die nog niet zijn bekeken, worden visueel gemarkeerd met een **primaryLighter-achtergrond**kleur. Dit maakt het eenvoudig om omlaag te scrollen naar waar u gebleven was en nieuwe gebeurtenissen in één oogopslag te identificeren.

### Automatisch wissen bij paginabezoek

Wanneer u naar de Activiteitsfeed-pagina navigeert, worden alle momenteel zichtbare items automatisch gemarkeerd als "gezien." De ongelezen badge in de linkernavigatie wordt gewist bij het bezoeken van de feed. Nieuwe gebeurtenissen die binnenkomen nadat u de feed hebt geopend, verschijnen met de markering totdat u de pagina herlaadt of opnieuw bezoekt.

***

## Sortering

De Activiteitsfeed is gesorteerd op **occurredOn aflopend** — de meest recente gebeurtenissen verschijnen bovenaan. Deze sorteervolgorde wordt opgeslagen als een **gebruikersvoorkeur**, zodat uw gekozen sorteervolgorde behouden blijft tussen sessies.

Momenteel is de primaire sortering op recentheid (nieuwste eerst), wat ervoor zorgt dat de meest actiegerichte en tijdsgevoelige gebeurtenissen altijd bovenaan uw feed staan.

***

## Filteren op gebouw

Gebruik de **gebouwcarrousel** bovenaan de feed om alleen gebeurtenissen van een specifiek gebouw te tonen:

1. Klik op een gebouwminiatuur in de carrousel.
2. De feed filtert om alleen gebeurtenissen van dat gebouw te tonen.
3. Klik opnieuw op dezelfde miniatuur, of klik op de optie "Alles", om terug te keren naar de niet-gefilterde feed.

Dit is met name handig bij het beheren van een groot portfolio — u kunt zich op één gebouw tegelijk concentreren en de activiteitsitems doorwerken voordat u naar het volgende gaat.

***

## Veelvoorkomende scenario's voor de Activiteitsfeed

### Document ingediend voor validatie

Een teamlid uploadt een document en wijst u toe als validator. U ziet:

* **Gebeurtenistype:** DOCUMENT
* **Titel:** "Document wacht op uw validatie"
* **Beschrijving:** "\[Naam] heeft \[Documentnaam] v2 geüpload in de sectie \[Niveau]."
* **Actie:** Document bekijken → opent het document zodat u het kunt beoordelen en valideren.

### Document afgewezen

U heeft een document geüpload en een validator heeft het afgewezen. U ziet:

* **Gebeurtenistype:** DOCUMENT
* **Titel:** "Uw document is afgewezen"
* **Beschrijving:** "\[Validatornaam] heeft \[Documentnaam] afgewezen — Reden: \[afwijzingsreden inline weergegeven]."
* **Actie:** Document bekijken → opent het document zodat u de afwijzingsreden kunt bekijken en een gecorrigeerde versie kunt uploaden.

### Toegangsverzoek ontvangen

Een externe partij heeft toegang aangevraagd tot een document dat u bezit. U ziet:

* **Gebeurtenistype:** DOCUMENT
* **Titel:** "Toegangsverzoek voor \[Documentnaam]"
* **Beschrijving:** "\[Naam aanvrager] verzoekt toegang tot \[Documentnaam]."
* **Actie:** Verzoek beoordelen → opent de workflow voor goedkeuring/weigering.

### Documentannotatie

Een stakeholder heeft een opmerking geplaatst op een pagina van een document. U ziet:

* **Gebeurtenistype:** DOCUMENT
* **Titel:** "Nieuwe opmerking bij \[Documentnaam]"
* **Beschrijving:** "\[Naam stakeholder] heeft een opmerking geplaatst op pagina \[X] van \[Documentnaam]."
* **Actie:** Opmerking bekijken → opent de documentviewer op de opmerkingspositie.

### Herinnering: Verlopen document

De geldigheid van een document nadert zijn vervaldatum. U ziet:

* **Gebeurtenistype:** REMINDER
* **Titel:** "Document verloopt binnenkort"
* **Beschrijving:** "\[Documentnaam] verloopt op \[datum]. Upload een vernieuwde versie om een indexstraf te vermijden."
* **Actie:** Document bekijken → opent het document voor vervanging.

***

## Tips voor het gebruik van de Activiteitsfeed

* Controleer de Activiteitsfeed **dagelijks** om op de hoogte te blijven van validatieverzoeken en vervalherinneringen — onbehandelde taken stapelen zich op en kunnen de voortgang van de Magma Index vertragen.
* Gebruik het **filter voor de gebouwcarrousel** wanneer u een specifiek gebouw heeft dat aandacht nodig heeft — het elimineert ruis van andere gebouwen.
* Onderneem actie op **REMINDER**-gebeurtenissen onmiddellijk — verlopen documenten veroorzaken een onmiddellijke Magma Index-straf zodra ze hun vervaldatum hebben overschreden.
* De actie **Verzoek beoordelen** is tijdsgevoelig — externe partijen die wachten op toegang hebben een reactie nodig om verder te kunnen werken.
* Als u een groot team beheert, is de Activiteitsfeed een efficiënte manier om alle stakeholderacties in het gebouw te monitoren zonder elke afzonderlijke sectie te hoeven openen.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mymagma.com/magma-documentation/nl/functies/activity-feed.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
