Petrogina Trading — agricultural export management platform
A B2B platform that connects the catalogue of Egyptian agricultural products with structured quote requests, customer accounts and order and shipment follow-up — in English and Arabic.
- Client
- Petrogina Trading
- Industry
- Agri-food export & logistics
- Role
- Full-stack developer — architecture, back-office, customer portal and front-end
- Engagement
- Client project
- Year
- 2026
- Live site
- petroginatrading.com
By the numbers
- 20
- admin modules
- 27
- automated test files
- 2
- AI assistants
- 5
- ocean carriers tracked
- 2
- languages
01 — The challenge
The challenge
International buyers need reliable product specifications, seasonality and shipment visibility before they commit to a container. The exporter was handling catalogue updates, quote requests, orders, shipments and recruiting across email and spreadsheets, with no single source of truth.
The platform also had to work equally well in English and Arabic, and give staff different levels of access to orders, prices and customer data.
02 — Goals
Goals
- Introduce buyers to each product and its specifications.
- Collect pricing, packing and destination requirements in one structured request.
- Support order and shipment follow-up for customers and staff.
- Organise the company’s content, documents and communication.
03 — Who it’s for
Who it’s for
Importers, distributors and trade buyers sourcing Egyptian produce — and the exporter’s own sales, export and management teams who answer them.
04 — The solution
The solution
The platform follows a trade buyer from first look to shipment: a fast bilingual public site, an authenticated customer portal and a Filament back-office with role-based permissions across 20 modules.
- Buyers browse a catalogue with spec sheets, a seasons calendar and sourcing regions, then send one quote request covering several products with quantities, packing, destination port and shipping terms.
- Customers follow their orders and notifications in the portal, and a tracking page shows the shipment information the team has recorded, with links to the carriers’ own tracking.
- Staff manage products (including bulk Excel imports), quotes, orders, shipments, quality documents, the company profile, careers and SEO from one panel.
- Two AI assistants — one for staff, one for customers — answer questions through server-side tools that check permissions on every call.
05 — How it works
How it works
- Browse a product and its specifications.
- Create an account and send a quote request with quantities, packing and destination.
- Follow orders and notifications from the account, and open the tracking page for the shipment information available.
- The export team receives the request, replies and updates its status from the back-office.
06 — Architecture
Architecture
Laravel 12 with Filament 5 and Livewire 4. Customer accounts live on a separate database connection from staff users. Order, shipment and payment states are explicit enums, and every status change dispatches notifications. The AI layer wraps the Gemini API behind per-audience tool classes; its threat model is documented on the principle that the model is never a security boundary. A static redesign prototype was built and tested with Playwright before being ported into the Laravel views.
07 — Key features
Key features
-
Bilingual catalogue with spec sheets
Product pages with specifications, seasons and sourcing regions in English and Arabic.
-
Customer portal
Registration, orders, quote requests, shipment tracking and notifications.
-
Sea-freight tracking
Carrier tracking links for five major ocean carriers and status history per shipment.
-
Excel catalogue import
Bulk product updates from spreadsheets with validation.
-
Permission-aware AI assistants
Separate staff and customer assistants whose tools enforce the same permissions as the UI.
-
Careers & SEO manager
Job listings with applications, plus per-page SEO metadata editable by staff.
-
Multi-product quote requests
One request covers several products with quantities, packing, destination port and shipping terms.
-
Quality documents & company profile
Quality certificates, a company profile and a catalogue visitors can view and download.