Automotive Parts Distribution Portal for Importers and Dealers

An automotive parts distribution platform serving importers and dealers across multiple markets needed rapid feature delivery but carried a database design flaw from its early stages. Azati joined as a core engineering partner, resolved the architectural issue through a structured ADR process, and has been continuously extending the platform ever since.

Scale my automotive platform
2

PHP engineers embedded full-time in a multi-vendor delivery team

Multi-region

platform supporting dealers across multiple countries and currencies

4

external systems integrated: vendor APIs, tracking, PDF generation, and SQS

Technologies used

PHP
PHP
Laravel
Laravel
TypeScript
TypeScript
Angular
Angular
PostgreSQL
PostgreSQL
AWS
AWS
Amazon S3
Amazon S3
Docker
Docker

Motivation

Automotive parts distribution is deceptively complex. On the surface it looks like an ordering system: a dealer requests a part, an importer sources it, it ships. But underneath sits a web of credit terms, warranty cases, multi-currency pricing, regional tax rules, vendor-specific ordering APIs, and tracking integrations that all have to work together without breaking when a new market is added or a supplier changes their API contract.

The client operates a B2B distribution platform connecting automotive importers and dealers across multiple markets, with dealers in Poland as the primary audience. The platform was already live and growing when Azati joined, but a database design decision made early in the project's life was now blocking an entire product epic. Feature delivery was falling behind. Azati was brought in to stabilize the architecture and keep the platform moving forward.

Business challenges

Challenge 01

A database design flaw blocking a core product epic

The original database schema had been built without accounting for one of the platform's core feature sets. By the time the gap surfaced, the system was already in production with real data. A redesign had to be designed, justified to the CTO, and implemented without breaking what was already running:

  • Schema incompatible with planned epic requirements
  • Production data constraints limiting migration options
  • CTO approval required before any architectural change
  • Ongoing feature delivery could not be paused during refactoring
#1
Challenge 02

Multi-region complexity in a single platform

The platform serves markets with different languages, currencies, tax regimes, and regulatory requirements. Every new feature has to work correctly across all of them, and the business logic for things like warranty handling and credit orders varies by region:

  • Multi-language and multi-currency support throughout
  • Regional tax and pricing rule variations per country
  • Warranty case handling and returns per market
  • Cross-region order and tracking consistency
#2
Challenge 03

External integrations with vendor and tracking APIs

The platform's value to dealers depends on live connectivity to supplier systems. Automated parts ordering, order confirmation, and shipment tracking all depend on external APIs that each have their own contracts, authentication models, and failure modes:

  • Vendor API integration for automated parts ordering
  • Order confirmation and status sync via external systems
  • Tracking system integration for shipment visibility
  • PDF invoice generation via third-party API
#3
Challenge 04

Coordinating delivery in a large multi-vendor team

The engineering team is made up of developers from multiple vendors, all working on the same codebase simultaneously. High commit volume, AI-assisted development, and no formal release process creates a coordination challenge that requires discipline from every contributor:

  • High-volume concurrent commits requiring careful merging
  • AI-assisted development increasing code generation speed
  • No formal release gate between staging and production
  • Kanban workflow with continuous deployment cadence
#4

The client's requirements

The client needed engineers who could integrate quickly into an active multi-vendor team, navigate a sensitive architectural refactoring without disrupting delivery, and contribute meaningfully to both backend and frontend across a broad feature scope:

  • Resolve the database architecture issue blocking a core product epic
  • Continue feature delivery in parallel with refactoring without disrupting the live platform
  • Develop and extend order management, parts catalog, and dealer portal features
  • Integrate external vendor APIs for automated parts ordering and confirmation
  • Implement tracking system integrations for shipment visibility
  • Build PDF invoice and document generation via third-party API
  • Maintain and extend test coverage across backend and frontend
  • Contribute to Angular frontend development alongside Laravel backend work

Why Azati?

Architecture diagnosis before implementation

When the database design flaw surfaced, Azati's response was a formal written proposal before a single line of schema change. The problem, the options, the rationale, documented, reviewed by the CTO, approved, then implemented. That sequence matters in a multi-vendor environment where undocumented decisions create compounding risk.

Full-stack depth on a modern automotive platform

The project requires fluency across Laravel backend development, Angular and TypeScript frontend work, PostgreSQL schema design, AWS infrastructure, and external API integration. Azati's engineers contribute across all of these without needing separate specialists for each layer, which matters in a team where coordination overhead is already high.

AI-augmented development as a productivity multiplier

The team runs AI tooling as a standard part of daily engineering, not as an experiment. Azati's engineers operate the same way: AI-assisted code generation and analysis, Playwright MCP for browser automation in testing, structured prompting against documented APIs. Joining a team already working this way means no friction, no ramp-up on tooling culture.

Embedded team member, not an external vendor

Two engineers, full-time, same codebase, same responsibilities as any other developer on the project. Not a separate workstream that delivers on a schedule, a genuine part of the team's daily capacity.

Scaling a B2B distribution platform across multiple markets?

If your automotive platform is falling behind on features, carrying an architectural debt, or needs engineers who can ship across the full stack without slowing the team down, let's talk.

Fix my platform architecture

Solution

01

Database Architecture Refactoring

The foundational work of the engagement was resolving a database design issue that was blocking an entire product epic. Azati produced a formal Architecture Decision Record laying out the problem, evaluated options, and recommended approach. After CTO approval, the schema was redesigned and the migration implemented without interrupting the ongoing delivery cadence of the wider team.

Key capabilities:
  • Formal ADR produced and approved before implementation
  • Schema redesign to support previously blocked product epic
  • Migration implemented without production downtime
  • PostgreSQL 18 schema patterns aligned to long-term product roadmap
02

Order Management and Parts Catalog

The core of the platform is the order lifecycle between importers and dealers. Azati contributed to building and extending order management features including visual order status tracking, parts catalog management, price request flows, and dealer credit order handling. The system handles the full importer-to-dealer supply chain with the regional and currency variations each market requires.

Key capabilities:
  • Order lifecycle management for importer and dealer roles
  • Visual order status display and tracking
  • Price request flow for parts enquiries
  • Credit order handling with regional business rule support
03

External API and Vendor Integrations

The platform's operational value depends on live connectivity to external systems. Azati built and maintained integrations with vendor ordering APIs for automated parts procurement, order confirmation flows, and shipment tracking systems. Amazon SQS handles async messaging between the platform and external services, ensuring reliability under variable load.

Key capabilities:
  • Vendor API integration for automated parts ordering
  • Order confirmation and status sync with external systems
  • Tracking system integration for shipment visibility
  • Amazon SQS for async messaging and integration reliability
04

Document Generation and Invoicing

The platform generates invoices, shipping documents, and other structured outputs using a third-party PDF generation API with template-based rendering. This allows the business to produce consistent, branded documents across different order types and markets without maintaining a custom PDF rendering stack.

Key capabilities:
  • PDF invoice and document generation via pdfgeneratorapi.com
  • Template-based rendering for consistent branded output
  • Support for multi-currency and multi-region document formats
  • Integrated into order completion and confirmation flows
05

Frontend Development and API Contracts

The Angular and TypeScript frontend is built against a well-structured API layer documented via OpenAPI and Swagger. Azati contributed to frontend feature development while helping maintain the API contract discipline that makes the codebase tractable for a large multi-vendor team, where consistent interfaces reduce the coordination overhead of many engineers working on the same system simultaneously.

Key capabilities:
  • Angular and TypeScript frontend feature development
  • OpenAPI and Swagger-documented API contracts
  • Angular + Swagger OpenAPI generator for frontend service generation
  • Test coverage via automated testing including Playwright MCP

Major achievements

Metric / areaBefore Azati's involvementAfter Azati's involvement
Database architectureSchema blocking core product epicADR approved by CTO, schema redesigned and migrated
Epic deliveryBlocked by architectural constraintEpic unblocked and delivered
Order managementBasic order flowsExtended with status tracking, price requests, credit handling
Vendor connectivityManual or limited integrationAutomated ordering and confirmation via vendor APIs
Document generationNo structured output pipelinePDF invoices and documents generated via API
API structureInconsistent contractsOpenAPI/Swagger documented, generator-ready for frontend

Security

All platform traffic is secured with TLS 1.3 encryption across client-server and service-to-service communication. File storage uses Amazon S3 with access policies appropriate to document sensitivity. Async messaging between the platform and external systems runs through Amazon SQS with standard AWS access control. The platform handles multi-region financial data including credit orders and invoices, and operates under the data handling requirements applicable to B2B commerce platforms serving EU markets.

Engagement & delivery

T&M full-time engagement

Two Azati engineers work on a Time and Material basis, giving the client flexible capacity that scales with the backlog rather than a fixed project scope. Hours are tracked transparently and billed against actual delivery.

Kanban with continuous delivery

The team operates on a Kanban basis with a continuously flowing backlog rather than fixed sprints. Features are developed, tested, and shipped in a continuous cycle:

  • Backlog driven by business priorities and CTO direction
  • High commit volume coordinated across multiple vendors
  • AI tooling used actively for code generation, analysis, and testing
  • Playwright MCP used for AI-assisted browser testing
  • Test coverage maintained across backend and frontend as a delivery standard

Results & business impact

Architectural Blocker Resolved

The schema issue that was holding back an entire product epic is gone. The redesigned database now supports the full planned feature set, and the product roadmap is no longer constrained by an early architectural mistake.

Continuous Feature Delivery at Pace

Azati engineers have contributed continuously to platform feature development across order management, vendor integrations, document generation, and frontend work, keeping pace with a fast-moving product backlog.

Multi-Region Growth Without Rearchitecting

Every feature delivered works across the existing language, currency, and market configuration. Expanding to a new EU market doesn't mean starting over it means turning on what's already built.

AI-Ready Engineering Practices

The investment in OpenAPI documentation, Swagger-generated frontend service clients, and structured data contracts means the team's AI-assisted development workflows operate at high efficiency. The codebase is legible to AI tooling in a way that most codebases are not.

Domain Expertise in Automotive Distribution

The engagement has built genuine expertise inside Azati in automotive B2B distribution mechanics: importer and dealer roles, credit ordering, warranty handling, cross-region tax and currency logic, and the vendor API landscape for parts procurement.

Team composition

Two Azati engineers work full-time as embedded members of the client's multi-vendor development team, contributing across the full stack from database architecture to frontend feature delivery.

  • PHP / Laravel Backend Developer responsible for database architecture work including the ADR and schema refactoring, vendor API integrations, Amazon SQS messaging, order management backend features, and backend test coverage.
  • PHP / Angular Full-Stack Developer contributing to Laravel backend feature development, Angular and TypeScript frontend work, PDF generation integration, tracking system connectivity, and AI-assisted development workflows including Playwright MCP for automated testing.

The described expertise is relevant for

  • B2B portal and marketplace development for distribution and wholesale businesses
  • Laravel and Angular platform development at production scale
  • Database architecture refactoring without downtime on live systems
  • Multi-region and multi-currency platform engineering
  • Vendor API integration for automated ordering and fulfillment workflows
  • AI-augmented engineering teams working on complex, well-documented codebases

Last updated

Got a job for Azati? Let’s talk business!

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

What's next?

  • 1. Tell Us Your Story
    Describe your project. We come back within 24 hours with team availability and a rough plan. NDA on request before the first call.
  • 2. Get Your Roadmap
    Receive a detailed proposal with scope, team composition, timeline, and costs tailored to your goals.
  • 3. Start Building
    Azati aligns on details, finalize terms, and launch your project with full transparency.