Directory Management

Manage business directory listings and company profiles

Manage the business directory where member companies can list their services and connect with other members.

Capabilities

Action	ROLE_CLIENT_ADMIN	ROLE_CLIENT_USER
View listings	✅	✅
Approve listings	✅	❌
Edit listings	✅	❌
Manage categories	✅	❌
Feature listings	✅	❌

Features

Listing Approval Workflow

Submitted → Pending Review → Approved/Rejected → Published

Acceptance Criteria

Frontend

• UI supports the workflows described in this feature.

Backend / API

• Backend behavior supports this feature as documented.

Permissions

• Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

Business Rules

• All business rules for this feature are enforced.

Error Handling

• Error states return clear messages and appropriate HTTP status codes.

Directory Categories

• Industry verticals
• Service types
• Geographic regions
• Company size

Acceptance Criteria

Frontend

• UI supports the workflows described in this feature.

Backend / API

• Backend behavior supports this feature as documented.

Permissions

• Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

Business Rules

• All business rules for this feature are enforced.

Error Handling

• Error states return clear messages and appropriate HTTP status codes.

Featured Listings

• Promote select companies
• Homepage placement
• Priority in search results

Acceptance Criteria

Frontend

• UI supports the workflows described in this feature.

Backend / API

• Backend behavior supports this feature as documented.

Permissions

• Access is restricted per the Capabilities matrix on this page (or equivalent role rules).

Business Rules

• All business rules for this feature are enforced.

Error Handling

• Error states return clear messages and appropriate HTTP status codes.

Map & Location Search

The directory can support Google Maps-style browsing and store-locator searches.

Expected configuration:

• Enable/disable map view in the Directory
• Ensure listings capture a valid address and store geocoded coordinates (lat/lng)
• Optionally configure default radius options and map zoom behavior

Acceptance Criteria

Frontend

• Admin UI can see whether a listing has valid geocoding (lat/lng) and prompt for address fixes.

Backend / API

• Listings persist geocoded location data and expose it to member directory search.

Permissions

• Only ROLE_CLIENT_ADMIN can configure map/search settings.

Business Rules

• Listings without valid geocoding can still appear in list search but are excluded from map pins.

Error Handling

• Geocoding failures are surfaced clearly and retriable.

Implementation Contracts

Backend (API)

GET    /api/directory/listings               # List all
GET    /api/directory/listings/pending       # Pending approval
PUT    /api/directory/listings/{id}/approve  # Approve
PUT    /api/directory/listings/{id}/reject   # Reject
PUT    /api/directory/listings/{id}/feature  # Feature listing

GET    /api/directory/categories             # List categories
POST   /api/directory/categories             # Create category