> ## 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-023: Browse Job Listings

> Member explores job opportunities posted by sponsors

## Journey Overview

| Attribute      | Value                                   |
| -------------- | --------------------------------------- |
| **Journey ID** | UJ-M-023                                |
| **Actor**      | Member                                  |
| **Goal**       | Find relevant job opportunities         |
| **Trigger**    | Member looking for career opportunities |
| **Outcome**    | Member finds jobs of interest           |

## Preconditions

* Job listings exist in the system
* Member has access to job board

## Journey Flow

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

## Detailed Steps

<Steps>
  <Step title="Access Job Board">
    Member navigates to Careers/Jobs:

    * Main navigation → Careers / Jobs
    * Dashboard → Jobs widget
    * Email job alerts
  </Step>

  <Step title="View Job Listings">
    Job board landing:

    ```
    ┌─────────────────────────────────────────────────────────────┐
    │ Job Board                                                   │
    ├─────────────────────────────────────────────────────────────┤
    │                                                             │
    │ [🔍 Search jobs, companies, skills...                ]      │
    │                                                             │
    │ CATEGORIES                                                  │
    │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐        │
    │ │ 💼       │ │ 💻       │ │ 📊       │ │ 🎨       │        │
    │ │Management│ │ Tech     │ │ Finance  │ │ Marketing│        │
    │ │ 23 jobs  │ │ 45 jobs  │ │ 18 jobs  │ │ 12 jobs  │        │
    │ └──────────┘ └──────────┘ └──────────┘ └──────────┘        │
    │                                                             │
    │ FEATURED JOBS                                               │
    │ ┌─────────────────────────────────────────────────────────┐ │
    │ │ [Logo] Senior Project Manager          🏆 Featured      │ │
    │ │ Acme Corp • Sydney • Full-time                          │ │
    │ │ $150k - $180k • Posted 2 days ago                       │ │
    │ └─────────────────────────────────────────────────────────┘ │
    │                                                             │
    │ ALL JOBS (98 listings)                                      │
    │ [Job cards...]                                              │
    │                                                             │
    └─────────────────────────────────────────────────────────────┘
    ```
  </Step>

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

    **Search Fields:**

    * Job title
    * Company name
    * Skills/keywords
    * Description

    **Search Features:**

    * Autocomplete suggestions
    * Recent searches
    * Saved searches (job alerts)
  </Step>

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

    | Filter       | Options                        |
    | ------------ | ------------------------------ |
    | Location     | City, State, Remote            |
    | Job Type     | Full-time, Part-time, Contract |
    | Experience   | Entry, Mid, Senior, Executive  |
    | Salary Range | Min-Max salary                 |
    | Category     | Industry/function category     |
    | Posted       | Today, This week, This month   |
    | Company      | Specific company               |
  </Step>

  <Step title="View Job Cards">
    Each job card displays:

    | Element      | Description                  |
    | ------------ | ---------------------------- |
    | Company Logo | Employer logo                |
    | Job Title    | Position name                |
    | Company      | Employer name                |
    | Location     | City or "Remote"             |
    | Type         | Full-time, Part-time, etc.   |
    | Salary       | Range (if disclosed)         |
    | Posted       | Days/weeks ago               |
    | Featured     | Badge for sponsored listings |
  </Step>

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

    * Most Recent (default)
    * Relevance (for search)
    * Salary (high to low)
    * Company A-Z
    * Closing Soon
  </Step>

  <Step title="View Job Details">
    Click job to view full details:

    ```
    ┌─────────────────────────────────────────────────────────────┐
    │ [Company Logo]                                              │
    │                                                             │
    │ Senior Project Manager                                      │
    │ ═══════════════════════                                     │
    │                                                             │
    │ 🏢 Acme Corporation                                         │
    │ 📍 Sydney, NSW • Hybrid                                     │
    │ 💼 Full-time • Permanent                                    │
    │ 💰 $150,000 - $180,000 + Super                             │
    │ 📅 Posted 2 days ago • Closes March 30                     │
    │                                                             │
    │ [Apply Now]  [Save Job]  [Share]                           │
    │                                                             │
    │ ─────────────────────────────────────────────────────────── │
    │                                                             │
    │ About the Role                                              │
    │ ───────────────                                             │
    │ We're looking for an experienced Project Manager to lead... │
    │                                                             │
    │ Responsibilities                                            │
    │ ────────────────                                            │
    │ • Lead project delivery...                                  │
    │ • Manage stakeholder relationships...                       │
    │                                                             │
    │ Requirements                                                │
    │ ────────────                                                │
    │ • 5+ years project management experience                    │
    │ • PMP or similar certification                              │
    │                                                             │
    │ Benefits                                                    │
    │ ────────                                                    │
    │ • Flexible working                                          │
    │ • Professional development budget                           │
    │                                                             │
    │ About the Company                                           │
    │ ─────────────────                                           │
    │ [Brief company description]                                 │
    │ [View Company Profile]                                      │
    │                                                             │
    └─────────────────────────────────────────────────────────────┘
    ```
  </Step>
</Steps>

## Job Alerts

Members can set up job alerts:

* Save search criteria
* Receive email when matching jobs posted
* Frequency: Daily or Weekly digest
* Manage alerts in preferences

## Related Entities

* [`Job Posting`](/entities/core/job-posting)
* [`Company Profile`](/entities/core/company-profile)

## Related Journeys

* [UJ-M-024](/member/journeys/apply-job)
* [UJ-M-020](/member/journeys/browse-directory)

## Acceptance Criteria

### Frontend

* [ ] Job board landing page
* [ ] Search bar with autocomplete
* [ ] Category browsing
* [ ] Filter panel
* [ ] Job card grid/list
* [ ] Job detail page
* [ ] Sort dropdown
* [ ] Pagination
* [ ] Save job functionality
* [ ] Job alerts setup
* [ ] Mobile-responsive

### Backend

* [ ] `GET /api/jobs` - List jobs with filters
* [ ] `GET /api/jobs/{id}` - Job details
* [ ] `GET /api/jobs/categories` - Categories
* [ ] `POST /api/jobs/alerts` - Create alert
* [ ] Query params: `?search=`, `?location=`, `?type=`

### Permissions

* [ ] Jobs visible based on membership level
* [ ] Some jobs may be member-only

### Business Rules

* [ ] Featured jobs prioritized
* [ ] Expired jobs hidden
* [ ] Company must be approved sponsor

### Error Handling

* [ ] Empty results with suggestions
* [ ] Job not found handling