Hey, willkommen im Dev Portal

Hier findest du alles rund um die SIRPLUS App-Infrastruktur. Das Backend, die Flutter App, Shopify-Anbindung und wie das alles zusammenspielt. Die technische Doku liegt in den jeweiligen Repos - hier gibt's den Überblick und ein paar nützliche Tools.

Wie das Ganze funktioniert

Die Flutter App redet nie direkt mit Shopify. Alles läuft über unser eigenes Backend, das als Proxy und Auth-Layer fungiert. Das hat ein paar Vorteile: Wir können Daten cachen, transformieren und haben volle Kontrolle über die API. Außerdem hält das die Shopify API Keys aus der App raus.

┌─────────────────┐
│   Flutter App   │
│    (Mobile)     │
└────────┬────────┘
         │
         │ JWT Auth
         │ REST API
         ▼
┌─────────────────────────────────────────────────────────┐
│                    SIRPLUS Backend                       │
│                    api.sirplus.de                        │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐  │
│  │   Phalcon   │  │    Redis    │  │     MariaDB     │  │
│  │   PHP 8.4   │  │    Cache    │  │   Product Sync  │  │
│  └──────┬──────┘  └─────────────┘  └─────────────────┘  │
└─────────┼───────────────────────────────────────────────┘
          │
          │ Shopify Access Token
          │ (Server-side only)
          ▼
┌─────────────────────────────────────────────────────────┐
│                      Shopify                             │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────┐  │
│  │ Storefront  │  │   Admin     │  │      Seal       │  │
│  │  GraphQL    │  │  REST API   │  │  Subscriptions  │  │
│  │  (Products) │  │ (Metafields)│  │   (Abos API)    │  │
│  └─────────────┘  └─────────────┘  └─────────────────┘  │
└─────────────────────────────────────────────────────────┘

2-Level Auth: User authentifiziert sich mit Email/Passwort gegen unser Backend und bekommt einen JWT. Das Backend authentifiziert sich dann mit dem Shopify Customer Access Token gegen die Storefront API. So sind die Shopify Credentials nie auf dem Client.

Product Sync: Produkte werden von Shopify in unsere MariaDB gespiegelt. Das passiert per Cron (alle 2h Full Sync) und per Webhooks (Echtzeit bei Änderungen). Bilder werden runtergeladen, zu WebP konvertiert und in drei Größen gespeichert.

Subscriptions: Abos laufen über Seal Subscriptions (Shopify App). Unser Backend wrapped deren API und macht sie für die Flutter App konsumierbar.

Status

API

...

Produkte in DB

...

Verfügbar

...

Repositories

Die technische Dokumentation findest du in den README.md Dateien der jeweiligen Repos. Da steht alles drin: Setup, Architektur, API-Referenz und so weiter.

Backend

Phalcon PHP API, Shopify Integration, Product Sync, Auth System

gitlab.com/sirplus/backend

Flutter App

Mobile App für iOS und Android, Riverpod State Management

gitlab.com/sirplus/flutter-app

Dev Environment

LXC Container Setup, lokale Entwicklungsumgebung

gitlab.com/sirplus/backend-dev-env

GitLab Group

Alle SIRPLUS Repositories auf einen Blick

gitlab.com/sirplus