Member PortalJourneys
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
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
- Access Directory
Member navigates to Directory:
- Main navigation → Directory
- Dashboard → Directory widget
- Search results
- 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...] │ │ │ └─────────────────────────────────────────────────────────────┘ - Search Companies
Search functionality:
Search Fields:
- Company name
- Description
- Services offered
- Keywords/tags
- Location
Search Features:
- Autocomplete suggestions
- Recent searches
- Popular searches
- 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 - 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 - Sort Results
Sort options:
- Featured First (default)
- Highest Rated
- Most Reviewed
- Alphabetical
- Newest
- Nearest (with geolocation)
- View Company Profile
Click to view full profile:
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
Related Journeys
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