Kumppaniekosysteemi, joka on luotu kasvattamaan liiketoimintaa

1. Tausta: Composable Commerce AI Commercessa

Composable Commerce -filosofia tarkoittaa, että jokainen osa-alue (tuotehallinta, tilausten käsittely, asiakashallinta ym.) on toteutettuna omana mikro­palvelunaan. Yhtenäisen alustan sijaan nämä palvelut keskustelevat API-rajapintojen välityksellä.

Hyödyt kumppaneille:

• Joustavuus: Voitte tuoda uusia ominaisuuksia ja integraatioita ilman laajoja muutoksia ydinkoodiin.

• Laajennettavuus: Kattava micro service -malli avaa mahdollisuuden toteuttaa räätälöityjä ratkaisuja (esim. maksu-, ERP- ja hakuintegraatiot).

• Nopea tuotekehitys: Julkaiskaa omia laajennuksia itsenäisesti, AI Commercen tiimin huolehtiessa taustalla turvallisuudesta ja infrastruktuurista.

2. GraphQL: Tehokas tiedonhakukerros

AI Commerce tarjoaa GraphQL-rajapinnan (Apollo), jonka kautta partnerit voivat hakea juuri tarvitsemaansa dataa – esimerkiksi tuotteita, hintoja tai maita.

Miksi GraphQL?

1. Räätälöidyt kyselyt: Partneri voi määritellä tarkasti, mitä dataa palautetaan, jolloin vältetään turha tiedonsiirto.

2. Vähemmän pyyntöjä: Monimutkaiset tietokantakyselyt voidaan yhdistää yhteen GraphQL-pyyntöön REST-rajapinnan usean kutsun sijaan.

3. Yhtenäinen rajapinta: Kaikki data on haettavissa saman päätepisteen kautta.

Esimerkki GraphQL-kyselystä (POST)

Pyyntöpalautus (JSON)

{
  "data": {
    "products": [
      { "id": "632", "name": "721H",       "price": 89.9 },
      { "id": "637", "name": "TC7092",     "price": 49.9 },
      { "id": "697", "name": "JERONE50EUR","price": 50   },
      { "id": "698", "name": "JERONE100EU","price": 100  },
      { "id": "699", "name": "JERONE200EU","price": 200  }
    ]

Turvatut headerit

Jokainen GraphQL-pyyntö vaatii mm.

• X-GraphQL-Secret: AI Commercen turva-avain

• X-Tenant-Id: Kaupan alias (esim. “boeing”)

• X-Tenant-Secret: Tenantin oma API-avain

Suosittelemme käyttämään aina AI Commercen sisäverkon kuormanjakajan osoitetta, APP_LOAD_BALANCER_URL, jolloin pyyntö pysyy nopeasti ja turvallisesti AI Commercen VPC:ssä.

Rate Limiting

Järjestelmämme rajoittaa pyyntöjen määrää (esim. 100 pyyntöä / 5 min per tenant). Ylitystilanteessa palautetaan 429 Too Many Requests.

3. Serverless Lambda -ympäristö: Kumppanin laajennukset turvallisesti

AI Commerce on tuonut käyttöön serverless-ympäristön, jossa voitte ajaa omia mikropalveluja (Lambda-funktioita) samassa VPC:ssä AI Commercen ydinpalveluiden kanssa. Näin rakennatte uutta logiikkaa tai laajennatte olemassa olevia toimintoja ilman, että koskette itse ydinkoodiin.

Mitä tämä tarkoittaa?

1. Nopea ja turvallinen yhteys

   • Dataa ei tarvitse siirtää julkisen verkon kautta, vaan kaikki liikenne pysyy AI Commercen sisäisessä VPC:ssä.

2. Valitse oma ohjelmointikieli

   • Lambda tukee laajasti eri runtimeja (Java, Node.js, Python, .NET, Go, Rust jne.).

3. Helppo deploy-prosessi

   • Saatte omat AWS CLI -avaimet, joilla voitte julkaista koodinne.

   • Yhteinen domainin alla oleva CloudFront ja API Gateway huolehtivat reitityksestä, joten ulospäin kaikki näyttäytyy yhtenä osana AI Commercea.

4. GitHub-repositorio

   • Jokaisella kumppanilla (tai asiakkaalla) on oma “extensions-” -repositorio, johon koodi pusketaan ja josta se deployataan serverless-frameworkin avulla.

4. Kenelle serverless-lisäykset sopivat?

• ERP-integraatiot: Voitte synkronoida AI Commercen tilauksia tai tuotevarastoja suoraan asiakkaan ERP-järjestelmään (SAP, Microsoft Dynamics, NetSuite jne.).

• Hakutoiminnot: Jos teillä on oma hakuratkaisu (esim. Elasticsearch, Solr), voitte laajentaa tai korvata AI Commercen natiiveja hakupalveluja.

• Uudet ominaisuudet: Kattavat laajennukset tilausten käsittelyyn, logistiikkaan, maksuihin tai muihin liiketoimintaprosesseihin.

5. Kehitysprosessi lyhyesti

1. Kloonaa repo

git clone https://github.com/petrosoft-fi/extensions-clientName.git
cd extensions-clientName

1. Asenna työkalut

AWS CLI, Node.js, Serverless Framework, sekä valitsemasi kielen build-työkalut (esim. Maven, pip, dotnet-cli).

2. Muokkaa serverless.yml

Aseta runtime (kuten java21, nodejs22.x tai python3.13).

Viittaa käännettyyn pakettiin (esim. Java-projektissa target/my-project.jar).

3. Deploy

serverless deploy

Luo Lambda-funktion, API Gateway -reitit ja muut resurssit AI Commercen hallinnoimaan AWS-ympäristöön.

4. Testaa

Saat vastauksena URL-osoitteen, jolla palvelu on saatavilla. Kutsu sitä cURLilla tai selaimella:

curl https://example.com/ext/your-endpoint

6. Laajennukset ja “ylikirjoitus”

• Laajennukset: Kumppani lisää uutta mikro­palvelua, joka käsittelee esim. tilauksia tai kutsuu kolmannen osapuolen järjestelmiä.

• Ylikirjoitus: Tietyt AI Commercen natiivit reitit voidaan ohittaa (esim. hakutoiminto) ohjaamalla frontend suoraan teidän kehittämään Lambdaan. Näin luodaan Composable Commerce -mallin äärimmäistä joustavuutta.

7. Yhteenveto

AI Commercen moderni arkkitehtuuri kokoaa yhteen GraphQL-rajapinnan, serverittömän Lambda-ympäristön ja joustavan Composable Commerce -filosofian. Kumppanit voivat turvallisesti ja skaalautuvasti toteuttaa omia ratkaisujaan “hopeatarjottimella”:

• Täysi hallinta: Pystytte kehittämään ja julkaisemaan koodia itsenäisesti.

• Tehokas tiedonhaku: GraphQL tarjoaa nopean ja tarkasti rajatun tavan hakea dataa.

• Kattava ympäristö: API Gateway, CloudFront ja Lambda ovat valmiiksi konfiguroituja, joten voitte keskittyä liiketoimintalogiikkaan.

• Turvallisuus ja suorituskyky: Kaikki pysyy AI Commercen sisäverkossa, minimoiden viiveet ja parantaen tietoturvaa.

Haluamme tehdä yhteistyöstä helppoa ja sujuvaa. Mikäli tarvitsette lisätietoa, tukitiimimme on valmiina auttamaan. Tervetuloa laajentamaan AI Commercea omilla ratkaisuillanne – moderni serverless-maailma odottaa!

Tutustu kumppaneihimme täältä!