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

Detailed Steps

1. Access Directory

   Member navigates to Directory:

   • Main navigation → Directory
   • Dashboard → Directory widget
   • Search results
2. 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...]                                          │
   │                                                             │
   └─────────────────────────────────────────────────────────────┘
   
3. Search Companies

   Search functionality:

   Search Fields:

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

   Search Features:

   • Autocomplete suggestions
   • Recent searches
   • Popular searches
4. 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

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

6. Sort Results

   Sort options:

   • Featured First (default)
   • Highest Rated
   • Most Reviewed
   • Alphabetical
   • Newest
   • Nearest (with geolocation)
7. View Company Profile

   Click to view full profile:

   → UJ-M-021: Contact a Company

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                                   │
│ 📧 [e-mail]                                  │
│                                                             │
│ [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
• Sponsorship

Related Journeys

• UJ-M-021
• UJ-M-022

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