Skip to content
Omar Khaled
Menu

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
Screenshot 1 of Petrogina Trading — agricultural export management platform

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

  1. Browse a product and its specifications.
  2. Create an account and send a quote request with quantities, packing and destination.
  3. Follow orders and notifications from the account, and open the tracking page for the shipment information available.
  4. 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.

Next step

A platform to build — or a role to fill?

Tell me about your project or your team in a few lines. You’ll get a reply within 24 hours with next steps — no sales script.