Challenge and Context
Business-to-business transactions rely heavily on trust and verified performance data. Organizations need a reliable way to assess supplier reliability before committing to partnerships, yet public review platforms often lack credibility due to unverified or biased submissions. The goal was to build a credentialed review system where only authenticated businesses can submit reviews, ensuring authenticity and accountability.
The platform needed to support multiple evaluation dimensions, not just a single star rating. Suppliers are evaluated across quality, accuracy, communication, cost, compliance, timeliness, and support. Each review captures both quantitative scores and qualitative commentary, creating comprehensive performance profiles that potential partners can use for due diligence.
Architecture and System Design
The application uses Laravel 12 as the core framework, leveraging its mature ecosystem for authentication, authorization, and database operations. The admin interface is built with Filament 3, providing a robust CRUD system for managing suppliers, reviews, and user accounts. The frontend utilizes Livewire for interactive components paired with Tailwind CSS for styling.
Data storage relies on MySQL for relational data, with Redis handling caching and queue management through Laravel Horizon. The search functionality integrates TypeSense, an open-source typo-tolerant search engine, enabling fast supplier lookups with fuzzy matching capabilities.
The application follows a domain-driven approach with clear separation between models, services, and controllers. Eloquent relationships define the connections between suppliers, users, and reviews, while service classes encapsulate business logic such as domain normalization and content moderation.
Key Engineering Decisions
The authentication system implements one-time password verification rather than traditional password-based login. Users register and authenticate using email plus time-limited OTPs sent via notification channels. This approach eliminates password management overhead while providing stronger security guarantees for a business platform where account integrity is paramount.
The review submission flow includes gatekeeping logic that verifies the reviewer has actually conducted business with the supplier being reviewed. This credentialing mechanism prevents fake reviews and maintains platform integrity. Authorization policies enforce these rules, checking supplier relationships before allowing review creation.
Supplier domains undergo normalization during registration and updates. The system extracts and standardizes domain formats, handling variations like with-www, without-www, and different protocol prefixes. This ensures consistent supplier identification and prevents duplicate entries from the same organization.
Content moderation is handled through a profanity filter service that processes review comments before storage. The implementation uses a separate filtering package with configurable word lists, allowing administrators to maintain appropriate content standards without blocking legitimate business language.
The search infrastructure uses Laravel Scout with TypeSense as the driver. Supplier records are synchronized to the search index with defined schemas specifying searchable fields and sorting behavior. The configuration enables multi-field queries across name, description, domain, and country attributes.
Delivery and Outcomes
The platform delivers a credentialed review system where businesses can build verified performance profiles for their supplier network. The seven-metric scoring system provides nuanced evaluation beyond simple ratings, allowing reviewers to highlight specific strengths and weaknesses in supplier relationships.
The OTP-based authentication removes password-related security risks while maintaining accessible user onboarding. The integration with Laravel Horizon ensures background tasks like search indexing and notification delivery operate reliably without impacting request response times.
TypeSense integration enables suppliers to be discovered quickly through typo-tolerant search, supporting use cases where users may not know exact spelling of supplier names. The search configuration prioritizes relevance while maintaining performance at scale.