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

# UJ-M-018: Browse Resource Library

> Member explores and discovers resources in the library

## Journey Overview

| Attribute      | Value                                              |
| -------------- | -------------------------------------------------- |
| **Journey ID** | UJ-M-018                                           |
| **Actor**      | Member                                             |
| **Goal**       | Find relevant resources and content                |
| **Trigger**    | Member needs information or professional materials |
| **Outcome**    | Member finds and accesses relevant resources       |

## Preconditions

* Resources exist in the library
* Member has appropriate access level

## Journey Flow

```mermaid theme={null}
flowchart TD
    A[Navigate to Resources] --> B[View resource library]
    B --> C{Search or browse?}
    C -->|Search| D[Enter search terms]
    C -->|Browse| E[Browse by category]
    D --> F[View search results]
    E --> F
    F --> G[Apply filters]
    G --> H[View resource cards]
    H --> I[Click resource]
    I --> J[View resource details]
```

## Detailed Steps

<Steps>
  <Step title="Access Resource Library">
    Member navigates to Resources:

    * Main navigation → Resources
    * Dashboard → Resource widget
    * Search results
    * Email/notification links
  </Step>

  <Step title="Browse Library">
    Library landing page shows:

    ```
    ┌─────────────────────────────────────────────────────────────┐
    │ Resource Library                                            │
    ├─────────────────────────────────────────────────────────────┤
    │                                                             │
    │ [🔍 Search resources...                              ]      │
    │                                                             │
    │ CATEGORIES                                                  │
    │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐        │
    │ │ 📄       │ │ 🎥       │ │ 📊       │ │ 📚       │        │
    │ │ Documents│ │ Videos   │ │ Templates│ │ Guides   │        │
    │ │ 124      │ │ 45       │ │ 32       │ │ 28       │        │
    │ └──────────┘ └──────────┘ └──────────┘ └──────────┘        │
    │                                                             │
    │ FEATURED RESOURCES                                          │
    │ ┌─────────────────────────────────────────────────────────┐ │
    │ │ [Image] 2025 Industry Report                            │ │
    │ │ Comprehensive analysis of industry trends...            │ │
    │ │ 📄 PDF • Free • ⭐ Popular                              │ │
    │ └─────────────────────────────────────────────────────────┘ │
    │                                                             │
    │ RECENTLY ADDED                                              │
    │ [Resource cards...]                                         │
    │                                                             │
    └─────────────────────────────────────────────────────────────┘
    ```
  </Step>

  <Step title="Search Resources">
    Search functionality:

    **Search Fields:**

    * Resource title
    * Description
    * Keywords/tags
    * Author name
    * Full-text (if enabled)

    **Search Behavior:**

    * Real-time suggestions
    * Recent searches
    * Popular searches
    * Spell correction
  </Step>

  <Step title="Apply Filters">
    Filter options:

    | Filter   | Options                            |
    | -------- | ---------------------------------- |
    | Category | Documents, Videos, Templates, etc. |
    | Type     | PDF, Video, Excel, PowerPoint      |
    | Access   | Free, Member, Premium              |
    | Date     | Newest, Last 30 days, This year    |
    | Topic    | Industry-specific topics           |
    | Author   | Content creator                    |
    | Series   | Resource series/collection         |
  </Step>

  <Step title="View Resource Cards">
    Each resource card displays:

    | Element      | Description                        |
    | ------------ | ---------------------------------- |
    | Thumbnail    | Preview image or file type icon    |
    | Title        | Resource name                      |
    | Description  | Brief summary                      |
    | Type         | File type badge (PDF, Video, etc.) |
    | Access Level | Free, Member, Premium              |
    | Date         | Published/updated date             |
    | Downloads    | Download count                     |
    | Rating       | User ratings (if enabled)          |
  </Step>

  <Step title="Sort Results">
    Sort options:

    * Most Recent (default)
    * Most Popular (downloads)
    * Highest Rated
    * Alphabetical
    * Relevance (search results)
  </Step>
</Steps>

## Resource Types

| Type         | Icon | Description                       |
| ------------ | ---- | --------------------------------- |
| PDF Document | 📄   | Reports, guides, whitepapers      |
| Video        | 🎥   | Recorded presentations, tutorials |
| Template     | 📊   | Excel, Word, PowerPoint templates |
| Presentation | 📽️  | Slide decks                       |
| Spreadsheet  | 📈   | Data files, calculators           |
| Image        | 🖼️  | Infographics, diagrams            |
| Audio        | 🎧   | Podcasts, recordings              |
| Link         | 🔗   | External resources                |

## Access Levels

| Level       | Audience        | Display                     |
| ----------- | --------------- | --------------------------- |
| Public      | All visitors    | Available                   |
| Free Member | Any member      | Available                   |
| Premium     | Paid membership | Lock icon for non-premium   |
| Gated       | Requires action | Registration/payment prompt |

## Personalization

Resources may be personalized:

* Based on interest categories
* Based on viewing history
* Based on profession/role
* Recommended by AI

**Personalized Sections:**

* "Recommended for You"
* "Based on Your Interests"
* "Because You Downloaded X"

## Mobile Experience

* Responsive grid layout
* Swipe through featured
* Quick filters accessible
* Download for offline (if enabled)

## Related Entities

* [`Resource`](/entities/core/resource)
* [`Resource Category`](/entities/core/resource-category)
* [`Resource Type`](/entities/core/resource-type)

## Related Journeys

* [UJ-M-019](/member/journeys/access-resource)
* [UJ-M-006](/member/journeys/browse-events)

## Acceptance Criteria

### Frontend

* [ ] Resource library landing page
* [ ] Search bar with suggestions
* [ ] Category browsing
* [ ] Filter panel/sidebar
* [ ] Resource card grid/list
* [ ] Sort dropdown
* [ ] Pagination/infinite scroll
* [ ] Mobile-responsive design
* [ ] Loading states

### Backend

* [ ] `GET /api/resources` - List resources with filters
* [ ] `GET /api/resources/categories` - Category list
* [ ] `GET /api/resources/featured` - Featured resources
* [ ] Query params: `?category=`, `?type=`, `?search=`
* [ ] Search indexing for full-text search

### Permissions

* [ ] Public resources visible to all
* [ ] Member resources require auth
* [ ] Premium resources show lock for non-premium

### Business Rules

* [ ] Access levels enforced
* [ ] Resources ordered by relevance/date
* [ ] Inactive/draft resources hidden

### Error Handling

* [ ] Empty search results with suggestions
* [ ] Network error with cached content