SIR LIN DERACHI - Fashion Ecommerce Platform

Project Overview

SIR LIN DERACHI is a fashion ecommerce platform built around a sharp black-and-white storefront and an operational admin console. The system supports public catalog discovery, product variants, cart and checkout flows, payment initiation, order fulfillment, homepage merchandising, and customer account surfaces.

Key Features

• Fashion storefront: A branded ecommerce interface for browsing products, collections, category routes, product detail pages, and editorial homepage content.
• Variant-first catalog: Products are containers, while sellable inventory is managed through color-first variants, size options, stock, pricing, and images.
• Cart and checkout: Customer flows include cart management, delivery notes, checkout summary, payment initialization, and order history.
• Admin commerce console: Admin users can manage products, variants, categories, collections, tags, homepage sections, hero items, users, and fulfillment queues.
• Payment and fulfillment lifecycle: The backend handles order creation, payment verification, webhook validation, shipment status, and order status transitions.

Technical Architecture

sirlinderachi-web/
  src/app/        # Next.js App Router storefront, account, and admin routes
  src/api/        # typed API clients
  src/components/ # shared layout, commerce, media, and navigation components
  src/lib/        # validation, formatting, media, order, and payment helpers

sirlinderachi-api/
  app/routes/     # FastAPI route modules
  app/services/   # catalog, order, payment, email, media, and homepage workflows
  app/schemas/    # Pydantic request and response contracts
  app/db/         # SQLModel database models and session management

Implementation Highlights

Storefront Experience

The public web app uses Next.js App Router and Mantine to deliver a fast, responsive storefront with structured catalog filters, shareable collection and category routes, product media, and clear purchase actions.

Catalog Modeling

The catalog treats products as merchandising containers and variants as the sellable units. Each variant owns color, stock, optional price overrides, size availability, and product imagery. This keeps inventory decisions explicit and prevents ambiguous cart items.

Admin Operations

The admin console centralizes the work needed to run the store: inventory, homepage presentation, product taxonomy, customer records, order queues, and shipment lifecycle actions. Admin list views use focused detail panes so operators can scan and update commerce data without leaving the workflow.

Backend Services

The FastAPI backend provides JWT auth, email flows, product media handling, paginated catalog endpoints, cart checkout, payment providers, webhook verification, and fulfillment transitions. SQLModel and Pydantic keep database records and API contracts typed end to end.

Technical Stack

Frontend

• Next.js App Router
• React
• TypeScript
• Mantine
• Playwright and Vitest

Backend

• FastAPI
• SQLModel and SQLAlchemy
• Pydantic
• JWT authentication
• Paystack and Flutterwave payment flows

Conclusion

SIR LIN DERACHI demonstrates a full ecommerce product that joins polished brand presentation with practical commerce operations. The project covers both the customer-facing buying experience and the admin workflows required to maintain catalog quality, payment integrity, and order fulfillment.