> ## 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.

# Resource Reporting

> Analytics for resource library usage and engagement

Track resource library engagement with download statistics, popular content analysis, and member usage patterns.

## Features

### Key Metrics

<CardGroup cols={4}>
  <Card title="Total Views">Views across all resources</Card>
  <Card title="Downloads">Total download count</Card>
  <Card title="Unique Users">Members accessing resources</Card>
  <Card title="Top Resource">Most downloaded item</Card>
</CardGroup>

#### 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.

### Reports Available

* **Usage Report** - Views and downloads by resource
* **Category Performance** - Engagement by category
* **Member Engagement** - Most active users
* **Trend Analysis** - Usage over time

#### 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/resources/reports/usage             # Usage statistics
GET /api/resources/reports/categories        # Category performance
GET /api/resources/reports/members           # Member engagement
GET /api/resources/reports/trends            # Usage trends
POST /api/resources/reports/export           # Export report
```
