> ## Documentation Index
> Fetch the complete documentation index at: https://memberpulseptyltd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Engagement Dashboard

> Monitor community engagement and content performance

Track how members engage with generated content and community features.

## Capabilities

| Action           | ROLE\_CLIENT\_ADMIN | ROLE\_CLIENT\_USER |
| ---------------- | ------------------- | ------------------ |
| View dashboard   | ✅                   | ✅                  |
| Export reports   | ✅                   | ❌                  |
| Configure alerts | ✅                   | ❌                  |

## Key Metrics

<CardGroup cols={4}>
  <Card title="Active Members">Members engaging this period</Card>
  <Card title="Content Views">Total content views</Card>
  <Card title="Comments">Total comments posted</Card>
  <Card title="Engagement Rate">Overall engagement %</Card>
</CardGroup>

## Dashboard Sections

### Content Performance

| Metric                 | Description                                 |
| ---------------------- | ------------------------------------------- |
| Top Performing Content | Highest engagement items                    |
| Category Performance   | Engagement by interest area                 |
| Content Type Analysis  | Articles vs discussions vs polls            |
| Poll Votes             | Total votes per poll and participation rate |
| Trending Topics        | Rising engagement areas                     |

#### Acceptance Criteria

##### Frontend

* [ ] Content Performance workflow is implemented in the UI as described.

##### Backend / API

* [ ] Backend behavior supports Content Performance as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

### Member Engagement

| Metric              | Description                             |
| ------------------- | --------------------------------------- |
| Most Active Members | Top contributors                        |
| New Engagers        | First-time commenters                   |
| Replies             | Comment replies (thread depth/activity) |
| Engagement Trends   | Activity over time                      |
| Silent Majority     | Members viewing but not engaging        |

#### Acceptance Criteria

##### Frontend

* [ ] Member Engagement workflow is implemented in the UI as described.

##### Backend / API

* [ ] Backend behavior supports Member Engagement as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

### Notification Effectiveness

| Metric                    | Description                      |
| ------------------------- | -------------------------------- |
| Nomination → View Rate    | % who viewed nominated content   |
| Notification → Engagement | % who engaged after notification |
| Opt-out Rate              | Members disabling notifications  |

#### Acceptance Criteria

##### Frontend

* [ ] Notification Effectiveness workflow is implemented in the UI as described.

##### Backend / API

* [ ] Backend behavior supports Notification Effectiveness as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

## Reports

<Tabs>
  <Tab title="Weekly Summary">
    * Content published
    * Total engagement
    * Top performing items
    * Active member count
  </Tab>

  <Tab title="Category Report">
    * Performance by interest category
    * Member distribution
    * Content gap analysis
  </Tab>

  <Tab title="Member Report">
    * Engagement leaders
    * Engagement trends
    * Inactive member segments
  </Tab>
</Tabs>

## Features

### Engagement Dashboard

#### Acceptance Criteria

##### Frontend

* [ ] UI supports the workflows described in this feature.

##### Backend / API

* [ ] Backend behavior supports this feature as documented.

##### Permissions

* [ ] Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

##### Business Rules

* [ ] All business rules for this feature are enforced.

##### Error Handling

* [ ] Error states return clear messages and appropriate HTTP status codes.

## Implementation Contracts

### Backend (API)

```
GET /api/community/analytics/dashboard           # Dashboard metrics
GET /api/community/analytics/content             # Content performance
GET /api/community/analytics/members             # Member engagement
GET /api/community/analytics/categories          # Category performance
GET /api/community/analytics/notifications       # Notification metrics
POST /api/community/analytics/export             # Export report
```