> ## 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-020: Browse Business Directory

> Member explores the business directory to find companies and service providers

## Journey Overview

| Attribute      | Value                                             |
| -------------- | ------------------------------------------------- |
| **Journey ID** | UJ-M-020                                          |
| **Actor**      | Member                                            |
| **Goal**       | Find companies/service providers in the directory |
| **Trigger**    | Member needs to find a business or service        |
| **Outcome**    | Member finds relevant companies                   |

## Preconditions

* Directory contains published company profiles
* Member has directory access (membership feature)

## Journey Flow

```mermaid theme={null}
flowchart TD
    A[Navigate to Directory] --> B[View directory listing]
    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 company cards]
    H --> I[Click company]
    I --> J[View company profile]
```

## Detailed Steps

<Steps>
  <Step title="Access Directory">
    Member navigates to Directory:

    * Main navigation → Directory
    * Dashboard → Directory widget
    * Search results
  </Step>

  <Step title="Directory Landing">
    Directory home page:

    ```
    ┌─────────────────────────────────────────────────────────────┐
    │ Business Directory                                          │
    ├─────────────────────────────────────────────────────────────┤
    │                                                             │
    │ [🔍 Search companies, services...                    ]      │
    │                                                             │
    │ CATEGORIES                                                  │
    │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐        │
    │ │ 🏢       │ │ 💼       │ │ 💻       │ │ 📊       │        │
    │ │ Consulting│ │ Legal    │ │ Tech     │ │ Finance  │        │
    │ │ 45 cos   │ │ 32 cos   │ │ 67 cos   │ │ 28 cos   │        │
    │ └──────────┘ └──────────┘ └──────────┘ └──────────┘        │
    │                                                             │
    │ FEATURED COMPANIES                                          │
    │ ┌─────────────────────────────────────────────────────────┐ │
    │ │ [Logo] Acme Consulting                    ⭐ Featured   │ │
    │ │ Management consulting for growing businesses...         │ │
    │ │ 📍 Sydney • ⭐ 4.8 (24 reviews)                         │ │
    │ └─────────────────────────────────────────────────────────┘ │
    │                                                             │
    │ ALL COMPANIES                                               │
    │ [Company cards...]                                          │
    │                                                             │
    └─────────────────────────────────────────────────────────────┘
    ```
  </Step>

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

    **Search Fields:**

    * Company name
    * Description
    * Services offered
    * Keywords/tags
    * Location

    **Search Features:**

    * Autocomplete suggestions
    * Recent searches
    * Popular searches
  </Step>

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

    | Filter   | Options                      |
    | -------- | ---------------------------- |
    | Category | Industry categories          |
    | Services | Specific services offered    |
    | Location | City, State, Country         |
    | Rating   | Minimum star rating          |
    | Tier     | Featured, Premium, Standard  |
    | Size     | Small, Medium, Enterprise    |
    | Offers   | Companies with member offers |
  </Step>

  <Step title="View Company Cards">
    Each company card shows:

    | Element    | Description                         |
    | ---------- | ----------------------------------- |
    | Logo       | Company logo                        |
    | Name       | Company name                        |
    | Tagline    | Brief description                   |
    | Category   | Primary category badge              |
    | Location   | City/Region                         |
    | Rating     | Star rating and count               |
    | Tier Badge | Featured/Premium indicator          |
    | Offer      | "Special Offer" badge if applicable |
  </Step>

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

    * Featured First (default)
    * Highest Rated
    * Most Reviewed
    * Alphabetical
    * Newest
    * Nearest (with geolocation)
  </Step>

  <Step title="View Company Profile">
    Click to view full profile:

    → [UJ-M-021: Contact a Company](/member/journeys/contact-company)
  </Step>
</Steps>

## Directory Display Tiers

| Tier              | Display Features                          |
| ----------------- | ----------------------------------------- |
| Featured/Platinum | Top of results, large card, special badge |
| Premium/Gold      | Enhanced listing, logo, description       |
| Standard          | Basic listing                             |

## Company Profile Preview

Clicking a company shows:

```
┌─────────────────────────────────────────────────────────────┐
│ [Banner Image]                                              │
│                                                             │
│ [Logo] ACME CONSULTING                    ⭐ 4.8 (24)       │
│        Management Consulting              🏆 Featured       │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│ About                                                       │
│ ─────                                                       │
│ Leading management consulting firm helping businesses...    │
│                                                             │
│ Services                                                    │
│ ────────                                                    │
│ • Strategy Consulting                                       │
│ • Digital Transformation                                    │
│ • Change Management                                         │
│                                                             │
│ Contact                                                     │
│ ───────                                                     │
│ 📍 Sydney, Australia                                        │
│ 🌐 www.acmeconsulting.com                                   │
│ 📧 info@acmeconsulting.com                                  │
│                                                             │
│ [Contact Company]  [Visit Website]  [Save]                  │
│                                                             │
│ MEMBER OFFER                                                │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 🎁 15% off first consultation for members               │ │
│ │ Use code: MEMBER15                                      │ │
│ └─────────────────────────────────────────────────────────┘ │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

## Member Offers

Directory may include member-exclusive offers:

* Discount codes
* Free consultations
* Special pricing
* Extended trials

## Related Entities

* [`Company Profile`](/entities/core/company-profile)
* [`Sponsorship`](/entities/core/sponsorship)

## Related Journeys

* [UJ-M-021](/member/journeys/contact-company)
* [UJ-M-022](/member/journeys/manage-company)

## Acceptance Criteria

### Frontend

* [ ] Directory landing page
* [ ] Search bar with autocomplete
* [ ] Category browsing
* [ ] Filter sidebar/panel
* [ ] Company card grid/list
* [ ] Company profile page
* [ ] Sort dropdown
* [ ] Pagination/infinite scroll
* [ ] Mobile-responsive design
* [ ] Map view (optional)

### Backend

* [ ] `GET /api/directory/companies` - List companies
* [ ] `GET /api/directory/companies/{id}` - Company details
* [ ] `GET /api/directory/categories` - Categories
* [ ] Query params: `?category=`, `?search=`, `?location=`
* [ ] Tier-based sorting logic

### Permissions

* [ ] Public directory may have limited view
* [ ] Full access requires membership

### Business Rules

* [ ] Featured companies prioritized in results
* [ ] Only approved profiles displayed
* [ ] Contact info visible based on tier

### Error Handling

* [ ] Empty search results suggestions
* [ ] Company not found handling