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

# Job Board Reports

> Analytics for job board performance and engagement

Track job board performance with posting statistics, engagement metrics, and revenue reporting.

## Key Metrics

<CardGroup cols={4}>
  <Card title="Active Jobs">Current listings</Card>
  <Card title="Applications">Total applications</Card>
  <Card title="Views">Job page views</Card>
  <Card title="Revenue">Posting revenue</Card>
</CardGroup>

## Reports

### Posting Report

* Jobs by category
* Jobs by employer
* Approval rates
* Time to fill

#### Acceptance Criteria

##### Frontend

* [ ] Posting Report workflow is implemented in the UI as described.

##### Backend / API

* [ ] Backend behavior supports Posting Report 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.

### Engagement Report

* Views per job
* Application rates
* Click-through rates
* Popular categories

#### Acceptance Criteria

##### Frontend

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

##### Backend / API

* [ ] Backend behavior supports Engagement Report 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.

### Revenue Report

* Revenue by posting type
* Revenue by employer
* Trends over time

#### Acceptance Criteria

##### Frontend

* [ ] Revenue Report workflow is implemented in the UI as described.

##### Backend / API

* [ ] Backend behavior supports Revenue Report 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.

## Features

### Job Board Reports

#### 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/jobs/reports/summary                # Summary metrics
GET /api/jobs/reports/postings               # Posting report
GET /api/jobs/reports/engagement             # Engagement report
GET /api/jobs/reports/revenue                # Revenue report
POST /api/jobs/reports/export                # Export report
```
