CartSome
kapoti all.

Ehitanud need,
kes ehitavad panku.

Kiirus on meie DNA-s. Nagu ka see, et sinu raha ei kao. CartSome'i ehitavad inimesed, kes ehitavad panku, ja see paistab välja seal, kuhu keegi ei vaata: rahal ja laoseisul on üks kirjutaja, iga tegu jätab jälje, iga suurema kirjutuse ees on eelvaade ja iga väite taga on number.

• Kõigepealt õige, siis kiireRahal ja laoseisul on üks kirjutaja: shop-core. Makseid kontrollib server – brauseri sõna peale neid kunagi ei usaldata – ja brauser arvutab täissentides.
• Kõik jätab jäljeIga ligipääsu andmine või äravõtmine kirjutatakse üles samas tehingus kui tegu ise, iga operaatori tegu aga platvormi auditilogisse.
• Meelega igavPostgreSQL, Java, puhas SQL ja Terraform: tööriistad, mis on alles ka kümne aasta pärast, ja mitte ühtegi nutikat kihti, mida kell 3 öösel siluda.
• Mõõdetud, mitte arvatudIga muudatust selles, kuidas vitriin andmeid loeb, võrdlustestitakse enne avaldamist 500 000 tootega kataloogil. Kõhutundest võrdlustest algab, kõhutundega see ei lõpe.

Kiire ja väravatega kiireks hoitud

• Serveris renderdatud, servas vahemälusLehed saabuvad HTML-ina ostja keeles ning shop-core hoiab tooteloendid ja tootelehed Valkeys soojas.
• Baidieelarve CI-sVitriini sisenemispunkt, kest ja iga marsruudi tükk peavad igal muudatusel eelarvesse mahtuma ning eelarve liigub ainult allapoole. Iga keel on omaette tükis, nii et ostja laadib alla ainult oma keele.
• Kiirusvärav enne väljalasetSee ehitab main-haru ja muudatuse kõrvuti ning lükkab tagasi lehe, mis läheb raskemaks või Lighthouse'is aeglasemaks, olgu laadimise, paigutuse nihke või blokeerimisaja poolest.
• Halvima juhu väravIga teemavalik kõige raskemal kujul, kõik sektsioonitüübid korraga – ja pood ei tohi ikkagi aeglaseks minna. Teemad on CSS-muutujad, nii et teema ei too kaasa grammigi JavaScripti.
• Kerged pildidIga tootepilt skaleeritakse AVIF-variantideks ja staatilised failid saadetakse välja brotliga eelpakituna.

Kaks poolt.
Raudne piir.

Enamik platvorme kasvatab igale funktsioonile oma teenuse. Meie tõmbasime piiri täpselt ühte kohta: poed ühel pool, platvorm teisel. Kummalgi poolel on oma rakendus, oma core, oma andmebaasi kasutaja ja oma pool võtmest. Ja vana reegel kehtib mõlemal pool: kirjutab ainult core.

• shop-core – rakk, Java 25 ja Spring BootAinus, kes kirjutab poodide andmeid PostgreSQL-i, Valkeysse ja S3-sse. Iga muudatus halduskeskkonnas, iga import, makse ja poe taustatöö käib selle kaudu. See pole avalikust internetist ligipääsetav, kontrollib iga makse-webhooki ja allkirja ise ning avab poodide pitseeritud saladused.
• platform-core – juhttasandSama koodibaas, ehitatud teise rakendusena oma konteineritõmmisega: konsooli taustasüsteem, arveldus, organisatsioonid ja uute poodide loomine, platvormi enda e-post ja juhttasandi taustatööd. Selle andmebaasi kasutaja ei ulatu ühegi poe skeemini ja see ei käivita ühtegi migratsiooni.
• Raku API nende vahelKaks core'i räägivad omavahel kahe sisemise ukse kaudu, üks kummaski suunas, kummalgi oma saladus. Iga uks hoiab ainult selle saladuse SHA-256 räsi, mida ta vastu võtab, nii et kummalgi core'il pole midagi, mis tema enda ukse avaks. Ükski ostja päring ei oota juhttasandi järel.
• shop web – TanStack Start, React, serveris renderdatudRenderdab iga vitriini ostja keeles, poe halduskeskkonna, admin MCP ja Trade API ukse. Loeb Valkeyd ja PostgreSQL-i poe enda lugemiskasutajaga ega kirjuta midagi peale sisselogimisseansside; kõik muud kirjutused lähevad shop-core'ile.
• Konsool – omaette rakendusEraldi rakendus ja konteineritõmmis, mis teenindab admin.cartsome.com-i, operaatori MCP-d, cartsome.com-i vorme ja Stripe'i webhooki. Sellel pole andmebaasidraiverit ega ühegi poe saladusi ja see räägib ainult platform-core'iga.
• Serv – CloudFront ja WAFLehed on servas vahemälus ja pildid tulevad otse S3-st. Selle taga olev koormusjaotur vastab ainult CloudFrontile, saadab iga aadressi rakendusele, mis seda teenindab, ning ühele poele suunatud päringutulv peatatakse juba servas, poe aadressi kaupa.
• Aurora PostgreSQL 18, puhas SQLORM-i pole kusagil. Ka täistekstiotsing käib PostgreSQL-i enda sees, ostja keeles ja kirjavigu andestades. Pole eraldi otsinguklastrit, mida lapsehoidjana valvata.
• Valkey ja S3Valkey hoiab lehti, mille shop-core ostjate jaoks ette soojendab. S3 hoiab tootepilte (AVIF-variandid), teemade fonte, iga keele tootevoogu ja lahkuva poe eksporti.
• Konteinerid ARM-ilNeli teenust jooksevad ECS Fargate'il, Gravitonil, igaüks oma konteineritõmmisest, ja pilditöötlejad Lambdal, samuti ARM-il. Kõik on Terraformis kirjeldatud ja midagi ei klõpsita konsoolis kokku.

Pildid järjekorras

Sissekoliv pood toob kaasa tuhandeid pilte ja uus pood ei tohiks kellegi kassat aeglustada, kuni neid töödeldakse. Seepärast shop-core neid ise ei töötle.

• Core ainult paneb järjekordaShop-core paneb iga pilditöö SQS-i järjekorda ja kirjutab vastused üles, kui need tagasi tulevad, partiidena, üks tehing poe kohta. Töötlejatel pole üldse andmebaasi kasutajat.
• Igal poel õiglane järjekordIga pood on SQS-i õiglastes järjekordades oma grupp: interaktiivne rada pildile, mille haldur üles laadib, hulgirada importidele ja kummaski poe kohta ülempiir. Ühe poe suur import ei seisa kunagi teise poe ainsa foto ees.
• Sama kodeerija, rohkem käsiLambda-töötlejad teevad sama libvipsi kodeeringu, mida core, nii et pilt näeb välja ühesugune, ükskõik kes selle valmis tegi. Allalaadimised on lähteserveri kaupa doseeritud, nii et tarnija serverit üle ei ujutata.
• Tehtud üks kord, kasutatud kõikjalPilti tuntakse selle baitide räsi järgi. Kui mõni raku pood on sama lähtepildi juba töödelnud, kasutavad töötlejad selle faile uuesti, selle asemel et uuesti kodeerida.
• Ehitatud tormijooksuksTöötlejate parv kasvab, kui palju poode korraga sisse kolib, ega maksa jõude seistes midagi, ning halduskeskkond näitab iga käiku reaalajas: tehtud, taaskasutatud, ebaõnnestunud, ootel ja koht järjekorras.

Kogu süsteem
ühel lehel.

Kes kellega räägib, ostja telefonist kuni ketasteni. Pidevjooned kannavad päringuid ja kirjutusi, katkendjooned ainult loevad.

Kaart sõnadega

1. Kes koputab. Ostjad (inimesed ja tehisaru ostuagendid), teiste ettevõtete süsteemid Trade API kaudu, poe omaniku tehisaru, poe haldurid ja CartSome'i operaatorid jõuavad kõik sisse serva kaudu.
2. Serv. CloudFront hoiab lehti vahemälus, serveerib pilte otse S3-st, hoiab sertifikaate iga *.cartsome.com aadressi ja iga poe oma domeeni jaoks ning selle WAF piirab iga poe aadressi eraldi.
3. Koormusjaotur vastab ainult CloudFrontile. Iga poe aadressi saadab see shop webile, admin.cartsome.com-i ja cartsome.com-i API konsoolile.
4. Shop web renderdab vitriini, halduskeskkonna ja admin MCP, lisaks avaliku MCP ostuagentidele, mille iga pood ise sisse lülitab, ja Trade API ukse. See loeb PostgreSQL-i ja Valkeyd ning annab iga kirjutuse shop-core'ile.
5. Konsool teenindab admin.cartsome.com-i, operaatori MCP-d, cartsome.com-i vorme ja Stripe'i webhooki ning räägib ainult platform-core'iga.
6. Shop-core on rakk: ainus, kes kirjutab poodide andmeid PostgreSQL-i, Valkeysse ja S3-sse. See kontrollib webhooke, avab poodide seifi ja paneb pilditööd järjekordadesse.
7. Platform-core on juhttasand: organisatsioonid, uute poodide loomine, arveldus, platvormi e-post ja selle taustatööd, oma andmebaasi kasutajaga. Rakuni ulatub see ainult raku API kaudu, kummaski suunas oma saladusega.
8. Pilditöötlejad võtavad ülesandeid SQS-i õiglastest järjekordadest, igal poel oma grupp, kodeerivad need Lambdal ja kirjutavad failid S3-sse.
9. Andmed: Aurora PostgreSQL platvormi skeemi ja iga poe oma skeemiga, Valkey iga poe soojade lehtedega ning S3 piltide, fontide, voogude ja eksportide jaoks.
10. Rakk 1 käitab seda kõike täna Stockholmis. Rakk 2 on sama pinu veel kord; see avatakse siis, kui seda vaja läheb, selles AWS-i piirkonnas, mida tema poed vajavad.

Päringu elukäik

Sinu pood.
Sinu skeem.

Palju poode, üks andmebaasiklaster, null jagatud poetabelit. Iga pood saab oma PostgreSQL-i skeemi ja naabreid hoiab eemal andmebaas ise.

• Skeem ja kaks kasutajatPood n elab oma skeemis, mis on loodud ühe ja sama baasskeemi järgi. Shop web logib sisse poe lugemiskasutajaga, shop-core selle kirjutuskasutajaga, ja kumbki ei ulatu ühegi teise poeni. Platform-core'i kasutaja ei ulatu ühegi poeni.
• Pole poe veergu, mida unustadaTabelid säilitavad skeemi sees oma kuju: igal real pole poe ID-d ega filtrit, mille päring võiks välja jätta. Välisvõtmed ei välju skeemist kunagi.
• SQL-laused ei nimeta kunagi skeemiPoe valib kasutaja, kellena ühendus sisse logib, ja ühendus teenindab kogu oma eluea jooksul ühte poodi. Staatiline kontroll kukutab ehituse läbi, kui päringus on skeemi nimi.
• Ühenduskogumid avanevad vajaduse järgiIga pood saab oma väikesed ühenduskogumid, mis avatakse selle esimesel päringul ja suletakse, kui pood vaikseks jääb, nii et andmebaasi ühenduste eelarve piirab seda, mitu poodi on korraga hõivatud, mitte seda, mitu poodi üldse on. Igal poel on ka oma päringueelarve ja pood, mis selle ületab, saab palve hiljem uuesti proovida – tema üksi.
• Vahemälu ja lingid teavad oma poodiIga vahemälukirje võtmes on pood. Seansid, tellimuse lingid, kinkekaardi lingid ja uudiskirjast loobumise tõendid allkirjastatakse poe enda võtmetega, nii et ühe poe linki teine pood vastu ei võta.
• Lekketestid, mis katsuvad kõiki uksiNeed külvavad kahele poele rea igasse poepõhisesse tabelisse ja loevad kumbagi teise poe nimel, nii shop-core'i kui ka shop webi ühendustel, ning kutsuvad seejärel välja iga core'i otspunkti, mis võtab ID. Need jooksevad igal muudatusel.

Rakud, mitte
üks suur kamakas.

Skaleerime rakkude kaupa. Rakk on terviklik pinu: oma Aurora klaster, oma shop-core ja shop web, tema poodide skeemid, oma pildijärjekorrad ja -töötlejad. Kui üks täitub, avame järgmise. Juhttasand on eraldi ja räägib rakuga ainult raku API kaudu. Platvorm kasvab, ükski üksik rakk ei pea kasvama.

Mida tähendab „täis“

Rakk ei võta uut poodi vastu, kui mõni neist signaalidest jõuab oma piirini. Kui mõni signaal jõuab 80 protsendini piirist, planeerime järgmise raku; konsooli rakulehel on näha täituvus reaalajas ja see, milline signaal piirile läheneb.

• Suur pood saab oma rakuPood, mis jagatud rakust välja kasvab, saab raku endale. Autotools jääb rakku 1.
• Ehituselt teisaldatavKõik, mis poele kuulub, kannab poe nime: tema skeem oma võtmete ja jadadega, tema organisatsiooni külge pitseeritud seifiread, tema vahemäluvõtmed, tema voofailid. Miski ei seo teda rakuga, kus ta sündis.
• Aus märkusPoe kolimine rakkude vahel pole veel üks nupuvajutus. See tuleb koos teise rakuga ja teel pole ühtki jagatud osa, mis takistaks.

Vaikimisi lukus.
Meelega igav.

Poe põnev osa peaksid olema tooted. Siin on igav osa – nii põhjalikult, kui seda hea meelega avalikult kirja paneme.

• Eraldatus andmebaasisPoepõhised skeemid ja kasutajad, mida jõustavad PostgreSQL-i õigused, mitte kood, mis peab filtrit meeles pidama. Juhttasandil on oma kasutaja ja shop-core'i kasutajal pole juhttasandi tabelitele ühtegi õigust.
• Igal organisatsioonil pitseeritud seifMakse-, kulleri- ja e-posti võtmed on seifis. Iga võti on pitseeritud AES-256-GCM-iga värske andmevõtme abil, mille väljastab KMS-võti, mida saavad kasutada ainult kaks core'i, ning seotud oma organisatsiooni ja nimega. Kopeeritud rida ei avane kusagil. Saladused ei ela kunagi koodis.
• Kummalgi core'il pool võtitShop-core avab poodide saladused ja platform-core platvormi enda omad, näiteks Stripe'i ja raamatupidamise võtmed. Võtme poliitika ei anna kummalegi teise poolt.
• Kaks ust, kaks saladustCore'id kutsuvad teineteist kummaski suunas eri saladusega ja iga uks hoiab ainult selle saladuse SHA-256 räsi, mida ta vastu võtab, nii et kummalgi core'il pole seda, mis tema enda ukse avab.
• Pääsuvõtmed neile, kes platvormi käitavadOperaatorid logivad sisse pääsuvõtmega ja kinnitavad iga platvormimuudatuse uuesti pääsuvõtmega. Ligipääsu andmine pole kunagi tööriist: ükski tõend ega tehisaru ei saa operaatorit lisada.
• Tehisaru kirjutused, mida näed ja tagasi võtadHulgi- ja väljapoole suunatud kirjutused käivad kõigepealt eelvaatena ja rakenduvad kinnitusega, mis on seotud sellega, mida nägid; kui pood vahepeal muutus, lükatakse kirjutus tagasi. Ja iga kirjutuse vastuses on kaasas, kuidas see tagasi võtta.
• Tõendid kõige väiksema võtmekimbugaIgal admin MCP tõendil või ühendusel on õigused ja see näeb ainult neid tööriistu, mida need õigused lubavad. Tagasimaksed, saladused ja haldurid vajavad igaüks eraldi õigust.
• Kliendid jäävad vestlusest väljaTööriista vastus liigub tehisaru pakkujani, seega jätavad vastused välja ostjate nimed, e-posti aadressid, telefoninumbrid, aadressid ja maksunumbrid. Vähesed sõnaselgelt nimetatud erandid, näiteks tellimuse kommentaari tekst, on reeglites kirjas.
• Iga operaatori teol on jälgIga muudatus, mille operaator teeb, ja iga mitut poodi hõlmav lugemine jõuab platvormi auditilogisse.

314 toimingut.
Null vormi.

Admin MCP annab tehisarule 314 poetoimingut ja igaüks neist on olemas ka veebi halduskeskkonnas. Ühenda Claude, ChatGPT, Cursor, Gemini või mõni muu MCP-klient sisselogimise või kleebitud tõendiga. Lüliti on väljas, kuni haldur selle sisse lülitab.

Turvamudel

Õigused kujundavad pinna

Tõend näeb ainult neid tööriistu, mida tema õigused lubavad, nii et kitsas tõend tähendab nii väikest pinda kui ka väikest võimu. Sildid ja menüüd on eraldi õigused, sest avaldatud menüü muudab kohe seda, mida ostjad näevad. Postituse mustand ja selle avaldamine on kaks eri õigust. Tehisaru ei saa ühtki raamatupidamiskannet kinnitada; seda teeb inimene halduskeskkonnas.

Näited

↑ Näidispäringud · nimetatud tööriistad on päris

Poest poodi.
Vahendajata.

Iga pood saab avada oma ärikliendidele Trade API: neutraalse, versioonitud HTTP API, mille kaudu nende enda süsteemid loevad kataloogi nende hindadega ja esitavad tellimusi. Ja iga pood saab osta igast teisest poest, mis seda räägib, nagu veel ühelt tarnijalt.

• Protokoll, mitte kaubamärkAvastamine aadressil /.well-known/trade-api, API ise /trade/v1 all, OpenAPI 3.1 dokument ja mitte kusagil ühegi platvormi nime. Müüja, kes seda räägib, on lihtsalt müüja, ükskõik mis teda käitab.
• Võtmed teeb klient iseHaldur kinnitab ettevõtte ärikontoks, määrab hinnataseme, millega see ostab, ja lubab API kasutamise. Klient loob ja tühistab oma võtmed ise oma konto lehel; pood hoiab ainult räsi ja ükski haldur ei näe kunagi ühtki võtit.
• Nende hinnad, päris laoseisIga toode on hinnastatud täpselt nii, nagu vitriin selle sisse loginud kliendi jaoks hinnastab, ja kõrval on vitriini müüdav laoseis, ülempiiriga.
• Tellimused, mis ei kahekordistuIgal tellimusel on idempotentsusvõti: sama võti ja sisu tagastavad esimese tellimuse, erineva sisuga päring lükatakse tagasi. Edasi on see poe tavaline tellimus, millele tehakse arve ja mis pakitakse ja saadetakse välja nagu ikka.
• Osta ükskõik millisest poestÜldotstarbeline tarnijaliides teeb Trade API-t rääkivast müüjast veel ühe tarnija: selle laoseisu ja hindu loetakse graafiku järgi, tellimused lähevad välja idempotentsusvõtmega ning kinnitused ja tarned loetakse tagasi. See kutsub müüja avalikku aadressi nagu iga võõras, mitte kunagi otseteed mööda raku sees.
• Lühike rihmPäringute ja tellimuste piirangud võtme kaupa, ülempiir tasumata tellimustele ning ühe poe võti on teises poes võõras. Iga konto, ligipääsu ja võtmega seotud tegu jõuab poe auditilogisse ja klient saab teada igast uuest võtmest.
• Aus märkusWebhooke veel pole: ostja peab muudatusi ise perioodiliselt küsima. Tellimused tasutakse praegu ettemaksuarvega; maksetähtajaga arve tuleb hiljem.

Pood minutitega.
Ava, kui oled valmis.

Pole paigaldusprogrammi ega serverit, mida valida. Lisame sinu organisatsiooni platvormi konsoolis, pood ehitab end ise üles ja sealt edasi juhid sina.

Keeled lülitiga. Uus pood alustab oma põhikeele ja eesti keelega. Lülita sisse ükskõik milline 8 keelest, kui selle tõlked on valmis, menüüs Seaded › Keeled või manage_languages abil. Toode jääb igas keeles samale aadressile.

Too oma pood.
Google jääb alles.

Autotools kolis Shopifyst ja müüb täna CartSome'il 25 000+ toodet. Samad tööriistad, millega see kolimine tehti, saad ka sina.

• Tooted: teisendab tehisaru, kontrollib inimeneSinu tehisaru loeb impordivormingut, poe sõnavara ja tarnija andmeid ning kirjutab faili, mille poe enda valideerija läbi laseb. See peatub ja nimetab iga lünga, selle asemel et kategooriat välja mõelda. Inimene vaatab üle, mis sobitus ja mis on uus, ning rakendub ainult see import, mille ta ise nimetab, ja seda eelvaate kinnitamisega, mille ta on läbi lugenud.
• Peidus, kuni ütled „näita“Uued tooted saabuvad peidetuna. Üks eelvaatega kutse toob nähtavale terve kuni 5 000 tootega valiku.
• Vanad aadressid, ümber suunatudAnna üle Shopify ümbersuunamiste eksport või mis tahes kaheveeruline loend. Iga rida sobitatakse samamoodi, nagu vitriin aadresse otsib, ahelad volditakse üheks püsivaks ümbersuunamiseks ja iga sihtkohta kontrollitakse poe enda lehtede vastu.
• Shopifyst kolimise tööriistakastMeie üleminekutööriistad teevad vanast saidist hetktõmmise, koostavad vana ja uue aadressi vastavustabeli koos aruandega selle kohta, mis on veel katmata, ning küsivad siis uuelt poelt iga rea kohta järele, nõudes ühte 301-suunamist lehele, mis päriselt vastab. Autotools tõi nii üle 12 598 vana aadressi.
• Uudiskirja nõusolekud, kolitud üks kordTurundusnimekiri kolib poe nõusolekuregistrisse koos iga inimese antud vastusega. Kolimise käigus ei saadeta midagi.
• Mis jääb mahaVarasemad tellimused jäävad vanale platvormile. Hoia selle eksport raamatupidamise jaoks alles.

Näidiskolimine

↑ Näide · tempo sõltub sinu kataloogi suurusest